--- title: Visão geral do Claude Managed Agents url: https://platform.claude.com/docs/pt-BR/managed-agents/overview description: 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. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- 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](https://platform.claude.com/docs/pt-BR/build-with-claude/working-with-messages). O Claude Managed Agents também está disponível no Claude Platform na AWS, com algumas diferenças na disponibilidade de recursos e no comportamento das sessões. Consulte [Claude Managed Agents](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws#claude-managed-agents) no guia do Claude Platform na AWS. 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 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. [Configure onde o agente é executado](https://platform.claude.com/docs/pt-BR/managed-agents/choosing-an-environment): um sandbox na nuvem ou um [sandbox auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes) em sua própria infraestrutura. Inicie uma sessão que referencie a configuração do seu agente e do seu ambiente. 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. 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](https://platform.claude.com/docs/pt-BR/managed-agents/scheduled-deployments) ## 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](https://platform.claude.com/docs/pt-BR/managed-agents/tools) para a lista completa e as opções de configuração. ## Acesso beta O Claude Managed Agents está em beta. Todos os endpoints do Managed Agents exigem o cabeçalho beta `managed-agents-2026-04-01`. O SDK define o cabeçalho beta automaticamente. Os comportamentos podem ser refinados entre versões para melhorar as saídas. Para começar, você precisa de: 1. Uma [chave de API do Claude](https://platform.claude.com/settings/keys) 2. O cabeçalho beta `managed-agents-2026-04-01` em todas as requisições 3. Acesso ao Claude Managed Agents (habilitado por padrão para todas as contas de API) Dentro do beta, os [túneis MCP](https://platform.claude.com/docs/pt-BR/agents-and-tools/mcp-tunnels/overview) e o [dreaming](https://platform.claude.com/docs/pt-BR/managed-agents/dreams) estão em uma prévia de pesquisa mais limitada. [Solicite acesso](https://claude.com/form/claude-managed-agents) 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](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) nem para cobertura de HIPAA Business Associate Agreement (BAA). Você mantém o controle sobre esses dados: você pode [excluir sessões](https://platform.claude.com/docs/pt-BR/managed-agents/session-operations#deleting-a-session) e, separadamente, excluir quaisquer [arquivos](https://platform.claude.com/docs/pt-BR/build-with-claude/files#delete-a-file) que tenha enviado, a qualquer momento por meio da API. Para a elegibilidade de todos os recursos, consulte [API e retenção de dados](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention#feature-eligibility). Consulte [Limites de taxa](https://platform.claude.com/docs/pt-BR/managed-agents/reference#rate-limits) e [Diretrizes de marca](https://platform.claude.com/docs/pt-BR/managed-agents/reference#branding-guidelines) na referência.