Les sessions d'agent sont exploratoires. Parfois l'agent s'engage dans la mauvaise direction, ou vous voulez essayer une autre approche sans perdre ce que vous avez déjà. Kiro vous offre deux façons distinctes de revenir en arrière : les points de contrôle restaurent vos fichiers à un point antérieur de la session, et une branche démarre une nouvelle conversation à partir d'un tour antérieur. Dans Kiro IDE 1.4.215 ou une version ultérieure, la branche correspond à l'action Fork conversation; dans Kiro CLI, c'est la commande /rewind.
| Fonctionnalité | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
| Points de contrôle - restaurer les fichiers à un point antérieur | ✓ | Expérimental (v2) | — | — |
| Créer une branche de la conversation à un tour antérieur | 1.4.215+ (Fork conversation) | ✓ (/rewind) | — | — |
| Annuler les modifications de fichiers du dernier tour | ✓ | — | — | — |
Les deux mécanismes résolvent des problèmes différents :
- Les points de contrôle capturent l'état de vos fichiers au fur et à mesure que l'agent les modifie. Restaurer un point de contrôle ramène votre espace de travail à ce moment - et fait reculer le contexte de la conversation en même temps, afin que la compréhension de l'agent corresponde à l'état de fichiers restauré.
- La création d'une branche ne touche jamais à vos fichiers. Elle démarre une nouvelle session à partir d'un tour antérieur, laissant la session d'origine et vos fichiers sur le disque exactement comme ils sont. Dans l'IDE, utilisez Fork conversation; dans la CLI, utilisez
/rewind.
Utilisez un point de contrôle lorsque vous voulez annuler le travail de l'agent. Utilisez une branche lorsque vous voulez rediriger la conversation - par exemple, pour essayer une requête différente à partir du même point de départ - tout en conservant les modifications de fichiers effectuées jusqu'à présent.
Chaque fois que vous envoyez une requête à Kiro, il crée un point de contrôle. Les points de contrôle apparaissent comme des marqueurs dans votre historique de conversation. Sélectionnez Restaurer sur un marqueur de point de contrôle pour ramener à la fois votre base de code et le contexte de Kiro à ce moment précis. Toutes les modifications apportées à votre base de code par Kiro après ce point de contrôle sont annulées, et tous les ajouts de contexte (interactions de conversation) après ce point sont également abandonnés.
Les points de contrôle agissent comme un filet de sécurité qui vous permet d'explorer en toute confiance plusieurs approches à un problème, d'essayer différents modèles pour une tâche donnée et de récupérer après des erreurs ou des incompréhensions de l'agent.
Dans Kiro IDE 1.4.215 ou une version ultérieure, Fork conversation démarre un nouveau clavardage à partir d'un tour antérieur et ne touche pas à vos fichiers. Pour annuler plutôt les modifications de fichiers de l'agent, restaurez un point de contrôle.
- Dans le clavardage, trouvez le tour à partir duquel vous voulez créer une branche. Il peut s'agir du dernier tour ou d'un tour antérieur.
- Dans le pied de page de ce tour, sélectionnez Fork conversation.
Kiro crée un nouveau clavardage qui reprend la conversation jusqu'au tour sélectionné inclusivement. Dans une fenêtre IDE ordinaire, Kiro ouvre la branche. Dans Agent Focus, le clavardage d'origine reste sélectionné; sélectionnez donc la nouvelle branche avant de continuer. Le clavardage d'origine reste ouvert et inchangé, et vos fichiers sur le disque restent tels qu'ils sont. Pour confirmer, vérifiez que le nouveau clavardage se termine au tour que vous avez sélectionné, puis envoyez une requête différente.
La création de branches est offerte seulement pour les clavardages locaux. Une branche ne reprend pas les artéfacts du clavardage d'origine. Fork conversation n'est pas offert dans les clavardages d'étape de workflow, dans le panneau de détails Agent Focus ni dans une fenêtre rattachée à une seule session infonuagique.
Les points de contrôle fonctionnent en capturant le contenu d'un fichier chaque fois que l'agent Kiro le modifie à l'aide d'un de ses outils intégrés de modification de fichiers, puis en restaurant cette capture lorsque vous revenez à ce point de contrôle.
Kiro ne suit pas les modifications apportées à un fichier en dehors de l'agent Kiro. Si Kiro capture un fichier et que vous modifiez ensuite manuellement ce même fichier ou que vous exécutez un outil de formatage de code sur celui-ci, vos modifications seront perdues lorsque vous reviendrez à ce point de contrôle. Kiro ne suit pas non plus les modifications de fichiers effectuées par les outils MCP ou les commandes bash qu'il exécute dans le cadre de son exécution.
Chaque fois que l'agent Kiro modifie un ou plusieurs fichiers puis termine son tour, vous verrez une option pour annuler les modifications apportées par l'agent immédiatement au-dessus de la zone de saisie de la conversation.
Les annulations sont similaires aux points de contrôle, mais diffèrent sur deux aspects clés. Premièrement, les annulations n'annulent que les modifications apportées par le dernier tour de l'agent, alors que les points de contrôle peuvent annuler des modifications apportées sur plusieurs tours. Deuxièmement, les annulations n'annulent que les modifications de fichiers, alors que les points de contrôle annulent les modifications de fichiers ainsi que les ajouts de contexte postérieurs au point de contrôle.
- Gestion des sessions - enregistrer, charger et reprendre des sessions CLI
- Compaction - comment Kiro résume l'historique plus ancien pour garder les longues sessions productives
- Permissions - contrôlez ce que l'agent peut faire avant que des modifications ne se produisent, plutôt que de les annuler après coup
Points de contrôle et rewind