Den Speicher eines Claude Managed Agent mit einem Dream prüfen

Ein Claude Managed Agent kann Notizen zwischen Sitzungen in einem Speicher behalten. Diese können jedoch wiederholend oder veraltet werden. Anthropics Dreams-Forschungsvorschau kann einen Speicher und vergangene Sitzungen lesen und einen separaten vorgeschlagenen Speicher schreiben. Dieser Leitfaden zeigt Entwicklern mit dem nötigen Zugang, wie sie einen einzigen manuellen Dream ausführen, das Übernommene prüfen und nur akzeptierte Erinnerungen an eine spätere Sitzung anhängen.

Dies ist ein dokumentationsgestütztes Verfahren, geprüft gegen Anthropics aktuelle Managed Agents-Anleitungen am 20. Oktober 2026. BIG CHANGE hat keinen Dream ausgeführt, keine echte Ausgabe geprüft, keinen Kontozugang getestet und weder Kosten noch Verbesserungen gemessen. Das Verfahren endet mit einem geprüften Speicher, den eine spätere Sitzung verwendet. Es richtet keine Wiederholung, Bewertung oder automatische gemeinsame Speichernutzung mit anderen Agenten ein.

Die wesentliche Veränderung

• Was sich ändert: Ein Dream kann einen vorhandenen Speicher und Transkripte von 1–100 ausgewählten Sitzungen zu einem neuen Speicher zusammenfassen, ohne die Eingabe zu ändern.
• Warum das wichtig ist: Die separate Ausgabe gibt dem Eigentümer Gelegenheit, neue oder verdichtete Notizen mit den Originalbelegen zu vergleichen, bevor eine weitere Sitzung sie liest.
• Worauf zu achten ist: Dreams benötigt einen eigenen Zugang zur Forschungsvorschau. Ein abgeschlossener Auftrag liefert einen Speicherkandidaten, keine genehmigten Fakten oder Präferenzen.

Vorbereitung

Sie benötigen ein Claude Console-Konto und einen API-Schlüssel, einen bestehenden Managed Agent mit Agentenwerkzeugen, eine Umgebung und Zugang zur im Schnellstart beschriebenen Managed Agents-Beta. Zusätzlich benötigen Sie eigenen Zugang zur Dreams-Forschungsvorschau. Die Managed Agents-Beta allein belegt diesen Anspruch nicht. Bestätigen Sie ihn über den Dreams-Zugangsweg , bevor Sie die Anfrage senden.

Wählen Sie einen bestehenden Speicher und 1–100 echte, relevante, abgeschlossene Sitzungen, deren Inhalte Sie gemeinsam verarbeiten dürfen. Haben Sie Transkripte, aber keinen Speicher, zeigt der Speicherleitfaden , wie ein leerer erstellt wird. Geben Sie ihm einen zweckgebundenen Namen und eine Beschreibung. Der Agent benötigt sein dokumentiertes Werkzeugset, um angehängten Speicher zu lesen oder zu schreiben. Hängen Sie ihn beim Erstellen einer Eingabesitzung an; eine laufende Sitzung kann ihn nicht nachträglich erhalten. Verwenden Sie read_write nur, wenn der Agent Erinnerungen speichern muss. Der Standard ist read_write, geben Sie daher read_only für Inhalte an, die er nur nachschlagen soll. Prüfen Sie den zurückgegebenen mount_path der Ressource, statt ihn zu erraten.

Prüfen Sie die geplante Eingabe mit den Datenverantwortlichen. Eine Sitzung kann Kundenmaterial, private Projektdetails oder nicht vertrauenswürdigen Text enthalten. Anthropic warnt, dass ein angreifergesteuerter Prompt oder Werkzeugausgabe einen beschreibbaren Speicher verunreinigen und spätere Sitzungen beeinflussen kann. Legen Sie fest, wer die Dream-Ausgabe prüfen darf und welche Fakten bleiben dürfen. Führen Sie einen für Menschen zugänglichen Nachweis über Quellsitzungen, vorherige Speicherinhalte und Prüfentscheidungen.

Führen Sie die Beispiele in einer Bash-kompatiblen Shell mit cURL-Unterstützung für --fail-with-body und Python 3 für Korrektur und abschließende Sitzungsprüfung aus. PowerShell nutzt andere Anführungszeichen und Umgebungsvariablen; seine Befehle müssen angepasst werden. Installieren Sie Anthropics Python-SDK mit pip install anthropic , wie im Schnellstart gezeigt. Setzen und exportieren Sie ANTHROPIC_API_KEY über Ihren üblichen sicheren Umgang mit Geheimnissen, damit cURL und Python-SDK darauf zugreifen können. Setzen Sie store_id, session_a, session_b, agent_id und environment_id auf Kennungen aus Ihrem eigenen Arbeitsbereich. Die Beispiele verwenden zwei Sitzungen; nutzen Sie echte Kennungen von einer bis zu 100 Sitzungen. Halten Sie den Schlüssel aus geteilten Protokollen und Entwürfen heraus. Die genauen Beta-Header sind wichtig: Direkte Speicher -Aufrufe nutzen agent-memory-2026-07-22 allein; Sitzungsaufrufe nutzen managed-agents-2026-04-01; Dream-Aufrufe nutzen sowohl managed-agents-2026-04-01 als auch dreaming-2026-04-21. Laut aktuellem spezifischem Speicherleitfaden liefert die Kombination der ersten beiden in einer Speicheranfrage HTTP 400. Anthropics SDK setzt die passenden Header automatisch.

