Claude Platform Docs
MessaggiGestione del contesto

Panoramica della compattazione

Scopri cosa fa la compattazione, come differiscono la compattazione su richiesta e la compattazione a una soglia di token, e quale pagina copre il tuo compito.

La “compaction” (compattazione) sostituisce i turni più vecchi di una conversazione con un riepilogo che Claude scrive sul server, così non hai bisogno di alcun codice di riepilogo tuo. Mantiene una conversazione lunga o un’attività agentica all’interno della “context window” (finestra di contesto) e mantiene piccolo il contesto attivo, perché la qualità delle risposte peggiora man mano che una conversazione cresce.

Se vuoi saltare questa panoramica, inizia con Compattazione su richiesta per aggiungere la compattazione alla tua applicazione. Sebbene sia questa sia la Compattazione a una soglia di token siano in beta, la Compattazione su richiesta copre più casi d’uso comuni. Per eliminare i vecchi risultati degli strumenti o i vecchi blocchi di ragionamento in base a una regola invece di riassumerli, consulta Modifica del contesto.

Scegli come compattare

Usa la compattazione su richiesta ovunque sia disponibile.

Compattazione su richiestaCompattazione a una soglia di tokenIl tuo riassuntore
Chi decide quandoTu, inviando una richiestaL’API, quando i token di input raggiungono la soglia di attivazione che hai impostatoTu
Codice che scriviUn ciclo di compattazione che richiede il riassunto e lo inserisce al posto dei messaggiUn parametro sulle tue richieste ordinarieLa chiamata di riassunto, il suo prompt e la riscrittura della cronologia
Cosa rinvii dopoIl blocco restituito, posto per primo in messages, al posto dei messaggi che riassumeLa risposta, aggiunta come di consueto. L’API scarta ciò che precede il bloccoIl tuo riassunto, come un tuo messaggio
I turni recenti restano parola per parolaSì: Compattazione che mantiene i turni recentiSì, mettendo in pausa dopo la compattazione e reinserendoliSì
Viene eseguita in backgroundSì: Compattazione in backgroundNo: viene eseguita all’interno della richiesta che raggiunge la sogliaSì, nel tuo codice
I turni mantenuti conservano il loro ragionamento, sui modelli con ragionamento preservatoSì, alle condizioni descritte in Compattazione e ragionamento preservatoNo: rimuovi il ragionamento dai turni che reinserisci, oppure lascia che sia l’API a scartarlo con prefix_mismatch_behavior: "drop_block" (vedi gli esempi di compattazione a soglia)No: quel ragionamento non supera il controllo del prefisso
Header beta, parametro e piattaformecompact-2026-09-04 e il parametro di primo livello compaction. Piattaforme: vedi la sezione sul supporto API per la compattazione su richiestaVedi la sezione sul supporto API per la compattazione a soglia e Utilizzo di baseNessuno. Viene eseguita nel tuo codice
Sceglila quandoLa tua applicazione deve controllare quando avviene la compattazione, non può mettersi in pausa mentre viene scritto un riassunto, o deve mantenere i turni recenti e il loro ragionamentoVuoi che l’API gestisca il contesto all’interno delle richieste ordinarieEsegui già un tuo riassuntore e questo sostituisce l’intera cronologia con il riassunto

Opzioni di compattazione su richiesta

Compattazione su richiesta mostra un ciclo che riepiloga l’intera conversazione mentre la tua applicazione attende. Le prime due pagine in questo elenco cambiano il modo in cui quel ciclo viene eseguito, e puoi combinarle. La terza si applica se rimandi indietro i blocchi di ragionamento e fai una delle due cose.

  • Compattazione che mantiene i turni recenti: quando gli ultimi turni devono raggiungere Claude parola per parola. Il riepilogo copre solo i turni più vecchi.
  • Compattazione in background: quando la conversazione non può mettersi in pausa per il riepilogo. La richiesta viene eseguita mentre il lavoro continua, e sostituisci il blocco quando arriva.
  • Compattazione e ragionamento preservato: se rimandi indietro i blocchi di ragionamento su un modello con ragionamento preservato e mantieni i turni recenti o compatti in background. Altrimenti saltala.
  • Scrivi il tuo prompt di riepilogo: quando il riepilogo predefinito scarta qualcosa di cui un turno successivo ha bisogno. Il tuo prompt sostituisce quello predefinito.
  • Compatta di nuovo: quando una conversazione che inizia già con un blocco di compattazione torna a diventare lunga.

Trova questi argomenti su altre pagine:

La compattazione a soglia ha una pagina dedicata: Compattazione a una soglia di token.

Questa pagina ti è stata utile?