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 seguem a convenção de nomenclatura {domain}.{action}. Consulte Stream de eventos de sessão para enviar, fazer streaming e listar eventos.
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 aguardar 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 solicitações por minuto |
| Endpoints de leitura (como recuperar, listar e fazer streaming) | 600 solicitações por minuto |
Limites de gastos e limites de taxa baseados em nível 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?