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-HK/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
  }
}

錯誤碼

參見錯誤碼文檔。