跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/agents/{agent_id}/versions 获取指定 Agent 的版本历史记录，按版本号降序排列（最新版本在前）。

​
请求头

头部必选说明
Authorization是Bearer <PAT>

​
路径参数

参数类型必选说明
agent_idstring是Agent 唯一标识

​
查询参数

参数类型必选默认值说明
limitinteger否20每页返回数量
orderstring否desc排序方向，"asc" 或 "desc"
after_idstring否-游标分页，返回此版本之后的记录
before_idstring否-游标分页，返回此版本之前的记录
完整分页规范详见 分页。

​
示例请求

curl -X GET "https://openapi.qoder.sh/api/v1/cloud/agents/agent_019eXXXX.../versions" \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 
{
  "data": [
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent-updated",
      "description": "用于 API 文档测试",
      "model": "ultimate",
      "system": "你是更新后的文档测试助手",
      "instructions": "你是更新后的文档测试助手",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 2,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:27:07.967138Z"
    },
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent",
      "description": "",
      "model": "ultimate",
      "system": "你是文档测试助手",
      "instructions": "你是文档测试助手",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 1,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    }
  ],
  "first_id": "2",
  "last_id": "1",
  "has_more": false
}

​
响应字段

字段类型说明
dataarrayAgent 版本快照数组，每个元素是该版本时刻的完整 Agent 对象
first_idstring当前页第一条记录的版本标识
last_idstring当前页最后一条记录的版本标识
has_moreboolean是否还有更多版本记录

​
版本历史说明

  • 每次通过 PUT 更新 Agent 都会创建一个新版本
  • 版本号从 1 开始递增
  • 每个版本保存当时的完整 Agent 快照
  • 可用于审计变更历史或回滚参考

​
错误码

HTTPtype触发条件
401authentication_errorPAT 无效或过期
403permission_error无权限访问此 Agent
404not_found_error指定 ID 的 Agent 不存在

​
注意事项

  • first_id 和 last_id 在此端点中对应版本号的字符串形式（如 "1"、"2"）
  • 默认按版本号降序，最新版本在前
  • 可配合 PUT 操作的 OCC 机制使用，追踪配置变更历史