Claude Managed Agent dapat membawa catatan antarsesi dalam penyimpanan memori, tetapi catatan itu bisa berulang atau kedaluwarsa. Pratinjau riset Dreams dari Anthropic dapat membaca satu penyimpanan dan sesi sebelumnya, lalu menulis usulan penyimpanan yang terpisah. Panduan ini menunjukkan kepada pengembang dengan akses yang diperlukan cara menjalankan satu Dream manual, memeriksa apa yang dipertahankan, dan menghubungkan hanya memori yang diterima ke sesi berikutnya.

Prosedur ini berdasarkan dokumentasi, yang diperiksa terhadap panduan Managed Agents terkini dari Anthropic pada 20 Oktober 2026. BIG CHANGE tidak menjalankan Dream, memeriksa keluaran nyata, menguji akses akun, atau mengukur biaya maupun peningkatan. Prosedur berakhir dengan satu penyimpanan yang telah ditinjau dan digunakan oleh satu sesi berikutnya. Prosedur ini tidak menyiapkan eksekusi berulang, penilaian, atau pembagian memori otomatis dengan agen lain.

Perubahan besar

  • Apa yang berubah: Dream dapat menyintesis penyimpanan memori yang ada dan 1–100 transkrip sesi terpilih menjadi penyimpanan baru tanpa mengubah masukan.
  • Mengapa penting: Keluaran terpisah memberi pemilik kesempatan untuk membandingkan catatan baru atau ringkasan dengan bukti asli sebelum sesi lain membacanya.
  • Yang perlu diperhatikan: Dreams memerlukan akses pratinjau riset tersendiri. Pekerjaan yang selesai menghasilkan calon penyimpanan, bukan kumpulan fakta atau preferensi yang disetujui.

Sebelum memulai

Anda memerlukan akun Claude Console dan kunci API, Managed Agent yang sudah ada beserta perangkat agen, lingkungan, serta akses ke Managed Agents beta yang dijelaskan dalam panduan mulai cepat. Anda juga memerlukan akses terpisah ke pratinjau riset Dreams. Managed Agents beta saja tidak membuktikan hak akses tersebut. Konfirmasikan melalui jalur akses Dreams sebelum mengirim permintaan.

Pilih satu penyimpanan memori yang ada dan 1–100 sesi nyata, relevan, dan selesai yang isinya boleh Anda proses bersama. Jika Anda memiliki transkrip tanpa penyimpanan, panduan memori menjelaskan cara membuat penyimpanan kosong. Beri nama dan deskripsi dengan cakupan terbatas. Agen memerlukan perangkat yang didokumentasikan untuk membaca atau menulis penyimpanan terhubung. Hubungkan penyimpanan saat membuat sesi masukan; sesi yang berjalan tidak dapat memperolehnya belakangan. Gunakan read_write hanya jika agen perlu menyimpan memori. Nilai bawaan adalah read_write, jadi tentukan read_only untuk materi yang hanya boleh dibaca agen. Periksa mount_path dari sumber daya yang dikembalikan, jangan menebaknya.

Tinjau masukan yang diusulkan bersama penanggung jawab datanya. Sesi dapat memuat materi pelanggan, detail proyek pribadi, atau teks tidak tepercaya. Anthropic memperingatkan bahwa perintah atau hasil alat yang dikendalikan penyerang dapat mencemari penyimpanan yang bisa ditulis dan memengaruhi sesi berikutnya. Tentukan siapa yang boleh memeriksa keluaran Dream dan fakta mana yang boleh disimpan. Catat sesi sumber, isi memori sebelumnya, dan keputusan peninjauan dalam bentuk yang dapat diakses manusia.

Jalankan contoh perintah dalam shell yang kompatibel dengan Bash, dengan cURL yang mendukung --fail-with-body serta Python 3 untuk koreksi dan pemeriksaan sesi terakhir. PowerShell memakai sintaks tanda kutip dan variabel lingkungan yang berbeda, sehingga perintahnya perlu disesuaikan. Pasang SDK Python Anthropic dengan pip install anthropic seperti yang ditunjukkan panduan mulai cepat . Tetapkan dan ekspor ANTHROPIC_API_KEY melalui metode pengelolaan rahasia yang biasa Anda gunakan agar cURL dan SDK Python dapat memakainya. Tetapkan store_id, session_a, session_b, agent_id dan environment_id ke ID yang dikembalikan ruang kerja Anda sendiri . Contoh menggunakan dua sesi; gunakan satu hingga 100 ID sesi nyata. Jangan simpan kunci dalam log atau draf bersama. Header beta yang tepat sangat penting: panggilan langsung penyimpanan memori memakai agent-memory-2026-07-22 saja; panggilan sesi memakai managed-agents-2026-04-01; panggilan Dream memakai managed-agents-2026-04-01 dan dreaming-2026-04-21. Panduan khusus memori terkini menyatakan bahwa menggabungkan dua header pertama pada permintaan penyimpanan memori menghasilkan HTTP 400. SDK Anthropic menetapkan header terkait secara otomatis.

