AI Agent
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
列出平台上所有公开可用的 Agent——与探索页展示的是同一份目录。返回的 uid 即发起对话接口路径中使用的 Agent 标识。
与 Workspace 下的 Agent 不同,本接口不限定 Workspace:返回所有已发布且公开分享的 Agent。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | integer | 可选 | 页码,从 1 开始,默认 1 |
limit | integer | 可选 | 每页条数,默认 20,最大 50 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
agents | object[] | 可选 | Agent 列表,按最后更新时间倒序 |
└ uid | string | 可选 | Agent UID,用作 [发起对话](/zh-CN/docs/ai/chat/conversation) 的路径参数 |
└ name | string | 可选 | Agent 名称,按 `Accept-Language` 请求头本地化 |
└ description | string | 可选 | Agent 描述,按 `Accept-Language` 请求头本地化 |
└ mode | string | 可选 | Agent 模式,如 `chat` |
└ icon | string | 可选 | 图标 URL |
└ is_published | boolean | 可选 | 本接口下恒为 `true` |
└ published_at | integer | 可选 | 发布时间,Unix 秒级时间戳 |
└ created_at | integer | 可选 | 创建时间,Unix 秒级时间戳 |
└ updated_at | integer | 可选 | 最后更新时间,Unix 秒级时间戳 |
total | integer | 可选 | 符合条件的公开 Agent 总数 |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"agents": [
{
"uid": "ag_7d3f9b2c",
"name": "US Stock Analyst",
"description": "Answers US stock questions with market and fundamental data",
"mode": "chat",
"icon": "https://cdn.longbridge.com/icons/agent.png",
"is_published": true,
"published_at": 1742000000,
"created_at": 1741000000,
"updated_at": 1742001000
}
],
"total": 35
}
}错误码
参见错误码文档。