事件

列出事件

get /v1/sessions/{session_id}/events

列出事件

路径参数

• session_id: string

查询参数

• "created_at[gt]": optional string

  返回在此时间之后创建的事件（不包含）。

• "created_at[gte]": optional string

  返回在此时间或之后创建的事件（包含）。

• "created_at[lt]": optional string

  返回在此时间之前创建的事件（不包含）。

• "created_at[lte]": optional string

  返回在此时间或之前创建的事件（包含）。

• limit: optional number

  limit 的查询参数

• order: optional "asc" or "desc"

  结果的排序方向，按 created_at 排序。默认为 asc（按时间顺序）。

  • "asc"

  • "desc"

• page: optional string

  来自先前响应 next_page 的不透明分页游标。

• types: optional array of string

  按事件类型过滤。值与返回事件的 type 字段匹配（例如 user.message 或 agent.tool_use）。省略以返回所有事件类型。

请求头参数

• "anthropic-beta": optional array of AnthropicBeta

  可选的请求头，用于指定要使用的 beta 版本。

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

返回值

• data: optional array of BetaManagedAgentsSessionEvent

  会话的事件，按 created_at 排序。

  • BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }

    会话对话中的用户消息事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      构成用户消息的内容块数组。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

        • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

          图像源变体的联合类型。

          • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

            Base64 编码的图像数据。

            • data: string

              Base64 编码的图像数据。

            • media_type: string

              图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsURLImageSource object { type, url }

            通过 URL 引用的图像。

            • type: "url"

              • "url"

            • url: string

              要获取的图像的 URL。

          • BetaManagedAgentsFileImageSource object { file_id, type }

            通过文件 ID 引用的图像。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "image"

          • "image"

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

          文档源变体的联合类型。

          • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

            Base64 编码的文档数据。

            • data: string

              Base64 编码的文档数据。

            • media_type: string

              文档的 MIME 类型（例如 "application/pdf"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

            纯文本文档内容。

            • data: string

              纯文本内容。

            • media_type: "text/plain"

              文本内容的 MIME 类型。必须为 "text/plain"。

              • "text/plain"

            • type: "text"

              • "text"

          • BetaManagedAgentsURLDocumentSource object { type, url }

            通过 URL 引用的文档。

            • type: "url"

              • "url"

            • url: string

              要获取的文档的 URL。

          • BetaManagedAgentsFileDocumentSource object { file_id, type }

            通过文件 ID 引用的文档。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "document"

          • "document"

        • context: optional string

          关于文档的附加上下文，供模型使用。

        • title: optional string

          文档的标题。

    • type: "user.message"

      • "user.message"

    • processed_at: optional string

      RFC 3339 格式的时间戳

  • BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }

    暂停代理执行并将控制权返回给用户的中断事件。

    • id: string

      此事件的唯一标识符。

    • type: "user.interrupt"

      • "user.interrupt"

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

  • BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }

    批准或拒绝待处理工具执行的工具确认事件。

    • id: string

      此事件的唯一标识符。

    • result: "allow" or "deny"

      UserToolConfirmationResult enum

      • "allow"

      • "deny"

    • tool_use_id: string

      此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_confirmation"

      • "user.tool_confirmation"

    • deny_message: optional string

      可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      设置后，确认将路由到此子代理的线程而非主线程。从触发批准的 agent.tool_use 或 agent.mcp_tool_use 事件的 session_thread_id 回显此值。

  • BetaManagedAgentsUserCustomToolResultEvent object { id, custom_tool_use_id, type, 4 more }

    客户端发送的事件，提供自定义工具执行的结果。

    • id: string

      此事件的唯一标识符。

    • custom_tool_use_id: string

      此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.custom_tool_result"

      • "user.custom_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

        • citations: BetaManagedAgentsSearchResultCitations

          搜索结果的引用设置。

          • enabled: boolean

            此搜索结果是否启用引用。

        • content: array of BetaManagedAgentsSearchResultContent

          搜索结果中的文本内容块数组。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • source: string

          The URL source of the search result.

        • title: string

          搜索结果的标题。

        • type: "search_result"

          • "search_result"

    • is_error: optional boolean

      工具执行是否导致错误。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      将此结果路由到子代理线程。从 agent.custom_tool_use 事件的 session_thread_id 复制。

  • BetaManagedAgentsAgentCustomToolUseEvent object { id, input, name, 3 more }

    代理调用自定义工具时发出的事件。会话进入空闲状态，直到客户端发送包含结果的 user.custom_tool_result 事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • name: string

      被调用的自定义工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.custom_tool_use"

      • "agent.custom_tool_use"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其自定义工具使用。线程自身的事件上为空。在 user.custom_tool_result 事件上回显此值以将结果路由回来。

  • BetaManagedAgentsAgentMessageEvent object { id, content, processed_at, type }

    会话对话中的代理响应事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock

      构成代理响应的文本块数组。

      • text: string

        文本内容。

      • type: "text"

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.message"

      • "agent.message"

  • BetaManagedAgentsAgentThinkingEvent object { id, processed_at, type }

    表示代理正在通过扩展思考取得进展。进度信号，而非内容载体。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thinking"

      • "agent.thinking"

  • BetaManagedAgentsAgentMCPToolUseEvent object { id, input, mcp_server_name, 5 more }

    代理调用 MCP 服务器提供的工具时发出的事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • mcp_server_name: string

      提供工具的 MCP 服务器名称。

    • name: string

      正在使用的 MCP 工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.mcp_tool_use"

      • "agent.mcp_tool_use"

    • evaluated_permission: optional "allow" or "ask" or "deny"

      AgentEvaluatedPermission enum

      • "allow"

      • "ask"

      • "deny"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

  • BetaManagedAgentsAgentMCPToolResultEvent object { id, mcp_tool_use_id, processed_at, 3 more }

    表示 MCP 工具执行结果的事件。

    • id: string

      此事件的唯一标识符。

    • mcp_tool_use_id: string

      此结果对应的 agent.mcp_tool_use 事件的 ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.mcp_tool_result"

      • "agent.mcp_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsAgentToolUseEvent object { id, input, name, 4 more }

    代理调用内置代理工具时发出的事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • name: string

      正在使用的代理工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.tool_use"

      • "agent.tool_use"

    • evaluated_permission: optional "allow" or "ask" or "deny"

      AgentEvaluatedPermission enum

      • "allow"

      • "ask"

      • "deny"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

  • BetaManagedAgentsAgentToolResultEvent object { id, processed_at, tool_use_id, 3 more }

    表示代理工具执行结果的事件。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID。

    • type: "agent.tool_result"

      • "agent.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsAgentThreadMessageReceivedEvent object { id, content, from_session_thread_id, 3 more }

    当代理间消息到达时写入目标线程输入流的传递事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      消息内容块。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

    • from_session_thread_id: string

      发送消息的线程的公共 sthr_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thread_message_received"

      • "agent.thread_message_received"

    • from_agent_name: optional string

      此消息来源的可调用代理名称。从主代理接收时为空。

  • BetaManagedAgentsAgentThreadMessageSentEvent object { id, content, processed_at, 3 more }

    发送代理间消息时发送到发送者输出流的可观测性事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      消息内容块。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

    • processed_at: string

      RFC 3339 格式的时间戳

    • to_session_thread_id: string

      消息发送到的线程的公共 sthr_ ID。

    • type: "agent.thread_message_sent"

      • "agent.thread_message_sent"

    • to_agent_name: optional string

      此消息发送到的可调用代理名称。发送到主代理时为空。

  • BetaManagedAgentsAgentThreadContextCompactedEvent object { id, processed_at, type }

    表示会话期间发生了上下文压缩（摘要）。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thread_context_compacted"

      • "agent.thread_context_compacted"

  • BetaManagedAgentsSessionErrorEvent object { id, error, processed_at, type }

    指示会话执行期间发生问题的错误事件。

    • id: string

      此事件的唯一标识符。

    • error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 4 more

      会话执行期间发生未知或意外错误。后备变体；无法识别新错误代码的客户端可以仅匹配 retry_status 和 message。

      • BetaManagedAgentsUnknownError object { message, retry_status, type }

        会话执行期间发生未知或意外错误。后备变体；无法识别新错误代码的客户端可以仅匹配 retry_status 和 message。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

            • type: "retrying"

              • "retrying"

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

            • type: "exhausted"

              • "exhausted"

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

            • type: "terminal"

              • "terminal"

        • type: "unknown_error"

          • "unknown_error"

      • BetaManagedAgentsModelOverloadedError object { message, retry_status, type }

        模型当前过载。在自动重试耗尽后发出。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_overloaded_error"

          • "model_overloaded_error"

      • BetaManagedAgentsModelRateLimitedError object { message, retry_status, type }

        模型请求被限速。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_rate_limited_error"

          • "model_rate_limited_error"

      • BetaManagedAgentsModelRequestFailedError object { message, retry_status, type }

        模型请求因过载或限速以外的原因失败。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_request_failed_error"

          • "model_request_failed_error"

      • BetaManagedAgentsMCPConnectionFailedError object { mcp_server_name, message, retry_status, type }

        连接 MCP 服务器失败。

        • mcp_server_name: string

          连接失败的 MCP 服务器名称。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "mcp_connection_failed_error"

          • "mcp_connection_failed_error"

      • BetaManagedAgentsMCPAuthenticationFailedError object { mcp_server_name, message, retry_status, type }

        MCP 服务器认证失败。

        • mcp_server_name: string

          认证失败的 MCP 服务器名称。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "mcp_authentication_failed_error"

          • "mcp_authentication_failed_error"

      • BetaManagedAgentsBillingError object { message, retry_status, type }

        调用者的组织或工作区无法发出模型请求 — 信用额度不足或达到支出限制。使用相同凭据重试不会成功；调用者必须解决计费状态。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "billing_error"

          • "billing_error"

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.error"

      • "session.error"

  • BetaManagedAgentsSessionStatusRescheduledEvent object { id, processed_at, type }

    表示会话正在从错误状态恢复，并已重新安排执行。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_rescheduled"

      • "session.status_rescheduled"

  • BetaManagedAgentsSessionStatusRunningEvent object { id, processed_at, type }

    表示会话正在积极运行，代理正在工作。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_running"

      • "session.status_running"

  • BetaManagedAgentsSessionStatusIdleEvent object { id, processed_at, stop_reason, type }

    表示代理已暂停，正在等待用户输入。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted

      代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionEndTurn object { type }

        代理自然完成了本轮，已准备好接收下一条用户消息。

        • type: "end_turn"

          • "end_turn"

      • BetaManagedAgentsSessionRequiresAction object { event_ids, type }

        代理正在空闲等待一个或多个阻塞的用户输入事件（工具确认、自定义工具结果等）。解决所有这些事件将使会话恢复运行。

        • event_ids: array of string

          代理被阻塞的事件 ID。解决少于全部事件将重新发出 session.status_idle，包含剩余事件。

        • type: "requires_action"

          • "requires_action"

      • BetaManagedAgentsSessionRetriesExhausted object { type }

        由于重试预算耗尽（达到 max_iterations 或错误升级为 retry_status: 'exhausted'），本轮结束。

        • type: "retries_exhausted"

          • "retries_exhausted"

    • type: "session.status_idle"

      • "session.status_idle"

  • BetaManagedAgentsSessionStatusTerminatedEvent object { id, processed_at, type }

    表示会话已终止，无论是由于错误还是完成。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_terminated"

      • "session.status_terminated"

  • BetaManagedAgentsSessionThreadCreatedEvent object { id, agent_name, processed_at, 2 more }

    当子代理作为新线程生成时发出。写入父线程的输出流，以便观察会话的客户端看到子线程创建。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的可调用代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      新创建线程的公共 sthr_ ID。

    • type: "session.thread_created"

      • "session.thread_created"

  • BetaManagedAgentsSpanOutcomeEvaluationStartEvent object { id, iteration, outcome_id, 2 more }

    当结果评估循环开始时发出。

    • id: string

      此事件的唯一标识符。

    • iteration: number

      从 0 开始的修订循环。0 是第一次评估；1 是第一次修订后的重新评估；依此类推。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.outcome_evaluation_start"

      • "span.outcome_evaluation_start"

  • BetaManagedAgentsSpanOutcomeEvaluationEndEvent object { id, explanation, iteration, 6 more }

    当结果评估循环完成时发出。携带判定和聚合 token 使用量。判定为 needs_revision 意味着将进行另一个评估循环；satisfied、max_iterations_reached、failed 或 interrupted 是终止状态 — 不会再进行更多评估循环。

    • id: string

      此事件的唯一标识符。

    • explanation: string

      判定的人类可读解释。对于 needs_revision，描述哪些标准失败以及原因。

    • iteration: number

      从 0 开始的修订循环，与相应的 span.outcome_evaluation_start 匹配。

    • outcome_evaluation_start_id: string

      相应的 span.outcome_evaluation_start 事件的 ID。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • result: string

      评估判定。'satisfied'：标准满足，会话进入空闲。'needs_revision'：标准未满足，将进行另一个修订循环。'max_iterations_reached'：评估预算耗尽但标准仍未满足 — 会话进入空闲前进行最后一轮确认，但不再进行评估。'failed'：评分器判定评分标准不适用于可交付成果。'interrupted'：评估进行中用户发送了中断。

    • type: "span.outcome_evaluation_end"

      • "span.outcome_evaluation_end"

    • usage: BetaManagedAgentsSpanModelUsage

      单个模型请求的 token 使用量。

      • cache_creation_input_tokens: number

        此请求中用于创建提示缓存的 token。

      • cache_read_input_tokens: number

        此请求中从提示缓存读取的 token。

      • input_tokens: number

        此请求消耗的输入 token。

      • output_tokens: number

        此请求生成的输出 token。

      • speed: optional "standard" or "fast"

        推理速度模式。fast 以更高的价格提供显著更快的输出 token 生成。并非所有模型都支持 fast；无效组合在创建时会被拒绝。

        • "standard"

        • "fast"

  • BetaManagedAgentsSpanModelRequestStartEvent object { id, processed_at, type }

    当代理发起模型请求时发出。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.model_request_start"

      • "span.model_request_start"

  • BetaManagedAgentsSpanModelRequestEndEvent object { id, is_error, model_request_start_id, 3 more }

    当模型请求完成时发出。

    • id: string

      此事件的唯一标识符。

    • is_error: boolean

      模型请求是否导致错误。

    • model_request_start_id: string

      相应的 span.model_request_start 事件的 ID。

    • model_usage: BetaManagedAgentsSpanModelUsage

      单个模型请求的 token 使用量。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.model_request_end"

      • "span.model_request_end"

  • BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent object { id, iteration, outcome_id, 2 more }

    结果评估循环进行期间发出的周期性心跳。在相应的 span.outcome_evaluation_start 和 span.outcome_evaluation_end 事件之间区分"评估正在积极运行"和"评估卡住"。

    • id: string

      此事件的唯一标识符。

    • iteration: number

      从 0 开始的修订循环，与相应的 span.outcome_evaluation_start 匹配。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.outcome_evaluation_ongoing"

      • "span.outcome_evaluation_ongoing"

  • BetaManagedAgentsUserDefineOutcomeEvent object { id, description, max_iterations, 4 more }

    user.define_outcome 输入事件的回显。携带后续 span.outcome_evaluation_* 事件引用的服务器生成的 outcome_id。

    • id: string

      此事件的唯一标识符。

    • description: string

      代理应产出的内容。从输入事件复制。

    • max_iterations: number

      放弃前的评估然后修订循环。默认 3，最大 20。

    • outcome_id: string

      此结果的服务器生成的 outc_ ID。由 span.outcome_evaluation_* 事件和会话的 outcome_evaluations 列表引用。

    • processed_at: string

      RFC 3339 格式的时间戳

    • rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric

      用于评估结果质量的评分标准。

      • BetaManagedAgentsFileRubric object { file_id, type }

        通过 Files API 上传的文件引用的评估标准。

        • file_id: string

          ID of the rubric file.

        • type: "file"

          • "file"

      • BetaManagedAgentsTextRubric object { content, type }

        以内联文本形式提供的评估标准内容。

        • content: string

          评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。

        • type: "text"

          • "text"

    • type: "user.define_outcome"

      • "user.define_outcome"

  • BetaManagedAgentsSessionDeletedEvent object { id, processed_at, type }

    当会话被删除时发出。终止所有活动事件流 — 不会再为此会话发出更多事件。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.deleted"

      • "session.deleted"

  • BetaManagedAgentsSessionThreadStatusRunningEvent object { id, agent_name, processed_at, 2 more }

    会话线程已开始执行。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      开始运行的线程的公共 sthr_ ID。

    • type: "session.thread_status_running"

      • "session.thread_status_running"

  • BetaManagedAgentsSessionThreadStatusIdleEvent object { id, agent_name, processed_at, 3 more }

    会话线程已让出并正在等待输入。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      进入空闲的线程的公共 sthr_ ID。

    • stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted

      代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionEndTurn object { type }

        代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionRequiresAction object { event_ids, type }

        代理正在空闲等待一个或多个阻塞的用户输入事件（工具确认、自定义工具结果等）。解决所有这些事件将使会话恢复运行。

      • BetaManagedAgentsSessionRetriesExhausted object { type }

        由于重试预算耗尽（达到 max_iterations 或错误升级为 retry_status: 'exhausted'），本轮结束。

    • type: "session.thread_status_idle"

      • "session.thread_status_idle"

  • BetaManagedAgentsSessionThreadStatusTerminatedEvent object { id, agent_name, processed_at, 2 more }

    会话线程已终止，不再接受输入。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      已终止线程的公共 sthr_ ID。

    • type: "session.thread_status_terminated"

      • "session.thread_status_terminated"

  • BetaManagedAgentsUserToolResultEvent object { id, tool_use_id, type, 4 more }

    客户端发送的事件，提供代理工具集工具执行的结果。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

    • id: string

      此事件的唯一标识符。

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_result"

      • "user.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      将此结果路由到子代理线程。从 agent.tool_use 事件的 session_thread_id 复制。

  • BetaManagedAgentsSessionThreadStatusRescheduledEvent object { id, agent_name, processed_at, 2 more }

    会话线程遇到瞬态错误，正在自动重试。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      正在重试的线程的公共 sthr_ ID。

    • type: "session.thread_status_rescheduled"

      • "session.thread_status_rescheduled"

  • BetaManagedAgentsSessionUpdatedEvent object { id, processed_at, type, 3 more }

    当 UpdateSession 请求更改了至少一个字段时发出。仅携带已更改的字段；缺失的字段不是更新的一部分。新配置从下一轮开始生效。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.updated"

      • "session.updated"

    • agent: optional BetaManagedAgentsSessionAgent

      已解析的 session 的 agent 定义。session 创建时 agent 的快照。

      • id: string

      • description: string

      • mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition

        • name: string

        • type: "url"

          • "url"

        • url: string

      • model: BetaManagedAgentsModelConfig

        模型标识符和配置。

        • id: BetaManagedAgentsModel

          驱动您的代理的模型。

          有关更多详细信息和选项，请参阅 models。

          • "claude-opus-4-7" or "claude-opus-4-6" or "claude-sonnet-4-6" or 6 more

            驱动您的代理的模型。

            有关更多详细信息和选项，请参阅 models。

            • "claude-opus-4-7"

              适用于长时间运行的代理和编码的前沿智能

            • "claude-opus-4-6"

              用于构建代理和编码的最智能模型

            • "claude-sonnet-4-6"

              速度和智能的最佳组合

            • "claude-haiku-4-5"

              具有接近前沿智能的最快模型

            • "claude-haiku-4-5-20251001"

              具有接近前沿智能的最快模型

            • "claude-opus-4-5"

              结合最大智能与实用性能的高级模型

            • "claude-opus-4-5-20251101"

              结合最大智能与实用性能的高级模型

            • "claude-sonnet-4-5"

              适用于代理和编码的高性能模型

            • "claude-sonnet-4-5-20250929"

              适用于代理和编码的高性能模型

          • string

        • speed: optional "standard" or "fast"

          推理速度模式。fast 以更高的价格提供显著更快的输出 token 生成。并非所有模型都支持 fast；无效组合在创建时会被拒绝。

          • "standard"

          • "fast"

      • multiagent: BetaManagedAgentsSessionMultiagentCoordinator

        已解析的协调器拓扑，包含每个成员的完整代理定义。

        • agents: array of BetaManagedAgentsSessionThreadAgent

          协调器可能作为会话线程生成的完整 agent 定义。

          • id: string

          • description: string

          • mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition

            • name: string

            • type: "url"

            • url: string

          • model: BetaManagedAgentsModelConfig

            模型标识符和配置。

          • name: string

          • skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill

            • BetaManagedAgentsAnthropicSkill object { skill_id, type, version }

              已解析的 Anthropic 管理的技能。

              • skill_id: string

              • type: "anthropic"

                • "anthropic"

              • version: string

            • BetaManagedAgentsCustomSkill object { skill_id, type, version }

              已解析的用户创建的自定义技能。

              • skill_id: string

              • type: "custom"

                • "custom"

              • version: string

          • system: string

          • tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool

            • BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }

              • configs: array of BetaManagedAgentsAgentToolConfig

                • enabled: boolean

                • name: "bash" or "edit" or "read" or 5 more

                  内置代理工具标识符。

                  • "bash"

                  • "edit"

                  • "read"

                  • "write"

                  • "glob"

                  • "grep"

                  • "web_fetch"

                  • "web_search"

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                    • type: "always_allow"

                      • "always_allow"

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

                    • type: "always_ask"

                      • "always_ask"

              • default_config: BetaManagedAgentsAgentToolsetDefaultConfig

                已解析的代理工具默认配置。

                • enabled: boolean

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • type: "agent_toolset_20260401"

                • "agent_toolset_20260401"

            • BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }

              • configs: array of BetaManagedAgentsMCPToolConfig

                • enabled: boolean

                • name: string

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • default_config: BetaManagedAgentsMCPToolsetDefaultConfig

                已解析的 MCP 服务器所有工具的默认配置。

                • enabled: boolean

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • mcp_server_name: string

              • type: "mcp_toolset"

                • "mcp_toolset"

            • BetaManagedAgentsCustomTool object { description, input_schema, name, type }

              API 响应中返回的自定义工具。

              • description: string

              • input_schema: BetaManagedAgentsCustomToolInputSchema

                自定义工具输入参数的 JSON Schema。

                • properties: optional map[unknown]

                  定义工具输入参数的 JSON Schema 属性。

                • required: optional array of string

                  必需属性名称列表。

                • type: optional "object"

                  工具输入模式必须为 'object'。

                  • "object"

              • name: string

              • type: "custom"

                • "custom"

          • type: "agent"

            • "agent"

          • version: number

        • type: "coordinator"

          • "coordinator"

      • name: string

      • skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill

        • BetaManagedAgentsAnthropicSkill object { skill_id, type, version }

          已解析的 Anthropic 管理的技能。

        • BetaManagedAgentsCustomSkill object { skill_id, type, version }

          已解析的用户创建的自定义技能。

      • system: string

      • tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool

        • BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }

        • BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }

        • BetaManagedAgentsCustomTool object { description, input_schema, name, type }

          API 响应中返回的自定义工具。

      • type: "agent"

        • "agent"

      • version: number

    • metadata: optional map[string]

      更新后会话的完整元数据包。当更新设置了非空元数据时存在；当元数据未更改或清除为空时缺失。

    • title: optional string

      会话的新标题。仅在更新更改了它时存在。

