Dreams

Agen menulis ke memory store (penyimpanan memori) mereka saat bekerja, tetapi penulisan ini bersifat lokal dan inkremental: setelah banyak sesi, sebuah memory store akan mengakumulasi duplikat, kontradiksi, dan entri yang sudah usang.

Dreams memungkinkan Claude membersihkan hal tersebut. Sebuah dream membaca memory store yang sudah ada bersama dengan transkrip sesi sebelumnya, lalu menghasilkan memory store baru yang telah direorganisasi: duplikat digabungkan, entri yang usang atau bertentangan diganti dengan nilai terbaru, dan wawasan baru dimunculkan.

Store input tidak pernah dimodifikasi, sehingga Anda dapat meninjau output dan membuangnya jika Anda tidak menyukai hasilnya.

Cara kerjanya

Sebuah dream adalah pekerjaan asinkron yang menerima:

• sebuah memory store yang sudah ada: store yang akan diverifikasi, dideduplikasi, dan direorganisasi oleh Claude, dan
• 1 hingga 100 sesi: transkrip sebelumnya yang ditambang oleh Claude untuk menemukan pola dan wawasan yang akan dimasukkan ke dalam output.

Dream menghasilkan memory store output lain, yang terpisah dari input. ID store output muncul di outputs[] milik dream setelah statusnya menjadi running.

Membuat dream

dream = client.beta.dreams.create(
    inputs=[
        {"type": "memory_store", "memory_store_id": store_id},
        {"type": "sessions", "session_ids": [session_a, session_b]},
    ],
    model="claude-opus-4-8",
    instructions="Focus on coding-style preferences; ignore one-off debugging notes.",
)
print(dream.id)  # drm_01...

Input dreaming mencakup memory store yang sudah ada dan sebuah array sesi. Model yang dipilih akan menjalankan pipeline dreaming; selama pratinjau riset, claude-opus-4-8, claude-opus-4-7, dan claude-sonnet-4-6 didukung. Anda dapat secara opsional meneruskan instructions untuk mengarahkan proses dreaming; lihat Mengarahkan dengan instruksi.

Responsnya adalah resource dream lengkap dengan status: "pending":

{
  "type": "dream",
  "id": "drm_01AbCDefGhIjKlMnOpQrStUv",
  "status": "pending",
  "inputs": [
    { "type": "memory_store", "memory_store_id": "memstore_01Hx..." },
    { "type": "sessions", "session_ids": ["sesn_01...", "sesn_02..."] }
  ],
  "outputs": [],
  "model": { "id": "claude-opus-4-8" },
  "instructions": "Focus on coding-style preferences; ignore one-off debugging notes.",
  "session_id": null,
  "created_at": "2026-04-29T17:04:10Z",
  "ended_at": null,
  "archived_at": null,
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  },
  "error": null
}

Mengarahkan dengan instruksi

Field opsional instructions mengarahkan apa yang disintesis oleh pipeline dreaming. Field ini diterapkan di seluruh pipeline: apa yang harus dibaca dengan cermat, apa yang harus digabungkan atau dibuang, dan bagaimana menyusun struktur store output.

Gunakan instructions untuk panduan sintesis tingkat tinggi seperti area fokus ("fokus pada preferensi gaya pengkodean"), konten yang harus dipertahankan tanpa perubahan, atau konvensi output yang ingin Anda terapkan di seluruh store. Pipeline ini adalah proses sintesis atas input, bukan editor yang diterapkan pada teks store, sehingga arahan imperatif yang menargetkan baris tertentu ("ubah kalimat X menjadi Y", "perbaiki hitungan di bagian Z") umumnya tidak menghasilkan perubahan. Untuk melakukan pengeditan yang ditargetkan pada memori individual, gunakan Memory Stores API langsung pada store output.

Melacak progres

