Visão geral do Claude Managed Agents
Harness de agente pré-construído e configurável que é executado em infraestrutura gerenciada. Ideal para tarefas de longa duração e trabalho assíncrono.
A Anthropic oferece duas maneiras de construir com o Claude, cada uma adequada a diferentes casos de uso:
| Messages API | Claude Managed Agents | |
|---|---|---|
| O que é | Acesso direto ao prompting do modelo | Harness de agente pré-construído e configurável que é executado em infraestrutura gerenciada |
| Ideal para | Loops de agente personalizados e controle refinado | Tarefas de longa duração e trabalho assíncrono |
O Claude Managed Agents fornece o harness e a infraestrutura para executar o Claude como um agente autônomo. Em vez de construir seu próprio loop de agente, execução de ferramentas e runtime, você obtém um ambiente totalmente gerenciado onde o Claude pode ler arquivos, executar comandos, navegar na web e executar código com segurança. O harness oferece suporte integrado a "prompt caching" (cache de prompt), compactação e outras otimizações de desempenho para saídas de agente eficientes e de alta qualidade. Para construir seu próprio loop de agente com acesso direto ao modelo, consulte Usando a Messages API.
Crie sua primeira sessão de agente
Crie uma sessão e envie seu primeiro evento
Tipos de eventos, limites de taxa, flags de CLI e outras tabelas de consulta
Conceitos principais
O Claude Managed Agents é construído em torno de quatro conceitos:
| Conceito | Descrição |
|---|---|
| Agent (agente) | O modelo, o prompt do sistema, as ferramentas, os servidores MCP e as skills |
| Environment (ambiente) | Configuração de onde as sessões são executadas: um sandbox em nuvem gerenciado pela Anthropic ou um sandbox auto-hospedado em sua própria infraestrutura |
| Session (sessão) | Uma instância de agente em execução dentro de um ambiente, realizando uma tarefa específica e gerando saídas |
| Events (eventos) | Mensagens trocadas entre sua aplicação e o agente (turnos do usuário, resultados de ferramentas, atualizações de status) |
Como funciona
Crie um agente
Defina o modelo, o prompt do sistema, as ferramentas, os servidores MCP e as skills. Crie o agente uma vez e referencie-o por ID em várias sessões.
Crie um ambiente
Configure onde o agente é executado: um sandbox na nuvem ou um sandbox auto-hospedado em sua própria infraestrutura.
Inicie uma sessão
Inicie uma sessão que referencie a configuração do seu agente e do seu ambiente.
Envie eventos e receba respostas por streaming
Envie mensagens do usuário como eventos. O Claude executa ferramentas de forma autônoma e transmite os resultados de volta por streaming através de "server-sent events" (eventos enviados pelo servidor), ou SSE. O histórico de eventos é persistido no lado do servidor e pode ser recuperado integralmente.
Direcione ou interrompa
Envie eventos de usuário adicionais para orientar o agente durante a execução, ou interrompa-o para mudar de direção.
Quando usar o Claude Managed Agents
O Claude Managed Agents é ideal para cargas de trabalho que precisam de:
- Execução de longa duração: Tarefas que são executadas por minutos ou horas com múltiplas chamadas de ferramentas
- Infraestrutura em nuvem: Sandboxes seguros com pacotes pré-instalados e acesso à rede
- Execução auto-hospedada: Sandboxes em infraestrutura que você controla, para requisitos de conformidade ou residência de dados
- Infraestrutura mínima: Sem necessidade de construir seu próprio loop de agente, sandbox ou camada de execução de ferramentas
- Sessões com estado: Sistemas de arquivos persistentes e histórico de conversas em múltiplas interações
- Execução agendada: Execuções recorrentes de agentes em um cronograma cron por meio de implantações agendadas
Ferramentas suportadas
O Claude Managed Agents dá ao Claude acesso a um conjunto de ferramentas integradas:
- Bash: Execute comandos de shell no sandbox
- Operações de arquivo: Leia, escreva, edite, faça glob e grep em arquivos no sandbox
- Busca e fetch na web: Pesquise na web e recupere conteúdo de URLs, opcionalmente restrito a uma lista de permissão ou lista de bloqueio de domínios
- Servidores MCP: Conecte-se a provedores de ferramentas externos
Consulte Ferramentas para a lista completa e as opções de configuração.
Acesso beta
Para começar, você precisa de:
- Uma chave de API do Claude
- O cabeçalho beta
managed-agents-2026-04-01em todas as requisições - Acesso ao Claude Managed Agents (habilitado por padrão para todas as contas de API)
Dentro do beta, os túneis MCP e o dreaming estão em uma prévia de pesquisa mais limitada. Solicite acesso para habilitá-los.
O Claude Managed Agents é projetado para manter estado: as sessões são de longa duração, são retomadas de forma limpa após pausas e armazenam o histórico de conversas, o estado do sandbox e as saídas no lado do servidor. Por isso, o Managed Agents atualmente não é elegível para Zero Data Retention nem para cobertura de HIPAA Business Associate Agreement (BAA). Você mantém o controle sobre esses dados: você pode excluir sessões e, separadamente, excluir quaisquer arquivos que tenha enviado, a qualquer momento por meio da API. Para a elegibilidade de todos os recursos, consulte API e retenção de dados.
Consulte Limites de taxa e Diretrizes de marca na referência.
Was this page helpful?