1回の Dream で Claude Managed Agent のメモリストアを確認する

Claude Managed Agent はメモリストアを使ってセッション間でメモを引き継げます。ただし、内容が重複したり古くなったりすることがあります。Anthropic の Dreams リサーチプレビュー は、1つのストアと過去のセッションを読み取り、候補となる別のストアを作成できます。このガイドでは、必要なアクセス権を持つ開発者が 手動の Dream を1回実行し、残された内容を確認して、承認したメモリだけを後続のセッションに接続する手順を説明します。

これは文書に基づく手順であり、2026年10月20日に Anthropic の現行 Managed Agents ガイドと照合しました。BIG CHANGE は Dream の実行、実際の出力の確認、アカウントのアクセス権のテスト、費用や改善効果の測定を行っていません。手順の到達点は、確認済みのストア1つを後続のセッション1つで使用することです。定期実行、採点、他のエージェントへの自動的なメモリ共有は設定しません。

大きな変化

• 変わったこと： Dream は、入力を変更せずに、既存のメモリストアと選択した1～100件のセッション記録を新しいメモリストアにまとめられます。
• 重要な理由： 出力が別になるため、所有者は他のセッションが読む前に、新規または要約されたメモを元の根拠と比較できます。
• 注意点： Dreams には別途リサーチプレビューのアクセス権が必要です。ジョブが完了しても、生成されるのは候補のストアであり、事実や好みが承認されたことにはなりません。

始める前に

Claude Console のアカウントと API キー、エージェント用ツールセットを備えた既存の Managed Agent、環境、および クイックスタートに記載された Managed Agents ベータへのアクセス権が必要です。加えて、 Dreams リサーチプレビューへの個別のアクセス権も必要です。Managed Agents ベータへのアクセス権だけでは、この資格を確認できません。リクエストを送信する前に、 Dreams のアクセス手続き で確認してください。

既存のメモリストアを1つと、内容をまとめて処理する権限がある、実在する関連性の高い完了済みセッションを1～100件選びます。記録はあってもストアがない場合は、 メモリガイド の手順で空のストアを作成します。対象範囲が分かる名前と説明を付けてください。接続したストアの読み書きには、文書に記載されたツールセットが必要です。入力セッションの作成時にストアを接続します。実行中のセッションに後から追加することはできません。メモリの保存が必要な場合に限り read_write を使用します。既定値は read_writeなので、参照だけに使う資料には read_only を明示します。推測せず、返されたリソースの mount_path を確認してください。

入力候補を、そのデータに責任を持つ人と確認してください。セッションには、顧客の資料、非公開のプロジェクト情報、信頼できないテキストが含まれる場合があります。Anthropic は、攻撃者が操作するプロンプトやツールの出力が書き込み可能なストアを汚染し、後続のセッションに影響し得ると警告しています。Dream の出力を誰が確認できるか、どの事実を残してよいかを決めます。元のセッション、以前のメモリ内容、確認時の判断を、人が参照できる形で記録してください。

コマンド例は Bash 互換のシェルで実行します。cURL は --fail-with-body をサポートしている必要があり、修正と最後のセッション確認には Python 3 も必要です。PowerShell は引用符と環境変数の構文が異なるため、コマンドの調整が必要です。Anthropic の Python SDK は pip install anthropic でインストールします。手順は クイックスタート にあります。 設定してエクスポートする変数は ANTHROPIC_API_KEY です。通常の秘密情報管理方法を使い、cURL と Python SDK の両方から利用できるようにします。次に store_id、 session_a、 session_b、 agent_id 、 environment_id には、 自分自身 のワークスペースが返した ID を設定します。例は2件のセッションを使用します。実在するセッション ID を1～100件指定してください。キーを共有ログや下書きに残さないでください。ベータヘッダーは正確に指定する必要があります。直接の メモリストア 呼び出しでは agent-memory-2026-07-22 だけを使用し、セッション呼び出しでは managed-agents-2026-04-01を使用します。Dream 呼び出しでは managed-agents-2026-04-01 と dreaming-2026-04-21の両方を使用します。現行の専用メモリガイドによると、メモリストアのリクエストで最初の2つを組み合わせると HTTP 400 が返ります。Anthropic の SDK は適切なヘッダーを自動で設定します。

1回の Dream を実行して追跡する

1. まず入力ストアと選択したセッションを読みます。実際の ID と、作業に関係するメモリのパスと内容を記録してください。文書化されたプロジェクトの慣例を残し、置き換えられたメモを除くなど、整理の目的を絞ります。実行が終わるまでストアとセッションを利用可能な状態に保ちます。実行中に入力ストアをアーカイブまたは削除したり、入力セッションを削除したりすると、Dream が失敗する場合があります。
2. 既存のストアとセッションを使って Dream を作成します。この例で使用する文書記載のモデルは claude-opus-5-5です。 Anthropic は他の対応プレビューモデルも掲載しています。任意の instructions で全体的な統合方針を示せますが、上限は4,096文字です。メモリ内の特定の文を確実に編集する方法ではありません。

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. 返された drm_... の ID を dream_idとして保存します。 pending という応答は、ジョブが作成され、キューに入ったことを示します。 同じ ID を使って、状態が completed、 failed 、または canceledになるまで定期的に確認します。

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"

応答内の status、 outputs、 usage 、 error を読みます。 outputs は、Dream が待機中、または実行開始直後に空の場合があります。それだけで別のジョブを送信しないでください。Anthropic によると、実行には数分から数時間かかり、選択したモデルの標準 API トークン料金が適用されます。 usage フィールドはトークン数を示しますが、最終的な請求額は実際の使用量と料金に依存します。このガイドでは費用や完了時間を測定していません。

