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-HK/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
}
}錯誤碼
參見錯誤碼文檔。