BIbigmodel
Managed Agents - Agent

列出 Agent 版本

Changed on

分页列出指定 Agent 的历史版本。每条记录都是该版本的完整 Agent 配置快照，而不是仅包含版本号的摘要。

get/agent/managed/v1/agents/{agentId}/versions

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Path parameters

agentIdstring required

agentId 资源标识。

Query parameters

limitinteger

每页数量；大于 100 时服务端截断为 100。

order'asc' | 'desc'

排序方向。

pagestring

上一页返回的 opaque cursor。

Headers

zai-version'2026-05-26' required
Example:2026-05-26

Managed Agents API 入口要求的基础协议标识，当前只接受 2026-05-26；响应兼容形态由 zai-beta 选择。两个头均需携带。

zai-betastring required
Example:managed-agents-2026-09-22

声明 Managed Agents Beta 协议并选择响应字段与兼容行为。新接入使用 managed-agents-2026-09-22；旧客户端仍可使用 managed-agents-2026-05-26。必须同时携带 zai-version: 2026-05-26。字段差异见 /cn/managed-agents/protocol-versions。

Response

请求成功。

next_pagestring nullable required

Example response

{
  "data": [
    {
      "id": "agent_01911111-1111-7111-8111-111111111111",
      "type": "agent",
      "name": "support-agent",
      "description": null,
      "model": {
        "id": "glm-5.3",
        "effort": {
          "type": "max"
        },
        "speed": "standard"
      },
      "system": null,
      "tools": [
        {
          "type": "agent_toolset_20260601",
          "default_config": {
            "enabled": true,
            "permission_policy": {
              "type": "always_allow"
            }
          },
          "configs": []
        }
      ],
      "skills": [],
      "mcp_servers": [],
      "metadata": {},
      "multiagent": null,
      "version": 1,
      "created_at": "2026-08-31T08:00:00.000Z",
      "updated_at": "2026-08-31T08:00:00.000Z",
      "archived_at": null
    }
  ]
}

Changes