Um Claude Managed Agent pode levar anotações entre sessões em um repositório de memória, mas elas podem ficar repetitivas ou desatualizadas. A prévia de pesquisa do Dreams, da Anthropic pode ler um repositório e sessões anteriores e gerar outro repositório como proposta. Este guia mostra a um desenvolvedor com o acesso necessário como executar um Dream manual, conferir o que ele manteve e conectar apenas a memória aceita a uma sessão posterior.

Este procedimento se baseia na documentação e foi conferido com os guias atuais de Managed Agents da Anthropic em 20 de outubro de 2026. A BIG CHANGE não executou um Dream, examinou uma saída real, testou o acesso de uma conta nem mediu custos ou melhorias. O procedimento termina com um repositório revisado usado por uma sessão posterior. Ele não configura execução recorrente, avaliação nem compartilhamento automático de memória com outros agentes.

A grande mudança

  • O que mudou: Um Dream pode sintetizar um repositório de memória existente e de 1 a 100 transcrições de sessões selecionadas em um novo repositório, sem alterar a entrada.
  • Por que importa: A saída separada permite ao responsável comparar anotações novas ou resumidas com as evidências originais antes que outra sessão as leia.
  • No que prestar atenção: O Dreams exige acesso separado à prévia de pesquisa. Um trabalho concluído produz um repositório candidato, não um conjunto aprovado de fatos ou preferências.

Antes de começar

Você precisa de uma conta no Claude Console e de uma chave de API, de um Managed Agent existente com o conjunto de ferramentas do agente, de um ambiente e de acesso à versão beta do Managed Agents descrita no guia de início rápido. Também precisa de acesso separado à prévia de pesquisa do Dreams. O acesso apenas à versão beta do Managed Agents não comprova essa autorização. Confirme-a pelo caminho de acesso ao Dreams antes de enviar a solicitação.

Escolha um repositório de memória existente e de 1 a 100 sessões reais, relevantes e concluídas cujo conteúdo você tenha autorização para processar em conjunto. Se você tem transcrições, mas nenhum repositório, o guia de memória mostra como criar um vazio. Dê a ele um nome e uma descrição que delimitem o escopo. O agente precisa do conjunto de ferramentas documentado para ler ou escrever em um repositório conectado. Conecte o repositório ao criar uma sessão de entrada; uma sessão em execução não pode recebê-lo depois. Use read_write apenas se o agente precisar salvar memória. O padrão é read_write, portanto especifique read_only para material que o agente deva apenas consultar. Confira o mount_path do recurso retornado em vez de tentar adivinhá-lo.

Revise a entrada proposta com as pessoas responsáveis pelos dados. Uma sessão pode conter material de clientes, detalhes privados de projetos ou texto não confiável. A Anthropic alerta que um comando ou resultado de ferramenta controlado por um invasor pode contaminar um repositório gravável e afetar sessões posteriores. Decida quem pode examinar a saída do Dream e quais fatos podem persistir. Mantenha um registro acessível a pessoas das sessões de origem, do conteúdo anterior da memória e das decisões tomadas na revisão.

Execute os exemplos de comandos em um shell compatível com Bash, com cURL que ofereça suporte a --fail-with-body e Python 3 para a correção e a verificação final da sessão. O PowerShell usa outra sintaxe para aspas e variáveis de ambiente, então seus comandos precisam de adaptação. Instale o SDK Python da Anthropic com pip install anthropic , conforme mostra o guia de início rápido . Defina e exporte ANTHROPIC_API_KEY pelo seu método habitual de gestão de segredos, para que cURL e o SDK Python possam usá-la. Defina store_id, session_a, session_b, agent_id e environment_id com os IDs retornados pelo seu próprio espaço de trabalho. Os exemplos usam duas sessões; use de um a 100 IDs de sessões reais. Não deixe a chave em registros ou rascunhos compartilhados. Os cabeçalhos beta exatos importam: chamadas diretas de repositório de memória usam agent-memory-2026-07-22 sozinho; chamadas de sessão usam managed-agents-2026-04-01; chamadas do Dream usam tanto managed-agents-2026-04-01 quanto dreaming-2026-04-21. O guia específico de memória atual informa que combinar os dois primeiros em uma solicitação ao repositório de memória retorna HTTP 400. O SDK da Anthropic define automaticamente os cabeçalhos pertinentes.

