Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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.
Todas as requisições à Managed Agents API exigem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.
As strings de tipo de evento persistidas seguem a 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 de sessão para enviar, fazer streaming e listar eventos.
| Tipo | Descrição |
|---|---|
user.message | Uma mensagem de usuário com conteúdo de texto. |
user.interrupt | Interrompe o agente no meio da execução. |
user.custom_tool_result | Resposta a uma chamada de ferramenta personalizada do 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 resultados de agent_toolset. Os helpers do SDK e a CLI fazem isso automaticamente. |
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 processo. Recebe detalhes da sessão como variáveis de ambiente. |
--unrestricted-paths | Permite que chamadas de ferramentas acessem caminhos fora de --workdir. |
--max-idle | Quanto tempo esperar após a sessão ficar ociosa com um stop reason end_turn antes de encerrar. O padrão é 60s. |
--log-format | Formato de saída de log. Use json para ingestão de log estruturado. O padrão é text. |
Claude Managed Agents conecta-se a servidores MCP remotos que expõem um endpoint HTTP, ou a servidores MCP privados através de túneis MCP. O servidor deve suportar o transporte HTTP com streaming do protocolo MCP. Consulte Conector MCP para declarar servidores em um agente.
Para mais informações sobre MCP e construção de servidores MCP, consulte a documentação do MCP.
Os endpoints de Managed Agents têm limite 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 stream) | 1.200 requisições por minuto |
Limites de gastos e limites de taxa por nível de uso no nível da organização também se aplicam.
Para parceiros que integram Claude Managed Agents, o uso da marca Claude é opcional. Ao referenciar Claude em seu produto:
Permitido:
Não permitido:
Seu produto deve manter sua própria marca e não parecer ser Claude Code, 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?