公開 Agent

列出平台上所有公開可用的 Agent——與探索頁展示的是同一份目錄。返回的 uid 即發起對話接口路徑中使用的 Agent 標識。

與 Workspace 下的 Agent 不同，本接口不限定 Workspace：返回所有已發佈且公開分享的 Agent。

Request

HTTP Method	GET
HTTP URL	/v1/ai/agents

Query Parameters

Name	Type	Required	Description
page	int32	NO	頁碼，從 1 開始，默認 1
limit	int32	NO	每頁條數，默認 20，最大 50
name	string	NO	按 Agent 名稱模糊搜索

Request Example

curl "https://openapi.longbridge.com/v1/ai/agents?page=1&limit=20" \
  -H "Authorization: Bearer <token>" \
  -H "Accept: application/json"

Response

Response Headers

• Content-Type: application/json

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "agents": [
      {
        "uid": "ag_7d3f9b2c",
        "name": "美股分析師",
        "description": "結合行情與基本面數據回答美股問題",
        "mode": "chat",
        "icon": "https://cdn.longbridge.com/icons/agent.png",
        "is_published": true,
        "published_at": 1742000000,
        "created_at": 1741000000,
        "updated_at": 1742001000
      }
    ],
    "total": 35
  }
}

Response Status

Status	Description	Schema
200	返回成功	public_agents_response
500	內部錯誤	None

Schemas

public_agents_response

Name	Type	Required	Description
agents	object[]	true	Agent 列表，按最後更新時間倒序
∟ uid	string	true	Agent UID，用作發起對話的路徑參數
∟ name	string	true	Agent 名稱，按 Accept-Language 請求頭本地化
∟ description	string	false	Agent 描述，按 Accept-Language 請求頭本地化
∟ mode	string	true	Agent 模式，如 chat
∟ icon	string	false	圖標 URL
∟ is_published	boolean	true	本接口下恆為 true
∟ published_at	int64	false	發佈時間，Unix 秒級時間戳
∟ created_at	int64	false	創建時間，Unix 秒級時間戳
∟ updated_at	int64	false	最後更新時間，Unix 秒級時間戳
total	int32	true	符合條件的公開 Agent 總數