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

Edição Markdown

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

# Reveja 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 o repositório de memória separado e associe apenas a memória revista 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 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](https://platform.claude.com/docs/en/managed-agents/dreams) 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](https://platform.claude.com/docs/en/managed-agents/quickstart). 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](https://platform.claude.com/docs/en/managed-agents/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](https://platform.claude.com/docs/en/managed-agents/memory#create-a-memory-store) 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](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk) . 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](https://platform.claude.com/docs/en/managed-agents/dreams#create-a-dream). 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.

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

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

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

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

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

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

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

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

```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 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](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide). A 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 do respetivo fluxo de recuperação com âmbito delimitado.

## Fontes e leituras adicionais

- O [guia de Dreams da Anthropic](https://platform.claude.com/docs/en/managed-agents/dreams) 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](https://platform.claude.com/docs/en/managed-agents/memory) 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](https://platform.claude.com/docs/en/managed-agents/quickstart) 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.

## Sources

- [Anthropic Dreams](https://platform.claude.com/docs/en/managed-agents/dreams) — Acesso à pré-visualização de investigação, um repositório de entrada e entre 1 e 100 sessões, comportamento de criação/consulta/estado/saída, modelos suportados, instruções opcionais, faturação e erros. A afirmação genérica sobre o cabeçalho do repositório de memória contradiz o guia específico atual; siga este último nos pedidos diretos. Não foi observada qualquer execução ou resultado.
- [Anthropic: utilizar a 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 associação, acesso e caminhos de montagem, listagem/obtenção/edição protegida por hash, limites, conservação de versões, ocultação e consequências de arquivar/eliminar. Alerta para conteúdo não fiável que contamina a memória com escrita; não valida o resultado do Dream.
- [Anthropic Managed Agents: iniciação](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é-visualização de investigação do Dreams.
- [BIG CHANGE: crie um fluxo de trabalho Claude que reveja 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 prova de resultados do Dream.
- [BIG CHANGE: o Hy Memory 2.0 oferece aos agentes três formas de manter o contexto](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) — Cobertura contextual de um SDK separado e de recuperação com âmbito delimitado. Não comprova o comportamento do Anthropic Dream nem é um artigo principal de In this story.