Jalankan dan pantau satu Dream

  1. Baca penyimpanan masukan dan sesi terpilih terlebih dahulu. Catat ID aslinya serta jalur dan isi memori yang penting bagi tugas Anda. Tentukan tujuan kurasi yang sempit, misalnya mempertahankan konvensi proyek yang terdokumentasi dan membuang catatan yang sudah digantikan. Pertahankan ketersediaan penyimpanan dan sesi sampai eksekusi selesai. Dream dapat gagal jika penyimpanan masukan diarsipkan atau dihapus, atau sesi masukan dihapus, saat eksekusi berlangsung.
  2. Buat Dream dengan penyimpanan dan sesi yang ada. Model terdokumentasi dalam contoh ini adalah claude-opus-5-5; Anthropic mencantumkan model pratinjau lain yang didukung. Kolom opsional instructions dapat mengarahkan sintesis secara umum dan dibatasi hingga 4.096 karakter. Ini bukan cara yang andal untuk mengedit kalimat tertentu dalam memori.
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. Simpan ID drm_... yang dikembalikan sebagai dream_id. Respons pending berarti pekerjaan telah dibuat dan masuk antrean. Periksa berkala ID yang sama itu sampai statusnya menjadi completed, failed atau 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"

Baca status, outputs, usage dan error pada respons. Kolom outputs bisa kosong saat Dream menunggu atau sesaat ketika berjalan; itu saja bukan alasan mengirim pekerjaan lain. Menurut Anthropic, eksekusi dapat memakan beberapa menit hingga berjam-jam dan dikenai tarif token API standar untuk model yang dipilih. Kolom usage melaporkan token, tetapi tagihan akhir bergantung pada penggunaan dan harga sebenarnya. Tidak ada biaya atau waktu penyelesaian yang diukur untuk panduan ini.

Periksa dan koreksi penyimpanan terpisah

  1. Setelah status mencapai completed, ambil memory_store_id dari entri memory_store dalam outputs dan tetapkan sebagai output_store_id. Daftarkan memori penyimpanan tersebut dengan header beta memori , lalu ambil memori individual yang perlu diperiksa. Ikuti seluruh halaman daftar dan periksa isi lengkap, termasuk jalur dan hash. Anda juga dapat meninjau penyimpanan di 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. Bandingkan setiap klaim yang dipertahankan atau disintesis dengan sesi sumber terkait dan penyimpanan lama. Periksa apakah pernyataan benar-benar didukung, milik pengguna atau proyek yang tepat, serta apakah instruksi baru bertentangan dengannya. Cari rahasia, data pribadi, dan instruksi yang diselundupkan melalui materi tidak tepercaya. Catat keputusan mempertahankan, mengoreksi, atau membuang setiap memori penting. Dream tidak mengubah keduanya : penyimpanan masukan maupun sesi sumber tetap sama; hanya keluaran yang telah ditinjau yang boleh diteruskan.

Untuk koreksi terarah, ambil dulu content_sha256 terkini dari memori keluaran. Kirim mem_id aslinya, hash terbaru, dan isi yang dikoreksi melalui pembaruan memori yang didokumentasikan. Hash yang tidak cocok berarti ada penulisan lain: baca ulang, selesaikan perbedaannya, lalu coba lagi dengan hash baru. Sintaks berikut menunjukkan prasyarat itu. Masukkan koreksi yang telah ditinjau sebagai corrected_content melalui pengode JSON; contoh ini memakai Python 3 untuk meloloskan karakter isi dengan aman.

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

Tetapkan dan ekspor corrected_content dan mem_sha sebelum pengodean, periksa correction.json, dan simpan dalam batas data pribadi yang sama dengan memori. Hapus salinan lokal sesuai kebijakan retensi Anda setelah pembacaan balik. Baca ulang setiap memori yang diedit. Satu penyimpanan menampung hingga 10.000 memori, masing-masing paling besar 100 kB. Penulisan memori baru gagal saat batas tercapai, meskipun memori yang ada masih dapat dibaca dan diedit. Batasi cakupan atau pangkas penyimpanan penuh dengan aman sebelum mengandalkan penulisan baru.