• next_page: optional string

  下一页的不透明游标。没有更多结果时为 null。

示例

curl https://api.anthropic.com/v1/sessions/$SESSION_ID/events \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

响应

{
  "data": [
    {
      "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
      "content": [
        {
          "text": "Where is my order #1234?",
          "type": "text"
        }
      ],
      "type": "user.message",
      "processed_at": "2026-03-15T10:00:00Z"
    },
    {
      "id": "sevt_011CZkZHPq1jCdq5lbRTjiVnz",
      "content": [
        {
          "text": "Let me look up order #1234 for you.",
          "type": "text"
        }
      ],
      "processed_at": "2026-03-15T10:00:00Z",
      "type": "agent.message"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

发送事件

post /v1/sessions/{session_id}/events

发送事件

路径参数

• session_id: string

请求头参数

• "anthropic-beta": optional array of AnthropicBeta

  可选的请求头，用于指定要使用的 beta 版本。

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

请求体参数

• events: array of BetaManagedAgentsEventParams

  要发送到 session 的事件。

  • BetaManagedAgentsUserMessageEventParams object { content, type }

    向会话发送用户消息的参数。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      用户消息的内容块数组。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

        • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

          图像源变体的联合类型。

          • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

            Base64 编码的图像数据。

            • data: string

              Base64 编码的图像数据。

            • media_type: string

              图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsURLImageSource object { type, url }

            通过 URL 引用的图像。

            • type: "url"

              • "url"

            • url: string

              要获取的图像的 URL。

          • BetaManagedAgentsFileImageSource object { file_id, type }

            通过文件 ID 引用的图像。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "image"

          • "image"

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

          文档源变体的联合类型。

          • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

            Base64 编码的文档数据。

            • data: string

              Base64 编码的文档数据。

            • media_type: string

              文档的 MIME 类型（例如 "application/pdf"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

            纯文本文档内容。

            • data: string

              纯文本内容。

            • media_type: "text/plain"

              文本内容的 MIME 类型。必须为 "text/plain"。

              • "text/plain"

            • type: "text"

              • "text"

          • BetaManagedAgentsURLDocumentSource object { type, url }

            通过 URL 引用的文档。

            • type: "url"

              • "url"

            • url: string

              要获取的文档的 URL。

          • BetaManagedAgentsFileDocumentSource object { file_id, type }

            通过文件 ID 引用的文档。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "document"

          • "document"

        • context: optional string

          关于文档的附加上下文，供模型使用。

        • title: optional string

          文档的标题。

    • type: "user.message"

      • "user.message"

  • BetaManagedAgentsUserInterruptEventParams object { type, session_thread_id }

    发送中断以暂停代理的参数。

    • type: "user.interrupt"

      • "user.interrupt"

    • session_thread_id: optional string

      如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

  • BetaManagedAgentsUserToolConfirmationEventParams object { result, tool_use_id, type, deny_message }

    确认或拒绝工具执行请求的参数。

    • result: "allow" or "deny"

      UserToolConfirmationResult enum

      • "allow"

      • "deny"

    • tool_use_id: string

      此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_confirmation"

      • "user.tool_confirmation"

    • deny_message: optional string

      可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

  • BetaManagedAgentsUserCustomToolResultEventParams object { custom_tool_use_id, type, content, is_error }

    提供自定义工具执行结果的参数。

    • custom_tool_use_id: string

      此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.custom_tool_result"

      • "user.custom_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

        • citations: BetaManagedAgentsSearchResultCitations

          搜索结果的引用设置。

          • enabled: boolean

            此搜索结果是否启用引用。

        • content: array of BetaManagedAgentsSearchResultContent

          搜索结果中的文本内容块数组。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • source: string

          The URL source of the search result.

        • title: string

          搜索结果的标题。

        • type: "search_result"

          • "search_result"

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsUserDefineOutcomeEventParams object { description, rubric, type, max_iterations }

    定义代理应努力实现的结果的参数。代理在收到后开始工作。

    • description: string

      代理应产出的内容。 This is the task specification.

    • rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams

      用于评估结果质量的评分标准。

      • BetaManagedAgentsFileRubricParams object { file_id, type }

        通过 Files API 上传的文件引用的评估标准。

        • file_id: string

          ID of the rubric file.

        • type: "file"

          • "file"

      • BetaManagedAgentsTextRubricParams object { content, type }

        以内联文本形式提供的评估标准内容。

        • content: string

          评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。 Maximum 262144 characters.

        • type: "text"

          • "text"

    • type: "user.define_outcome"

      • "user.define_outcome"

    • max_iterations: optional number

      Eval→revision cycles before giving up. Default 3, max 20.

  • BetaManagedAgentsUserToolResultEventParams object { tool_use_id, type, content, is_error }

    提供代理工具集工具执行结果的参数。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_result"

      • "user.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

返回值

• BetaManagedAgentsSendSessionEvents object { data }

  成功发送到会话的事件。

  • data: optional array of BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 3 more

    已发送的事件

    • BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }

      会话对话中的用户消息事件。

      • id: string

        此事件的唯一标识符。

      • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

        构成用户消息的内容块数组。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

          • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

            图像源变体的联合类型。

            • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

              Base64 编码的图像数据。

              • data: string

                Base64 编码的图像数据。

              • media_type: string

                图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

              • type: "base64"

                • "base64"

            • BetaManagedAgentsURLImageSource object { type, url }

              通过 URL 引用的图像。

              • type: "url"

                • "url"

              • url: string

                要获取的图像的 URL。

            • BetaManagedAgentsFileImageSource object { file_id, type }

              通过文件 ID 引用的图像。

              • file_id: string

                先前上传的文件的 ID。

              • type: "file"

                • "file"

          • type: "image"

            • "image"

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

          • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

            文档源变体的联合类型。

            • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

              Base64 编码的文档数据。

              • data: string

                Base64 编码的文档数据。

              • media_type: string

                文档的 MIME 类型（例如 "application/pdf"）。

              • type: "base64"

                • "base64"

            • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

              纯文本文档内容。

              • data: string

                纯文本内容。

              • media_type: "text/plain"

                文本内容的 MIME 类型。必须为 "text/plain"。

                • "text/plain"

              • type: "text"

                • "text"

            • BetaManagedAgentsURLDocumentSource object { type, url }

              通过 URL 引用的文档。

              • type: "url"

                • "url"

              • url: string

                要获取的文档的 URL。

            • BetaManagedAgentsFileDocumentSource object { file_id, type }

              通过文件 ID 引用的文档。

              • file_id: string

                先前上传的文件的 ID。

              • type: "file"

                • "file"

          • type: "document"

            • "document"

          • context: optional string

            关于文档的附加上下文，供模型使用。

          • title: optional string

            文档的标题。

      • type: "user.message"

        • "user.message"

      • processed_at: optional string

        RFC 3339 格式的时间戳

    • BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }

      暂停代理执行并将控制权返回给用户的中断事件。

      • id: string

        此事件的唯一标识符。

      • type: "user.interrupt"

        • "user.interrupt"

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

    • BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }

      批准或拒绝待处理工具执行的工具确认事件。

      • id: string

        此事件的唯一标识符。

      • result: "allow" or "deny"

        UserToolConfirmationResult enum

        • "allow"

        • "deny"

      • tool_use_id: string

        此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.tool_confirmation"

        • "user.tool_confirmation"

      • deny_message: optional string

        可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        设置后，确认将路由到此子代理的线程而非主线程。从触发批准的 agent.tool_use 或 agent.mcp_tool_use 事件的 session_thread_id 回显此值。

    • BetaManagedAgentsUserCustomToolResultEvent object { id, custom_tool_use_id, type, 4 more }

      客户端发送的事件，提供自定义工具执行的结果。

      • id: string

        此事件的唯一标识符。

      • custom_tool_use_id: string

        此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.custom_tool_result"

        • "user.custom_tool_result"

      • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

        工具返回的结果内容。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

          包含网络搜索结果的块。

          • citations: BetaManagedAgentsSearchResultCitations

            搜索结果的引用设置。

            • enabled: boolean

              此搜索结果是否启用引用。

          • content: array of BetaManagedAgentsSearchResultContent

            搜索结果中的文本内容块数组。

            • text: string

              文本内容。

            • type: "text"

              • "text"

          • source: string

            The URL source of the search result.

          • title: string

            搜索结果的标题。

          • type: "search_result"

            • "search_result"

      • is_error: optional boolean

        工具执行是否导致错误。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        将此结果路由到子代理线程。从 agent.custom_tool_use 事件的 session_thread_id 复制。

    • BetaManagedAgentsUserDefineOutcomeEvent object { id, description, max_iterations, 4 more }

      user.define_outcome 输入事件的回显。携带后续 span.outcome_evaluation_* 事件引用的服务器生成的 outcome_id。

      • id: string

        此事件的唯一标识符。

      • description: string

        代理应产出的内容。从输入事件复制。

      • max_iterations: number

        放弃前的评估然后修订循环。默认 3，最大 20。

      • outcome_id: string

        此结果的服务器生成的 outc_ ID。由 span.outcome_evaluation_* 事件和会话的 outcome_evaluations 列表引用。

      • processed_at: string

        RFC 3339 格式的时间戳

      • rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric

        用于评估结果质量的评分标准。

        • BetaManagedAgentsFileRubric object { file_id, type }

          通过 Files API 上传的文件引用的评估标准。

          • file_id: string

            ID of the rubric file.

          • type: "file"

            • "file"

        • BetaManagedAgentsTextRubric object { content, type }

          以内联文本形式提供的评估标准内容。

          • content: string

            评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。

          • type: "text"

            • "text"

      • type: "user.define_outcome"

        • "user.define_outcome"

    • BetaManagedAgentsUserToolResultEvent object { id, tool_use_id, type, 4 more }

      客户端发送的事件，提供代理工具集工具执行的结果。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

      • id: string

        此事件的唯一标识符。

      • tool_use_id: string

        此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.tool_result"

        • "user.tool_result"

      • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

        工具返回的结果内容。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

          包含网络搜索结果的块。

      • is_error: optional boolean

        工具执行是否导致错误。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        将此结果路由到子代理线程。从 agent.tool_use 事件的 session_thread_id 复制。

