LE MONDE NE S’ARRÊTE PAS.RSS
BIG CHANGE.

Édition Markdown

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

# Examiner la mémoire d’un Claude Managed Agent avec un seul Dream

> Exécutez un Claude Dream manuel sur des sessions autorisées, inspectez et corrigez son magasin de mémoire distinct, puis ne joignez que la mémoire vérifiée à une session ultérieure.

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

## Sources

- [Anthropic Dreams](https://platform.claude.com/docs/en/managed-agents/dreams) — Accès à la préversion de recherche, un magasin d’entrée et 1 à 100 sessions, création/interrogation/états/sortie, modèles pris en charge, instructions facultatives, facturation et erreurs. Sa formulation générique sur les en-têtes des magasins contredit le guide spécifique actuel ; suivez ce dernier pour les requêtes directes. Aucune exécution ni résultat n’a été observé.
- [Anthropic, utiliser la mémoire d’agent](https://platform.claude.com/docs/en/managed-agents/memory) — En-tête bêta spécifique des appels directs, création et liaison, accès et montages, listes/récupération/modifications protégées, limites, conservation des versions, suppression de données historiques et conséquences de l’archivage/suppression. Avertit qu’un contenu non fiable peut contaminer la mémoire modifiable ; ne valide pas la sortie Dream.
- [Anthropic, démarrage Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart) — Prérequis de configuration Console/clé API, agent, environnement et session. L’accès Managed Agents seul ne prouve pas le droit à la préversion de recherche Dreams.
- [BIG CHANGE : créer un processus Claude de revue parallèle de documents](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide) — Couverture contextuelle Managed Agents d’une autre tâche de revue parallèle. Connexe et distincte, sans suite datée ni preuve de résultats Dream.
- [BIG CHANGE : Hy Memory 2.0 propose aux agents trois façons de conserver le contexte](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) — Couverture contextuelle d’un SDK distinct et d’un rappel à périmètre défini. Ne prouve pas le comportement Anthropic Dream et ne constitue pas un parent « In this story ».