Un Claude Managed Agent puede conservar notas entre sesiones en un almacén de memoria, pero pueden volverse repetitivas u obsoletas. La vista previa de investigación Dreams de Anthropic puede leer un almacén y sesiones anteriores y escribir otro almacén propuesto. Esta guía muestra a un desarrollador con el acceso necesario cómo ejecutar un único Dream manual, comprobar lo que retuvo y adjuntar solo la memoria aceptada a una sesión posterior.

Es un procedimiento documental, contrastado con las guías actuales de Managed Agents de Anthropic el 20 de octubre de 2026. BIG CHANGE no ejecutó un Dream, inspeccionó resultados reales, probó acceso a cuentas ni midió costes o mejoras. Termina con un almacén revisado usado en una sesión posterior. No configura ejecuciones recurrentes, calificación ni intercambio automático de memoria con otros agentes.

El cambio principal

  • Qué cambió: Un Dream puede sintetizar un almacén existente y transcripciones de entre 1 y 100 sesiones elegidas en un almacén nuevo sin cambiar la entrada.
  • Por qué importa: La salida separada permite al propietario comparar notas nuevas o condensadas con las pruebas originales antes de que otra sesión las lea.
  • Qué vigilar: Dreams requiere acceso independiente a la vista previa de investigación. Un trabajo completado produce un almacén candidato, no hechos o preferencias aprobados.

Antes de empezar

Necesitas cuenta Claude Console y clave API, un Managed Agent existente con las herramientas de agente, un entorno y acceso a la beta Managed Agents descrita en el inicio rápido. También necesitas acceso independiente a la vista previa de investigación Dreams. La beta Managed Agents por sí sola no prueba ese derecho. Confírmalo por la vía de acceso a Dreams antes de enviar la petición.

Elige un almacén existente y entre 1 y 100 sesiones reales, pertinentes y terminadas cuyo contenido tengas permiso para procesar conjuntamente. Si tienes transcripciones pero no almacén, la guía de memoria explica cómo crear uno vacío. Dale nombre y descripción de alcance preciso. El agente necesita las herramientas documentadas para leer o escribir un almacén adjunto. Adjunta el almacén al crear una sesión de entrada; una sesión en ejecución no puede recibirlo después. Usa read_write solo si el agente debe guardar recuerdos. El valor predeterminado es read_write, así que especifica read_only para material que solo deba consultar. Comprueba el mount_path del recurso devuelto en vez de adivinarlo.

Revisa la entrada propuesta con las personas responsables de los datos. Una sesión puede incluir material de clientes, detalles privados o texto no fiable. Anthropic advierte que un prompt o resultado de herramienta controlado por un atacante puede contaminar un almacén modificable y afectar a sesiones posteriores. Decide quién puede inspeccionar la salida Dream y qué hechos pueden persistir. Conserva un registro accesible para personas de las sesiones fuente, memoria anterior y decisiones de revisión.

Ejecuta los ejemplos en un intérprete compatible con Bash y cURL que admita --fail-with-body y Python 3 para la corrección y la comprobación final. PowerShell usa comillas y variables de entorno distintas; sus órdenes deben adaptarse. Instala el SDK Python de Anthropic con pip install anthropic como muestra el inicio rápido . Define y exporta ANTHROPIC_API_KEY mediante tu sistema habitual de gestión de secretos para que cURL y el SDK Python puedan usarla. Define store_id, session_a, session_b, agent_id y environment_id con identificadores devueltos por tu propio espacio de trabajo. Los ejemplos usan dos sesiones; utiliza identificadores reales de una a 100 sesiones. Mantén la clave fuera de registros y borradores compartidos. Las cabeceras beta exactas importan: las llamadas directas al almacén de memoria usan agent-memory-2026-07-22 sola; las llamadas de sesión usan managed-agents-2026-04-01; las de Dream usan tanto managed-agents-2026-04-01 como dreaming-2026-04-21. La guía específica actual de memoria dice que combinar las dos primeras en una petición de almacén devuelve HTTP 400. El SDK de Anthropic establece automáticamente las cabeceras correspondientes.

Ejecutar y seguir un Dream

  1. Lee primero el almacén de entrada y las sesiones seleccionadas. Registra sus identificadores reales y las rutas y contenidos de memoria relevantes. Define una finalidad limitada, como preservar convenciones documentadas del proyecto y retirar notas sustituidas. Mantén disponibles almacén y sesiones hasta terminar. El Dream puede fallar si se archiva o elimina el almacén de entrada, o se elimina una sesión de entrada durante la ejecución.
  2. Crea el Dream con el almacén y las sesiones existentes. El modelo documentado del ejemplo es claude-opus-5-5; Anthropic enumera otros modelos de vista previa compatibles. Las instructions opcionales orientan la síntesis general y admiten hasta 4096 caracteres. No son una forma fiable de editar una frase concreta de la memoria.
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. Guarda el identificador drm_... devuelto como dream_id. Una respuesta pending significa que se creó y puso en cola el trabajo. Consulta ese mismo identificador hasta que su estado sea completed, failed o 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"

Lee status, outputs, usage y error en la respuesta. outputs puede estar vacío mientras Dream espera o lleva poco ejecutándose; eso solo no justifica enviar otro trabajo. Anthropic indica que puede tardar de minutos a horas y factura según las tarifas API estándar de tokens del modelo elegido. El campo usage informa de tokens, pero el cobro final depende del uso y precios reales. No hay coste ni tiempo medido para esta guía.

