GET
/api/v1/agentstudio/agents/{agent_id}/versions
cURL
Copy
curl --request GET \
--url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/agents/{agent_id}/versions' \
--header 'Authorization: Bearer <YOUR_API_KEY>'Copy
{
"data": [
{
"id": "agent_xxx",
"type": "agent",
"version": 2,
"name": "data-analyst",
"description": "数据分析助手",
"model": {
"id": "qwen3-max"
},
"system": "你是资深数据分析师,输出结论时附带置信度。",
"tools": [],
"mcp_servers": [],
"skills": [],
"multiagent": {
"type": "coordinator",
"agents": [
{
"type": "self"
},
{
"type": "agent",
"id": "agent_researcher",
"version": 3
}
]
},
"metadata": {
"team": "data"
},
"created_at": "2026-05-28T17:10:02.789+08:00",
"updated_at": "2026-05-28T17:10:02.789+08:00",
"archived_at": null,
"workspace_id": "ws_xxx"
},
{
"id": "agent_xxx",
"type": "agent",
"version": 1,
"name": "data-analyst",
"description": "数据分析助手",
"model": {
"id": "qwen3-max"
},
"system": "你是数据分析专家,使用 pandas 处理 CSV 文件。",
"tools": [],
"mcp_servers": [],
"skills": [],
"multiagent": {
"type": "coordinator",
"agents": [
{
"type": "self"
}
]
},
"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"
}
],
"next_page": null,
"request_id": "req_xxx"
}Authorizations
string
header
required
DashScope API Key
Path Parameters
string
required
Response
200-application/json
object[]
Agent 对象数组,每项为一个历史版本快照,按版本号倒序排列
Show child attributes
Show child attributes
string
智能体 ID(所有版本相同)
string
固定为 agent
integer
该版本号;按版本号倒序返回
string
该版本快照中的名称
string
该版本快照中的用途说明
object
string
该版本快照中的系统提示词
object[]
该版本快照中的工具包列表
Show child attributes
Show child attributes
enum<string>
工具包类型
Available options:builtin_toolkit,mcp_toolkit
object
object[]
当前工具包中单个工具的启用和审批策略配置;逐工具配置覆盖 default_config
Show child attributes
Show child attributes
string
mcp_toolkit 类型对应的 MCP Server 名称
object[]
object[]
object
多智能体协作配置。不传或为空表示单智能体
Show child attributes
Show child attributes
enum<string>
协作拓扑类型,当前仅支持 coordinator
Available options:coordinator
object
该版本快照中的业务元数据
string | null
归档时间,未归档时为 null
string
该版本的创建时间,ISO 8601
string
该版本的更新时间,ISO 8601
string
所属工作空间 ID
string | null
下一页游标,无更多数据时为 null
string
本次请求的唯一标识