Um Claude Managed Agent pode transportar notas entre sessões num repositório de memória, mas estas podem tornar-se repetitivas ou desatualizadas. A pré-visualização de investigação do Dreams, da Anthropic pode ler um repositório e sessões anteriores e produzir um repositório separado como proposta. Este guia mostra a um programador com o acesso necessário como executar um Dream manual, verificar o que foi conservado e associar apenas a memória aceite a uma sessão posterior.

Este procedimento baseia-se na documentação e foi confrontado com os guias atuais de Managed Agents da Anthropic em 20 de outubro de 2026. A BIG CHANGE não executou um Dream, examinou resultados reais, testou o acesso de uma conta nem mediu custos ou melhorias. O procedimento termina com um repositório revisto utilizado por uma sessão posterior. Não configura execuções recorrentes, classificação nem partilha automática 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 entre 1 e 100 transcrições de sessões selecionadas num novo repositório, sem alterar a entrada.
  • Porque importa: O resultado separado permite ao responsável comparar notas novas ou resumidas com as provas originais antes de outra sessão as ler.
  • A que prestar atenção: O Dreams exige acesso separado à pré-visualização de investigação. Uma tarefa concluída produz um repositório candidato, não um conjunto aprovado de factos ou preferências.

Antes de começar

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 iniciação. Precisa também de acesso separado à pré-visualização de investigação do Dreams. A versão beta do Managed Agents, por si só, não comprova essa autorização. Confirme-a através da via de acesso ao Dreams antes de enviar o pedido.

Escolha um repositório de memória existente e entre 1 e 100 sessões reais, relevantes e concluídas cujo conteúdo esteja autorizado a processar em conjunto. Se tem transcrições, mas não um repositório, o guia de memória mostra como criar um vazio. Dê-lhe um nome e uma descrição com âmbito delimitado. O agente precisa do conjunto de ferramentas documentado para ler ou escrever num repositório associado. Associe o repositório ao criar uma sessão de entrada; não é possível acrescentá-lo posteriormente a uma sessão em execução. Use read_write apenas se o agente precisar de guardar memória. A predefinição é read_write, pelo que deve especificar read_only para material que o agente deva apenas consultar. Verifique o mount_path do recurso devolvido, em vez de o tentar adivinhar.

Reveja a entrada proposta com as pessoas responsáveis pelos dados. Uma sessão pode conter material de clientes, pormenores privados de projetos ou texto não fiável. A Anthropic alerta que uma instrução ou resultado de ferramenta controlado por um atacante pode contaminar um repositório com escrita e afetar sessões posteriores. Decida quem pode examinar o resultado do Dream e que factos podem persistir. Mantenha um registo 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 numa shell compatível com Bash, com cURL que suporte --fail-with-body e Python 3 para a correção e a verificação final da sessão. O PowerShell utiliza uma sintaxe diferente para aspas e variáveis de ambiente, pelo que os comandos têm de ser adaptados. Instale o SDK Python da Anthropic com pip install anthropic , como mostra o guia de iniciação . Defina e exporte ANTHROPIC_API_KEY através do seu método habitual de gestão de segredos, para que cURL e o SDK Python a possam utilizar. Defina store_id, session_a, session_b, agent_id e environment_id com os identificadores devolvidos pelo seu próprio espaço de trabalho. Os exemplos usam duas sessões; utilize entre um e 100 identificadores reais de sessão. Não deixe a chave em registos ou rascunhos partilhados. Os cabeçalhos beta exatos são importantes: as chamadas diretas ao repositório de memória usam agent-memory-2026-07-22 isoladamente; as chamadas de sessão usam managed-agents-2026-04-01; as chamadas do Dream usam managed-agents-2026-04-01 e dreaming-2026-04-21. O guia específico de memória atual indica que combinar os dois primeiros num pedido ao repositório de memória devolve HTTP 400. O SDK da Anthropic define automaticamente os cabeçalhos adequados.

Execute e acompanhe um Dream

  1. Leia primeiro o repositório de entrada e as sessões selecionadas. Registe os identificadores reais e os caminhos e conteúdos da memória relevantes para a tarefa. Defina um objetivo restrito de seleção, como preservar convenções documentadas do projeto e eliminar notas 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 eliminado, ou se uma sessão de entrada for eliminada, 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 enumera outros modelos suportados na pré-visualização. As instructions opcionais podem orientar a síntese geral e têm um limite de 4096 carateres. Não são uma forma fiável de editar uma frase específica numa 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. Guarde o identificador drm_... devolvido como dream_id. Uma resposta pending significa que a tarefa foi criada e colocada em fila. Consulte periodicamente esse mesmo identificador até o 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 está pendente ou por breves instantes durante a execução; isso, por si só, não justifica submeter outra tarefa. A Anthropic indica que as execuções podem demorar de minutos a horas e são cobradas às tarifas normais de tokens da API do modelo selecionado. O campo usage apresenta os tokens, mas o custo final depende da utilização 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 atingir 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 de examinar. Percorra todas as páginas da listagem e examine o conteúdo completo, incluindo caminhos e hashes. Também pode rever 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 conservada ou sintetizada com a respetiva sessão de origem e com o repositório antigo. Verifique se tem realmente fundamento, se pertence ao utilizador ou projeto certo e se alguma instrução mais recente a contradiz. Procure segredos, dados pessoais e instruções introduzidas através de material não fiável. Registe 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; só o resultado revisto deve avançar.

