Thread

获取会话线程

Changed on

获取指定会话线程的状态、Agent 与用量信息。

get/agent/managed/v1/sessions/{sessionId}/threads/{threadId}

Request

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

Path parameters

sessionIdstring required
threadIdstring required

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

成功

idstring required
type'session_thread' required
session_idstring required
parent_thread_idstring nullable required
status'running' | 'idle' | 'rescheduling' | 'terminated' required
created_atstring date-time required
updated_atstring date-time required
archived_atstring date-time nullable required
workflow_run_idstring nullable

新协议恒 null;旧协议省略,当前无 Workflow Run。

Example response

{
  "agent": {
    "model": {
      "id": "glm-5.3",
      "speed": "standard"
    },
    "skills": [
      {
        "version": "latest"
      }
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "knowledge-base",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}

Changes