示例

curl https://api.anthropic.com/v1/sessions/$SESSION_ID/events \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "events": [
            {
              "content": [
                {
                  "text": "Where is my order #1234?",
                  "type": "text"
                }
              ],
              "type": "user.message"
            }
          ]
        }'

响应

{
  "data": [
    {
      "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
      "content": [
        {
          "text": "Where is my order #1234?",
          "type": "text"
        }
      ],
      "type": "user.message",
      "processed_at": "2026-03-15T10:00:00Z"
    }
  ]
}

流式事件

get /v1/sessions/{session_id}/events/stream

流式事件

路径参数

• session_id: string

请求头参数

• "anthropic-beta": optional array of AnthropicBeta

  可选的请求头，用于指定要使用的 beta 版本。

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

返回值

• BetaManagedAgentsStreamSessionEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 30 more

  会话流中的服务器发送事件。

  • BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }

    会话对话中的用户消息事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      构成用户消息的内容块数组。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

        • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

          图像源变体的联合类型。

          • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

            Base64 编码的图像数据。

            • data: string

              Base64 编码的图像数据。

            • media_type: string

              图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsURLImageSource object { type, url }

            通过 URL 引用的图像。

            • type: "url"

              • "url"

            • url: string

              要获取的图像的 URL。

          • BetaManagedAgentsFileImageSource object { file_id, type }

            通过文件 ID 引用的图像。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "image"

          • "image"

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

          文档源变体的联合类型。

          • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

            Base64 编码的文档数据。

            • data: string

              Base64 编码的文档数据。

            • media_type: string

              文档的 MIME 类型（例如 "application/pdf"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

            纯文本文档内容。

            • data: string

              纯文本内容。

            • media_type: "text/plain"

              文本内容的 MIME 类型。必须为 "text/plain"。

              • "text/plain"

            • type: "text"

              • "text"

          • BetaManagedAgentsURLDocumentSource object { type, url }

            通过 URL 引用的文档。

            • type: "url"

              • "url"

            • url: string

              要获取的文档的 URL。

          • BetaManagedAgentsFileDocumentSource object { file_id, type }

            通过文件 ID 引用的文档。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "document"

          • "document"

        • context: optional string

          关于文档的附加上下文，供模型使用。

        • title: optional string

          文档的标题。

    • type: "user.message"

      • "user.message"

    • processed_at: optional string

      RFC 3339 格式的时间戳

  • BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }

    暂停代理执行并将控制权返回给用户的中断事件。

    • id: string

      此事件的唯一标识符。

    • type: "user.interrupt"

      • "user.interrupt"

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

  • BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }

    批准或拒绝待处理工具执行的工具确认事件。

    • id: string

      此事件的唯一标识符。

    • result: "allow" or "deny"

      UserToolConfirmationResult enum

      • "allow"

      • "deny"

    • tool_use_id: string

      此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_confirmation"

      • "user.tool_confirmation"

    • deny_message: optional string

      可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      设置后，确认将路由到此子代理的线程而非主线程。从触发批准的 agent.tool_use 或 agent.mcp_tool_use 事件的 session_thread_id 回显此值。

  • BetaManagedAgentsUserCustomToolResultEvent object { id, custom_tool_use_id, type, 4 more }

    客户端发送的事件，提供自定义工具执行的结果。

    • id: string

      此事件的唯一标识符。

    • custom_tool_use_id: string

      此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.custom_tool_result"

      • "user.custom_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

        • citations: BetaManagedAgentsSearchResultCitations

          搜索结果的引用设置。

          • enabled: boolean

            此搜索结果是否启用引用。

        • content: array of BetaManagedAgentsSearchResultContent

          搜索结果中的文本内容块数组。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • source: string

          The URL source of the search result.

        • title: string

          搜索结果的标题。

        • type: "search_result"

          • "search_result"

    • is_error: optional boolean

      工具执行是否导致错误。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      将此结果路由到子代理线程。从 agent.custom_tool_use 事件的 session_thread_id 复制。

  • BetaManagedAgentsAgentCustomToolUseEvent object { id, input, name, 3 more }

    代理调用自定义工具时发出的事件。会话进入空闲状态，直到客户端发送包含结果的 user.custom_tool_result 事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • name: string

      被调用的自定义工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.custom_tool_use"

      • "agent.custom_tool_use"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其自定义工具使用。线程自身的事件上为空。在 user.custom_tool_result 事件上回显此值以将结果路由回来。

  • BetaManagedAgentsAgentMessageEvent object { id, content, processed_at, type }

    会话对话中的代理响应事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock

      构成代理响应的文本块数组。

      • text: string

        文本内容。

      • type: "text"

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.message"

      • "agent.message"

  • BetaManagedAgentsAgentThinkingEvent object { id, processed_at, type }

    表示代理正在通过扩展思考取得进展。进度信号，而非内容载体。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thinking"

      • "agent.thinking"

  • BetaManagedAgentsAgentMCPToolUseEvent object { id, input, mcp_server_name, 5 more }

    代理调用 MCP 服务器提供的工具时发出的事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • mcp_server_name: string

      提供工具的 MCP 服务器名称。

    • name: string

      正在使用的 MCP 工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.mcp_tool_use"

      • "agent.mcp_tool_use"

    • evaluated_permission: optional "allow" or "ask" or "deny"

      AgentEvaluatedPermission enum

      • "allow"

      • "ask"

      • "deny"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

  • BetaManagedAgentsAgentMCPToolResultEvent object { id, mcp_tool_use_id, processed_at, 3 more }

    表示 MCP 工具执行结果的事件。

    • id: string

      此事件的唯一标识符。

    • mcp_tool_use_id: string

      此结果对应的 agent.mcp_tool_use 事件的 ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.mcp_tool_result"

      • "agent.mcp_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsAgentToolUseEvent object { id, input, name, 4 more }

    代理调用内置代理工具时发出的事件。

    • id: string

      此事件的唯一标识符。

    • input: map[unknown]

      工具调用的输入参数。

    • name: string

      正在使用的代理工具名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.tool_use"

      • "agent.tool_use"

    • evaluated_permission: optional "allow" or "ask" or "deny"

      AgentEvaluatedPermission enum

      • "allow"

      • "ask"

      • "deny"

    • session_thread_id: optional string

      设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

  • BetaManagedAgentsAgentToolResultEvent object { id, processed_at, tool_use_id, 3 more }

    表示代理工具执行结果的事件。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID。

    • type: "agent.tool_result"

      • "agent.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsAgentThreadMessageReceivedEvent object { id, content, from_session_thread_id, 3 more }

    当代理间消息到达时写入目标线程输入流的传递事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      消息内容块。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

    • from_session_thread_id: string

      发送消息的线程的公共 sthr_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thread_message_received"

      • "agent.thread_message_received"

    • from_agent_name: optional string

      此消息来源的可调用代理名称。从主代理接收时为空。

  • BetaManagedAgentsAgentThreadMessageSentEvent object { id, content, processed_at, 3 more }

    发送代理间消息时发送到发送者输出流的可观测性事件。

    • id: string

      此事件的唯一标识符。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      消息内容块。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

    • processed_at: string

      RFC 3339 格式的时间戳

    • to_session_thread_id: string

      消息发送到的线程的公共 sthr_ ID。

    • type: "agent.thread_message_sent"

      • "agent.thread_message_sent"

    • to_agent_name: optional string

      此消息发送到的可调用代理名称。发送到主代理时为空。

  • BetaManagedAgentsAgentThreadContextCompactedEvent object { id, processed_at, type }

    表示会话期间发生了上下文压缩（摘要）。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "agent.thread_context_compacted"

      • "agent.thread_context_compacted"

  • BetaManagedAgentsSessionErrorEvent object { id, error, processed_at, type }

    指示会话执行期间发生问题的错误事件。

    • id: string

      此事件的唯一标识符。

    • error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 4 more

      会话执行期间发生未知或意外错误。后备变体；无法识别新错误代码的客户端可以仅匹配 retry_status 和 message。

      • BetaManagedAgentsUnknownError object { message, retry_status, type }

        会话执行期间发生未知或意外错误。后备变体；无法识别新错误代码的客户端可以仅匹配 retry_status 和 message。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

            • type: "retrying"

              • "retrying"

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

            • type: "exhausted"

              • "exhausted"

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

            • type: "terminal"

              • "terminal"

        • type: "unknown_error"

          • "unknown_error"

      • BetaManagedAgentsModelOverloadedError object { message, retry_status, type }

        模型当前过载。在自动重试耗尽后发出。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_overloaded_error"

          • "model_overloaded_error"

      • BetaManagedAgentsModelRateLimitedError object { message, retry_status, type }

        模型请求被限速。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_rate_limited_error"

          • "model_rate_limited_error"

      • BetaManagedAgentsModelRequestFailedError object { message, retry_status, type }

        模型请求因过载或限速以外的原因失败。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "model_request_failed_error"

          • "model_request_failed_error"

      • BetaManagedAgentsMCPConnectionFailedError object { mcp_server_name, message, retry_status, type }

        连接 MCP 服务器失败。

        • mcp_server_name: string

          连接失败的 MCP 服务器名称。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "mcp_connection_failed_error"

          • "mcp_connection_failed_error"

      • BetaManagedAgentsMCPAuthenticationFailedError object { mcp_server_name, message, retry_status, type }

        MCP 服务器认证失败。

        • mcp_server_name: string

          认证失败的 MCP 服务器名称。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "mcp_authentication_failed_error"

          • "mcp_authentication_failed_error"

      • BetaManagedAgentsBillingError object { message, retry_status, type }

        调用者的组织或工作区无法发出模型请求 — 信用额度不足或达到支出限制。使用相同凭据重试不会成功；调用者必须解决计费状态。

        • message: string

          人类可读的错误描述。

        • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

          客户端对此错误应采取的下一步操作。

          • BetaManagedAgentsRetryStatusRetrying object { type }

            服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

          • BetaManagedAgentsRetryStatusExhausted object { type }

            此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

          • BetaManagedAgentsRetryStatusTerminal object { type }

            会话遇到终端错误，将转换到 terminated 状态。

        • type: "billing_error"

          • "billing_error"

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.error"

      • "session.error"

  • BetaManagedAgentsSessionStatusRescheduledEvent object { id, processed_at, type }

    表示会话正在从错误状态恢复，并已重新安排执行。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_rescheduled"

      • "session.status_rescheduled"

  • BetaManagedAgentsSessionStatusRunningEvent object { id, processed_at, type }

    表示会话正在积极运行，代理正在工作。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_running"

      • "session.status_running"

  • BetaManagedAgentsSessionStatusIdleEvent object { id, processed_at, stop_reason, type }

    表示代理已暂停，正在等待用户输入。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted

      代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionEndTurn object { type }

        代理自然完成了本轮，已准备好接收下一条用户消息。

        • type: "end_turn"

          • "end_turn"

      • BetaManagedAgentsSessionRequiresAction object { event_ids, type }

        代理正在空闲等待一个或多个阻塞的用户输入事件（工具确认、自定义工具结果等）。解决所有这些事件将使会话恢复运行。

        • event_ids: array of string

          代理被阻塞的事件 ID。解决少于全部事件将重新发出 session.status_idle，包含剩余事件。

        • type: "requires_action"

          • "requires_action"

      • BetaManagedAgentsSessionRetriesExhausted object { type }

        由于重试预算耗尽（达到 max_iterations 或错误升级为 retry_status: 'exhausted'），本轮结束。

        • type: "retries_exhausted"

          • "retries_exhausted"

    • type: "session.status_idle"

      • "session.status_idle"

  • BetaManagedAgentsSessionStatusTerminatedEvent object { id, processed_at, type }

    表示会话已终止，无论是由于错误还是完成。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.status_terminated"

      • "session.status_terminated"

  • BetaManagedAgentsSessionThreadCreatedEvent object { id, agent_name, processed_at, 2 more }

    当子代理作为新线程生成时发出。写入父线程的输出流，以便观察会话的客户端看到子线程创建。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的可调用代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      新创建线程的公共 sthr_ ID。

    • type: "session.thread_created"

      • "session.thread_created"

  • BetaManagedAgentsSpanOutcomeEvaluationStartEvent object { id, iteration, outcome_id, 2 more }

    当结果评估循环开始时发出。

    • id: string

      此事件的唯一标识符。

    • iteration: number

      从 0 开始的修订循环。0 是第一次评估；1 是第一次修订后的重新评估；依此类推。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.outcome_evaluation_start"

      • "span.outcome_evaluation_start"

  • BetaManagedAgentsSpanOutcomeEvaluationEndEvent object { id, explanation, iteration, 6 more }

    当结果评估循环完成时发出。携带判定和聚合 token 使用量。判定为 needs_revision 意味着将进行另一个评估循环；satisfied、max_iterations_reached、failed 或 interrupted 是终止状态 — 不会再进行更多评估循环。

    • id: string

      此事件的唯一标识符。

    • explanation: string

      判定的人类可读解释。对于 needs_revision，描述哪些标准失败以及原因。

    • iteration: number

      从 0 开始的修订循环，与相应的 span.outcome_evaluation_start 匹配。

    • outcome_evaluation_start_id: string

      相应的 span.outcome_evaluation_start 事件的 ID。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • result: string

      评估判定。'satisfied'：标准满足，会话进入空闲。'needs_revision'：标准未满足，将进行另一个修订循环。'max_iterations_reached'：评估预算耗尽但标准仍未满足 — 会话进入空闲前进行最后一轮确认，但不再进行评估。'failed'：评分器判定评分标准不适用于可交付成果。'interrupted'：评估进行中用户发送了中断。

    • type: "span.outcome_evaluation_end"

      • "span.outcome_evaluation_end"

    • usage: BetaManagedAgentsSpanModelUsage

      单个模型请求的 token 使用量。

      • cache_creation_input_tokens: number

        此请求中用于创建提示缓存的 token。

      • cache_read_input_tokens: number

        此请求中从提示缓存读取的 token。

      • input_tokens: number

        此请求消耗的输入 token。

      • output_tokens: number

        此请求生成的输出 token。

      • speed: optional "standard" or "fast"

        推理速度模式。fast 以更高的价格提供显著更快的输出 token 生成。并非所有模型都支持 fast；无效组合在创建时会被拒绝。

        • "standard"

        • "fast"

  • BetaManagedAgentsSpanModelRequestStartEvent object { id, processed_at, type }

    当代理发起模型请求时发出。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.model_request_start"

      • "span.model_request_start"

  • BetaManagedAgentsSpanModelRequestEndEvent object { id, is_error, model_request_start_id, 3 more }

    当模型请求完成时发出。

    • id: string

      此事件的唯一标识符。

    • is_error: boolean

      模型请求是否导致错误。

    • model_request_start_id: string

      相应的 span.model_request_start 事件的 ID。

    • model_usage: BetaManagedAgentsSpanModelUsage

      单个模型请求的 token 使用量。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.model_request_end"

      • "span.model_request_end"

  • BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent object { id, iteration, outcome_id, 2 more }

    结果评估循环进行期间发出的周期性心跳。在相应的 span.outcome_evaluation_start 和 span.outcome_evaluation_end 事件之间区分"评估正在积极运行"和"评估卡住"。

    • id: string

      此事件的唯一标识符。

    • iteration: number

      从 0 开始的修订循环，与相应的 span.outcome_evaluation_start 匹配。

    • outcome_id: string

      正在评估的结果的 outc_ ID。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "span.outcome_evaluation_ongoing"

      • "span.outcome_evaluation_ongoing"

  • BetaManagedAgentsUserDefineOutcomeEvent object { id, description, max_iterations, 4 more }

    user.define_outcome 输入事件的回显。携带后续 span.outcome_evaluation_* 事件引用的服务器生成的 outcome_id。

    • id: string

      此事件的唯一标识符。

    • description: string

      代理应产出的内容。从输入事件复制。

    • max_iterations: number

      放弃前的评估然后修订循环。默认 3，最大 20。

    • outcome_id: string

      此结果的服务器生成的 outc_ ID。由 span.outcome_evaluation_* 事件和会话的 outcome_evaluations 列表引用。

    • processed_at: string

      RFC 3339 格式的时间戳

    • rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric

      用于评估结果质量的评分标准。

      • BetaManagedAgentsFileRubric object { file_id, type }

        通过 Files API 上传的文件引用的评估标准。

        • file_id: string

          ID of the rubric file.

        • type: "file"

          • "file"

      • BetaManagedAgentsTextRubric object { content, type }

        以内联文本形式提供的评估标准内容。

        • content: string

          评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。

        • type: "text"

          • "text"

    • type: "user.define_outcome"

      • "user.define_outcome"

  • BetaManagedAgentsSessionDeletedEvent object { id, processed_at, type }

    当会话被删除时发出。终止所有活动事件流 — 不会再为此会话发出更多事件。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.deleted"

      • "session.deleted"

  • BetaManagedAgentsSessionThreadStatusRunningEvent object { id, agent_name, processed_at, 2 more }

    会话线程已开始执行。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      开始运行的线程的公共 sthr_ ID。

    • type: "session.thread_status_running"

      • "session.thread_status_running"

  • BetaManagedAgentsSessionThreadStatusIdleEvent object { id, agent_name, processed_at, 3 more }

    会话线程已让出并正在等待输入。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      进入空闲的线程的公共 sthr_ ID。

    • stop_reason: BetaManagedAgentsSessionEndTurn or BetaManagedAgentsSessionRequiresAction or BetaManagedAgentsSessionRetriesExhausted

      代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionEndTurn object { type }

        代理自然完成了本轮，已准备好接收下一条用户消息。

      • BetaManagedAgentsSessionRequiresAction object { event_ids, type }

        代理正在空闲等待一个或多个阻塞的用户输入事件（工具确认、自定义工具结果等）。解决所有这些事件将使会话恢复运行。

      • BetaManagedAgentsSessionRetriesExhausted object { type }

        由于重试预算耗尽（达到 max_iterations 或错误升级为 retry_status: 'exhausted'），本轮结束。

    • type: "session.thread_status_idle"

      • "session.thread_status_idle"

  • BetaManagedAgentsSessionThreadStatusTerminatedEvent object { id, agent_name, processed_at, 2 more }

    会话线程已终止，不再接受输入。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      已终止线程的公共 sthr_ ID。

    • type: "session.thread_status_terminated"

      • "session.thread_status_terminated"

  • BetaManagedAgentsUserToolResultEvent object { id, tool_use_id, type, 4 more }

    客户端发送的事件，提供代理工具集工具执行的结果。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

    • id: string

      此事件的唯一标识符。

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_result"

      • "user.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

    • processed_at: optional string

      RFC 3339 格式的时间戳

    • session_thread_id: optional string

      将此结果路由到子代理线程。从 agent.tool_use 事件的 session_thread_id 复制。

  • BetaManagedAgentsSessionThreadStatusRescheduledEvent object { id, agent_name, processed_at, 2 more }

    会话线程遇到瞬态错误，正在自动重试。在线程自身的流上发出，并交叉发布到子线程的主流。

    • id: string

      此事件的唯一标识符。

    • agent_name: string

      线程运行的代理名称。

    • processed_at: string

      RFC 3339 格式的时间戳

    • session_thread_id: string

      正在重试的线程的公共 sthr_ ID。

    • type: "session.thread_status_rescheduled"

      • "session.thread_status_rescheduled"

  • BetaManagedAgentsSessionUpdatedEvent object { id, processed_at, type, 3 more }

    当 UpdateSession 请求更改了至少一个字段时发出。仅携带已更改的字段；缺失的字段不是更新的一部分。新配置从下一轮开始生效。

    • id: string

      此事件的唯一标识符。

    • processed_at: string

      RFC 3339 格式的时间戳

    • type: "session.updated"

      • "session.updated"

    • agent: optional BetaManagedAgentsSessionAgent

      已解析的 session 的 agent 定义。session 创建时 agent 的快照。

      • id: string

      • description: string

      • mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition

        • name: string

        • type: "url"

          • "url"

        • url: string

      • model: BetaManagedAgentsModelConfig

        模型标识符和配置。

        • id: BetaManagedAgentsModel

          驱动您的代理的模型。

          有关更多详细信息和选项，请参阅 models。

          • "claude-opus-4-7" or "claude-opus-4-6" or "claude-sonnet-4-6" or 6 more

            驱动您的代理的模型。

            有关更多详细信息和选项，请参阅 models。

            • "claude-opus-4-7"

              适用于长时间运行的代理和编码的前沿智能

            • "claude-opus-4-6"

              用于构建代理和编码的最智能模型

            • "claude-sonnet-4-6"

              速度和智能的最佳组合

            • "claude-haiku-4-5"

              具有接近前沿智能的最快模型

            • "claude-haiku-4-5-20251001"

              具有接近前沿智能的最快模型

            • "claude-opus-4-5"

              结合最大智能与实用性能的高级模型

            • "claude-opus-4-5-20251101"

              结合最大智能与实用性能的高级模型

            • "claude-sonnet-4-5"

              适用于代理和编码的高性能模型

            • "claude-sonnet-4-5-20250929"

              适用于代理和编码的高性能模型

          • string

        • speed: optional "standard" or "fast"

          推理速度模式。fast 以更高的价格提供显著更快的输出 token 生成。并非所有模型都支持 fast；无效组合在创建时会被拒绝。

          • "standard"

          • "fast"

      • multiagent: BetaManagedAgentsSessionMultiagentCoordinator

        已解析的协调器拓扑，包含每个成员的完整代理定义。

        • agents: array of BetaManagedAgentsSessionThreadAgent

          协调器可能作为会话线程生成的完整 agent 定义。

          • id: string

          • description: string

          • mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition

            • name: string

            • type: "url"

            • url: string

          • model: BetaManagedAgentsModelConfig

            模型标识符和配置。

          • name: string

          • skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill

            • BetaManagedAgentsAnthropicSkill object { skill_id, type, version }

              已解析的 Anthropic 管理的技能。

              • skill_id: string

              • type: "anthropic"

                • "anthropic"

              • version: string

            • BetaManagedAgentsCustomSkill object { skill_id, type, version }

              已解析的用户创建的自定义技能。

              • skill_id: string

              • type: "custom"

                • "custom"

              • version: string

          • system: string

          • tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool

            • BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }

              • configs: array of BetaManagedAgentsAgentToolConfig

                • enabled: boolean

                • name: "bash" or "edit" or "read" or 5 more

                  内置代理工具标识符。

                  • "bash"

                  • "edit"

                  • "read"

                  • "write"

                  • "glob"

                  • "grep"

                  • "web_fetch"

                  • "web_search"

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                    • type: "always_allow"

                      • "always_allow"

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

                    • type: "always_ask"

                      • "always_ask"

              • default_config: BetaManagedAgentsAgentToolsetDefaultConfig

                已解析的代理工具默认配置。

                • enabled: boolean

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • type: "agent_toolset_20260401"

                • "agent_toolset_20260401"

            • BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }

              • configs: array of BetaManagedAgentsMCPToolConfig

                • enabled: boolean

                • name: string

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • default_config: BetaManagedAgentsMCPToolsetDefaultConfig

                已解析的 MCP 服务器所有工具的默认配置。

                • enabled: boolean

                • permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy

                  工具执行的权限策略。

                  • BetaManagedAgentsAlwaysAllowPolicy object { type }

                    工具调用无需用户确认即自动批准。

                  • BetaManagedAgentsAlwaysAskPolicy object { type }

                    工具调用在执行前需要用户确认。

              • mcp_server_name: string

              • type: "mcp_toolset"

                • "mcp_toolset"

            • BetaManagedAgentsCustomTool object { description, input_schema, name, type }

              API 响应中返回的自定义工具。

              • description: string

              • input_schema: BetaManagedAgentsCustomToolInputSchema

                自定义工具输入参数的 JSON Schema。

                • properties: optional map[unknown]

                  定义工具输入参数的 JSON Schema 属性。

                • required: optional array of string

                  必需属性名称列表。

                • type: optional "object"

                  工具输入模式必须为 'object'。

                  • "object"

              • name: string

              • type: "custom"

                • "custom"

          • type: "agent"

            • "agent"

          • version: number

        • type: "coordinator"

          • "coordinator"

      • name: string

      • skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill

        • BetaManagedAgentsAnthropicSkill object { skill_id, type, version }

          已解析的 Anthropic 管理的技能。

        • BetaManagedAgentsCustomSkill object { skill_id, type, version }

          已解析的用户创建的自定义技能。

      • system: string

      • tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool

        • BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }

        • BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }

        • BetaManagedAgentsCustomTool object { description, input_schema, name, type }

          API 响应中返回的自定义工具。

      • type: "agent"

        • "agent"

      • version: number

    • metadata: optional map[string]

      更新后会话的完整元数据包。当更新设置了非空元数据时存在；当元数据未更改或清除为空时缺失。

    • title: optional string

      会话的新标题。仅在更新更改了它时存在。

