Claude Platform Docs
PesanManajemen konteks

Ikhtisar compaction

Pelajari apa yang dilakukan compaction, perbedaan antara compaction sesuai permintaan dan compaction pada ambang batas token, serta halaman mana yang membahas tugas Anda.

“Compaction” (pemadatan) menggantikan giliran-giliran lama dalam percakapan dengan ringkasan yang ditulis Claude di server, sehingga Anda tidak memerlukan kode peringkasan sendiri. Compaction menjaga percakapan panjang atau tugas agen tetap berada di dalam “context window” (jendela konteks), dan menjaga konteks aktif tetap kecil, karena kualitas respons menurun seiring bertambah panjangnya percakapan.

Jika Anda ingin melewati ikhtisar ini, mulailah dengan Compaction sesuai permintaan untuk menambahkan compaction ke aplikasi Anda. Meskipun fitur tersebut dan Compaction pada ambang batas token sama-sama masih dalam beta, Compaction sesuai permintaan mencakup lebih banyak kasus penggunaan umum. Untuk membersihkan hasil alat lama atau blok pemikiran lama berdasarkan aturan alih-alih meringkasnya, lihat Pengeditan konteks.

Pilih cara melakukan compaction

Gunakan compaction sesuai permintaan di mana pun fitur tersebut tersedia.

Compaction sesuai permintaanCompaction pada ambang batas tokenPeringkas Anda sendiri
Siapa yang menentukan kapanAnda, dengan mengirim permintaanAPI, ketika token input mencapai pemicu yang Anda tetapkanAnda
Kode yang Anda tulisSebuah loop compaction yang meminta ringkasan dan menggantikannya ke dalam riwayatSatu parameter pada permintaan biasa AndaPanggilan peringkasan, prompt-nya, dan penulisan ulang riwayat
Apa yang Anda kirim kembali setelahnyaBlok yang dikembalikan di urutan pertama dalam messages, menggantikan pesan-pesan yang diringkasnyaRespons, ditambahkan seperti biasa. API tidak menyertakan apa yang ada sebelum blok tersebutRingkasan Anda, sebagai pesan Anda sendiri
Giliran terbaru tetap kata demi kataYa: Compaction yang mempertahankan giliran terbaruYa, dengan menjeda setelah compaction dan memasukkannya kembaliYa
Berjalan di latar belakangYa: Compaction di latar belakangTidak: berjalan di dalam permintaan yang mencapai ambang batasYa, di kode Anda sendiri
Giliran yang dipertahankan tetap menyimpan pemikirannya, pada model dengan pemikiran yang dipertahankanYa, dengan ketentuan dalam Compaction dan pemikiran yang dipertahankanTidak: hapus pemikiran dari giliran yang Anda masukkan kembali, atau biarkan API tidak menyertakannya dengan prefix_mismatch_behavior: "drop_block" (lihat contoh compaction ambang)Tidak: pemikiran tersebut gagal dalam pemeriksaan prefiks
Header beta, parameter, dan platformcompact-2026-09-04 dan parameter compaction tingkat atas. Platform: lihat bagian dukungan API sesuai permintaanLihat bagian dukungan API ambang dan Penggunaan dasarTidak ada. Berjalan di kode Anda
Pilih ini ketikaAplikasi Anda perlu mengontrol kapan compaction terjadi, tidak dapat menjeda saat ringkasan sedang ditulis, atau harus mempertahankan giliran terbaru beserta pemikirannyaAnda ingin API mengelola konteks di dalam permintaan biasaAnda sudah menjalankan peringkas sendiri dan peringkas itu mengganti seluruh riwayat dengan ringkasan

Opsi compaction sesuai permintaan

Compaction sesuai permintaan menunjukkan loop yang meringkas seluruh percakapan sementara aplikasi Anda menunggu. Dua halaman pertama dalam daftar ini mengubah cara loop tersebut berjalan, dan Anda dapat menggabungkan keduanya. Halaman ketiga berlaku jika Anda mengirim kembali blok pemikiran dan melakukan salah satu dari keduanya.

  • Compaction yang mempertahankan giliran terbaru: ketika beberapa giliran terakhir harus sampai ke Claude kata demi kata. Ringkasan hanya mencakup giliran-giliran yang lebih lama.
  • Compaction di latar belakang: ketika percakapan tidak dapat berhenti sejenak untuk menunggu ringkasan. Permintaan berjalan sementara pekerjaan berlanjut, dan Anda menukarkan blok tersebut ke dalam percakapan saat blok itu tiba.
  • Compaction dan pemikiran yang dipertahankan: jika Anda mengirim kembali blok pemikiran pada model dengan pemikiran yang dipertahankan dan Anda mempertahankan giliran terbaru atau melakukan compaction di latar belakang. Jika tidak, lewati halaman ini.
  • Menulis prompt peringkasan Anda sendiri: ketika ringkasan default tidak menyertakan sesuatu yang dibutuhkan oleh giliran berikutnya. Prompt Anda menggantikan prompt default.
  • Melakukan compaction lagi: ketika percakapan yang sudah diawali dengan blok compaction kembali menjadi panjang.

Temukan topik-topik berikut di halaman lain:

Compaction ambang batas memiliki halamannya sendiri: Compaction pada ambang batas token.

Apakah halaman ini membantu?