列出智能体

返回智能体及其元数据列表。

请求头

xi-api-keystring可选

查询参数

page_sizeinteger可选1-100默认为 30

最多返回的智能体数量。不能超过 100,默认为 30。

searchstring or null可选

按智能体名称搜索。

archivedboolean or null可选默认为 false

按归档状态筛选智能体

show_only_owned_agentsboolean可选默认为 falseDeprecated

设为 true 时,此端点将忽略他人分享给你的智能体,仅包含你拥有的智能体。已弃用:请改用 created_by_user_id。

created_by_user_idstring or null可选

按创建者用户 ID 筛选智能体。设置后,仅返回该用户创建的智能体。优先于 show_only_owned_agents。使用 ‘@me’ 指代已认证用户。

tagslist of strings or null可选

按标签筛选智能体。重复传入此参数可匹配多个标签中的任意一个。

sort_directionenum可选

结果排序方向

允许的值:
sort_byenum or null可选

用于排序结果的字段

允许的值:
cursorstring or null可选

用于获取下一页。响应中会返回游标。

响应

成功响应

agentslist of objects

智能体及其元数据列表。

has_moreboolean

是否还有更多智能体可分页获取

next_cursorstring or null可选

用于分页浏览智能体的下一个游标

错误

422
Unprocessable Entity Error