示例

curl https://api.anthropic.com/v1/sessions/$SESSION_ID/events/stream \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

响应

{
  "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
  "content": [
    {
      "text": "Where is my order #1234?",
      "type": "text"
    }
  ],
  "type": "user.message",
  "processed_at": "2026-03-15T10:00:00Z"
}

域类型

Beta Managed Agents Agent Custom Tool Use Event

• BetaManagedAgentsAgentCustomToolUseEvent object { id, input, name, 3 more }

  代理调用自定义工具时发出的事件。会话进入空闲状态，直到客户端发送包含结果的 user.custom_tool_result 事件。

  • id: string

    此事件的唯一标识符。

  • input: map[unknown]

    工具调用的输入参数。

  • name: string

    被调用的自定义工具名称。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.custom_tool_use"

    • "agent.custom_tool_use"

  • session_thread_id: optional string

    设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其自定义工具使用。线程自身的事件上为空。在 user.custom_tool_result 事件上回显此值以将结果路由回来。

Beta Managed Agents Agent MCP Tool Result Event

• BetaManagedAgentsAgentMCPToolResultEvent object { id, mcp_tool_use_id, processed_at, 3 more }

  表示 MCP 工具执行结果的事件。

  • id: string

    此事件的唯一标识符。

  • mcp_tool_use_id: string

    此结果对应的 agent.mcp_tool_use 事件的 ID。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.mcp_tool_result"

    • "agent.mcp_tool_result"

  • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

    工具返回的结果内容。

    • BetaManagedAgentsTextBlock object { text, type }

      常规文本内容。

      • text: string

        文本内容。

      • type: "text"

        • "text"

    • BetaManagedAgentsImageBlock object { source, type }

      直接指定为 base64 数据或通过 URL 引用的图像内容。

      • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

        图像源变体的联合类型。

        • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

          Base64 编码的图像数据。

          • data: string

            Base64 编码的图像数据。

          • media_type: string

            图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsURLImageSource object { type, url }

          通过 URL 引用的图像。

          • type: "url"

            • "url"

          • url: string

            要获取的图像的 URL。

        • BetaManagedAgentsFileImageSource object { file_id, type }

          通过文件 ID 引用的图像。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "image"

        • "image"

    • BetaManagedAgentsDocumentBlock object { source, type, context, title }

      文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

        文档源变体的联合类型。

        • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

          Base64 编码的文档数据。

          • data: string

            Base64 编码的文档数据。

          • media_type: string

            文档的 MIME 类型（例如 "application/pdf"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

          纯文本文档内容。

          • data: string

            纯文本内容。

          • media_type: "text/plain"

            文本内容的 MIME 类型。必须为 "text/plain"。

            • "text/plain"

          • type: "text"

            • "text"

        • BetaManagedAgentsURLDocumentSource object { type, url }

          通过 URL 引用的文档。

          • type: "url"

            • "url"

          • url: string

            要获取的文档的 URL。

        • BetaManagedAgentsFileDocumentSource object { file_id, type }

          通过文件 ID 引用的文档。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "document"

        • "document"

      • context: optional string

        关于文档的附加上下文，供模型使用。

      • title: optional string

        文档的标题。

    • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

      包含网络搜索结果的块。

      • citations: BetaManagedAgentsSearchResultCitations

        搜索结果的引用设置。

        • enabled: boolean

          此搜索结果是否启用引用。

      • content: array of BetaManagedAgentsSearchResultContent

        搜索结果中的文本内容块数组。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • source: string

        The URL source of the search result.

      • title: string

        搜索结果的标题。

      • type: "search_result"

        • "search_result"

  • is_error: optional boolean

    工具执行是否导致错误。

