Managed Agents - Session

订阅实时事件

Changed on

通过 Server-Sent Events 订阅指定 Session 的实时事件。该流只推送连接后的新事件;重连时应先调用事件列表接口补齐历史并按事件 ID 去重。

get/agent/managed/v1/sessions/{sessionId}/events/stream

Request

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

Path parameters

sessionIdstring required

sessionId 资源标识。

Query parameters

beta'true'

提供时必须为 true。

event_deltas[]string[]

订阅的 delta 类型;可重复传入,两个写法合计最多 100 项。

event_deltasstring[]

event_deltas[] 的兼容写法;两个写法合计最多 100 项。

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

实时 Session 事件流。

Changes