--- title: Referência url: https://platform.claude.com/docs/pt-BR/managed-agents/reference description: Tipos de eventos, flags de CLI do worker auto-hospedado, tipos de servidor MCP suportados, limites de taxa e diretrizes de marca para o Claude Managed Agents. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Esta página reúne material de referência para o Claude Managed Agents. Para guias orientados a tarefas, siga os links em cada seção. Para as operações no recurso de sessão, consulte [Operações de sessão](https://platform.claude.com/docs/pt-BR/managed-agents/session-operations). ## Tipos de eventos As strings de tipo de evento persistidas seguem uma convenção de nomenclatura `{domain}.{action}`; os deltas de evento exclusivos de stream (consulte a aba Deltas de evento) são a exceção. Consulte [Stream de eventos da sessão](https://platform.claude.com/docs/pt-BR/managed-agents/events-and-streaming) para enviar, fazer streaming e listar eventos. Os tipos de eventos de webhook estão listados separadamente em [Assinar webhooks](https://platform.claude.com/docs/pt-BR/managed-agents/webhooks#supported-event-types), e alguns de seus nomes diferem dos do stream (por exemplo, `session.status_idled` em vez de `session.status_idle`). | Tipo | Descrição | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `user.message` | Uma mensagem do usuário com conteúdo de texto, imagem ou documento. | | `user.interrupt` | Interrompe o agente no meio da execução. Ele não encerra nenhuma [execução de workflow](https://platform.claude.com/docs/pt-BR/managed-agents/workflow-runs#interrupt-a-session-with-runs-open). | | `user.custom_tool_result` | Resposta a uma chamada de ferramenta personalizada feita pelo agente. | | `user.tool_confirmation` | Aprova ou nega uma chamada de ferramenta do agente ou de MCP quando uma política de permissão exige confirmação. | | `user.define_outcome` | Define um [resultado](https://platform.claude.com/docs/pt-BR/managed-agents/define-outcomes) para o agente buscar alcançar. | | `user.tool_result` | Somente para sessões com [ambientes](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes) `self_hosted`, sua integração é responsável por fornecer os resultados de `agent_toolset`. Os helpers do SDK e a CLI fazem isso automaticamente. | | Tipo | Descrição | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | Blocos de conteúdo da resposta do agente. | | `agent.thinking` | Sinaliza que o agente está progredindo por meio de "extended thinking" (pensamento estendido). Este é apenas um sinal de progresso e não carrega o conteúdo do pensamento. | | `agent.tool_use` | O agente invoca uma ferramenta de agente pré-construída (bash, operações de arquivo e assim por diante). Carrega `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) e, geralmente, `evaluation` (csharp, go: `Evaluation`) (consulte [como cada chamada foi avaliada](https://platform.claude.com/docs/pt-BR/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.tool_result` | Resultado da execução de uma ferramenta de agente pré-construída. | | `agent.mcp_tool_use` | O agente invoca uma ferramenta de servidor MCP. Carrega `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) e, geralmente, `evaluation` (csharp, go: `Evaluation`) (consulte [como cada chamada foi avaliada](https://platform.claude.com/docs/pt-BR/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.mcp_tool_result` | Resultado da execução de uma ferramenta MCP. | | `agent.custom_tool_use` | O agente invoca uma de suas ferramentas personalizadas. Responda com um evento `user.custom_tool_result`. | | `agent.thread_context_compacted` | O histórico da conversa foi compactado para caber na "context window" (janela de contexto). | | `agent.thread_message_received` | Em uma sessão [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration), uma mensagem de outra thread chegou à thread cujo stream carrega este evento; na thread principal, um agente enviou um relatório ou uma pergunta para o agente que a sessão executa. | | `agent.thread_message_sent` | Em uma sessão [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration), a thread cujo stream carrega este evento enviou uma mensagem para outra thread; na thread principal, o agente que a sessão executa enviou uma tarefa ou mensagem de acompanhamento para outro agente. | O conteúdo das mensagens nesses eventos pode incluir um bloco de conteúdo `redacted`, `{"type": "redacted"}`: um placeholder para conteúdo retido pela política de modelos da Anthropic. O bloco não carrega nenhum outro campo. Blocos redacted aparecem apenas em conteúdo emitido pela plataforma; um evento do usuário que inclua um deles é rejeitado com um erro 400. | Tipo | Descrição | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `session.status_running` | O agente está processando ativamente. | | `session.status_idle` | O agente concluiu sua tarefa atual e está aguardando entrada. Inclui um `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`) indicando por que o agente parou. | | `session.status_rescheduled` | Ocorreu um erro transitório e a sessão está tentando novamente de forma automática. | | `session.status_terminated` | A sessão foi encerrada, seja por causa de um erro irrecuperável ou porque foi arquivada. | | `session.deleted` | A sessão foi excluída. Encerra qualquer stream de eventos ativo; nenhum outro evento é emitido para esta sessão. | | `session.updated` | Uma solicitação de atualização da sessão alterou pelo menos um campo. Inclui apenas os campos que foram alterados. As atualizações se aplicam no próximo turno. | | `session.error` | Ocorreu um erro durante o processamento. Inclui um objeto tipado `error` (csharp, go: `Error`) com um `retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`). | | `session.usage` | Snapshot do uso cumulativo da sessão e do custo de lista rastreado. Carrega os totais de uso da sessão e, se a sessão tiver um, seu [orçamento](https://platform.claude.com/docs/pt-BR/managed-agents/budgets). | | `session.thread_created` | Uma thread [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration) foi criada. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`): o ID da execução para a thread de uma [execução de workflow](https://platform.claude.com/docs/pt-BR/managed-agents/workflow-runs#a-runs-threads), e `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) para qualquer outra thread. | | `session.thread_status_running` | Uma thread da sessão começou a ser executada. Toda sessão emite isso para sua thread principal; em sessões [multiagente](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration), as transições de threads filhas também são replicadas no fluxo principal. | | `session.thread_status_idle` | Uma thread da sessão concluiu seu turno e está aguardando entrada. Inclui `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`). | | `session.thread_status_rescheduled` | Uma thread da sessão encontrou um erro transitório e está tentando novamente de forma automática. | | `session.thread_status_terminated` | Uma thread da sessão foi encerrada e não aceita mais entradas, por exemplo porque foi arquivada ou encontrou um erro irrecuperável. Uma thread do advisor também é encerrada quando sua consulta termina. O servidor arquiva as threads de uma execução de workflow por conta própria. | Em uma sessão cujo agente tem [workflows dinâmicos](https://platform.claude.com/docs/pt-BR/managed-agents/multiagent-orchestration#dynamic-workflows) ativados, estes eventos `workflow_run.*` chegam ao fluxo de eventos da sessão: | Tipo | Descrição | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | Uma execução de workflow foi criada. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), o `name` (csharp, go: `Name`) e a `description` (csharp, go: `Description`) da execução, e `phases` (csharp, go: `Phases`), as fases declaradas para a execução. Um evento de status vem em seguida, embora após uma interrupção possa não vir. | | `workflow_run.status_running` | Uma execução de workflow está em andamento. Enviado quando a execução começa a ser executada, o que pode ocorrer algum tempo após `workflow_run.created`, e novamente quando ela é retomada após uma pausa no orçamento. Uma retomada após uma interrupção pode não enviá-lo. Uma execução que está ociosa desde o início pode receber `workflow_run.status_idle` primeiro. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_idle` | Uma execução de workflow ficou ociosa: foi pausada, por exemplo no orçamento da sessão. Uma pausa após uma interrupção pode não enviá-lo. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_ended` | Uma execução de workflow terminou. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) e `result` (csharp, go: `Result`), cujo `type` (csharp, go: `Type`) indica como a execução terminou. | | `workflow_run.error` | Um erro de uma execução de workflow, ou um início que o servidor recusou. Uma execução que termina em erro o recebe, com o mesmo erro, antes de seu `workflow_run.status_ended`. Inclui `error` (csharp, go: `Error`) e `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), que é `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) quando nenhuma execução foi criada. | | `workflow_run.phase_started` | Uma execução de workflow entrou em uma de suas fases. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) e `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`). | | `workflow_run.phase_ended` | Uma execução de workflow saiu de uma fase. Inclui `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`) e `phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`). | Eventos de span são marcadores de observabilidade que envolvem atividades para rastreamento de tempo e uso. | Tipo | Descrição | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `span.model_request_start` | Uma chamada de inferência do modelo foi iniciada. | | `span.model_request_end` | Uma chamada de inferência do modelo foi concluída. Inclui `model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`) com contagens de tokens. | | `span.outcome_evaluation_start` | A avaliação de [resultado](https://platform.claude.com/docs/pt-BR/managed-agents/define-outcomes) foi iniciada. | | `span.outcome_evaluation_ongoing` | Heartbeat durante uma avaliação de [resultado](https://platform.claude.com/docs/pt-BR/managed-agents/define-outcomes) em andamento. | | `span.outcome_evaluation_end` | Um ciclo de avaliação de [resultado](https://platform.claude.com/docs/pt-BR/managed-agents/define-outcomes) foi concluído. Um resultado `needs_revision` significa que outro ciclo se segue; `satisfied`, `max_iterations_reached`, `failed` e `interrupted` são terminais. | | Tipo | Descrição | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `system.message` | Acrescenta contexto privilegiado em nível de sistema que se aplica ao turno correspondente e a todos os turnos subsequentes. Para os modelos que o aceitam, consulte [Modelos compatíveis](https://platform.claude.com/docs/pt-BR/managed-agents/events-and-streaming#supported-models). Em um modelo principal não compatível, o evento é rejeitado com `model_does_not_support_mid_conversation_system`. | Deltas de eventos são eventos de pré-visualização exclusivos do stream. Eles são emitidos em conexões de stream (em nível de sessão ou por thread) que optam por recebê-los com o parâmetro `event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`), e nunca são persistidos no histórico de eventos da sessão. Consulte [Pré-visualizar respostas com deltas de eventos](https://platform.claude.com/docs/pt-BR/managed-agents/event-deltas) para saber como optar por recebê-los, acumulá-los e reconciliá-los. | Tipo | Descrição | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event_start` | Um evento pré-visualizado começou a ser gerado. Carrega o `type` (csharp, go: `Type`) e o `id` (csharp, go: `ID`) do próximo evento. Exclusivo do stream e nunca persistido. | | `event_delta` | Conteúdo incremental para um evento pré-visualizado, identificado por `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`). Exclusivo do stream e nunca persistido. | ## Worker auto-hospedado Consulte a [Referência de workers auto-hospedados](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-reference) para ver as flags de CLI do `ant beta:worker`, as variáveis de ambiente, os caminhos do sistema de arquivos e as opções dos helpers do SDK dos workers pré-construídos que controlam um ambiente `self_hosted`. ## Tipos de servidores MCP suportados O Claude Managed Agents se conecta a [servidores MCP remotos](https://platform.claude.com/docs/pt-BR/agents-and-tools/remote-mcp-servers) que expõem um endpoint HTTP, ou a servidores MCP privados por meio de [túneis MCP](https://platform.claude.com/docs/pt-BR/agents-and-tools/mcp-tunnels/overview). O servidor deve suportar o transporte HTTP streamable do protocolo MCP; servidores que suportam apenas o transporte SSE descontinuado ainda funcionam por meio de um fallback automático. Consulte [Conector MCP](https://platform.claude.com/docs/pt-BR/managed-agents/mcp-connector) para declarar servidores em um agente. Para mais informações sobre MCP e a construção de servidores MCP, consulte a [documentação do MCP](https://modelcontextprotocol.io). ## Limites de taxa Os endpoints do Managed Agents têm "rate limits" (limites de taxa) por organização: | Operação | Limite | | --------------------------------------------------------------- | ---------------------------- | | Endpoints de criação (como agentes, sessões e ambientes) | 300 requisições por minuto | | Endpoints de leitura (como recuperar, listar e fazer streaming) | 1.200 requisições por minuto | Os [limites de gastos e limites de taxa por nível de uso](https://platform.claude.com/docs/pt-BR/api/rate-limits) em nível de organização também se aplicam. ## Diretrizes de marca Para parceiros que integram o Claude Managed Agents, o uso da marca Claude é opcional. Ao fazer referência ao Claude em seu produto: **Permitido:** * "Claude Agent" (preferido para menus suspensos) * "Claude" (quando dentro de um menu já rotulado como "Agents") * "\{YourAgentName} Powered by Claude" (se você já tiver um nome de agente existente) **Não permitido:** * "Claude Code" ou "Claude Code Agent" * "Claude Cowork" ou "Claude Cowork Agent" * Arte ASCII com a marca Claude Code ou elementos visuais que imitem o Claude Code Seu produto deve manter sua própria marca e não parecer ser o Claude Code, o Claude Cowork ou qualquer outro produto da Anthropic. Para dúvidas sobre conformidade de marca, entre em contato com a [equipe de vendas](https://www.anthropic.com/contact-sales) da Anthropic.