AI Agent

公开 Agent

GEThttps://openapi.longbridge.com/v1/ai/agents

鉴权

签名方式:每个请求用 App Key / Secret 签名。请求头如下:

名称类型必填说明
Authorizationstring · header必填OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填请求时间戳,单位秒(Unix 时间)。
X-Api-Signaturestring · header必填HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。

列出平台上所有公开可用的 Agent——与探索页展示的是同一份目录。返回的 uid 即发起对话接口路径中使用的 Agent 标识。

与 Workspace 下的 Agent 不同,本接口不限定 Workspace:返回所有已发布且公开分享的 Agent。

请求

查询参数

名称类型必填说明
pageinteger可选页码,从 1 开始,默认 1
limitinteger可选每页条数,默认 20,最大 50

响应

响应字段

名称类型必填说明
agentsobject[]可选Agent 列表,按最后更新时间倒序
└ uidstring可选Agent UID,用作 [发起对话](/zh-CN/docs/ai/chat/conversation) 的路径参数
└ namestring可选Agent 名称,按 `Accept-Language` 请求头本地化
└ descriptionstring可选Agent 描述,按 `Accept-Language` 请求头本地化
└ modestring可选Agent 模式,如 `chat`
└ iconstring可选图标 URL
└ is_publishedboolean可选本接口下恒为 `true`
└ published_atinteger可选发布时间,Unix 秒级时间戳
└ created_atinteger可选创建时间,Unix 秒级时间戳
└ updated_atinteger可选最后更新时间,Unix 秒级时间戳
totalinteger可选符合条件的公开 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
  }
}

错误码

参见错误码文档。