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é | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
| Compaction automatique | ✓ | ✓ | ✓ | ✓ |
Déclenchement manuel (/compact) | — | ✓ | — | — |
| Indicateur d'utilisation du contexte | ✓ | ✓ | ✓ | ✓ |
Lorsque votre conversation approche de la limite de contexte du modèle, la compaction se déclenche automatiquement :
- Génération de résumé - Kiro crée un résumé structuré qui capture vos objectifs, décisions, progrès et prochaines étapes
- 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
- 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.
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.
| 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és | Extraits de code dans les messages précédents |
| Prochaines étapes | Détails d'erreurs des problèmes résolus |
| Votre intention et vos exigences énoncées | Discussions 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é.
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.
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ètre | Par défaut | Description |
|---|---|---|
compaction.autoCompactionThreshold | 80 | Pourcentage 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.excludeMessages | 2 | Nombre minimal de paires de messages récents à conserver textuellement |
compaction.excludeContextWindowPercent | 2 | Pourcentage 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.
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.
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.
Compaction