Beta Managed Agents Agent MCP Tool Use Event

• BetaManagedAgentsAgentMCPToolUseEvent object { id, input, mcp_server_name, 5 more }

  代理调用 MCP 服务器提供的工具时发出的事件。

  • id: string

    此事件的唯一标识符。

  • input: map[unknown]

    工具调用的输入参数。

  • mcp_server_name: string

    提供工具的 MCP 服务器名称。

  • name: string

    正在使用的 MCP 工具名称。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.mcp_tool_use"

    • "agent.mcp_tool_use"

  • evaluated_permission: optional "allow" or "ask" or "deny"

    AgentEvaluatedPermission enum

    • "allow"

    • "ask"

    • "deny"

  • session_thread_id: optional string

    设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

Beta Managed Agents Agent Message Event

• BetaManagedAgentsAgentMessageEvent object { id, content, processed_at, type }

  会话对话中的代理响应事件。

  • id: string

    此事件的唯一标识符。

  • content: array of BetaManagedAgentsTextBlock

    构成代理响应的文本块数组。

    • text: string

      文本内容。

    • type: "text"

      • "text"

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.message"

    • "agent.message"

Beta Managed Agents Agent Thinking Event

• BetaManagedAgentsAgentThinkingEvent object { id, processed_at, type }

  表示代理正在通过扩展思考取得进展。进度信号，而非内容载体。

  • id: string

    此事件的唯一标识符。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.thinking"

    • "agent.thinking"