Einen Dream ausführen und verfolgen

1. Lesen Sie zuerst Eingabespeicher und ausgewählte Sitzungen. Erfassen Sie echte Kennungen und relevante Speicherpfade und Inhalte. Formulieren Sie ein enges Auswahlziel, etwa dokumentierte Projektkonventionen zu bewahren und überholte Notizen zu entfernen. Halten Sie Speicher und Sitzungen bis zum Ende verfügbar. Der Dream kann scheitern, wenn währenddessen der Eingabespeicher archiviert oder gelöscht beziehungsweise eine Eingabesitzung gelöscht wird.
2. Erstellen Sie den Dream mit bestehendem Speicher und Sitzungen. Das dokumentierte Modell dieses Beispiels ist claude-opus-5-5; Anthropic nennt weitere unterstützte Vorschaumodelle. Optionale instructions können die allgemeine Zusammenfassung lenken und sind auf 4096 Zeichen begrenzt. Sie sind kein zuverlässiger Weg, einen bestimmten Satz in einer Erinnerung zu bearbeiten.

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. Speichern Sie die zurückgegebene drm_... -Kennung als dream_id. Eine Antwort pending bedeutet, dass der Auftrag erstellt und eingereiht wurde. Fragen Sie dieselbe Kennung ab, bis ihr Status completed, failed oder canceled ist:

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"

Lesen Sie status, outputs, usage und error in der Antwort. outputs kann während des Wartens oder kurz nach Ausführungsbeginn leer sein; allein deshalb darf kein weiterer Auftrag eingereicht werden. Anthropic nennt Laufzeiten von Minuten bis Stunden und berechnet die Standard-API-Tokenpreise des gewählten Modells. Das Feld usage meldet Token, die Endkosten hängen aber von tatsächlicher Nutzung und Preisen ab. Für diesen Leitfaden wurden weder Kosten noch Abschlusszeit gemessen.

Den separaten Speicher prüfen und korrigieren

4. Sobald status den Zustand completed erreicht, nehmen Sie die memory_store_id des Eintrags memory_store aus outputs und setzen sie als output_store_id. Listen Sie die Erinnerungen dieses Speichers mit dem Speicher -Beta-Header auf und rufen Sie die einzeln zu prüfenden Erinnerungen ab. Folgen Sie allen Listenseiten und prüfen Sie den vollständigen Inhalt einschließlich Pfaden und Hashes. Sie können den Speicher auch in Console prüfen.

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. Vergleichen Sie jede beibehaltene oder zusammengefasste Aussage mit ihrer Quellsitzung und dem alten Speicher. Prüfen Sie Belege, richtige Zuordnung zu Nutzer oder Projekt und Widersprüche zu neueren Anweisungen. Suchen Sie nach Geheimnissen, personenbezogenen Daten und eingeschleusten Anweisungen aus nicht vertrauenswürdigen Inhalten. Dokumentieren Sie für jede wichtige Erinnerung Behalten, Korrigieren oder Verwerfen. Der Dream ändert weder den Eingabespeicher noch die Quellsitzungen; nur die geprüfte Ausgabe darf weiterverwendet werden.

Für eine gezielte Korrektur rufen Sie zuerst den aktuellen content_sha256 der Ausgabeerinnerung ab. Übermitteln Sie ihre tatsächliche mem_id, den frischen Hash und den korrigierten Inhalt über die dokumentierte Speicheraktualisierung. Ein abweichender Hash bedeutet eine andere Schreiboperation: Lesen Sie erneut, lösen Sie den Unterschied und versuchen Sie es mit dem neuen Hash. Die folgende Syntax zeigt diese Vorbedingung. Geben Sie Ihre geprüfte Korrektur als corrected_content über einen JSON-Encoder ein; das Beispiel maskiert den Inhalt mit Python 3 sicher.

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

Setzen und exportieren Sie corrected_content und mem_sha vor der Kodierung, prüfen Sie correction.json und halten Sie die Datei im selben privaten Datenbereich wie die Erinnerung. Entfernen Sie die lokale Kopie nach dem Readback gemäß Ihrer Aufbewahrungsregel. Lesen Sie jede geänderte Erinnerung erneut. Ein Speicher umfasst höchstens 10 000 Erinnerungen mit jeweils maximal 100 kB. Neue Einträge scheitern am Speicherlimit, vorhandene bleiben jedoch lesbar und bearbeitbar. Begrenzen Sie den Umfang oder bereinigen Sie sicher, bevor Sie sich auf einen neuen Eintrag verlassen.

