Passer au contenu principal
Afficher en Markdown

Compaction

La compaction permet de maintenir la productivité des longues sessions en résumant automatiquement l'historique des conversations plus ancien à mesure que votre session progresse. Vos objectifs, décisions et progrès techniques sont préservés - seule la partie centrale verbeuse est compressée.

CapacitéIDECLIWebMobile
Compaction automatique✓✓✓✓
Déclenchement manuel (/compact)—✓——
Indicateur d'utilisation du contexte✓✓✓✓

Comment ça fonctionne

Lorsque votre conversation approche de la limite de contexte du modèle, la compaction se déclenche automatiquement :

  1. Génération de résumé - Kiro crée un résumé structuré qui capture vos objectifs, décisions, progrès et prochaines étapes
  2. Réduction du contexte - L'historique de conversation plus ancien est remplacé par le résumé, tandis que vos messages les plus récents sont conservés textuellement
  3. Continuation - La session se poursuit là où vous l'aviez laissée, sans interruption

Dans les sessions V3 de la CLI, la réponse active et l'indicateur de réflexion restent visibles pendant la compaction automatique. Les requêtes déjà en attente se poursuivent automatiquement une fois la compaction terminée.

Dans Kiro CLI 3.1.0 ou une version ultérieure, les sessions V3 exécutent les Hooks PreCompact avant la compaction et les Hooks PostCompact après celle-ci. Un Hook PreCompact peut refuser la compaction; un Hook PostCompact reçoit le résumé. Consultez Types de Hooks.

Vos objectifs, décisions, modifications de fichiers et contraintes énoncées survivent à la compaction. Ce qui est compressé, c'est le résultat intermédiaire - les détails des appels d'outils, les discussions exploratoires et les messages d'erreur résolus.

Exemple

Vous travaillez sur une tâche de refactorisation depuis 45 minutes - l'agent a modifié 12 fichiers, exécuté des tests et corrigé trois erreurs de build. L'utilisation du contexte est à 80 %.

La compaction se déclenche. Le résumé capture : quels fichiers ont été modifiés, quels tests réussissent, les 2 fichiers restants à refactoriser, et votre contrainte selon laquelle « tous les changements doivent être rétrocompatibles ». Les deux derniers échanges (votre instruction la plus récente et la réponse de l'agent) sont conservés textuellement.

L'agent continue immédiatement. Il sait ce qui est fait, ce qui reste à faire, et quelles sont vos règles - sans avoir à conserver 45 minutes de résultats d'outils intermédiaires.

Ce qui est préservé ou résumé

Toujours préservéPeut être résumé
Statut des tâches (terminé / en cours / en attente)Détails des appels d'outils individuels
Chemins des fichiers modifiésÉtapes de raisonnement intermédiaires
Décisions et contraintes clésExtraits de code dans les messages précédents
Prochaines étapesDétails d'erreurs des problèmes résolus
Votre intention et vos exigences énoncéesDiscussions exploratoires

Dans Kiro IDE 1.4.178 ou une version ultérieure, Kiro indique à l'agent quels Skills et fichiers de Steering chargés le résumé a retirés, et l'agent recharge ceux que vous aviez demandés. Un Skill ou un fichier de Steering de 30 000 caractères ou plus se charge au complet lorsqu'il y a de la place pour lui après un résumé, au lieu d'un aperçu abrégé.

Déclenchement de la compaction

La compaction est automatique dans l'IDE. Il n'y a pas de déclenchement manuel.

L'indicateur d'utilisation du contexte dans le panneau de clavardage montre à quel point vous êtes près de la limite du modèle. Lorsque la compaction se déclenche, l'indicateur se réinitialise pour refléter l'espace libéré et la session se poursuit.

Configuration

La CLI expose des paramètres qui contrôlent le moment où la compaction automatique démarre et la quantité de contexte conservée :

ParamètrePar défautDescription
compaction.autoCompactionThreshold80Pourcentage d'utilisation du contexte à partir duquel la compaction automatique démarre dans une session V3 (Kiro CLI 3.3.0 ou version ultérieure). Un nombre de 0 à 100 comportant au plus deux décimales
compaction.excludeMessages2Nombre minimal de paires de messages récents à conserver textuellement
compaction.excludeContextWindowPercent2Pourcentage minimal de la fenêtre de contexte à conserver comme messages récents

Les deux paramètres d'exclusion sont évalués ensemble, et la valeur la plus conservatrice (la plus grande) l'emporte. Cela garantit qu'un contexte récent suffisant est toujours disponible pour que l'agent maintienne la continuité.

Dans Kiro CLI 3.3.0 ou version ultérieure, une session V3 peut aussi définir le seuil à partir de /settings. Ouvrez Compaction pour activer ou désactiver la compaction automatique, voir le seuil qu'utilise la session en cours et modifier le Global default. L'éditeur affiche la plage qu'accepte le harnais d'agent et sa valeur par défaut; la valeur que vous enregistrez s'applique à la prochaine session que vous démarrez ou chargez. kiro-cli settings compaction.autoCompactionThreshold <value> accepte de 0 à 100, et une session interactive applique la plage qu'annonce le harnais d'agent. Une valeur compaction.autoCompactionThreshold dans un fichier .kiro/settings/cli.json d'espace de travail remplace la valeur globale par défaut pour cet espace de travail. Consultez Paramètres en session.

Limitations

La compaction est à sens unique. L'historique complet de la conversation avant le point de compaction n'est pas récupérable au sein de la session. Si vous devez préserver l'historique complet, exportez votre session avant que la compaction ne se produise.

Versions précédentes

Dans IDE 0.x, cette fonctionnalité s'appelait « Summarization ». Le comportement était similaire (déclenchement automatique à 80 % d'utilisation du contexte), mais créait une nouvelle session avec le contexte compacté plutôt que de continuer dans la même session. Consultez la référence 0.x pour connaître le comportement antérieur.

Page mise à jour : 13 novembre 2026