Beta Managed Agents Agent Thread Context Compacted Event

• BetaManagedAgentsAgentThreadContextCompactedEvent object { id, processed_at, type }

  表示会话期间发生了上下文压缩（摘要）。

  • id: string

    此事件的唯一标识符。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.thread_context_compacted"

    • "agent.thread_context_compacted"

Beta Managed Agents Agent Thread Message Received Event

• BetaManagedAgentsAgentThreadMessageReceivedEvent object { id, content, from_session_thread_id, 3 more }

  当代理间消息到达时写入目标线程输入流的传递事件。

  • id: string

    此事件的唯一标识符。

  • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

    消息内容块。

    • BetaManagedAgentsTextBlock object { text, type }

      常规文本内容。

      • text: string

        文本内容。

      • type: "text"

        • "text"

    • BetaManagedAgentsImageBlock object { source, type }

      直接指定为 base64 数据或通过 URL 引用的图像内容。

      • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

        图像源变体的联合类型。

        • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

          Base64 编码的图像数据。

          • data: string

            Base64 编码的图像数据。

          • media_type: string

            图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsURLImageSource object { type, url }

          通过 URL 引用的图像。

          • type: "url"

            • "url"

          • url: string

            要获取的图像的 URL。

        • BetaManagedAgentsFileImageSource object { file_id, type }

          通过文件 ID 引用的图像。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "image"

        • "image"

    • BetaManagedAgentsDocumentBlock object { source, type, context, title }

      文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

        文档源变体的联合类型。

        • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

          Base64 编码的文档数据。

          • data: string

            Base64 编码的文档数据。

          • media_type: string

            文档的 MIME 类型（例如 "application/pdf"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

          纯文本文档内容。

          • data: string

            纯文本内容。

          • media_type: "text/plain"

            文本内容的 MIME 类型。必须为 "text/plain"。

            • "text/plain"

          • type: "text"

            • "text"

        • BetaManagedAgentsURLDocumentSource object { type, url }

          通过 URL 引用的文档。

          • type: "url"

            • "url"

          • url: string

            要获取的文档的 URL。

        • BetaManagedAgentsFileDocumentSource object { file_id, type }

          通过文件 ID 引用的文档。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "document"

        • "document"

      • context: optional string

        关于文档的附加上下文，供模型使用。

      • title: optional string

        文档的标题。

  • from_session_thread_id: string

    发送消息的线程的公共 sthr_ ID。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.thread_message_received"

    • "agent.thread_message_received"

  • from_agent_name: optional string

    此消息来源的可调用代理名称。从主代理接收时为空。

Beta Managed Agents Agent Thread Message Sent Event

• BetaManagedAgentsAgentThreadMessageSentEvent object { id, content, processed_at, 3 more }

  发送代理间消息时发送到发送者输出流的可观测性事件。

  • id: string

    此事件的唯一标识符。

  • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

    消息内容块。

    • BetaManagedAgentsTextBlock object { text, type }

      常规文本内容。

      • text: string

        文本内容。

      • type: "text"

        • "text"

    • BetaManagedAgentsImageBlock object { source, type }

      直接指定为 base64 数据或通过 URL 引用的图像内容。

      • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

        图像源变体的联合类型。

        • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

          Base64 编码的图像数据。

          • data: string

            Base64 编码的图像数据。

          • media_type: string

            图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsURLImageSource object { type, url }

          通过 URL 引用的图像。

          • type: "url"

            • "url"

          • url: string

            要获取的图像的 URL。

        • BetaManagedAgentsFileImageSource object { file_id, type }

          通过文件 ID 引用的图像。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "image"

        • "image"

    • BetaManagedAgentsDocumentBlock object { source, type, context, title }

      文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

        文档源变体的联合类型。

        • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

          Base64 编码的文档数据。

          • data: string

            Base64 编码的文档数据。

          • media_type: string

            文档的 MIME 类型（例如 "application/pdf"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

          纯文本文档内容。

          • data: string

            纯文本内容。

          • media_type: "text/plain"

            文本内容的 MIME 类型。必须为 "text/plain"。

            • "text/plain"

          • type: "text"

            • "text"

        • BetaManagedAgentsURLDocumentSource object { type, url }

          通过 URL 引用的文档。

          • type: "url"

            • "url"

          • url: string

            要获取的文档的 URL。

        • BetaManagedAgentsFileDocumentSource object { file_id, type }

          通过文件 ID 引用的文档。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "document"

        • "document"

      • context: optional string

        关于文档的附加上下文，供模型使用。

      • title: optional string

        文档的标题。

  • processed_at: string

    RFC 3339 格式的时间戳

  • to_session_thread_id: string

    消息发送到的线程的公共 sthr_ ID。

  • type: "agent.thread_message_sent"

    • "agent.thread_message_sent"

  • to_agent_name: optional string

    此消息发送到的可调用代理名称。发送到主代理时为空。

