列出 Agent 版本 - 阿里云百炼

前提

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

GET /agents/{agent_id}/versions

参数	必填	类型	说明
`limit`	否	int	单页条数，默认 20，最大 100
`page`	否	string	分页游标。首次不传，后续传上一次响应的 `next_page` 翻下一页

curl "$AGENTSTUDIO_URL/agents/agent_xxx/versions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应包含 data（Agent 对象数组，每项为一个历史版本快照，按版本号倒序排列）、next_page（下一页游标，无更多数据时为 null）与 request_id。每个 Agent 对象的字段同创建 Agent响应，字段说明如下：

字段	类型	说明
`id`	string	智能体 ID（所有版本相同）
`type`	string	固定为 `agent`
`version`	int	该版本号；按版本号倒序返回
`name` / `description` / `system`	string	该版本快照中的名称、用途说明、系统提示词
`model` / `tools` / `mcp_servers` / `skills` / `metadata`	object / array	该版本快照中的模型、工具包、MCP 引用、技能、业务元数据
`archived_at`	string \| null	归档时间，未归档时为 `null`
`created_at` / `updated_at`	string	该版本的创建/更新时间
`workspace_id`	string	所属工作空间 ID