Inspeccionar y corregir el almacén separado

  1. Cuando status alcance completed, toma el memory_store_id de la entrada memory_store en outputs y defínelo como output_store_id. Lista los recuerdos del almacén con la cabecera beta de memoria y recupera los recuerdos individuales que debas examinar. Recorre todas las páginas e inspecciona todo el contenido, incluidas rutas y hashes. También puedes revisar el almacén en 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. Compara cada afirmación retenida o sintetizada con su sesión fuente y el almacén anterior. Comprueba su respaldo, si corresponde al usuario o proyecto correcto y si una instrucción más nueva la contradice. Busca secretos, datos personales e instrucciones introducidas mediante material no fiable. Registra conservar, corregir o descartar para cada recuerdo importante. El Dream no cambia ni el almacén de entrada ni las sesiones fuente; solo debe reutilizarse la salida revisada.

Para una corrección concreta, recupera primero el content_sha256 actual del recuerdo de salida. Envía su verdadero mem_id, hash reciente y contenido corregido mediante la actualización de memoria documentada. Un hash diferente significa otra escritura: lee de nuevo, resuelve la diferencia y reintenta con el nuevo hash. La sintaxis siguiente muestra esa condición. Introduce la corrección revisada como corrected_content mediante un codificador JSON; el ejemplo usa Python 3 para escapar el contenido con seguridad.

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

Define y exporta corrected_content y mem_sha antes de codificar, inspecciona correction.json y mantenlo dentro del mismo límite privado que la memoria. Elimina la copia local según tu política de conservación después de comprobar la lectura. Vuelve a leer cada recuerdo editado. Un almacén admite hasta 10 000 recuerdos de 100 kB como máximo cada uno. Al llegar al límite fallan nuevas escrituras, aunque los recuerdos existentes siguen legibles y editables. Reduce el alcance o depura con seguridad el almacén antes de depender de una escritura nueva.

Adjuntar solo memoria aceptada a una sesión posterior

  1. Cuando la salida supere la revisión, crea una nueva sesión con ese almacén. El ejemplo lo adjunta como read_only, apropiado para una comprobación que no debe alterar el registro revisado. Si el agente necesita añadir recuerdos después, concede read_write deliberadamente y revisa también esas futuras escrituras.
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"}
    ]
  }'

Comprueba en los recursos de la nueva sesión el identificador del almacén previsto y su mount_path real. Guarda el identificador de sesión devuelto como new_session_id y exporta esa variable para que Python pueda leerla. Escribe una pregunta en lenguaje natural sobre un hecho retenido cuya fuente verificaste, defínela y expórtala como memory_question. El flujo de mensajes del inicio rápido de Anthropic abre un flujo de eventos, envía un user.message, imprime texto agent.message y se detiene en session.status_idle. Usa esa interfaz documentada para enviar la pregunta y leer la respuesta:

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

Compara la respuesta recibida con el texto almacenado y la sesión original. Una respuesta plausible no basta si no puede vincularse a esas pruebas. Registra identificador Dream, almacén aceptado, decisiones de comparación, nueva sesión y resultado. Conserva el almacén de entrada hasta que el reemplazo supere esta comprobación.

Si la creación devuelve un error de acceso o validación, comprueba el derecho a la vista previa, los identificadores exactos y el número de sesiones antes de cambiar la petición. Si sigue pendiente o ejecutándose, consulta su identificador. Una ejecución failed o canceled puede dejar un almacén parcial; inspecciona el error y no lo adjuntes como memoria aprobada. Si una sesión posterior no puede usar la memoria aceptada, comprueba recursos y ruta de montaje de esa sesión. No se puede añadir un almacén a una sesión ya en ejecución.

Los cambios de memoria crean versiones. Anthropic indica que las ordinarias se guardan 30 días y algunas recientes de una memoria activa permanecen más. Eliminar un recuerdo actual no elimina su historial retenido. Para restaurar una versión anterior conservada, léela y actualiza la memoria activa o recrea la eliminada; no hay llamada de restauración independiente. Exporta el historial necesario antes del fin de retención y usa la vía documentada de eliminación de datos históricos sensibles. Archivar un almacén es irreversible, lo deja solo para lectura e impide adjuntarlo de nuevo. Eliminarlo borra permanentemente recuerdos y versiones. Decide según la política del dueño de los datos, después de verificar la sesión posterior.

Para otra tarea anterior de Managed Agents, consulta nuestra guía de revisión paralela de documentos. Nuestra cobertura de Hy Memory 2.0 trata un SDK de memoria distinto y su propio proceso de recuperación con alcance limitado.

Fuentes y lecturas adicionales

  • La guía Dreams de Anthropic documenta acceso a la vista previa, entradas, creación y consulta, estados, salida separada, facturación y fallos. Su afirmación general sobre cabeceras beta de almacenes contradice la guía específica actual de memoria; usa esta última para llamadas directas.
  • La guía de memoria de Anthropic documenta creación, conexión a sesiones, cabecera específica, listas, ediciones protegidas por hash, versiones y retención. Advierte de contaminación del almacén modificable y de archivo y borrado irreversibles.
  • El inicio rápido Managed Agents de Anthropic explica requisitos de cuenta, clave API, agente, entorno y sesión. Ninguna página establece una ejecución observada o mejora de calidad para esta guía.