You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
Agents
查询智能体版本列表
复制全文
下载 pdf
查询智能体版本列表
GET https://ark.cn-beijing.volces.com/api/v3/agents/{agent_id}/versions​
分页查询指定智能体的历史版本,结果按版本号从大到小排列。本接口仅用于查询;如需恢复某个历史配置,请读取该版本并调用更新智能体接口。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Path 参数​
agent_id string 必选 | 智能体 ID​
​
​
Query 参数​
在 URL Query String 中传入。​
limit integer 默认值 20 | 每页数量​
​
page string | 下一页标识​
​
​
响应参数​
data object[] | 版本列表​
​
next_page string | 下一页标识​
​
​

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/agents/<AGENT_ID>/versions?limit=20" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
  "data": [
    {
      "id": "<AGENT_ID>",
      "type": "agent",
      "name": "<AGENT_NAME>",
      "model": {
        "id": "doubao-seed-2-1-pro-260915"
      },
      "system": "你是一个乐于助人的智能助手。",
      "version": 2,
      "created_at": "2026-07-15T09:00:00Z",
      "updated_at": "2026-07-15T09:00:00Z"
    },
    {
      "id": "<AGENT_ID>",
      "type": "agent",
      "name": "<AGENT_NAME>",
      "model": {
        "id": "doubao-seed-2-1-pro-260915"
      },
      "version": 1,
      "created_at": "2026-07-15T08:00:00Z",
      "updated_at": "2026-07-15T08:00:00Z"
    }
  ]
}
最近更新时间:2026.10.30 21:22:47
这个页面对您有帮助吗?
有用
有用
无用
无用