Workspace 下的 Agent

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

SDK Links

Python	longbridge.openapi.AgentContext.agents
Rust	longbridge::agent::AgentContext#agents
Go	AgentContext.Agents
Node.js	AgentContext#agents
Java	AgentContext.getAgents
C++	longbridge::agent::AgentContext::agents

Request

HTTP Method	GET
HTTP URL	/v1/ai/workspaces/:id/agents

Path Parameters

Name	Type	Required	Description
id	string	YES	Workspace ID

Query Parameters

Name	Type	Required	Description
page	int32	NO	页码，从 1 开始，默认 1
limit	int32	NO	每页数量，默认 20
name	string	NO	按 Agent 名称模糊搜索

Request Example

curl "https://openapi.longbridge.com/v1/ai/workspaces/1001/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": 12
  }
}

Response Status

Status	Description	Schema
200	返回成功	agents_response
400	参数非法	Workspace 不存在或无权访问
500	内部错误	None

Schemas

agents_response

Name	Type	Required	Description
agents	object[]	true	Agent 列表
∟ uid	string	true	Agent UID，用于 发起对话 的路径参数
∟ name	string	true	Agent 名称
∟ description	string	false	Agent 描述
∟ mode	string	true	Agent 模式，如 chat
∟ icon	string	false	图标 URL
∟ is_published	boolean	true	是否已发布，仅已发布的 Agent 可发起对话
∟ published_at	int64	false	发布时间，Unix 时间戳（秒），未发布为 0
∟ created_at	int64	false	创建时间，Unix 时间戳（秒）
∟ updated_at	int64	false	最后更新时间，Unix 时间戳（秒）
total	int32	true	符合条件的 Agent 总数