Un Claude Managed Agent peut conserver des notes entre sessions dans un magasin de mémoire, mais ces notes peuvent devenir répétitives ou obsolètes. La préversion de recherche Dreams d’Anthropic peut lire un magasin et des sessions antérieures, puis écrire un nouveau magasin proposé distinct. Ce guide montre à un développeur disposant de l’accès requis comment exécuter un seul Dream manuel, contrôler ce qu’il a retenu et ne joindre que la mémoire acceptée à une session ultérieure.

Cette procédure repose sur la documentation, vérifiée dans les guides Managed Agents actuels d’Anthropic le 20 octobre 2026. BIG CHANGE n’a pas exécuté de Dream, inspecté de résultat réel, testé l’accès à un compte ni mesuré de coût ou d’amélioration. Elle se termine par un magasin vérifié utilisé par une session ultérieure. Elle ne configure ni exécution récurrente, ni évaluation, ni partage automatique de mémoire avec d’autres agents.

Le changement essentiel

  • Ce qui change : Un Dream peut synthétiser un magasin existant et les transcriptions de 1 à 100 sessions sélectionnées dans un nouveau magasin, sans modifier l’entrée.
  • Pourquoi cela compte : La sortie distincte permet au propriétaire de comparer les notes nouvelles ou condensées aux preuves originales avant leur lecture par une autre session.
  • À surveiller : Dreams nécessite un accès distinct à la préversion de recherche. Une tâche terminée produit un magasin candidat, et non des faits ou préférences approuvés.

Avant de commencer

Il vous faut un compte Claude Console et une clé API, un Managed Agent existant avec les outils d’agent, un environnement et l’accès à la bêta Managed Agents décrite dans le guide de démarrage. Il faut aussi un accès distinct à la préversion de recherche Dreams. La seule bêta Managed Agents ne prouve pas ce droit. Confirmez-le par la voie d’accès Dreams avant d’envoyer la demande.

Choisissez un magasin existant et 1 à 100 sessions réelles, pertinentes et terminées, dont vous êtes autorisé à traiter ensemble le contenu. Si vous avez des transcriptions mais pas de magasin, le guide de mémoire explique comment en créer un vide. Donnez-lui un nom et une description au périmètre précis. L’agent a besoin des outils documentés pour lire ou écrire un magasin joint. Joignez-le lors de la création de la session d’entrée ; une session en cours ne peut pas recevoir de magasin après coup. Utilisez read_write seulement si l’agent doit enregistrer des souvenirs. La valeur par défaut est read_write, donc indiquez read_only pour les éléments que l’agent doit seulement consulter. Vérifiez le mount_path de la ressource renvoyée au lieu de le deviner.

Examinez l’entrée proposée avec les responsables des données. Une session peut contenir des éléments clients, des détails de projet privés ou du texte non fiable. Anthropic avertit qu’un prompt ou résultat d’outil contrôlé par un attaquant peut contaminer un magasin modifiable et affecter les sessions suivantes. Décidez qui peut inspecter la sortie Dream et quels faits peuvent persister. Gardez un relevé accessible aux personnes des sessions sources, de la mémoire antérieure et des décisions prises pendant la revue.

Exécutez les exemples dans un interpréteur compatible Bash avec cURL prenant en charge --fail-with-body et Python 3 pour la correction et la vérification de la session finale. PowerShell utilise des guillemets et variables d’environnement différents ; ses commandes doivent donc être adaptées. Installez le SDK Python d’Anthropic avec pip install anthropic comme le montre le guide de démarrage . Définissez et exportez ANTHROPIC_API_KEY par votre méthode habituelle de gestion des secrets afin que cURL et le SDK Python puissent l’utiliser. Définissez store_id, session_a, session_b, agent_id et environment_id avec les identifiants renvoyés par votre propre espace de travail. Les exemples utilisent deux sessions ; utilisez de véritables identifiants de 1 à 100 sessions. Gardez la clé hors des journaux et brouillons partagés. Les en-têtes bêta exacts comptent : les appels directs au magasin de mémoire utilisent agent-memory-2026-07-22 seul ; les appels de session utilisent managed-agents-2026-04-01 ; les appels Dream utilisent à la fois managed-agents-2026-04-01 et dreaming-2026-04-21. Le guide de mémoire spécifique actuel indique qu’associer les deux premiers sur une requête de magasin renvoie HTTP 400. Le SDK d’Anthropic définit automatiquement les en-têtes pertinents.

