Skip to main content
GET
列出智能体

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

查询参数

order
enum<string>

列表排序。默认为 created_at_desc。 智能体列表的排序方式:created_at 最旧在前,created_at_desc 最新在前(默认)。

可用选项:
created_at,
created_at_desc
exclude_multiagent
boolean

为 true 时只返回未配置 multiagent 的智能体。子智能体选择器使用它,因为子智能体名单不能引用本身就是协调者的智能体。

official_only
boolean

为 true 时只返回平台提供的官方智能体。默认为 false。

created_at_gt
string<date-time>

返回在该时间戳之后创建的智能体(不含该时刻)。

created_at_gte
string<date-time>

返回在该时间戳及之后创建的智能体(含该时刻)。

created_at_lt
string<date-time>

返回在该时间戳之前创建的智能体(不含该时刻)。

created_at_lte
string<date-time>

返回在该时间戳及之前创建的智能体(含该时刻)。

updated_at_gt
string<date-time>

返回在该时间戳之后更新的智能体(不含该时刻)。

updated_at_gte
string<date-time>

返回在该时间戳及之后更新的智能体(含该时刻)。

updated_at_lt
string<date-time>

返回在该时间戳之前更新的智能体(不含该时刻)。

updated_at_lte
string<date-time>

返回在该时间戳及之前更新的智能体(含该时刻)。

page_size
integer<int32>
默认值:50

返回的条目数,1 到 1000(默认 50)。

必填范围: 1 <= x <= 1000
page_token
string

来自上一次响应 next_page_token 的不透明分页令牌。

响应

一页智能体,按请求的排序返回。

一页智能体。已归档的智能体不会出现在列表中。

items
object[]
必填

本页中的智能体。

next_page_token
string

下一页的分页令牌。列表耗尽时缺省。