GET
/api/v1/agentstudio/agents/{agent_id}/versions
cURL
复制
curl --request GET \
--url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/agents/{agent_id}/versions' \
--header 'Authorization: Bearer <YOUR_API_KEY>'复制
{
"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"
}鉴权
string
header
必填
DashScope API Key
路径参数
string
必填
响应
200-application/json
object[]
Agent 对象数组,每项为一个历史版本快照,按版本号倒序排列
显示子属性
显示子属性
string
智能体 ID(所有版本相同)
string
固定为 agent
integer
该版本号;按版本号倒序返回
string
该版本快照中的名称
string
该版本快照中的用途说明
string
该版本快照中的系统提示词
object[]
该版本快照中的工具包列表
显示子属性
显示子属性
enum<string>
工具包类型
可选值:builtin_toolkit,mcp_toolkit
object
object[]
string
mcp_toolkit 类型对应的 MCP Server 名称
object[]
object
多智能体协作配置。不传或为空表示单智能体
object
该版本快照中的业务元数据
string | null
归档时间,未归档时为 null
string
该版本的创建时间,ISO 8601
string
该版本的更新时间,ISO 8601
string
所属业务空间 ID
string | null
下一页游标,无更多数据时为 null
string
本次请求的唯一标识