Exécuter et suivre un seul Dream

  1. Lisez d’abord le magasin d’entrée et les sessions choisies. Notez leurs véritables identifiants et les chemins et contenus de mémoire utiles à votre tâche. Fixez un objectif limité de sélection, par exemple conserver les conventions de projet documentées et retirer les notes remplacées. Gardez le magasin et les sessions disponibles jusqu’à la fin. Le Dream peut échouer si un magasin d’entrée est archivé ou supprimé, ou si une session d’entrée est supprimée pendant l’exécution.
  2. Créez le Dream avec le magasin et les sessions existants. Le modèle documenté dans cet exemple est claude-opus-5-5 ; Anthropic répertorie d’autres modèles de préversion pris en charge. Les instructions facultatives peuvent orienter la synthèse générale et sont limitées à 4 096 caractères. Elles ne constituent pas un moyen fiable de modifier une phrase précise en mémoire.
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. Enregistrez l’identifiant drm_... renvoyé sous dream_id. Une réponse pending signifie que la tâche est créée et en attente. Interrogez ce même identifiant jusqu’à ce que son état soit 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"

Lisez status, outputs, usage et error dans la réponse. outputs peut être vide lorsque le Dream est en attente ou vient de démarrer ; cela ne justifie pas à lui seul de soumettre une autre tâche. Anthropic indique que les exécutions peuvent durer de quelques minutes à plusieurs heures et les facture au tarif API standard des jetons du modèle choisi. Le champ usage indique les jetons, mais la facture finale dépend de l’utilisation et des prix réels. Aucun coût ni temps d’achèvement n’a été mesuré pour ce guide.

Inspecter et corriger le magasin distinct

  1. Une fois que status atteint completed, prenez le memory_store_id de l’entrée memory_store dans outputs et définissez-le comme output_store_id. Listez les souvenirs de ce magasin avec l’en-tête bêta mémoire , puis récupérez individuellement ceux à examiner. Parcourez toutes les pages de la liste et inspectez le contenu complet, y compris chemins et empreintes. Vous pouvez aussi examiner le magasin dans 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. Comparez chaque affirmation conservée ou synthétisée à sa session source et à l’ancien magasin. Vérifiez son fondement, son attribution au bon utilisateur ou projet et une éventuelle contradiction avec une instruction plus récente. Recherchez secrets, données personnelles et instructions introduites dans des contenus non fiables. Notez une décision de conservation, de correction ou de rejet pour chaque souvenir important. Le Dream ne modifie ni le magasin d’entrée ni les sessions sources ; seule la sortie vérifiée doit être réutilisée.

Pour une correction ciblée, récupérez d’abord le content_sha256 actuel du souvenir de sortie. Soumettez son véritable mem_id, son empreinte récente et le contenu corrigé au moyen de la mise à jour de mémoire documentée. Une empreinte différente indique une autre écriture : relisez, résolvez le différend, puis réessayez avec la nouvelle empreinte. La syntaxe suivante montre cette condition préalable. Saisissez votre correction vérifiée comme corrected_content au moyen d’un encodeur JSON ; cet exemple utilise Python 3 pour échapper son contenu sans risque.

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

Définissez et exportez corrected_content et mem_sha avant l’encodage, inspectez correction.json et conservez-le dans le même périmètre privé que la mémoire. Supprimez la copie locale selon votre politique de conservation après vérification de la sauvegarde. Relisez chaque souvenir modifié. Un magasin contient au plus 10 000 souvenirs, chacun de 100 kB maximum. Les écritures de nouveaux souvenirs échouent à cette limite, même si les souvenirs existants restent lisibles et modifiables. Limitez le périmètre ou supprimez prudemment les éléments superflus avant de dépendre d’une nouvelle écriture.

