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 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 diverifikasi, dideduplikasi, dan direorganisasi oleh Claude, dan
• 1 hingga 100 sesi: transkrip sebelumnya yang ditambang Claude untuk mencari pola dan wawasan yang akan dimasukkan ke dalam output.

Dream menghasilkan output memory store lain, terpisah dari input. ID output store muncul di outputs[] milik dream sesaat setelah dream mulai running, setelah alur kerja mengkloning input store; 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 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 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. Ini diterapkan di seluruh pipeline: apa yang harus dibaca dengan cermat, apa yang harus digabungkan atau dibuang, dan bagaimana menyusun struktur output store.

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 pada output store secara langsung.



Melacak progres

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 dream berstatus running, field session_id-nya menunjuk ke sesi yang mendasari dan menjalankan pipeline. Anda dapat melakukan streaming event sesi tersebut untuk mengamati apa yang sedang dibaca dan ditulis oleh dream secara real time. Sesi diarsipkan (bukan 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:

• Manfaatkan: lampirkan ke sesi mendatang sebagai resource memory_store sebagai pengganti (atau bersama dengan) input memory store, 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, output store 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

Cancel 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

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 yang idempoten. Mengarsipkan dream yang berstatus pending atau running mengembalikan 400; batalkan terlebih dahulu. Tidak ada unarchive.

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

Mengarsipkan dream tidak menyentuh output memory store-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

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 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 pratinjau riset. Hubungi dukungan jika Anda memerlukan batas yang lebih tinggi.