Agentes GerenciadosReferência

Referência

Tipos de eventos, flags da CLI do worker auto-hospedado, tipos de servidores MCP suportados, limites de taxa e diretrizes de marca para Claude Managed Agents.

Esta página reúne material de referência para 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.

As requisições da API de Managed Agents exigem o cabeçalho beta managed-agents-2026-04-01, exceto os endpoints de memory store, que usam agent-memory-2026-07-22 em vez disso. O SDK define o cabeçalho beta correto automaticamente. Consulte Cabeçalhos beta.

Tipos de eventos

As strings de tipos de eventos persistidos seguem uma convenção de nomenclatura {domain}.{action}; os deltas de eventos exclusivos de stream (consulte a aba Deltas de eventos) são a exceção. Consulte Stream de eventos da sessão para enviar, fazer streaming e listar eventos.

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.
`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 MCP quando uma política de permissão exige confirmação.
`user.define_outcome`	Define um resultado para o agente trabalhar em direção a ele.
`user.tool_result`	Apenas 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.

Worker auto-hospedado

Estas são as flags da CLI ant beta:worker para o worker pré-construído que opera um ambiente self_hosted. Consulte Sandboxes auto-hospedados para configurar o ambiente, executar um worker e as opções de helper do SDK.

Flag	Descrição
`--environment-id`	O ambiente a ser consultado em busca de trabalho. Também lê de `ANTHROPIC_ENVIRONMENT_ID`.
`--environment-key`	Autentica o worker com este ambiente. Também lê de `ANTHROPIC_ENVIRONMENT_KEY`.
`--workdir`	Diretório onde as skills são baixadas e as ferramentas leem e gravam arquivos. O padrão é `.` (o diretório atual); o diretório de trabalho padrão do sistema é `/workspace`.
`--on-work`	Script a ser chamado para cada item de trabalho reivindicado em vez de executar ferramentas no próprio processo. Recebe os detalhes da sessão como variáveis de ambiente.
`--unrestricted-paths`	Permite que as ferramentas de arquivo leiam e gravem caminhos fora de `--workdir`. A verificação do workdir é uma proteção apenas para as ferramentas de arquivo, não um sandbox; ela não restringe o bash.
`--max-idle`	Quanto tempo esperar depois que a sessão fica ociosa com um motivo de parada `end_turn` antes de encerrar. O padrão é `60s`.
`--log-format`	Formato de saída do log. Use `json` para ingestão de logs estruturados. O padrão é `text`.

Tipos de servidores MCP suportados

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 com streaming 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 de Managed Agents têm "rate limit" (limite de taxa) por organização:

Operação	Limite
Endpoints de criação (como agentes, sessões e ambientes)	300 solicitações por minuto
Endpoints de leitura (como recuperar, listar e fazer stream)	1.200 solicitaçõ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 Claude Managed Agents, o uso da marca Claude é opcional. Ao referenciar 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?

Agentes GerenciadosReferência

Referência

Tipos de eventos, flags da CLI do worker auto-hospedado, tipos de servidores MCP suportados, limites de taxa e diretrizes de marca para Claude Managed Agents.

Tipos de eventos

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.
`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 MCP quando uma política de permissão exige confirmação.
`user.define_outcome`	Define um resultado para o agente trabalhar em direção a ele.
`user.tool_result`	Apenas 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.

Worker auto-hospedado

Flag	Descrição
`--environment-id`	O ambiente a ser consultado em busca de trabalho. Também lê de `ANTHROPIC_ENVIRONMENT_ID`.
`--environment-key`	Autentica o worker com este ambiente. Também lê de `ANTHROPIC_ENVIRONMENT_KEY`.
`--workdir`	Diretório onde as skills são baixadas e as ferramentas leem e gravam arquivos. O padrão é `.` (o diretório atual); o diretório de trabalho padrão do sistema é `/workspace`.
`--on-work`	Script a ser chamado para cada item de trabalho reivindicado em vez de executar ferramentas no próprio processo. Recebe os detalhes da sessão como variáveis de ambiente.
`--unrestricted-paths`	Permite que as ferramentas de arquivo leiam e gravem caminhos fora de `--workdir`. A verificação do workdir é uma proteção apenas para as ferramentas de arquivo, não um sandbox; ela não restringe o bash.
`--max-idle`	Quanto tempo esperar depois que a sessão fica ociosa com um motivo de parada `end_turn` antes de encerrar. O padrão é `60s`.
`--log-format`	Formato de saída do log. Use `json` para ingestão de logs estruturados. O padrão é `text`.

Tipos de servidores MCP suportados

Para mais informações sobre MCP e a construção de servidores MCP, consulte a documentação do MCP.

Limites de taxa

Os endpoints de Managed Agents têm "rate limit" (limite de taxa) por organização:

Operação	Limite
Endpoints de criação (como agentes, sessões e ambientes)	300 solicitações por minuto
Endpoints de leitura (como recuperar, listar e fazer stream)	1.200 solicitaçõ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 Claude Managed Agents, o uso da marca Claude é opcional. Ao referenciar 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

Was this page helpful?

Tipos de eventos

Worker auto-hospedado

Tipos de servidores MCP suportados

Limites de taxa

Diretrizes de marca

Tipos de eventos

Worker auto-hospedado

Tipos de servidores MCP suportados

Limites de taxa

Diretrizes de marca

Tipos de eventos

Worker auto-hospedado

Tipos de servidores MCP suportados

Limites de taxa

Diretrizes de marca

Tipos de eventos

Worker auto-hospedado

Tipos de servidores MCP suportados

Limites de taxa

Diretrizes de marca