AI Agent

Workspace 下的 Agent

GEThttps://openapi.longbridge.com/v1/ai/workspaces/{workspace_id}/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=。

获取指定 Workspace 下的 Agent 列表。返回的 uid 即 发起对话 接口路径中的 Agent 标识;只有 is_published 为 true 的 Agent 才能发起对话。

请求

路径参数

名称类型必填说明
workspace_idstring必填工作区 ID

查询参数

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

响应

响应字段

名称类型必填说明
agentsobject[]必填Agent 列表
└ uidstring必填Agent UID,用于 [发起对话](/zh-CN/docs/ai/chat/conversation) 的路径参数
└ namestring必填Agent 名称
└ descriptionstring可选Agent 描述
└ modestring必填Agent 模式,如 `chat`
└ iconstring可选图标 URL
└ is_publishedboolean必填是否已发布,仅已发布的 Agent 可发起对话
└ published_atint64可选发布时间,Unix 时间戳(秒),未发布为 0
└ created_atint64可选创建时间,Unix 时间戳(秒)
└ updated_atint64可选最后更新时间,Unix 时间戳(秒)
totalint32必填符合条件的 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": 12
  }
}

错误码

参见错误码文档。