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

錯誤碼

參見錯誤碼文檔。