Hubungkan hanya memori yang diterima ke sesi berikutnya

  1. Setelah keluaran lolos peninjauan, buat sesi baru dengan penyimpanan tersebut. Contoh ini menghubungkannya sebagai read_only, cocok untuk pemeriksaan yang tidak boleh mengubah catatan yang telah ditinjau. Jika agen perlu menambahkan memori belakangan, berikan read_write secara sengaja dan tinjau penulisan berikutnya itu juga.
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"}
    ]
  }'

Periksa sumber daya yang dikembalikan sesi baru untuk ID penyimpanan yang dituju dan mount_path aslinya. Simpan ID sesi yang dikembalikan sebagai new_session_id dan ekspor variabel shell tersebut agar Python dapat membacanya. Tulis pertanyaan dalam bahasa biasa tentang satu fakta yang dipertahankan dan telah Anda verifikasi sumbernya, lalu tetapkan dan ekspor sebagai memory_question. Alur pesan panduan mulai cepat Anthropic membuka aliran peristiwa, mengirim user.message, mencetak teks agent.message dan berhenti pada session.status_idle. Gunakan antarmuka terdokumentasi tersebut untuk mengirim pertanyaan dan membaca jawaban:

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

Bandingkan jawaban dari aliran dengan teks tersimpan dan sesi asli. Jawaban yang masuk akal tidak cukup jika tidak dapat ditelusuri ke bukti tersebut. Catat ID Dream, ID penyimpanan keluaran yang diterima, keputusan perbandingan, ID sesi baru, dan hasilnya. Pertahankan penyimpanan masukan sampai penggantinya lolos pemeriksaan ini.

Jika pembuatan menghasilkan kesalahan akses atau validasi, periksa hak pratinjau riset, ID masukan yang tepat, dan jumlah sesi sebelum mengubah permintaan. Jika eksekusi masih menunggu atau berjalan, terus periksa ID-nya. Eksekusi failed atau canceled dapat meninggalkan penyimpanan keluaran parsial; periksa kesalahan dan jangan hubungkan penyimpanan itu sebagai memori yang disetujui. Jika sesi berikutnya tidak dapat memakai memori yang diterima, periksa sumber daya dan jalur pemasangan pada sesi tersebut. Penyimpanan tidak dapat ditambahkan ke sesi yang sudah berjalan.

Perubahan memori membuat versi. Menurut Anthropic, versi biasa disimpan selama 30 hari, sedangkan beberapa versi terbaru dari memori yang masih ada disimpan lebih lama. Menghapus memori saat ini tidak menghapus riwayat yang dipertahankan. Untuk memulihkan versi lama yang masih disimpan, baca versi itu lalu perbarui memori yang ada atau buat ulang yang telah dihapus; tidak ada panggilan pemulihan terpisah. Ekspor riwayat yang diperlukan sebelum masa retensinya berakhir dan gunakan jalur penyamaran terdokumentasi untuk isi historis yang sensitif. Pengarsipan penyimpanan tidak dapat dibatalkan, menjadikannya hanya baca dan mencegah pemasangan baru. Penghapusan penyimpanan secara permanen menghapus memori dan versinya. Ambil kedua keputusan retensi itu berdasarkan kebijakan pemilik data setelah sesi berikutnya diverifikasi.

Untuk tugas Managed Agents terdahulu yang berbeda, lihat panduan peninjauan dokumen paralel kami. Liputan Hy Memory 2.0 kami membahas SDK memori terpisah dan alur pengingatan dengan cakupannya sendiri.

Sumber dan bacaan lanjutan

  • Panduan Dreams dari Anthropic mendokumentasikan akses pratinjau riset, masukan, permintaan pembuatan dan pemeriksaan status, status, keluaran terpisah, penagihan, serta perilaku kegagalan. Pernyataan umumnya tentang header beta penyimpanan memori bertentangan dengan panduan khusus memori terkini; gunakan yang terakhir untuk panggilan langsung penyimpanan memori.
  • Panduan memori dari Anthropic mendokumentasikan pembuatan penyimpanan, pemasangan sesi, header khusus memori, daftar, edit terlindungi hash, versi, dan retensi. Panduan ini memperingatkan kontaminasi penyimpanan yang bisa ditulis serta pengarsipan dan penghapusan yang tak dapat dibatalkan.
  • Panduan mulai cepat Managed Agents dari Anthropic menjelaskan prasyarat akun, kunci API, agen, lingkungan, dan sesi. Tidak satu pun halaman ini membuktikan eksekusi yang diamati atau peningkatan kualitas untuk panduan ini.