Nur akzeptierte Erinnerungen an eine spätere Sitzung anhängen

6. Besteht die Ausgabe die Prüfung, erstellen Sie eine neue Sitzung mit diesem Speicher. Das Beispiel hängt ihn als read_only an, passend für eine Prüfung ohne Änderung des geprüften Bestands. Muss der Agent später Erinnerungen hinzufügen, gewähren Sie read_write bewusst und prüfen Sie auch diese späteren Schreibvorgänge.

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

Prüfen Sie die zurückgegebenen Ressourcen der neuen Sitzung auf die richtige Speicherkennung und den tatsächlichen mount_path. Speichern Sie die zurückgegebene Sitzungskennung als new_session_id und exportieren Sie diese Shellvariable für Python. Schreiben Sie eine allgemeinverständliche Frage zu einem beibehaltenen Fakt, dessen Quelle Sie geprüft haben, und setzen und exportieren Sie diese als memory_question. Der Nachrichtenablauf aus Anthropics Schnellstart öffnet einen Ereignisstrom, sendet eine user.message, gibt den Text von agent.message aus und endet bei session.status_idle. Nutzen Sie diese dokumentierte Schnittstelle zum Senden der Frage und Lesen der Antwort:

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

Vergleichen Sie die gestreamte Antwort mit gespeichertem Text und Originalsitzung. Eine plausible Antwort reicht nicht, wenn sie nicht auf diese Belege zurückgeführt werden kann. Erfassen Sie Dream-Kennung, akzeptierten Ausgabespeicher, Vergleichsentscheidungen, neue Sitzungskennung und Ergebnis. Behalten Sie den Eingabespeicher, bis der Ersatz diese Prüfung bestanden hat.

Liefert die Erstellung einen Zugriffs- oder Validierungsfehler, prüfen Sie Vorschauzugang, genaue Eingabekennungen und Sitzungszahl vor einer Änderung der Anfrage. Ist der Auftrag noch wartend oder laufend, fragen Sie seine Kennung weiter ab. Ein Auftrag mit failed oder canceled kann einen Teilspeicher hinterlassen; prüfen Sie den Fehler und hängen Sie ihn nicht als genehmigten Speicher an. Kann die spätere Sitzung akzeptierte Erinnerungen nicht nutzen, prüfen Sie Ressourcen und Einhängepfad dieser Sitzung. Einer bereits laufenden Sitzung kann kein Speicher nachträglich hinzugefügt werden.

Speicheränderungen erzeugen Versionen. Anthropic nennt 30 Tage für gewöhnliche Versionen und längere Aufbewahrung einiger neuerer Versionen einer aktiven Erinnerung. Das Löschen einer aktuellen Erinnerung entfernt nicht ihren aufbewahrten Verlauf. Um eine ältere erhaltene Version wiederherzustellen, lesen Sie sie und aktualisieren die aktive Erinnerung oder erstellen eine gelöschte neu; ein separater Wiederherstellungsaufruf existiert nicht. Exportieren Sie benötigten Verlauf vor Ablauf und nutzen Sie den dokumentierten Schwärzungsweg für sensible historische Inhalte. Archivierung ist endgültig, macht den Speicher schreibgeschützt und verhindert neue Anhänge. Löschen entfernt Erinnerungen und Versionen dauerhaft. Treffen Sie diese Entscheidungen nach der Richtlinie des Dateneigentümers, nachdem die spätere Sitzung geprüft ist.

Für eine frühere andere Managed Agents-Aufgabe lesen Sie unseren Leitfaden zur parallelen Dokumentenprüfung. Unsere Berichterstattung über Hy Memory 2.0 betrifft ein separates Speicher-SDK mit eigenem begrenztem Abrufablauf.

Quellen und weiterführende Informationen

• Anthropics Dreams-Leitfaden dokumentiert Vorschauzugang, Eingaben, Erstellen und Abfragen, Zustände, separate Ausgabe, Abrechnung und Fehler. Seine allgemeine Aussage zu Speicher-Beta-Headern widerspricht dem aktuellen spezifischen Speicherleitfaden; nutzen Sie diesen für direkte Speicheraufrufe.
• Anthropics Speicherleitfaden dokumentiert Erstellung, Sitzungsanbindung, spezifischen Header, Listen, hashgeschützte Bearbeitung, Versionen und Aufbewahrung. Er warnt vor Verunreinigung beschreibbarer Speicher und unwiderruflichem Archivieren und Löschen.
• Anthropics Managed Agents-Schnellstart erklärt Voraussetzungen für Konto, API-Schlüssel, Agent, Umgebung und Sitzung. Keine dieser Seiten belegt einen beobachteten Lauf oder Qualitätsgewinn für diesen Leitfaden.