O MUNDO NÃO ESTÁ PARADO.RSS
BIG CHANGE.

Edição em Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Revise um repositório de memória do Claude Managed Agent com um Dream

> Execute um Claude Dream manual sobre sessões autorizadas, examine e corrija seu repositório de memória separado e conecte apenas a memória revisada a uma sessão posterior.

By BIG CHANGE Editorial

Published: 2026-10-20T01:54:53.933Z
Updated: 2026-10-20T01:54:53.933Z
Canonical: https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide

![Conceptual charcoal illustration of one reviewer at a desktop monitor comparing two separate areas of indistinct text; one line on the right is orange.](https://bigchange.ai/api/media/file/claude-dream-reviewed-memory-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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](https://platform.claude.com/docs/en/managed-agents/dreams) 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](https://platform.claude.com/docs/en/managed-agents/quickstart). 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](https://platform.claude.com/docs/en/managed-agents/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](https://platform.claude.com/docs/en/managed-agents/memory#create-a-memory-store) 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](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk) . 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](https://platform.claude.com/docs/en/managed-agents/dreams#create-a-dream). 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.

```bash
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."
  }'
```

3. 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`:

```bash
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

4. 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.

```bash
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"
```

5. 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](https://platform.claude.com/docs/en/managed-agents/memory#update-a-memory). 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.

```bash
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

6. 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.

```bash
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](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session) 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:

```bash
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](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide). Nossa [cobertura do Hy Memory 2.0](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) 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](https://platform.claude.com/docs/en/managed-agents/dreams) 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](https://platform.claude.com/docs/en/managed-agents/memory) 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](https://platform.claude.com/docs/en/managed-agents/quickstart) 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.

## Sources

- [Anthropic Dreams](https://platform.claude.com/docs/en/managed-agents/dreams) — Acesso à prévia de pesquisa, um repositório de entrada e de 1 a 100 sessões, comportamento de criação/consulta/estado/saída, modelos compatíveis, instruções opcionais, cobrança e erros. Sua afirmação genérica sobre cabeçalhos de repositório de memória conflita com o guia específico atual; siga este último nas solicitações diretas. Nenhuma execução ou resultado foi observado.
- [Anthropic: uso da memória do agente](https://platform.claude.com/docs/en/managed-agents/memory) — Cabeçalho beta específico para chamadas diretas ao repositório de memória, criação e conexão, acesso e caminhos de montagem, listagem/obtenção/edição protegida por hash, limites, retenção de versões, supressão e consequências de arquivar/excluir. Alerta para conteúdo não confiável contaminando a memória gravável; não valida a saída do Dream.
- [Anthropic Managed Agents: início rápido](https://platform.claude.com/docs/en/managed-agents/quickstart) — Pré-requisitos de configuração de Console/chave de API, agente, ambiente e sessão. O acesso ao Managed Agents não comprova, por si só, autorização para a prévia de pesquisa do Dreams.
- [BIG CHANGE: crie um fluxo de trabalho Claude que revise documentos em paralelo](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide) — Cobertura contextual de Managed Agents sobre outra tarefa de revisão paralela de documentos. Relacionada, mas distinta; não é uma continuação datada nem evidência de resultados do Dream.
- [BIG CHANGE: o Hy Memory 2.0 dá aos agentes três formas de manter contexto](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) — Cobertura contextual de um SDK separado e de recuperação com escopo delimitado. Não comprova o comportamento do Anthropic Dream nem é um artigo principal de In this story.