Dreams berjalan secara asinkron dan biasanya memakan waktu beberapa menit hingga puluhan menit tergantung pada ukuran input. Lakukan polling pada dream berdasarkan ID untuk memeriksa status:

while dream.status in ("pending", "running"):
    time.sleep(10)
    dream = client.beta.dreams.retrieve(dream.id)
    print(f"status={dream.status} input_tokens={dream.usage.input_tokens}")

Siklus hidup

Mengamati pipeline berjalan

Setelah sebuah dream berstatus running, field session_id-nya menunjuk ke sesi yang mendasari dan menjalankan pipeline tersebut. Anda dapat melakukan streaming event sesi tersebut untuk mengamati apa yang sedang dibaca dan ditulis oleh dream secara real time. Sesi tersebut diarsipkan (bukan dihapus) ketika dream mencapai status terminal, sehingga transkripnya tetap tersedia setelahnya.

Menggunakan output

Ketika status mencapai completed, entri memory_store di outputs[] mereferensikan store yang telah terisi penuh. Ini adalah memory store biasa di workspace Anda. Tinjau dengan Memory Stores API atau di Console, lalu:

• Manfaatkan: lampirkan ke sesi-sesi berikutnya sebagai resource memory_store sebagai pengganti (atau bersama dengan) memory store input, atau
• Buang: hapus atau arsipkan.

# After the dream ends, the output holds the rebuilt memory store
output_store_id = next(
    output.memory_store_id for output in dream.outputs if output.type == "memory_store"
)

session = client.beta.sessions.create(
    agent=agent_id,
    environment_id=environment_id,
    resources=[
        {"type": "memory_store", "memory_store_id": output_store_id},
    ],
)

Dream itu sendiri tidak pernah menghapus atau memodifikasi inputnya. Pada status failed atau canceled, store output tetap ada dengan konten parsial sehingga Anda dapat memeriksa apa yang telah dihasilkan sebelum berhenti; bersihkan melalui Memory Stores API jika Anda tidak membutuhkannya.

Membatalkan dream

Cancel memindahkan dream yang berstatus pending atau running ke canceled secara langsung. Membatalkan dream yang sudah berstatus canceled adalah no-op idempoten; membatalkan dream yang berstatus completed atau failed mengembalikan kode 400.

client.beta.dreams.cancel(dream.id)

Mengarsipkan dream

Archive menetapkan archived_at pada dream yang telah mencapai status terminal (completed, failed, atau canceled); status dibiarkan tidak berubah. Dream yang diarsipkan dikecualikan dari respons list default tetapi tetap dapat dibaca berdasarkan ID. Mengarsipkan dream yang sudah diarsipkan adalah no-op idempoten. Mengarsipkan dream yang berstatus pending atau running mengembalikan kode 400; batalkan terlebih dahulu. Tidak ada fitur unarchive.

client.beta.dreams.archive(dream.id)

Mengarsipkan dream tidak menyentuh memory store output-nya; kelola itu secara terpisah melalui Memory Stores API.

Mendaftar dreams

Mengembalikan semua dream yang tidak diarsipkan di workspace, yang terbaru lebih dulu. Gunakan limit (default 20, maks 100) dan kursor page untuk paginasi. Teruskan include_archived=true untuk menyertakan dream yang diarsipkan.

for listed_dream in client.beta.dreams.list(limit=20):
    print(listed_dream.id, listed_dream.status)

Error

Daftar non-lengkap dari kemungkinan error dreaming ada di bawah ini.

Penagihan

Dreams ditagih dengan tarif token API standar untuk model yang Anda pilih; usage pada resource melaporkan total yang tepat. Biaya berskala kira-kira linear dengan jumlah dan panjang sesi input. Mulailah dengan batch sesi yang kecil dan tingkatkan setelah Anda puas dengan kualitas kurasi.

Batasan

Batas laju default berlaku untuk pembuatan dream selama fitur ini dalam versi beta. Hubungi dukungan jika Anda memerlukan batas yang lebih tinggi.