Referência
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.
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.
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 para enviar, fazer streaming e listar eventos. Os tipos de eventos de webhook estão listados separadamente em Assinar webhooks, 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. |
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 para o agente buscar alcançar. |
user.tool_result | Somente para sessões com ambientes 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 e, geralmente, evaluation (consulte como cada chamada foi avaliada). |
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 e, geralmente, evaluation (consulte como cada chamada foi avaliada). |
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, 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, 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 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 com um retry_status. |
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. |
session.thread_created | Uma thread multiagente foi criada. Inclui workflow_run_id: o ID da execução para a thread de uma execução de workflow, e None 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, 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. |
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 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, o name e a description da execução, e 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. |
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. |
workflow_run.status_ended | Uma execução de workflow terminou. Inclui workflow_run_id e result, cujo 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 e workflow_run_id, que é None 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 e workflow_run_phase_id. |
workflow_run.phase_ended | Uma execução de workflow saiu de uma fase. Inclui workflow_run_id, workflow_run_phase_id e phase_started_id. |
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 com contagens de tokens. |
span.outcome_evaluation_start | A avaliação de resultado foi iniciada. |
span.outcome_evaluation_ongoing | Heartbeat durante uma avaliação de resultado em andamento. |
span.outcome_evaluation_end | Um ciclo de avaliação de resultado 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. 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, e nunca são persistidos no histórico de eventos da sessão. Consulte Pré-visualizar respostas com deltas de eventos 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 e o 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. Exclusivo do stream e nunca persistido. |
Worker auto-hospedado
Consulte a Referência de workers auto-hospedados 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 que expõem um endpoint HTTP, ou a servidores MCP privados por meio de túneis MCP. 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 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.
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 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 da Anthropic.
Was this page helpful?