Descripción general de la compactación
Aprende qué hace la compactación, en qué se diferencian la compactación bajo demanda y la compactación en un umbral de tokens, y qué página cubre tu tarea.
La “compaction” (compactación) reemplaza los turnos más antiguos de una conversación con un resumen que Claude escribe en el servidor, por lo que no necesitas código de resumen propio. Mantiene una conversación larga o una tarea de agente dentro de la “context window” (ventana de contexto), y mantiene pequeño el contexto activo, porque la calidad de las respuestas se degrada a medida que crece una conversación.
Si quieres omitir esta descripción general, comienza con Compactación bajo demanda para agregar compactación a tu aplicación. Aunque tanto esta como Compactación en un umbral de tokens están en beta, la compactación bajo demanda cubre más casos de uso comunes. Para borrar resultados de herramientas antiguos o bloques de pensamiento antiguos mediante reglas en lugar de resumirlos, consulta Edición de contexto.
Elige cómo compactar
Usa la compactación bajo demanda siempre que esté disponible.
| Compactación bajo demanda | Compactación en un umbral de tokens | Tu propio resumidor | |
|---|---|---|---|
| Quién decide cuándo | Tú, al enviar una solicitud | La API, cuando los tokens de entrada alcanzan el activador que configuras | Tú |
| Código que escribes | Un bucle de compactación que solicita el resumen y lo coloca en lugar de los mensajes | Un parámetro en tus solicitudes habituales | La llamada de resumen, su prompt y la reescritura del historial |
| Qué envías de vuelta después | El bloque devuelto, primero en messages, en lugar de los mensajes que resume | La respuesta, añadida como de costumbre. La API omite lo que vino antes del bloque | Tu resumen, como un mensaje propio |
| Los turnos recientes se mantienen palabra por palabra | Sí: Compactación que conserva los turnos recientes | Sí, pausando después de la compactación y reinsertándolos | Sí |
| Se ejecuta en segundo plano | Sí: Compactación en segundo plano | No: se ejecuta dentro de la solicitud que alcanza el umbral | Sí, en tu propio código |
| Los turnos conservados mantienen su pensamiento, en modelos con pensamiento preservado | Sí, bajo las condiciones de Compactación y pensamiento preservado | No: elimina el pensamiento de los turnos que reinsertas, o deja que la API lo omita con prefix_mismatch_behavior: "drop_block" (consulta los ejemplos de compactación por umbral) | No: ese pensamiento no supera la verificación de prefijo |
| Encabezado beta, parámetro y plataformas | compact-2026-09-04 y el parámetro compaction de nivel superior. Plataformas: consulta la sección de soporte de la API para la compactación bajo demanda | Consulta la sección de soporte de la API para la compactación por umbral y Uso básico | Ninguno. Se ejecuta en tu código |
| Elígelo cuando | Tu aplicación necesita controlar cuándo ocurre la compactación, no puede pausarse mientras se escribe un resumen, o debe conservar los turnos recientes y su pensamiento | Quieres que la API gestione el contexto dentro de solicitudes habituales | Ya ejecutas tu propio resumidor y este reemplaza todo el historial con el resumen |
Opciones de compactación bajo demanda
Compactación bajo demanda muestra un bucle que resume toda la conversación mientras tu aplicación espera. Las dos primeras páginas de esta lista cambian cómo se ejecuta ese bucle, y puedes combinarlas. La tercera aplica si envías bloques de pensamiento de vuelta y haces cualquiera de las dos.
- Compactación que conserva los turnos recientes: cuando los últimos turnos deben llegar a Claude palabra por palabra. El resumen cubre solo los turnos más antiguos.
- Compactación en segundo plano: cuando la conversación no puede pausarse para el resumen. La solicitud se ejecuta mientras el trabajo continúa, y sustituyes el bloque cuando llega.
- Compactación y pensamiento preservado: si envías bloques de pensamiento de vuelta en un modelo con pensamiento preservado y conservas los turnos recientes o compactas en segundo plano. De lo contrario, omítela.
- Escribir tu propio prompt de resumen: cuando el resumen predeterminado omite algo que un turno posterior necesita. Tu prompt reemplaza al predeterminado.
- Compactar de nuevo: cuando una conversación que ya comienza con un bloque de compactación vuelve a crecer.
Encuentra estos temas en otras páginas:
- Solicitar un resumen se encuentra en Compactación bajo demanda.
- Continuar desde el resumen se encuentra en Compactación bajo demanda. Las condiciones que mantienen válido el pensamiento en los turnos que conservas se encuentran en Compactación y pensamiento preservado.
- Cuando no se devuelve ningún resumen: consulta Gestionar un resumen faltante o un error en Compactación bajo demanda.
- Cómo encaja con el resto de la API: consulta Límites e interacciones con otras funciones en Compactación bajo demanda.
- Comprender el uso: consulta Contabilizar el uso de la compactación para la compactación bajo demanda, o Comprender el uso para la compactación por umbral.
- Compatibilidad: cada tipo tiene su propio encabezado beta, por lo que cada página tiene su propia sección: Soporte de la API para la compactación bajo demanda y Soporte de la API para la compactación por umbral.
La compactación por umbral tiene su propia página: Compactación en un umbral de tokens.
¿Te resultó útil esta página?