Execute e acompanhe um Dream

  1. Leia primeiro o repositório de entrada e as sessões selecionadas. Registre seus IDs reais e os caminhos e conteúdos de memória que importam para sua tarefa. Defina um objetivo restrito de curadoria, como preservar convenções documentadas do projeto e descartar anotações substituídas. Mantenha o repositório e as sessões disponíveis até a execução terminar. O Dream pode falhar se um repositório de entrada for arquivado ou excluído, ou se uma sessão de entrada for excluída, durante a execução.
  2. Crie o Dream com o repositório e as sessões existentes. O modelo documentado neste exemplo é claude-opus-5-5; a Anthropic lista outros modelos compatíveis com a prévia. As instructions opcionais podem orientar a síntese geral e têm limite de 4.096 caracteres. Elas não são uma forma confiável de editar uma frase específica em uma memória.
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/dreams \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21" \
  -H "content-type: application/json" \
  --data '{
    "inputs": [
      {"type": "memory_store", "memory_store_id": "'"$store_id"'"},
      {"type": "sessions", "session_ids": ["'"$session_a"'", "'"$session_b"'"]}
    ],
    "model": "claude-opus-5-5",
    "instructions": "Preserve documented project conventions; drop superseded or one-off notes."
  }'
  1. Salve o ID drm_... retornado como dream_id. Uma resposta pending significa que o trabalho foi criado e colocado na fila. Consulte periodicamente esse mesmo ID até seu estado ser completed, failed ou canceled:
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/dreams/$dream_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21"

Leia status, outputs, usage e error na resposta. O campo outputs pode estar vazio enquanto o Dream aguarda ou por um breve período durante a execução; isso, por si só, não justifica enviar outro trabalho. A Anthropic informa que as execuções podem levar de minutos a horas e são cobradas pelas tarifas padrão de tokens da API do modelo selecionado. O campo usage informa os tokens, mas a cobrança final depende do uso e dos preços reais. Não há custo nem tempo de conclusão medidos para este guia.

Examine e corrija o repositório separado

  1. Quando status chegar a completed, obtenha o memory_store_id da entrada memory_store em outputs e defina-o como output_store_id. Liste as memórias desse repositório com o cabeçalho beta de memória e obtenha as memórias individuais que precisa examinar. Percorra todas as páginas da listagem e confira o conteúdo completo, inclusive caminhos e hashes. Você também pode revisar o repositório no Console.
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories?path_prefix=/" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"

curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"
  1. Compare cada afirmação mantida ou sintetizada com a sessão de origem pertinente e com o repositório antigo. Confira se ela realmente tem respaldo, se pertence ao usuário ou projeto certo e se alguma instrução mais recente a contradiz. Procure segredos, dados pessoais e instruções introduzidas por material não confiável. Registre a decisão de manter, corrigir ou descartar cada memória importante. O Dream não altera nenhum dos dois : nem o repositório de entrada nem as sessões de origem; somente a saída revisada deve seguir adiante.

Para uma correção pontual, obtenha primeiro o content_sha256 atual da memória de saída. Envie seu mem_id real, o hash atualizado e o conteúdo corrigido pelo procedimento documentado de atualização de memória. Uma divergência de hash indica que houve outra escrita: leia novamente, resolva a diferença e tente de novo com o novo hash. A sintaxe abaixo mostra essa precondição. Insira sua correção revisada como corrected_content por meio de um codificador JSON; este exemplo usa Python 3 para escapar o conteúdo com segurança.

Terminal
python3 -c 'import json,os; print(json.dumps({"content": os.environ["corrected_content"], "precondition": {"type": "content_sha256", "content_sha256": os.environ["mem_sha"]}}))' > correction.json

curl -sS --fail-with-body -X POST "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22" \
  -H "content-type: application/json" \
  --data-binary @correction.json

Defina e exporte corrected_content e mem_sha antes da codificação, examine correction.json e mantenha-o no mesmo perímetro de dados privados da memória. Remova a cópia local conforme sua política de retenção após a leitura de confirmação. Releia todas as memórias editadas. Um repositório comporta até 10.000 memórias, cada uma com no máximo 100 kB. Escritas de novas memórias falham no limite do repositório, embora as existentes continuem legíveis e editáveis. Delimite o escopo ou reduza com segurança um repositório cheio antes de depender de uma nova escrita.