Para uma correção pontual, obtenha primeiro o content_sha256 atual da memória de saída. Submeta o seu mem_id real, o hash atualizado e o conteúdo corrigido através da atualização de memória documentada. Uma divergência de hash indica que ocorreu outra escrita: leia novamente, resolva a diferença e tente de novo com o novo hash. A sintaxe seguinte mostra essa pré-condição. Introduza a correção revista como corrected_content através de um codificador JSON; este exemplo usa Python 3 para escapar o conteúdo em 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 segundo a sua política de conservação depois da leitura de confirmação. Volte a ler todas as memórias editadas. Um repositório admite até 10 000 memórias, cada uma com um máximo de 100 kB. A escrita de novas memórias falha ao atingir o limite, embora as existentes continuem legíveis e editáveis. Delimite o âmbito ou reduza em segurança um repositório cheio antes de depender de uma nova escrita.

Associe apenas a memória aceite a uma sessão posterior

  1. Quando o resultado passar na revisão, crie uma nova sessão com esse repositório. Este exemplo associa-o como read_only, adequado a uma verificação que não deve alterar o registo revisto. Se o agente precisar de acrescentar memórias mais tarde, conceda read_write deliberadamente e reveja 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"}
    ]
  }'

Verifique nos recursos devolvidos pela nova sessão o identificador do repositório pretendido e o respetivo mount_path real. Guarde o identificador de sessão devolvido como new_session_id e exporte essa variável da shell para que o Python a possa ler. Escreva uma pergunta em linguagem corrente sobre um facto conservado cuja fonte verificou; depois, defina-a e exporte-a como memory_question. O fluxo de mensagens do guia de iniciação da Anthropic abre um fluxo de eventos, envia uma user.message, apresenta 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 com o texto guardado e com a sessão original. Uma resposta plausível não basta se não for possível ligá-la a essas provas. Registe o identificador do Dream, o do repositório de saída aceite, as decisões de comparação, o identificador da nova sessão e o resultado. Mantenha o repositório de entrada até o substituto passar nesta verificação.

Se a criação devolver um erro de acesso ou validação, verifique a autorização da pré-visualização de investigação, os identificadores exatos de entrada e o número de sessões antes de alterar o pedido. Se a execução continuar pendente ou em curso, continue a consultar o seu identificador. Uma execução failed ou canceled pode deixar um repositório de saída parcial; examine o erro e não associe esse repositório como memória aprovada. Se uma sessão posterior não conseguir utilizar a memória aceite, verifique os recursos e o caminho de montagem dessa sessão. Não é possível acrescentar um repositório a uma sessão já em execução.

As alterações à memória criam versões. A Anthropic indica que as versões normais são conservadas durante 30 dias, sendo algumas versões recentes de uma memória existente conservadas por mais tempo. Eliminar uma memória atual não remove o histórico conservado. Para restaurar uma versão anterior conservada, leia-a e atualize a memória existente ou recrie uma eliminada; não existe uma chamada de restauro separada. Exporte o histórico necessário antes de terminar o prazo de conservação e use a via documentada de ocultação para conteúdo histórico sensível. Arquivar um repositório é irreversível, torna-o só de leitura e impede novas associações. Eliminá-lo remove permanentemente as memórias e versões. Tome qualquer uma destas decisões de conservaçã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, consulte o nosso guia de revisão paralela de documentos. A nossa cobertura do Hy Memory 2.0 trata de um SDK de memória separado e do respetivo fluxo de recuperação com âmbito delimitado.

Fontes e leituras adicionais

  • O guia de Dreams da Anthropic documenta acesso à pré-visualização de investigação, entradas, pedidos de criação e consulta de estado, estados, resultado separado, faturação e comportamento em falhas. A sua afirmação mais geral sobre os cabeçalhos beta do repositório de memória contradiz o guia específico 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órios, associação a sessões, cabeçalho específico de memória, listagem, edições protegidas por hash, versões e conservação. Alerta para a contaminação de repositórios com escrita e para o arquivo e a eliminação irreversíveis.
  • O guia de iniciação de Managed Agents da Anthropic explica os pré-requisitos de conta, chave de API, agente, ambiente e sessão. Nenhuma destas páginas comprova uma execução observada ou melhoria de qualidade neste guia.