Beta Managed Agents Agent Tool Result Event

• BetaManagedAgentsAgentToolResultEvent object { id, processed_at, tool_use_id, 3 more }

  表示代理工具执行结果的事件。

  • id: string

    此事件的唯一标识符。

  • processed_at: string

    RFC 3339 格式的时间戳

  • tool_use_id: string

    此结果对应的 agent.tool_use 事件的 ID。

  • type: "agent.tool_result"

    • "agent.tool_result"

  • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

    工具返回的结果内容。

    • BetaManagedAgentsTextBlock object { text, type }

      常规文本内容。

      • text: string

        文本内容。

      • type: "text"

        • "text"

    • BetaManagedAgentsImageBlock object { source, type }

      直接指定为 base64 数据或通过 URL 引用的图像内容。

      • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

        图像源变体的联合类型。

        • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

          Base64 编码的图像数据。

          • data: string

            Base64 编码的图像数据。

          • media_type: string

            图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsURLImageSource object { type, url }

          通过 URL 引用的图像。

          • type: "url"

            • "url"

          • url: string

            要获取的图像的 URL。

        • BetaManagedAgentsFileImageSource object { file_id, type }

          通过文件 ID 引用的图像。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "image"

        • "image"

    • BetaManagedAgentsDocumentBlock object { source, type, context, title }

      文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

        文档源变体的联合类型。

        • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

          Base64 编码的文档数据。

          • data: string

            Base64 编码的文档数据。

          • media_type: string

            文档的 MIME 类型（例如 "application/pdf"）。

          • type: "base64"

            • "base64"

        • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

          纯文本文档内容。

          • data: string

            纯文本内容。

          • media_type: "text/plain"

            文本内容的 MIME 类型。必须为 "text/plain"。

            • "text/plain"

          • type: "text"

            • "text"

        • BetaManagedAgentsURLDocumentSource object { type, url }

          通过 URL 引用的文档。

          • type: "url"

            • "url"

          • url: string

            要获取的文档的 URL。

        • BetaManagedAgentsFileDocumentSource object { file_id, type }

          通过文件 ID 引用的文档。

          • file_id: string

            先前上传的文件的 ID。

          • type: "file"

            • "file"

      • type: "document"

        • "document"

      • context: optional string

        关于文档的附加上下文，供模型使用。

      • title: optional string

        文档的标题。

    • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

      包含网络搜索结果的块。

      • citations: BetaManagedAgentsSearchResultCitations

        搜索结果的引用设置。

        • enabled: boolean

          此搜索结果是否启用引用。

      • content: array of BetaManagedAgentsSearchResultContent

        搜索结果中的文本内容块数组。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • source: string

        The URL source of the search result.

      • title: string

        搜索结果的标题。

      • type: "search_result"

        • "search_result"

  • is_error: optional boolean

    工具执行是否导致错误。

Beta Managed Agents Agent Tool Use Event

• BetaManagedAgentsAgentToolUseEvent object { id, input, name, 4 more }

  代理调用内置代理工具时发出的事件。

  • id: string

    此事件的唯一标识符。

  • input: map[unknown]

    工具调用的输入参数。

  • name: string

    正在使用的代理工具名称。

  • processed_at: string

    RFC 3339 格式的时间戳

  • type: "agent.tool_use"

    • "agent.tool_use"

  • evaluated_permission: optional "allow" or "ask" or "deny"

    AgentEvaluatedPermission enum

    • "allow"

    • "ask"

    • "deny"

  • session_thread_id: optional string

    设置后，此事件从子代理的线程交叉发布，以在主线程的流上显示其权限请求。线程自身的事件上为空。在 user.tool_confirmation 事件上回显此值以将批准路由回来。

Beta Managed Agents Base64 Document Source

• BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

  Base64 编码的文档数据。

  • data: string

    Base64 编码的文档数据。

  • media_type: string

    文档的 MIME 类型（例如 "application/pdf"）。

  • type: "base64"

    • "base64"

Beta Managed Agents Base64 Image Source

• BetaManagedAgentsBase64ImageSource object { data, media_type, type }

  Base64 编码的图像数据。

  • data: string

    Base64 编码的图像数据。

  • media_type: string

    图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

  • type: "base64"

    • "base64"

Beta Managed Agents Billing Error

• BetaManagedAgentsBillingError object { message, retry_status, type }

  调用者的组织或工作区无法发出模型请求 — 信用额度不足或达到支出限制。使用相同凭据重试不会成功；调用者必须解决计费状态。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "billing_error"

    • "billing_error"

Beta Managed Agents Document Block

• BetaManagedAgentsDocumentBlock object { source, type, context, title }

  文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

  • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

    文档源变体的联合类型。

    • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

      Base64 编码的文档数据。

      • data: string

        Base64 编码的文档数据。

      • media_type: string

        文档的 MIME 类型（例如 "application/pdf"）。

      • type: "base64"

        • "base64"

    • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

      纯文本文档内容。

      • data: string

        纯文本内容。

      • media_type: "text/plain"

        文本内容的 MIME 类型。必须为 "text/plain"。

        • "text/plain"

      • type: "text"

        • "text"

    • BetaManagedAgentsURLDocumentSource object { type, url }

      通过 URL 引用的文档。

      • type: "url"

        • "url"

      • url: string

        要获取的文档的 URL。

    • BetaManagedAgentsFileDocumentSource object { file_id, type }

      通过文件 ID 引用的文档。

      • file_id: string

        先前上传的文件的 ID。

      • type: "file"

        • "file"

  • type: "document"

    • "document"

  • context: optional string

    关于文档的附加上下文，供模型使用。

  • title: optional string

    文档的标题。

Beta Managed Agents Event Params

• BetaManagedAgentsEventParams = BetaManagedAgentsUserMessageEventParams or BetaManagedAgentsUserInterruptEventParams or BetaManagedAgentsUserToolConfirmationEventParams or 3 more

  可发送到会话的事件参数的联合类型。

  • BetaManagedAgentsUserMessageEventParams object { content, type }

    向会话发送用户消息的参数。

    • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

      用户消息的内容块数组。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

        • text: string

          文本内容。

        • type: "text"

          • "text"

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

        • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

          图像源变体的联合类型。

          • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

            Base64 编码的图像数据。

            • data: string

              Base64 编码的图像数据。

            • media_type: string

              图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsURLImageSource object { type, url }

            通过 URL 引用的图像。

            • type: "url"

              • "url"

            • url: string

              要获取的图像的 URL。

          • BetaManagedAgentsFileImageSource object { file_id, type }

            通过文件 ID 引用的图像。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "image"

          • "image"

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

          文档源变体的联合类型。

          • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

            Base64 编码的文档数据。

            • data: string

              Base64 编码的文档数据。

            • media_type: string

              文档的 MIME 类型（例如 "application/pdf"）。

            • type: "base64"

              • "base64"

          • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

            纯文本文档内容。

            • data: string

              纯文本内容。

            • media_type: "text/plain"

              文本内容的 MIME 类型。必须为 "text/plain"。

              • "text/plain"

            • type: "text"

              • "text"

          • BetaManagedAgentsURLDocumentSource object { type, url }

            通过 URL 引用的文档。

            • type: "url"

              • "url"

            • url: string

              要获取的文档的 URL。

          • BetaManagedAgentsFileDocumentSource object { file_id, type }

            通过文件 ID 引用的文档。

            • file_id: string

              先前上传的文件的 ID。

            • type: "file"

              • "file"

        • type: "document"

          • "document"

        • context: optional string

          关于文档的附加上下文，供模型使用。

        • title: optional string

          文档的标题。

    • type: "user.message"

      • "user.message"

  • BetaManagedAgentsUserInterruptEventParams object { type, session_thread_id }

    发送中断以暂停代理的参数。

    • type: "user.interrupt"

      • "user.interrupt"

    • session_thread_id: optional string

      如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

  • BetaManagedAgentsUserToolConfirmationEventParams object { result, tool_use_id, type, deny_message }

    确认或拒绝工具执行请求的参数。

    • result: "allow" or "deny"

      UserToolConfirmationResult enum

      • "allow"

      • "deny"

    • tool_use_id: string

      此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_confirmation"

      • "user.tool_confirmation"

    • deny_message: optional string

      可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

  • BetaManagedAgentsUserCustomToolResultEventParams object { custom_tool_use_id, type, content, is_error }

    提供自定义工具执行结果的参数。

    • custom_tool_use_id: string

      此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.custom_tool_result"

      • "user.custom_tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

        • citations: BetaManagedAgentsSearchResultCitations

          搜索结果的引用设置。

          • enabled: boolean

            此搜索结果是否启用引用。

        • content: array of BetaManagedAgentsSearchResultContent

          搜索结果中的文本内容块数组。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • source: string

          The URL source of the search result.

        • title: string

          搜索结果的标题。

        • type: "search_result"

          • "search_result"

    • is_error: optional boolean

      工具执行是否导致错误。

  • BetaManagedAgentsUserDefineOutcomeEventParams object { description, rubric, type, max_iterations }

    定义代理应努力实现的结果的参数。代理在收到后开始工作。

    • description: string

      代理应产出的内容。 This is the task specification.

    • rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams

      用于评估结果质量的评分标准。

      • BetaManagedAgentsFileRubricParams object { file_id, type }

        通过 Files API 上传的文件引用的评估标准。

        • file_id: string

          ID of the rubric file.

        • type: "file"

          • "file"

      • BetaManagedAgentsTextRubricParams object { content, type }

        以内联文本形式提供的评估标准内容。

        • content: string

          评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。 Maximum 262144 characters.

        • type: "text"

          • "text"

    • type: "user.define_outcome"

      • "user.define_outcome"

    • max_iterations: optional number

      Eval→revision cycles before giving up. Default 3, max 20.

  • BetaManagedAgentsUserToolResultEventParams object { tool_use_id, type, content, is_error }

    提供代理工具集工具执行结果的参数。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

    • tool_use_id: string

      此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

    • type: "user.tool_result"

      • "user.tool_result"

    • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

      工具返回的结果内容。

      • BetaManagedAgentsTextBlock object { text, type }

        常规文本内容。

      • BetaManagedAgentsImageBlock object { source, type }

        直接指定为 base64 数据或通过 URL 引用的图像内容。

      • BetaManagedAgentsDocumentBlock object { source, type, context, title }

        文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

      • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

        包含网络搜索结果的块。

    • is_error: optional boolean

      工具执行是否导致错误。

Beta Managed Agents File Document Source

• BetaManagedAgentsFileDocumentSource object { file_id, type }

  通过文件 ID 引用的文档。

  • file_id: string

    先前上传的文件的 ID。

  • type: "file"

    • "file"

Beta Managed Agents File Image Source

• BetaManagedAgentsFileImageSource object { file_id, type }

  通过文件 ID 引用的图像。

  • file_id: string

    先前上传的文件的 ID。

  • type: "file"

    • "file"

Beta Managed Agents File Rubric

• BetaManagedAgentsFileRubric object { file_id, type }

  通过 Files API 上传的文件引用的评估标准。

  • file_id: string

    ID of the rubric file.

  • type: "file"

    • "file"

Beta Managed Agents File Rubric Params

• BetaManagedAgentsFileRubricParams object { file_id, type }

  通过 Files API 上传的文件引用的评估标准。

  • file_id: string

    ID of the rubric file.

  • type: "file"

    • "file"

Beta Managed Agents Image Block