Conecte apenas a memória aceita a uma sessão posterior

  1. Quando a saída passar na revisão, crie uma nova sessão com esse repositório. Este exemplo o conecta como read_only, o que serve para uma verificação que não deve alterar o registro revisado. Se o agente precisar adicionar memórias depois, conceda read_write de forma deliberada e revise também essas escritas posteriores.
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  --data '{
    "agent": "'"$agent_id"'",
    "environment_id": "'"$environment_id"'",
    "resources": [
      {"type": "memory_store", "memory_store_id": "'"$output_store_id"'", "access": "read_only"}
    ]
  }'

Confira nos recursos retornados pela nova sessão o ID do repositório pretendido e seu mount_path real. Salve o ID de sessão retornado como new_session_id e exporte essa variável de shell para que o Python possa lê-la. Escreva uma pergunta em linguagem comum sobre um fato mantido cuja fonte você verificou, depois defina-a e exporte-a como memory_question. O fluxo de mensagens do guia de início rápido da Anthropic abre um fluxo de eventos, envia uma user.message, imprime o texto de agent.message e para em session.status_idle. Use essa interface documentada para enviar a pergunta e ler a resposta:

Terminal
python3 - <<'PY'
import os
from anthropic import Anthropic

client = Anthropic()
session_id = os.environ["new_session_id"]
question = os.environ["memory_question"]

with client.beta.sessions.events.stream(session_id) as stream:
    client.beta.sessions.events.send(
        session_id,
        events=[{"type": "user.message", "content": [{"type": "text", "text": question}]}],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                if block.type == "text":
                    print(block.text, end="")
        elif event.type == "session.status_idle":
            print()
            break
PY

Compare a resposta recebida pelo fluxo tanto com o texto armazenado quanto com a sessão original. Uma resposta plausível não basta se não puder ser rastreada até essa evidência. Registre o ID do Dream, o ID do repositório de saída aceito, as decisões de comparação, o ID da nova sessão e o resultado. Mantenha o repositório de entrada até o substituto passar nessa verificação.

Se a criação retornar um erro de acesso ou validação, confira a autorização para a prévia de pesquisa, os IDs exatos de entrada e o número de sessões antes de alterar a solicitação. Se uma execução ainda estiver pendente ou em andamento, continue consultando seu ID. Uma execução failed ou canceled pode deixar um repositório de saída parcial; examine o erro e não conecte esse repositório como memória aprovada. Se uma sessão posterior não conseguir usar a memória aceita, confira os recursos e o caminho de montagem dessa sessão. Não é possível adicionar um repositório a uma sessão já em execução.

Alterações na memória criam versões. A Anthropic informa que versões comuns são mantidas por 30 dias, com algumas versões recentes de uma memória existente preservadas por mais tempo. Excluir uma memória atual não remove seu histórico retido. Para restaurar uma versão anterior retida, leia-a e atualize a memória existente ou recrie uma excluída; não há uma chamada de restauração separada. Exporte o histórico necessário antes de terminar seu período de retenção e use o procedimento documentado de supressão para conteúdo histórico sensível. Arquivar um repositório é irreversível, torna-o somente leitura e impede novas conexões. Excluí-lo remove permanentemente suas memórias e versões. Tome qualquer uma dessas decisões de retenção segundo a política do responsável pelos dados, depois de verificar a sessão posterior.

Para uma tarefa anterior e distinta de Managed Agents, veja nosso guia de revisão paralela de documentos. Nossa cobertura do Hy Memory 2.0 trata de um SDK de memória separado e de seu próprio fluxo de recuperação com escopo delimitado.

Fontes e leituras complementares

  • O guia de Dreams da Anthropic documenta acesso à prévia de pesquisa, entradas, solicitações de criação e consulta de estado, estados, saída separada, cobrança e comportamento em falhas. Sua afirmação mais ampla sobre os cabeçalhos beta do repositório de memória conflita com o guia específico de memória atual; use este último para chamadas diretas ao repositório de memória.
  • O guia de memória da Anthropic documenta criação de repositório, conexão à sessão, cabeçalho específico de memória, listagem, edições protegidas por hash, versões e retenção. Ele alerta sobre contaminação de repositórios graváveis e sobre arquivamento e exclusão irreversíveis.
  • O guia de início rápido de Managed Agents da Anthropic explica os pré-requisitos de conta, chave de API, agente, ambiente e sessão. Nenhuma dessas páginas comprova uma execução observada ou ganho de qualidade neste guia.