Joindre seulement la mémoire acceptée à une session ultérieure

  1. Lorsque la sortie passe la revue, créez une nouvelle session avec ce magasin. Cet exemple le joint en read_only, ce qui convient à une vérification qui ne doit pas changer le relevé approuvé. Si l’agent doit ensuite ajouter des souvenirs, accordez read_write délibérément et examinez aussi ces futures écritures.
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"}
    ]
  }'

Vérifiez que les ressources renvoyées de la nouvelle session contiennent l’identifiant du bon magasin et son véritable mount_path. Enregistrez l’identifiant de session renvoyé sous new_session_id et exportez cette variable pour que Python puisse la lire. Rédigez une question en langage courant sur un fait conservé dont vous avez vérifié la source, puis définissez-la et exportez-la sous memory_question. Le flux de messages du guide de démarrage d’Anthropic ouvre un flux d’événements, envoie un user.message, affiche le texte agent.message et s’arrête à session.status_idle. Utilisez cette interface documentée pour envoyer votre question et lire la réponse :

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

Comparez la réponse diffusée au texte stocké et à la session originale. Une réponse plausible ne suffit pas si elle ne peut pas être reliée à ces preuves. Notez l’identifiant Dream, celui du magasin de sortie accepté, vos décisions de comparaison, le nouvel identifiant de session et le résultat. Conservez le magasin d’entrée jusqu’à la réussite de cette vérification du remplacement.

Si la création renvoie une erreur d’accès ou de validation, vérifiez le droit à la préversion de recherche, les identifiants exacts et le nombre de sessions avant de changer la requête. Si l’exécution est encore en attente ou en cours, continuez à interroger son identifiant. Une exécution failed ou canceled peut laisser un magasin de sortie partiel ; examinez l’erreur et ne le joignez pas comme mémoire approuvée. Si une session ultérieure ne peut pas utiliser la mémoire acceptée, vérifiez les ressources et le chemin de montage de cette session. Un magasin ne peut pas être ajouté à une session déjà en cours.

Les changements de mémoire créent des versions. Anthropic indique que les versions ordinaires sont conservées 30 jours, certaines versions récentes d’un souvenir actif restant plus longtemps. Supprimer un souvenir actuel ne supprime pas son historique conservé. Pour restaurer une ancienne version conservée, lisez-la et mettez à jour le souvenir actif ou recréez celui supprimé ; aucun appel de restauration distinct n’existe. Exportez l’historique nécessaire avant la fin de rétention et utilisez la voie documentée de suppression des données sensibles dans l’historique. L’archivage d’un magasin est irréversible, le rend non modifiable et empêche toute nouvelle liaison. La suppression d’un magasin efface définitivement ses souvenirs et versions. Prenez l’une ou l’autre décision selon la politique du propriétaire des données, après vérification de la session ultérieure.

Pour une tâche Managed Agents antérieure et distincte, consultez notre guide de revue parallèle de documents. Notre couverture de Hy Memory 2.0 concerne un SDK de mémoire différent et son propre processus de rappel au périmètre défini.

Sources et lectures complémentaires

  • Le guide Dreams d’Anthropic documente accès à la préversion, entrées, création, interrogation, états, sortie distincte, facturation et échecs. Sa formulation générale sur les en-têtes bêta des magasins contredit le guide de mémoire spécifique actuel ; utilisez ce dernier pour les appels directs aux magasins.
  • Le guide de mémoire d’Anthropic documente création, liaison aux sessions, en-tête spécifique, listes, modifications protégées par empreinte, versions et conservation. Il avertit de la contamination des magasins modifiables et de l’archivage et la suppression irréversibles.
  • Le guide de démarrage Managed Agents d’Anthropic explique les prérequis de compte, clé API, agent, environnement et session. Aucune de ces pages ne prouve une exécution observée ou un gain de qualité pour ce guide.