--- 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 zdr: eligibility: not-eligible note: Não é elegível para ZDR, exceto o Managed Agents auto-hospedado. Sessões são recursos com estado; as transcrições persistem até que você as exclua. supportedModels: - claude-fable-5-2 - claude-mythos-5-2 - claude-fable-5-1 - claude-mythos-5-1 - claude-fable-5 - claude-mythos-5 - claude-mythos-preview - claude-opus-5-5 - claude-opus-5 - claude-sonnet-5-5 - claude-sonnet-5 - claude-haiku-5-5 - claude-haiku-4-5-20251001 - claude-opus-4-8 - claude-opus-4-7 - claude-opus-4-6 - claude-sonnet-4-6 - claude-opus-4-5-20251101 - claude-sonnet-4-5-20250929 supportedPlatforms: Claude API: beta Claude Platform on AWS: beta Claude Models on Google Cloud (Anthropic managed): beta --- 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 Models on Google Cloud (Anthropic managed) e no Claude Platform on AWS, com algumas diferenças na disponibilidade de recursos e no comportamento das sessões. Consulte o guia do [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed#claude-managed-agents) ou [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 on 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 serviço do Managed Agents mantém o histórico de eventos, e você pode recuperá-lo integralmente. Envie eventos adicionais do usuário para orientar o agente enquanto ele é executado, 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 * **Serviço auto-hospedado:** Todo o serviço do Managed Agents em sua própria infraestrutura, com o [Claude Managed Agents auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted) * **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. A Anthropic pode refinar os comportamentos 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) obtida no Claude Console. 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. Para habilitá-los, [solicite acesso à prévia de pesquisa](https://claude.com/form/claude-managed-agents). 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 [retenção zero de dados](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). A exceção para a retenção zero de dados é o Claude Managed Agents auto-hospedado, no qual você mesmo armazena esses dados, conforme descrito em [Por quanto tempo os dados são mantidos](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access#how-long-data-is-kept). 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. ## Disponibilidade Managed Agents estão em beta em todos os modelos. ### Suporte da API | Status | Plataformas de nuvem | Modelos | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | | Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Todos os modelos](https://platform.claude.com/docs/pt-BR/models/overview) | ### Cabeçalhos beta obrigatórios [Visão geral dos cabeçalhos beta](https://platform.claude.com/docs/pt-BR/api/beta-headers) Os cabeçalhos beta permitem que você acesse recursos experimentais e novas capacidades de modelos antes que eles se tornem parte da API padrão. * `managed-agents-2026-04-01` ### Tratamento de dados [Visão geral do tratamento de dados](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention#feature-eligibility) | Item | Retenção zero de dados | HIPAA | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | Status | Não elegível | Não elegível | | Detalhes | Não é elegível para ZDR, exceto o Managed Agents auto-hospedado. Sessões são recursos com estado; as transcrições persistem até que você as exclua. [Saiba mais](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | Não é elegível para HIPAA. Aplica-se a todos os sub-recursos do Managed Agents. | Endpoints aplicáveis: * `/v1/agents` * `/v1/sessions` * `/v1/environments`