Dreams

Agen menulis ke memory store mereka saat bekerja, tetapi penulisan ini bersifat lokal dan inkremental: selama banyak sesi, sebuah memory store mengakumulasi duplikat, kontradiksi, dan entri yang 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 saling 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 sebelumnya: store yang diverifikasi, dideduplikasi, dan direorganisasi oleh Claude, dan
• 1 hingga 100 sesi: transkrip sebelumnya yang ditelusuri Claude untuk menemukan pola dan wawasan yang akan dimasukkan ke dalam output.

Dream menghasilkan memory store output lain, terpisah dari input. ID store output muncul di outputs[] dream tidak lama setelah dream mulai running, setelah alur kerja mengkloning store input; dream yang running dapat secara singkat melaporkan outputs[] yang kosong.



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 sebelumnya dan sebuah array sesi. Model yang dipilih menjalankan pipeline dreaming; selama pratinjau riset, claude-fable-5, claude-opus-4-8, claude-opus-4-7, claude-sonnet-5, 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_read_input_tokens": 0,
    "cache_creation_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 store output.

Gunakan instructions untuk panduan sintesis tingkat tinggi seperti area fokus ("fokus pada preferensi gaya penulisan kode"), konten yang harus dipertahankan tanpa perubahan, atau konvensi output yang ingin Anda terapkan di seluruh store. Pipeline 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 membuat pengeditan yang ditargetkan pada memori individual, gunakan Memory Stores API langsung pada store output.



Melacak kemajuan

Dreams berjalan secara asinkron dan biasanya memakan waktu beberapa menit hingga beberapa jam, tergantung pada jumlah transkrip 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 yang menjalankan pipeline. Anda dapat melakukan streaming event sesi tersebut untuk mengamati apa yang dibaca dan ditulis oleh dream secara real time. Sesi tersebut diarsipkan (tidak dihapus) ketika dream mencapai status terminal, sehingga transkrip 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 pilih salah satu:

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

# Setelah dream berakhir, output menyimpan penyimpanan memori yang dibangun ulang
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 dihasilkan sebelum berhenti; bersihkan melalui Memory Stores API jika Anda tidak membutuhkannya.



Membatalkan dream

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

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



Mengarsipkan dream

Pengarsipan mengatur archived_at pada dream yang telah mencapai status terminal (completed, failed, atau canceled); status dibiarkan tidak berubah. Dream yang diarsipkan dikecualikan dari respons daftar default tetapi tetap dapat dibaca berdasarkan ID. Mengarsipkan dream yang sudah diarsipkan adalah no-op yang idempoten. Mengarsipkan dream yang berstatus pending atau running mengembalikan 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.



Menampilkan daftar dream

Mengembalikan semua dream yang tidak diarsipkan di workspace, yang terbaru terlebih dahulu. Gunakan limit (default 20, maksimum 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

Berikut adalah daftar tidak lengkap dari kemungkinan error dreaming.



Penagihan

Dreams ditagih dengan tarif token API standar untuk model yang Anda pilih; usage pada resource melaporkan total yang tepat. Biaya meningkat secara kurang lebih linear dengan jumlah dan panjang sesi input. Mulailah dengan batch sesi yang kecil dan tingkatkan setelah Anda puas dengan kualitas kurasinya.



Batasan

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