Conteúdo
Rodar um agente em produção significa montar o loop do agente, a execução de ferramentas, um sandbox e a persistência de estado—tudo por conta própria. Os Claude Managed Agents tiram todo esse fardo das suas mãos: a Anthropic roda tudo para você. Lançado como beta público em 8 de abril de 2026, é um conjunto de APIs combináveis para construir e implantar agentes hospedados na nuvem em escala.
Este artigo cobre, com base em informações oficiais, o que são os Managed Agents, como diferem do Agent SDK auto-hospedado, a memória persistente e o "dreaming", a avaliação baseada em resultados e o multiagente, além dos preços. Os pontos principais logo de início. ① Em vez de "construir o seu próprio loop de agente", você ganha um ambiente totalmente gerenciado onde o Claude pode ler arquivos, executar comandos, navegar na web e rodar código com segurança. ② Possui memória persistente com escopo de workspace (montada em /mnt/memory), que um "dream" pode reorganizar e consolidar. ③ O preço é tokens + $0.08 por hora de sessão.
A Anthropic assume todo o "lado da execução"
— loop, sandbox, estado e memória em infraestrutura gerenciada
/mnt/memoryVocê foca em definir o agente. O preço é tokens + $0.08 por hora de sessão (apenas enquanto roda, medido ao milissegundo).
1. O que são os Managed Agents?
Nas palavras da Anthropic, os Managed Agents são "um conjunto de APIs combináveis para construir e implantar agentes hospedados na nuvem em escala", e a documentação os descreve como um "harness de agente pré-construído e configurável que roda em infraestrutura gerenciada". O ponto central: "Em vez de construir o seu próprio loop de agente, execução de ferramentas e runtime, você ganha um ambiente totalmente gerenciado onde o Claude pode ler arquivos, executar comandos, navegar na web e rodar código com segurança". Cache de prompt, compactação de contexto, sandboxing e persistência de estado já vêm embutidos desde o início.
Está organizado em torno de quatro conceitos—Agent (a definição) / Environment (onde roda) / Session / Events. O Environment pode ser um sandbox em nuvem gerenciado pela Anthropic ou um sandbox auto-hospedado na sua própria infraestrutura.
Ao agente é possível anexar as skills prontas da Anthropic (pptx, xlsx, docx, pdf) e skills que você mesmo cria e envia (até 500 por sessão). Quanto às ferramentas, além do conjunto embutido e dos servidores MCP, também dá para definir "ferramentas personalizadas" (custom tools), executadas pelo seu próprio código.
Aqui, "harness" significa tudo em um agente além do modelo — o loop, as ferramentas, a memória, os controles de segurança e assim por diante. A ideia em si é explicada em O que é Harness Engineering?
2. vs o Agent SDK (auto-hospedado vs gerenciado)
O que é fácil confundir é a diferença em relação ao Claude Agent SDK. Os dois formam um par ao longo do eixo "você roda" vs "a Anthropic roda".
- Seu próprio harness em Python / TypeScript
- Você opera o loop, as ferramentas e o runtime
- A infraestrutura e a escala são sua responsabilidade
- Controle total sobre os detalhes
- Loop, sandbox e estado ficam no lado gerenciado
- Memória persistente e dreaming já vêm embutidos
- Cobrado pelo tempo de execução ($0.08/hora)
- Foque na definição, delegue a operação
Em resumo: "quer construir o seu próprio motor? Agent SDK. Quer alugar o motor e focar no conteúdo? Managed Agents." Não são concorrentes—são uma escolha sobre quanto da operação você mesmo mantém. Para o conceito de agentes, veja o que é multiagente; para construir um, como construir um sistema multiagente.
3. Memória persistente e "dreaming"
Um recurso marcante dos Managed Agents é a memória persistente (um memory store). É "uma coleção de documentos de texto com escopo de workspace", montada como um diretório (/mnt/memory/) dentro do sandbox da sessão. O agente a lê e escreve com operações normais de arquivo, e o conteúdo persiste entre sessões. Cada alteração cria uma versão de memória imutável para auditoria. As versões anteriores ficam guardadas por 30 dias após serem gravadas, mas as versões recentes de uma memória ativa são sempre mantidas, independentemente da idade (uma memória que muda pouco pode guardar histórico com mais de 30 dias). Para manter o histórico por mais tempo, exporte-o pela API. Limites: 100 kB por memória, 10.000 memórias por store, 8 stores por sessão.
Uma observação para desenvolvedores: as APIs de memory stores usam um cabeçalho beta próprio, agent-memory-2026-07-22. Enviá-lo junto com managed-agents-2026-04-01 resulta em erro 400 (vincular um memory store a uma sessão continua usando o cabeçalho de sempre). Em um sandbox auto-hospedado, a memória não é uma montagem conectada o tempo todo: o processo de trabalho mantém uma cópia e a sincroniza (documentação de memory).
Mais incomum é o "dreaming". Conforme a descrição oficial: "Um dream lê um memory store existente junto com transcrições de sessões passadas e então produz um novo memory store reorganizado: duplicatas mescladas, entradas obsoletas ou contraditas substituídas pelo valor mais recente e novos insights trazidos à tona". É um job assíncrono (1–100 sessões de entrada, com instruções opcionais) que exige um cabeçalho beta próprio, dreaming-2026-04-21 (só com managed-agents-2026-04-01 não se acessa os endpoints de dream).
O modelo que executa o dream é escolhido na criação. A documentação de dreams lista nove modelos compatíveis durante a prévia de pesquisa: Claude Opus 5.5, Claude Fable 5.1, Claude Opus 5, Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6 (verificado em 12 de outubro de 2026). Os modelos Haiku não estão na lista, então não podem executar um dream. O dream é cobrado pelas tarifas padrão por token do modelo escolhido.
⚠️ Nota de precisão: o dreaming é um research preview que exige solicitação de acesso. O post de lançamento da Anthropic (19 de maio de 2026) o chama de "processo agendado" e diz que você pode deixá-lo atualizar a memória automaticamente ou revisar as mudanças antes de aplicá-las. Já a documentação da API o descreve como um job assíncrono que você cria e acompanha: ele nunca altera o memory store de entrada e grava um store de saída separado, então você pode descartar o resultado se não gostar. Este artigo não afirma que "a Anthropic sempre o executa automaticamente".
4. Avaliação por resultados e multiagente
Um recurso mais recente é a avaliação baseada em resultados (outcomes-based grading). Segundo a Anthropic: "Você escreve uma rubrica descrevendo como é o sucesso e o agente trabalha em direção a ela. Um avaliador (grader) separado avalia a saída contra os seus critérios na sua própria janela de contexto". A Anthropic relata que isso "melhorou a taxa de sucesso de tarefas em até 10 pontos em relação a um loop de prompting padrão" (+8,4% para docx, +10,1% para pptx). São medições da própria Anthropic — o anúncio as chama de "our internal benchmarks" —, não resultados de terceiros. Beta público.
A orquestração multiagente também já vem embutida: "Um agente líder divide o trabalho em partes e delega cada uma a um especialista com seu próprio modelo, prompt e ferramentas", rodando em paralelo sobre um sistema de arquivos compartilhado. A filosofia de design de orquestrar agentes ecoa como construir um sistema multiagente.
Hoje há três formas de distribuir o trabalho (documentação de multiagente). ① Delegar a subagentes (a delegação tem um único nível e aceita até 25 threads filhas simultâneas). ② Dynamic workflows: o próprio agente escreve um programa que executa vários agentes e junta os resultados, e o servidor o executa (até 1.000 agentes por execução e, por padrão, 10 execuções simultâneas por sessão). ③ Advisor: o agente continua o trabalho por conta própria, mas pede conselho a um modelo superior em momentos como o planejamento ou a revisão final (o conselho é cobrado pela tarifa desse modelo). Em todos os casos, pagam-se os tokens de todos os agentes que rodaram, por isso a Anthropic recomenda definir um limite de gastos na sessão.
5. O que foi adicionado desde o lançamento
Desde o lançamento em 8 de abril de 2026, o Managed Agents ganhou recursos a cada poucas semanas. As datas vêm dos anúncios da Anthropic (as de outubro de 2026, das notas de versão da Claude Platform).
- 23 de abril de 2026 — Memória: os memory stores foram lançados em beta pública.
- 19 de maio de 2026 — Outcomes, orquestração multiagente, webhooks, dreaming: os três primeiros em beta pública e o dreaming como research preview. Você pode ser avisado por webhook quando o trabalho termina.
- 19 de maio de 2026 — Sandboxes auto-hospedados e túneis MCP: só a execução das ferramentas pode ir para a sua própria infraestrutura (ou para um provedor de sandbox como Cloudflare, Daytona, Modal ou Vercel), enquanto o loop, a gestão de contexto e a recuperação de erros ficam com a Anthropic. Os túneis MCP conectam servidores MCP da sua rede privada sem expô-los, como research preview.
- 9 de junho de 2026 — Implantações agendadas e vaults: um agente pode iniciar conforme uma expressão cron e um fuso horário (granularidade de minuto). Para chaves de API guardadas em um vault, o sandbox só tem um valor substituto; a chave real é anexada na fronteira da rede e apenas em requisições a domínios que você permitir, então o agente nunca a vê.
- 7 de outubro de 2026 — Os limites de rede passam a valer para busca e coleta na web: quando um ambiente na nuvem usa a rede
limited, os hosts permitidos (allowed_hosts) agora também valem para as ferramentasweb_searcheweb_fetch. Uma chamada deweb_fetchpara uma URL de um host não permitido retorna um erro, eweb_searchomite resultados desses hosts. Seallowed_hostsestiver vazio, nenhuma das duas retorna páginas nem resultados.allow_package_managerseallow_mcp_serversnão acrescentam hosts para essas duas ferramentas. A redeunrestrictede os sandboxes auto-hospedados não são afetados. Além disso, a criação de uma sessão falha com erro 400 quando oallowed_domainsde uma ferramenta web ativada tem um host fora deallowed_hosts(o mesmo vale para uma atualização de sessão que acrescente essa entrada). Uma entrada deallowed_hostscorresponde a um único host exato, a menos que comece com*.; por isso,docs.example.comnão está dentro de["example.com"]. - 7 de outubro de 2026 — A coleta web só alcança URLs já vistas na sessão:
web_fetchagora só busca URLs que já apareceram na sessão, por exemplo no texto de uma mensagem do usuário, em um resultado deweb_searchou em uma página coletada antes comweb_fetch. O objetivo é reduzir o risco de exfiltração de dados. Uma URL que aparece apenas na saída do próprio Claude, no prompt de sistema, em um documento anexado ou na saída debashou de uma ferramenta MCP não conta, e buscá-la retorna o errourl_not_in_prior_context. Para que o agente busque uma URL, envie-a no texto de um eventouser.message. - 9 de outubro de 2026 — Dynamic workflows (beta): os dynamic workflows da opção ② da seção 4 passaram a estar disponíveis. O agente escreve um programa que executa muitos agentes em fases e junta os resultados, e o servidor o roda em segundo plano como um workflow run. Para ativar, defina o campo
multiagentdo agente com o tipomultiagent_20261001e workflows habilitados, e diga no prompt de sistema quando iniciar uma execução. O andamento aparece nos eventosworkflow_run.*do fluxo de eventos. - 14 de outubro de 2026 — Implantações agendadas passam a funcionar no Claude Platform on AWS: as implantações agendadas, lançadas em junho, agora também podem ser usadas no Claude Platform on AWS (verificado em 18 de outubro de 2026). Na AWS, cada execução cria uma sessão como uma IAM role na sua própria conta AWS. É preciso definir antes o
execution_identitydo agente comoaws_role; criar uma implantação sem isso retorna erro 400. A documentação das implantações agendadas ainda indica o recurso como beta. - 14 de outubro de 2026 — Exportação para OpenTelemetry (beta): as requisições da Messages API e as sessões dos Managed Agents agora podem ser rastreadas via OpenTelemetry e enviadas para a infraestrutura de monitoramento que você já usa (verificado em 18 de outubro de 2026). O SDK do Claude gera spans em Python, TypeScript, C#, Go, Java, PHP e Ruby; para obter os spans do lado da API, adicione um destino de exportação no Claude Console (documentação oficial).
Também dá para definir um teto de gasto por sessão (session budget): o consumo é calculado a preço de tabela e novas chamadas ao modelo param quando o teto é atingido.
6. Preços e disponibilidade
O preço tem duas dimensões: ① tokens (tarifas padrão do modelo, com cache de prompt aplicado) + ② tempo de execução da sessão a $0.08 por hora de sessão. O tempo de execução é medido ao milissegundo e cobrado apenas enquanto o status estiver running (ocioso ou reagendando é gratuito). O exemplo prático da Anthropic: uma sessão de programação de 1 hora que consome 50.000 tokens de entrada e 15.000 de saída custa cerca de $0.705 Esse exemplo usa as tarifas do Claude Opus 5 ($5 de entrada / $25 de saída por milhão de tokens, segundo a página de preços em setembro de 2026).
Abaixo, o mesmo caso recalculado por modelo com as tarifas da página de preços em 12 de outubro de 2026. A coluna da direita reproduz o segundo exemplo da Anthropic, em que 40.000 dos tokens de entrada são leituras de cache (a leitura de cache custa normalmente 0,1× a tarifa de entrada; no Opus 5.5 e no Sonnet 5.5, 0,05×).
| Modelo (entrada / saída por milhão de tokens) | 50.000 de entrada, 15.000 de saída, 1 hora em execução | dos quais 40.000 são leituras de cache |
|---|---|---|
| Claude Opus 5 ($5 / $25) — exemplo da Anthropic | $0.705 | $0.525 |
| Claude Opus 5.5 ($4 / $20) | $0.58 | $0.428 |
| Claude Sonnet 5.5 ($2 / $10) | $0.33 | $0.254 |
| Claude Haiku 4.5 ($1 / $5) | $0.205 | $0.169 |
| Claude Haiku 5.5 ($0.10 / $0.50) — até 100.000 tokens de entrada por requisição | $0.0925 | $0.0889 |
Os $0.08 de execução são iguais em todas as linhas; a diferença vem dos tokens. Quanto mais barato o modelo, maior o peso do tempo de execução na conta (cerca de 40% no Haiku 4.5 e cerca de 90% no Haiku 5.5). Atenção: no Haiku 5.5, quando a entrada de uma única requisição passa de 100.000 tokens, vale uma tarifa mais alta (entrada $0.50, saída $2.50). Em sessões de agentes, em que o contexto vai se acumulando, é fácil ultrapassar esse limite.
Só o tempo de execução por mês é horas por dia × 30 dias × $0.08. Conta apenas o tempo em status running; o tempo idle esperando a sua próxima mensagem não entra. Deixar uma sessão aberta o dia todo só cobra o tempo em que ela realmente trabalha.
| Execução por dia | Tempo de execução por mês (30 dias) | Referência: mesmos tokens a cada hora (Sonnet 5.5) | Idem (Opus 5.5) |
|---|---|---|---|
| 1 hora | $2.40 | $9.90 | $17.40 |
| 4 horas | $9.60 | $39.60 | $69.60 |
| 8 horas | $19.20 | $79.20 | $139.20 |
| 24 horas | $57.60 | $237.60 | $417.60 |
As duas colunas da direita supõem que cada hora consome os mesmos tokens do exemplo acima (50.000 de entrada, 15.000 de saída, sem cache). O consumo real de tokens varia em ordens de grandeza conforme a tarefa, então leia a coluna de execução como um piso e limite o gasto com tokens com um orçamento de sessão.
| Item | Detalhes |
|---|---|
| Lançamento | 8 de abril de 2026 · beta público (habilitado por padrão para todas as contas de API) |
| Acesso | Via Claude Console / Platform CLI / Claude Code |
| Preço | Tokens + $0.08 / hora de sessão (apenas enquanto roda, medido ao ms) |
| Busca na web | Buscas dentro de uma sessão são cobradas pela tarifa padrão (US$ 10 por 1.000 buscas) |
| Descontos | O desconto da Batch API não se aplica (sessões têm estado e são interativas; não há modo batch) |
| Acréscimos | Fixar model.inference_geo do agente em "us" cobra os tokens a 1,1×; definir model.speed como "fast" aplica as tarifas premium do modo rápido |
| Ressalva | Stateful por design, então não elegível para Zero Data Retention (ZDR) nem para um HIPAA BAA |
| Memória / dream | o dreaming é um research preview (exige solicitação de acesso) |
7. Como começar
O quickstart oficial tem quatro etapas. Toda requisição precisa do cabeçalho beta managed-agents-2026-04-01 (o SDK coloca para você).
- Crie um agente: defina o modelo, o prompt de sistema, as ferramentas, os servidores MCP e as skills. O conjunto de ferramentas embutidas (bash, operações com arquivos, busca na web e mais) é ativado com
agent_toolset_20260401. Crie uma vez e reutilize pelo ID. - Crie um ambiente: decida onde ele roda. Em um sandbox na nuvem, informe os pacotes pré-instalados e se o tráfego de saída é livre (
unrestricted) ou restrito a hosts permitidos (limited). Se você omitir isso na API, ficaunrestricted; já a tela de criação do Console começa emlimited. A documentação oficial pede que você defina isso explicitamente. Desde 7 de outubro de 2026, os hosts permitidos delimitedtambém valem para as ferramentas de busca e coleta na web; por isso, adicione aallowed_hostsos sites de que elas precisam (um host adicionado também fica aberto para o sandbox). - Inicie uma sessão: suba a sessão com o agente e o ambiente. É aqui também que você pode definir um teto de gasto (budget).
- Envie eventos e receba os resultados: envie a mensagem do usuário como evento; o Claude usa as ferramentas por conta própria e devolve os resultados via server-sent events (SSE). Dá para mandar mais instruções no meio do caminho ou interromper.
Você também pode escrever o agente e o ambiente em arquivos e criá-los com ant apply na CLI. Para começar pelo Claude Code, execute /claude-api managed-agents-onboard na versão mais recente e um guia interativo conduz a configuração passo a passo (quickstart oficial).
8. Quando serve e quando não serve
Com base na seção "quando usar" da documentação oficial e nas condições da página de preços:
| Se você… | Escolha |
|---|---|
| quer delegar, de forma assíncrona, trabalho que leva de minutos a horas e chama muitas ferramentas | Managed Agents |
| quer rodar algo em uma cadência fixa, como um relatório semanal | As implantações agendadas do Managed Agents |
| não pode enviar código ou arquivos sensíveis a um sandbox externo | Managed Agents com sandbox auto-hospedado |
| quer controlar o loop passo a passo | Seu próprio loop na Messages API, ou o Agent SDK |
| precisa de Zero Data Retention (ZDR) ou de um HIPAA BAA | O Managed Agents não é elegível; monte seu próprio loop |
| quer o desconto da Batch API para grandes volumes | Não disponível no Managed Agents; use o Batch da Messages API |
| quer usar via Amazon Bedrock ou Google Cloud | Não é oferecido no Bedrock nem na versão operada pelo Google (o Vertex AI anterior) Está disponível na Claude Platform on AWS, operada pela Anthropic Também está disponível na versão do Google Cloud operada pela Anthropic (disponibilidade geral em 22 de outubro de 2026), mas o túnel MCP não está disponível As duas versões do Google Cloud são comparadas em Claude no Vertex AI |
Resumo
Os Claude Managed Agents são um ambiente totalmente gerenciado onde a Anthropic opera o loop do agente, a execução de ferramentas, o sandbox e a persistência de estado por você. Onde o Agent SDK auto-hospedado significa "você roda o motor", os Managed Agents significam "a Anthropic roda, e você foca na definição"—uma escolha pareada que difere em onde fica a responsabilidade operacional.
Suas marcas registradas são a memória persistente com escopo de workspace (montada em /mnt/memory, persistindo entre sessões) e o "dreaming" (research preview) para reorganizá-la e consolidá-la, além da avaliação baseada em resultados e da orquestração multiagente. O preço é tokens + $0.08 por hora de sessão, disponível para todas as contas de API como beta público de abril de 2026 (stateful, então não elegível para ZDR / HIPAA BAA). Relacionados: guia do Agent SDK, o que é multiagente, como construir um sistema multiagente.
FAQ
Q. O que são os Managed Agents?
A. O conjunto de APIs da Anthropic para construir e implantar agentes hospedados na nuvem. Em vez de construir o seu próprio loop de agente, execução de ferramentas e runtime, você ganha um ambiente totalmente gerenciado onde o Claude pode ler arquivos, executar comandos, navegar na web e rodar código com segurança. Cache de prompt, compactação, sandboxing e persistência de estado já vêm embutidos. Foi lançado como beta público em 8 de abril de 2026.
Q. Como difere do Agent SDK?
A. Em quem é dono da operação. O Agent SDK é um harness auto-hospedado que você roda em Python / TypeScript, onde você opera o loop, as ferramentas e a infraestrutura. Nos Managed Agents, a Anthropic fornece o loop, o sandbox, o estado e a memória em infraestrutura gerenciada, e você foca em definir o agente. Não são concorrentes—é uma escolha sobre quanto da operação você mantém.
Q. O que são a memória persistente e o "dreaming"?
A. A memória persistente (um memory store) é uma coleção de documentos de texto com escopo de workspace, montada no sandbox como /mnt/memory/; o agente a lê e escreve com operações normais de arquivo e ela persiste entre sessões. O "dreaming" é um job assíncrono que lê a memória existente e as transcrições de sessões passadas para produzir um memory store reorganizado—mesclando duplicatas, atualizando valores obsoletos e trazendo à tona novos insights. O dreaming é atualmente um research preview (exige solicitação de acesso).
Q. Quanto custa?
A. Duas dimensões: cobrança por tokens + tempo de execução da sessão a $0.08 por hora de sessão. O tempo de execução é medido ao milissegundo e cobrado apenas enquanto o status estiver running (ocioso / reagendando é gratuito). A estimativa da Anthropic é de cerca de $0.705 para uma sessão de 1 hora com 50.000 tokens de entrada e 15.000 de saída (com as tarifas do Claude Opus 5: $0.625 em tokens mais $0.08 de tempo de execução). Com as tarifas de 12 de outubro de 2026, o mesmo caso custa $0.58 no Opus 5.5, $0.33 no Sonnet 5.5, $0.205 no Haiku 4.5 e cerca de $0.09 no Haiku 5.5. Só o tempo de execução, com 8 horas por dia em running, dá $19.20 por mês (8 × 30 × $0.08). Os tokens usam as tarifas padrão do modelo com cache de prompt.
Q. Qualquer um pode usar?
A. É um beta público a partir de 8 de abril de 2026, habilitado por padrão para todas as contas de API, acessível via Claude Console / Platform CLI / Claude Code. Mas, por ser stateful por design, não é elegível para Zero Data Retention (ZDR) nem para um HIPAA BAA. Note também que os recursos variam por estágio—o dreaming é um research preview que exige solicitação de acesso (consulte a documentação oficial para o mais recente).