Referência
Tipos de eventos, flags de CLI do worker auto-hospedado, tipos de servidores 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. |
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. |
Worker auto-hospedado
Estas são as flags de CLI ant beta:worker para o worker pré-construído que conduz um ambiente self_hosted. Consulte Sandboxes auto-hospedadas para configurar o ambiente, executar um worker e conhecer as opções do 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 uma sandbox; ela não restringe o bash. |
--max-idle | Quanto tempo esperar após a sessão ficar ociosa com um motivo de parada end_turn antes de encerrar. O padrão é 60s. |
--log-format | Formato de saída de log. Use json para ingestão de logs estruturados. O padrão é text. |
O worker da CLI não monta armazenamentos de memória: uma sessão que anexa um ainda é executada, mas o agente não encontra nada no mount_path do armazenamento e nenhuma alteração é sincronizada de volta ao armazenamento. Para usar armazenamentos de memória em sessões em um ambiente auto-hospedado, execute o worker do SDK em vez disso; consulte Usar armazenamentos de memória.
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?