• BetaManagedAgentsImageBlock object { source, type }

  直接指定为 base64 数据或通过 URL 引用的图像内容。

  • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

    图像源变体的联合类型。

    • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

      Base64 编码的图像数据。

      • data: string

        Base64 编码的图像数据。

      • media_type: string

        图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

      • type: "base64"

        • "base64"

    • BetaManagedAgentsURLImageSource object { type, url }

      通过 URL 引用的图像。

      • type: "url"

        • "url"

      • url: string

        要获取的图像的 URL。

    • BetaManagedAgentsFileImageSource object { file_id, type }

      通过文件 ID 引用的图像。

      • file_id: string

        先前上传的文件的 ID。

      • type: "file"

        • "file"

  • type: "image"

    • "image"

Beta Managed Agents MCP Authentication Failed Error

• BetaManagedAgentsMCPAuthenticationFailedError object { mcp_server_name, message, retry_status, type }

  MCP 服务器认证失败。

  • mcp_server_name: string

    认证失败的 MCP 服务器名称。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "mcp_authentication_failed_error"

    • "mcp_authentication_failed_error"

Beta Managed Agents MCP Connection Failed Error

• BetaManagedAgentsMCPConnectionFailedError object { mcp_server_name, message, retry_status, type }

  连接 MCP 服务器失败。

  • mcp_server_name: string

    连接失败的 MCP 服务器名称。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "mcp_connection_failed_error"

    • "mcp_connection_failed_error"

Beta Managed Agents Model Overloaded Error

• BetaManagedAgentsModelOverloadedError object { message, retry_status, type }

  模型当前过载。在自动重试耗尽后发出。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "model_overloaded_error"

    • "model_overloaded_error"

Beta Managed Agents Model Rate Limited Error

• BetaManagedAgentsModelRateLimitedError object { message, retry_status, type }

  模型请求被限速。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "model_rate_limited_error"

    • "model_rate_limited_error"

Beta Managed Agents Model Request Failed Error

• BetaManagedAgentsModelRequestFailedError object { message, retry_status, type }

  模型请求因过载或限速以外的原因失败。

  • message: string

    人类可读的错误描述。

  • retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal

    客户端对此错误应采取的下一步操作。

    • BetaManagedAgentsRetryStatusRetrying object { type }

      服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

      • type: "retrying"

        • "retrying"

    • BetaManagedAgentsRetryStatusExhausted object { type }

      此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

      • type: "exhausted"

        • "exhausted"

    • BetaManagedAgentsRetryStatusTerminal object { type }

      会话遇到终端错误，将转换到 terminated 状态。

      • type: "terminal"

        • "terminal"

  • type: "model_request_failed_error"

    • "model_request_failed_error"

Beta Managed Agents Plain Text Document Source

• BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

  纯文本文档内容。

  • data: string

    纯文本内容。

  • media_type: "text/plain"

    文本内容的 MIME 类型。必须为 "text/plain"。

    • "text/plain"

  • type: "text"

    • "text"

Beta Managed Agents Retry Status Exhausted

• BetaManagedAgentsRetryStatusExhausted object { type }

  此轮已死；排队的输入被刷新，会话返回空闲状态。客户端可以发送新的提示。

  • type: "exhausted"

    • "exhausted"

Beta Managed Agents Retry Status Retrying

• BetaManagedAgentsRetryStatusRetrying object { type }

  服务器正在自动重试。客户端应等待；同一错误类型可能再次作为重试触发，然后在重试预算用尽时作为耗尽触发一次。

  • type: "retrying"

    • "retrying"

Beta Managed Agents Retry Status Terminal

• BetaManagedAgentsRetryStatusTerminal object { type }

  会话遇到终端错误，将转换到 terminated 状态。

  • type: "terminal"

    • "terminal"

Beta Managed Agents Search Result Block

• BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

  包含网络搜索结果的块。

  • citations: BetaManagedAgentsSearchResultCitations

    搜索结果的引用设置。

    • enabled: boolean

      此搜索结果是否启用引用。

  • content: array of BetaManagedAgentsSearchResultContent

    搜索结果中的文本内容块数组。

    • text: string

      文本内容。

    • type: "text"

      • "text"

  • source: string

    The URL source of the search result.

  • title: string

    搜索结果的标题。

  • type: "search_result"

    • "search_result"

Beta Managed Agents Search Result Citations

• BetaManagedAgentsSearchResultCitations object { enabled }

  搜索结果的引用设置。

  • enabled: boolean

    此搜索结果是否启用引用。

Beta Managed Agents Search Result Content

• BetaManagedAgentsSearchResultContent object { text, type }

  搜索结果中的文本内容。

  • text: string

    文本内容。

  • type: "text"

    • "text"

Beta Managed Agents Send Session Events

• BetaManagedAgentsSendSessionEvents object { data }

  成功发送到会话的事件。

  • data: optional array of BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 3 more

    已发送的事件

    • BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }

      会话对话中的用户消息事件。

      • id: string

        此事件的唯一标识符。

      • content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock

        构成用户消息的内容块数组。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

          • text: string

            文本内容。

          • type: "text"

            • "text"

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

          • source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource

            图像源变体的联合类型。

            • BetaManagedAgentsBase64ImageSource object { data, media_type, type }

              Base64 编码的图像数据。

              • data: string

                Base64 编码的图像数据。

              • media_type: string

                图像的 MIME 类型（例如 "image/png"、"image/jpeg"、"image/gif"、"image/webp"）。

              • type: "base64"

                • "base64"

            • BetaManagedAgentsURLImageSource object { type, url }

              通过 URL 引用的图像。

              • type: "url"

                • "url"

              • url: string

                要获取的图像的 URL。

            • BetaManagedAgentsFileImageSource object { file_id, type }

              通过文件 ID 引用的图像。

              • file_id: string

                先前上传的文件的 ID。

              • type: "file"

                • "file"

          • type: "image"

            • "image"

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

          • source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource

            文档源变体的联合类型。

            • BetaManagedAgentsBase64DocumentSource object { data, media_type, type }

              Base64 编码的文档数据。

              • data: string

                Base64 编码的文档数据。

              • media_type: string

                文档的 MIME 类型（例如 "application/pdf"）。

              • type: "base64"

                • "base64"

            • BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }

              纯文本文档内容。

              • data: string

                纯文本内容。

              • media_type: "text/plain"

                文本内容的 MIME 类型。必须为 "text/plain"。

                • "text/plain"

              • type: "text"

                • "text"

            • BetaManagedAgentsURLDocumentSource object { type, url }

              通过 URL 引用的文档。

              • type: "url"

                • "url"

              • url: string

                要获取的文档的 URL。

            • BetaManagedAgentsFileDocumentSource object { file_id, type }

              通过文件 ID 引用的文档。

              • file_id: string

                先前上传的文件的 ID。

              • type: "file"

                • "file"

          • type: "document"

            • "document"

          • context: optional string

            关于文档的附加上下文，供模型使用。

          • title: optional string

            文档的标题。

      • type: "user.message"

        • "user.message"

      • processed_at: optional string

        RFC 3339 格式的时间戳

    • BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }

      暂停代理执行并将控制权返回给用户的中断事件。

      • id: string

        此事件的唯一标识符。

      • type: "user.interrupt"

        • "user.interrupt"

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        如果缺失，中断多代理会话中每个未归档的线程（或单代理会话中仅中断主线程）。如果存在，仅中断指定的线程。

    • BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }

      批准或拒绝待处理工具执行的工具确认事件。

      • id: string

        此事件的唯一标识符。

      • result: "allow" or "deny"

        UserToolConfirmationResult enum

        • "allow"

        • "deny"

      • tool_use_id: string

        此结果对应的 agent.tool_use 或 agent.mcp_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.tool_confirmation"

        • "user.tool_confirmation"

      • deny_message: optional string

        可选消息，为 'deny' 决策提供上下文。仅在结果为 'deny' 时允许。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        设置后，确认将路由到此子代理的线程而非主线程。从触发批准的 agent.tool_use 或 agent.mcp_tool_use 事件的 session_thread_id 回显此值。

    • BetaManagedAgentsUserCustomToolResultEvent object { id, custom_tool_use_id, type, 4 more }

      客户端发送的事件，提供自定义工具执行的结果。

      • id: string

        此事件的唯一标识符。

      • custom_tool_use_id: string

        此结果对应的 agent.custom_tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.custom_tool_result"

        • "user.custom_tool_result"

      • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

        工具返回的结果内容。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

          包含网络搜索结果的块。

          • citations: BetaManagedAgentsSearchResultCitations

            搜索结果的引用设置。

            • enabled: boolean

              此搜索结果是否启用引用。

          • content: array of BetaManagedAgentsSearchResultContent

            搜索结果中的文本内容块数组。

            • text: string

              文本内容。

            • type: "text"

              • "text"

          • source: string

            The URL source of the search result.

          • title: string

            搜索结果的标题。

          • type: "search_result"

            • "search_result"

      • is_error: optional boolean

        工具执行是否导致错误。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        将此结果路由到子代理线程。从 agent.custom_tool_use 事件的 session_thread_id 复制。

    • BetaManagedAgentsUserDefineOutcomeEvent object { id, description, max_iterations, 4 more }

      user.define_outcome 输入事件的回显。携带后续 span.outcome_evaluation_* 事件引用的服务器生成的 outcome_id。

      • id: string

        此事件的唯一标识符。

      • description: string

        代理应产出的内容。从输入事件复制。

      • max_iterations: number

        放弃前的评估然后修订循环。默认 3，最大 20。

      • outcome_id: string

        此结果的服务器生成的 outc_ ID。由 span.outcome_evaluation_* 事件和会话的 outcome_evaluations 列表引用。

      • processed_at: string

        RFC 3339 格式的时间戳

      • rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric

        用于评估结果质量的评分标准。

        • BetaManagedAgentsFileRubric object { file_id, type }

          通过 Files API 上传的文件引用的评估标准。

          • file_id: string

            ID of the rubric file.

          • type: "file"

            • "file"

        • BetaManagedAgentsTextRubric object { content, type }

          以内联文本形式提供的评估标准内容。

          • content: string

            评分标准内容。纯文本或 markdown — 评分器将其视为自由格式文本。

          • type: "text"

            • "text"

      • type: "user.define_outcome"

        • "user.define_outcome"

    • BetaManagedAgentsUserToolResultEvent object { id, tool_use_id, type, 4 more }

      客户端发送的事件，提供代理工具集工具执行的结果。仅在 self_hosted 环境中有效，其中沙箱路由的工具由客户端而非服务器执行。

      • id: string

        此事件的唯一标识符。

      • tool_use_id: string

        此结果对应的 agent.tool_use 事件的 ID，可以在最后一个 session.status_idle 事件的 stop_reason.event_ids 字段中找到。

      • type: "user.tool_result"

        • "user.tool_result"

      • content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock

        工具返回的结果内容。

        • BetaManagedAgentsTextBlock object { text, type }

          常规文本内容。

        • BetaManagedAgentsImageBlock object { source, type }

          直接指定为 base64 数据或通过 URL 引用的图像内容。

        • BetaManagedAgentsDocumentBlock object { source, type, context, title }

          文档内容，直接指定为 base64 数据、文本或通过 URL 引用。

        • BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }

          包含网络搜索结果的块。

      • is_error: optional boolean

        工具执行是否导致错误。

      • processed_at: optional string

        RFC 3339 格式的时间戳

      • session_thread_id: optional string

        将此结果路由到子代理线程。从 agent.tool_use 事件的 session_thread_id 复制。