Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
根据智能体 ID 返回完整配置。默认返回最新版本，可通过 version 参数指定历史版本。
/agents/{agent_id}
参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 否 | 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-max"},
"system": "你是数据分析专家，使用 pandas 处理 CSV 文件。",
"tools": [],
"mcp_servers": [],
"skills": [],
"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"
}
字段 | 类型 | 说明 |
|---|---|---|
| string | 智能体 ID，格式 |
| string | 固定为 |
| int | 当前版本号，每次更新自动递增；会话创建时锁定该值 |
| string | 智能体名称、用途说明、系统提示词 |
| object / array | 模型、工具包、MCP 引用、技能、业务元数据，结构同创建时 |
| string | null | 归档时间，未归档时为 |
| string | 创建/最近更新时间，ISO 8601 |
| string | 所属工作空间 ID |
| string | 本次请求的唯一标识 |