获取 Agent

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /agents/{agent_id}

Query 参数

参数	必填	类型	说明
`version`	否	int	指定要查询的版本号；不传则返回最新版本

请求示例

# 默认返回最新版本
curl "$AGENTSTUDIO_URL/agents/agent_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

# 指定版本
curl "$AGENTSTUDIO_URL/agents/agent_xxx?version=3" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例

{
  "id": "agent_xxx",
  "type": "agent",
  "version": 1,
  "name": "data-analyst",
  "description": "数据分析助手",
  "model": {"id": "qwen3.7-max"},
  "system": "你是数据分析专家，使用 pandas 处理 CSV 文件。",
  "tools": [],
  "mcp_servers": [],
  "skills": [],
  "multiagent": {
    "type": "coordinator",
    "agents": [
      {"type": "self"},
      {"type": "agent", "id": "agent_researcher", "version": 3}
    ]
  },
  "metadata": {"team": "data"},
  "created_at": "2026-05-28T16:23:11.456+08:00",
  "updated_at": "2026-05-28T16:23:11.456+08:00",
  "archived_at": null,
  "workspace_id": "ws_xxx",
  "request_id": "req_xxx"
}

响应字段

字段	类型	说明
`id`	string	智能体 ID，格式 `agent_<ULID>`
`type`	string	固定为 `agent`
`version`	int	当前版本号，每次更新自动递增；会话创建时锁定该值
`name` / `description` / `system`	string	智能体名称、用途说明、系统提示词
`model` / `tools` / `mcp_servers` / `skills` / `multiagent` / `metadata`	object / array	模型、工具包、MCP 引用、技能、多智能体协作配置、业务元数据，结构同创建时
`archived_at`	string / null	归档时间，未归档时为 `null`
`created_at` / `updated_at`	string	创建 / 最近更新时间，ISO 8601
`workspace_id`	string	所属工作空间 ID
`request_id`	string	本次请求的唯一标识

​前提

​接口

​Query 参数

​请求示例

​响应示例

​响应字段

前提

接口

Query 参数

请求示例

响应示例

响应字段