別に生成されたストアを確認・修正する

4. まず status が completedに達したら、取得する値は memory_store_id です。この値は memory_store という項目にあり、その項目は outputs に含まれます。取得した値を output_store_idに設定します。このストアのメモリを一覧取得する際は、 メモリ用 ベータヘッダーを使い、その後、確認する個々のメモリを取得します。一覧の全ページをたどり、パスとハッシュを含む内容全体を確認してください。Console でもストアを確認できます。

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. 残された、または統合された各主張を、関連する元のセッションと古いストアに照らして確認します。実際に根拠があるか、正しいユーザーやプロジェクトに属するか、新しい指示と矛盾しないかを調べます。秘密情報、個人情報、信頼できない資料に紛れ込んだ指示を探してください。重要な各メモリについて、残す、修正する、破棄する、の判断を記録します。Dream は どちらも変更しません 。入力ストアと元のセッションはそのままで、確認済みの出力だけを次に進めます。

特定の内容を修正するには、まず出力メモリの現在の content_sha256を取得します。実際の mem_id、最新のハッシュ、修正済みの内容を 文書記載のメモリ更新手順で送信します。ハッシュが一致しない場合、別の書き込みが行われています。読み直して差異を解消し、新しいハッシュで再試行してください。次の構文は、その事前条件を示しています。確認済みの修正内容を corrected_content として JSON エンコーダーに渡します。この例では Python 3 で内容を安全にエスケープします。

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

エンコードする前に、設定してエクスポートする変数は corrected_content と mem_sha です。 correction.jsonを確認し、メモリと同じ非公開データの管理範囲内に保管します。読み戻しで確認した後、保持方針に従ってローカルコピーを削除してください。編集したメモリはすべて読み直します。ストアの上限は10,000件で、各メモリは最大100 kBです。ストアが上限に達すると新規メモリの書き込みは失敗しますが、既存のメモリの読み取りと編集は可能です。新規書き込みに依存する前に、対象を絞るか、混雑したストアを安全に整理してください。

承認したメモリだけを後続のセッションに接続する

6. 出力の確認が済んだら、そのストアを使う 新しい セッションを作成します。この例では read_onlyとして接続します。確認済みの記録を変更しない検証に適しています。後でエージェントがメモリを追加する必要がある場合は、意図的に read_write を付与し、その後の書き込みも確認してください。

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

新しいセッションが返すリソースで、目的のストア ID と実際の mount_pathを確認します。返されたセッション ID を new_session_id として保存し、Python が読めるようにそのシェル変数をエクスポートします。出典を確認した保存済みの事実1つについて、自然言語で質問を書き、それを設定・エクスポートする変数は memory_questionです。Anthropic の クイックスタートのメッセージ処理 はイベントストリームを開き、 user.messageを送信し、 agent.message のテキストを出力して、 session.status_idleで停止します。この文書記載のインターフェースで質問を送り、回答を読んでください。

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

ストリームで受け取った回答を、保存されたテキストと元のセッションの両方と比較します。もっともらしい回答でも、その根拠をたどれなければ十分ではありません。Dream ID、承認した出力ストア ID、比較時の判断、新しいセッション ID、結果を記録します。置き換え先がこの確認を通過するまで、入力ストアを保管してください。

作成時にアクセスまたは検証エラーが返った場合は、リクエストを変更する前に、リサーチプレビューの資格、正確な入力 ID、セッション数を確認します。実行が待機中または実行中なら、同じ ID の状態確認を続けます。 failed または canceled の実行では、一部だけ生成された出力ストアが残る場合があります。エラーを調べ、そのストアを承認済みメモリとして接続しないでください。後続のセッションが承認済みメモリを使えない場合は、リソースとマウントパスを確認する対象は そのセッションです。実行中のセッションにストアを後から追加することはできません。

メモリを変更するとバージョンが作られます。Anthropic によると、通常のバージョンは30日間保持され、現存するメモリの最近の一部のバージョンはより長く保持されます。現在のメモリを削除しても、保持済みの履歴は 削除されません 。保持されている古いバージョンを復元するには、それを読み取り、現存するメモリを更新するか、削除したメモリを作り直します。別の復元呼び出しはありません。必要な履歴は保持期間が終わる前にエクスポートし、過去の機密情報には文書記載の墨消し手順を使ってください。ストアのアーカイブは取り消せず、読み取り専用になり、新規接続ができなくなります。ストアを削除すると、メモリとバージョンは完全に削除されます。どちらの保持判断も、後続のセッションを検証した後、データ所有者の方針に従って行います。

以前に紹介した別の Managed Agents の作業については、 並列ドキュメントレビューのガイドを参照してください。 Hy Memory 2.0 の記事 は、別のメモリ SDK と、その対象範囲を限定した想起手順を扱っています。

出典と参考資料

• Anthropic の Dreams ガイド は、リサーチプレビューへのアクセス、入力、作成と状態確認のリクエスト、各状態、独立した出力、課金、失敗時の挙動を説明しています。メモリストアのベータヘッダーに関する一般的な記述は、現行の専用メモリガイドと矛盾します。メモリストアを直接呼び出す際は、後者に従ってください。
• Anthropic の メモリガイド は、ストアの作成、セッションへの接続、メモリ専用ヘッダー、一覧取得、ハッシュで保護された編集、バージョンと保持を説明しています。書き込み可能なストアの汚染と、取り消せないアーカイブや削除にも警告しています。
• Anthropic の Managed Agents クイックスタート は、アカウント、API キー、エージェント、環境、セッションの前提条件を説明しています。どのページも、このガイドで実行を観測したことや、品質改善を確認したことの証明にはなりません。