---
title: "发送事件"
method: POST
path: "/agent/managed/v1/sessions/{sessionId}/events"
tags: ["Managed Agents - Session"]
---

# 发送事件

`POST /agent/managed/v1/sessions/{sessionId}/events`

## Request

- Base URL: `https://agent-api.bigmodel.cn/api`
- URL: `https://agent-api.bigmodel.cn/api/agent/managed/v1/sessions/{sessionId}/events`
- Auth: HTTP bearer

向指定 Session 追加事件并触发后续处理。一次可发送 1 至 10 个受支持事件；已归档 Session 不接受新事件。

## Path parameters

- `sessionId` string, required

## Headers

- `zai-version` '2026-05-26', required
- `zai-beta` string, required

## Request body

- ManagedSendEventsRequest
  - `events` ManagedEventInput[], required: 一次提交 1–10 个事件，按数组顺序处理。
    - union
      - object
        - `type` 'user.message', required: 固定为 user.message。
        - `content` ManagedContentBlock[], required: 非空内容块数组，允许 text、image 或 document；图片最多 50 张，总量受请求体限制。
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - object: 请求停止当前工作。平台会主动停止当前模型响应和运行中的命令；请求入队后接口立即返回，会话完成收尾后以 session.status_idle(end_turn) 结束本轮。
        - `type` 'user.interrupt', required
        - `session_thread_id` string: 可选，只打断该线程；省略打断全部活跃线程。
      - object
        - `type` 'user.tool_confirmation', required
        - `tool_use_id` string, required
        - `result` 'allow' | 'deny', required
        - `deny_message` string, nullable: 仅 result=deny 时可提供拒绝原因。
      - object
        - `type` 'user.custom_tool_result', required
        - `custom_tool_use_id` string, required
        - `content` ManagedContentBlock[]
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `is_error` boolean, nullable

## Response `200`

请求成功。

- ManagedSendEventsResponse
  - `data` ManagedPersistedEvent[], required
    - `id` string, required
    - `type` 'agent.custom_tool_use' | 'agent.mcp_tool_result' | 'agent.mcp_tool_use' | 'agent.message' | 'agent.thinking' | 'agent.thread_context_compacted' | 'agent.thread_message_received' | 'agent.thread_message_sent' | 'agent.tool_result' | 'agent.tool_use' | 'session.deleted' | 'session.error' | 'session.status_idle' | 'session.status_rescheduled' | 'session.status_running' | 'session.status_terminated' | 'session.thread_created' | 'session.thread_status_idle' | 'session.thread_status_rescheduled' | 'session.thread_status_running' | 'session.thread_status_terminated' | 'session.updated' | 'session.usage' | 'span.model_request_end' | 'span.model_request_start' | 'span.outcome_evaluation_end' | 'span.outcome_evaluation_ongoing' | 'span.outcome_evaluation_start' | 'system.message' | 'user.custom_tool_result' | 'user.define_outcome' | 'user.interrupt' | 'user.message' | 'user.tool_confirmation' | 'user.tool_result', required
    - `processed_at` string, date-time, nullable: 事件被平台处理时写入，不保证唯一。排队中的 user.message / user.interrupt 在历史接口中可能省略或为 null；公共 SSE 会在平台接手后携带 processed_at 推送。
    - `session_thread_id` string: Session 面子线程 cross-post 的来源归属；Thread ID，不是第三类资源。
    - `from_session_thread_id` string
    - `from_agent_name` string
    - `to_session_thread_id` string
    - `to_agent_name` string
    - `stop_details` null, nullable
    - `workflow_run_id` string, nullable
    - `content` object[]: 消息/Thinking 内容或工具结果块。Search 使用 search_result，Fetch 使用 document；agent.thinking 的 content 仅新协议下输出。
    - `usage` object
      - `input_tokens` integer, required
      - `output_tokens` integer, required
      - `cache_read_input_tokens` integer, required
      - `server_tool_use` object
        - `web_search_requests` integer, required
        - `web_fetch_requests` 0, required

## Other responses

- `default`: 请求失败。

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/agent/managed/v1/sessions/:sessionId/events/post.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)