Agentes GerenciadosPrimeiros passos

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 modelo via prompts	Estrutura de agente pré-construída e configurável que é executada em infraestrutura gerenciada
Ideal para	Loops de agente personalizados e controle refinado	Tarefas de longa duração e trabalho assíncrono
Saiba mais	Documentação da Messages API	Documentação do Claude Managed Agents

O Claude Managed Agents fornece o "harness" (estrutura de execução) 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 a cache de prompt integrado, compactação e outras otimizações de desempenho para saídas de agente eficientes e de alta qualidade.

O Claude Managed Agents também está disponível no Claude Platform on AWS, com algumas diferenças na disponibilidade de recursos e no comportamento de sessão. Consulte Claude Managed Agents no guia do Claude Platform on AWS.

Início rápido

Crie sua primeira sessão de agente

Iniciar uma sessão

Crie uma sessão e envie seu primeiro evento

Referência

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, prompt do sistema, ferramentas, servidores MCP e 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

Criar 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.
Criar um ambiente
Configure onde o agente é executado: um sandbox na nuvem ou um sandbox auto-hospedado em sua própria infraestrutura.
Iniciar uma sessão
Inicie uma sessão que referencia a configuração do seu agente e ambiente.
Enviar eventos e receber respostas via streaming
Envie mensagens do usuário como eventos. O Claude executa ferramentas de forma autônoma e transmite os resultados de volta por meio de "server-sent events" (eventos enviados pelo servidor), ou SSE. O histórico de eventos é persistido no lado do servidor e pode ser recuperado na íntegra.
Orientar ou interromper
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 atender a 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

Ferramentas suportadas

O Claude Managed Agents dá ao Claude acesso a um conjunto de ferramentas integradas:

Bash: Executar comandos de shell no sandbox
Operações de arquivo: Ler, escrever, editar, glob e grep em arquivos no sandbox
Busca e recuperação na web: Pesquisar na web e recuperar conteúdo de URLs
Servidores MCP: Conectar-se a provedores de ferramentas externos

Consulte Ferramentas para ver a lista completa e as opções de configuração.

Acesso beta

O Claude Managed Agents está atualmente 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. Comportamentos podem ser refinados entre versões para melhorar as saídas.

Para começar, você precisa de:

Uma chave de API do Claude
O cabeçalho beta managed-agents-2026-04-01 em 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 é stateful por design: as sessões são de longa duração, retomam 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 "Business Associate Agreement" (Acordo de Associado Comercial), ou BAA, da HIPAA. Você mantém o controle sobre esses dados: pode excluir sessões e, separadamente, excluir quaisquer arquivos que tenha enviado, a qualquer momento por meio da API. Para elegibilidade em 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?

Agentes GerenciadosPrimeiros passos

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 modelo via prompts	Estrutura de agente pré-construída e configurável que é executada em infraestrutura gerenciada
Ideal para	Loops de agente personalizados e controle refinado	Tarefas de longa duração e trabalho assíncrono
Saiba mais	Documentação da Messages API	Documentação do Claude Managed Agents

Início rápido

Crie sua primeira sessão de agente

Iniciar uma sessão

Crie uma sessão e envie seu primeiro evento

Referência

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, prompt do sistema, ferramentas, servidores MCP e 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

Criar 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.
Criar um ambiente
Configure onde o agente é executado: um sandbox na nuvem ou um sandbox auto-hospedado em sua própria infraestrutura.
Iniciar uma sessão
Inicie uma sessão que referencia a configuração do seu agente e ambiente.
Enviar eventos e receber respostas via streaming
Envie mensagens do usuário como eventos. O Claude executa ferramentas de forma autônoma e transmite os resultados de volta por meio de "server-sent events" (eventos enviados pelo servidor), ou SSE. O histórico de eventos é persistido no lado do servidor e pode ser recuperado na íntegra.
Orientar ou interromper
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 atender a 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

Ferramentas suportadas

O Claude Managed Agents dá ao Claude acesso a um conjunto de ferramentas integradas:

Bash: Executar comandos de shell no sandbox
Operações de arquivo: Ler, escrever, editar, glob e grep em arquivos no sandbox
Busca e recuperação na web: Pesquisar na web e recuperar conteúdo de URLs
Servidores MCP: Conectar-se a provedores de ferramentas externos

Consulte Ferramentas para ver 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-01 em 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.

Consulte Limites de taxa e Diretrizes de marca na referência.

Was this page helpful?