Dreams

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

Dreams (mimpi) memungkinkan Claude membersihkannya. Sebuah dream membaca memory store yang sudah ada bersama dengan transkrip sesi sebelumnya, lalu menghasilkan memory store baru yang telah ditata ulang: duplikat digabungkan, entri yang usang atau bertentangan diganti dengan nilai terbaru, dan wawasan baru dimunculkan.

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

Cara kerjanya

Sebuah dream adalah pekerjaan asinkron yang menerima:

• sebuah memory store yang sudah ada: store yang diverifikasi, dideduplikasi, dan ditata ulang oleh Claude, dan
• 1 hingga 100 sesi: transkrip sebelumnya yang digali 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 tidak lama setelah dream mulai running, setelah alur kerja mengkloning store input; dream yang running dapat sesaat 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 dan sebuah array sesi. Model yang dipilih menjalankan pipeline dreaming. Selama pratinjau riset, claude-opus-5, claude-fable-5, claude-opus-4-8, claude-opus-4-7, claude-sonnet-5, dan claude-sonnet-4-6 didukung. Anda dapat secara opsional memberikan 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 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 jumlah di bagian Z") umumnya tidak menghasilkan perubahan. Untuk melakukan pengeditan terarah 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, bergantung 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 dream berstatus running, field session_id-nya menunjuk ke sesi dasar 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 (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 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 telah dihasilkan sebelum berhenti; bersihkan melalui Memory Stores API jika Anda tidak membutuhkannya.

Membatalkan dream

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

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

Mengarsipkan dream

Pengarsipan menetapkan 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 pending atau running mengembalikan 400; batalkan terlebih dahulu. Tidak ada pembatalan arsip.

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

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

Mendaftar dreams

Mengembalikan semua dream yang tidak diarsipkan di workspace, yang terbaru terlebih dahulu. Gunakan limit (default 20, maksimum 100) dan kursor page untuk melakukan paginasi. Berikan 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 kira-kira secara linear dengan jumlah dan panjang sesi input. Mulailah dengan batch sesi yang kecil dan tingkatkan setelah Anda puas dengan kualitas kurasinya.

Batas

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