Certains travaux sont trop vastes pour une seule session d'agent : une fonctionnalité qui exige des exigences, une conception, une implémentation, une révision indépendante et une validation. D'autres, vous préférez les confier plutôt que les surveiller : une investigation qui devrait se terminer pendant que vous continuez à travailler. Un workflow confie les deux à une équipe d'agents munie d'un plan.
Le modèle définit quels agents effectuent le travail et dans quel ordre, et l'environnement d'exécution de Kiro exécute ce plan, de sorte que chaque étape s'exécute au bon moment, sans rappel. Les workflows sont des graphes composés d'étapes d'agent, de séquences, de boucles et de branches parallèles, dans un format que les personnes comme les agents peuvent lire et créer. Chaque étape s'exécute dans sa propre session avec un nouveau contexte : un réviseur, par exemple, évalue le travail sans hériter du raisonnement de celui qui a écrit le code.
Les workflows s'exécutent en arrière-plan. Vous continuez à travailler avec Kiro dans le clavardage principal pendant que le travail délégué progresse, et la session de chaque étape reste accessible pour la mettre en pause, la reprendre ou l'orienter pendant l'exécution, puis pour y revenir avec des questions de suivi par la suite. Déléguer même une petite investigation garde le résultat de ses outils et son raisonnement détaillé hors du clavardage principal, ce qui préserve votre contexte pour le travail en cours.
Kiro génère un workflow pour la tâche à accomplir. Enregistrez-en un comme recette pour le réutiliser, ou écrivez le vôtre.
Vous n'écrivez pas d'abord une recette. Décrivez le résultat dans le clavardage parent et précisez le degré de structure ou de révision souhaité; Kiro propose un workflow pour cette tâche, nomme ses étapes et ses agents, puis le lance. Voici trois requêtes qui démarrent une exécution :
Analyse le fonctionnement de l'authentification dans ce dépôt et présente les risques avant que nous changions quoi que ce soit. Effectue la tâche en arrière-plan et remets-moi un résumé avec des références.
Livre la fonctionnalité de limitation du débit dans un nouveau worktree : exigences, révision de la conception, plan, mise en œuvre avec deux réviseurs indépendants et validation finale par rapport aux exigences.
Rétablis la compilation sans modifier le comportement. Reproduis l'échec, corrige une cause à la fois et relance la même vérification. Interromps-toi et consulte-moi après dix tentatives.
Vous pouvez également spécifier des agents personnalisés, des modèles privilégiés et l'effort de raisonnement par étape, ou orienter la façon dont Kiro répartit le travail au moyen de votre requête ou d'un fichier de Steering. Kiro fournit trois recettes que sa propre équipe utilise : investigate pour les analyses en lecture seule, feature-pipeline pour la livraison progressive de fonctionnalités et publish-pr pour ouvrir une pull request et traiter les commentaires de révision. Nommez-en une et fournissez-lui les entrées. Kiro génère les recettes en JSON; YAML est également pris en charge.
Un workflow coordonne plusieurs agents et répète les révisions, il utilise donc plus de jetons qu'une session unique. C'est le compromis : consacrez davantage de ressources à la structure et au jugement indépendant pour les travaux qui en bénéficient, et gardez les petites tâches dans le clavardage. Pour savoir comment l'utilisation des modèles est comptabilisée dans votre forfait, consultez la page Facturation.
Les workflows doivent être activés dans chaque client. Une recette est le même fichier dans Kiro IDE, Kiro CLI et Kiro Web; la façon d'activer les workflows, la provenance des recettes et les commandes disponibles varient selon le client.
Le paramètre sous-jacent est kiroAgent.workflows.enabled. Si Workflows est absent, il n'est pas encore disponible pour votre compte.
En coulisses, un workflow est un graphe : des étapes d'agents, des séquences, des boucles et des branches parallèles dans un format que Kiro et vous pouvez lire et écrire. Vous pouvez comprendre la plupart des recettes au moyen de cinq concepts :
| Concept | Signification |
|---|---|
| Étape | Un agent s'exécute dans sa propre session avec un contexte ciblé. Une étape ne peut pas lire la session d'une autre étape; elle reçoit les résultats antérieurs uniquement par des transferts explicites |
| Transfert | Un extrant capturé ou un artéfact déclaré transmet des éléments de preuve à une étape ultérieure |
| Branche et jonction | Des agents indépendants évaluent le même travail, puis une politique combine leurs résultats |
| Boucle | Un groupe d'étapes se répète jusqu'à ce que les éléments de preuve correspondent à une condition ou qu'un plafond de sécurité soit atteint |
| Attente | L'exécution surveille un système externe, une pull request ou tout ce qu'un de vos scripts peut vérifier, sans consacrer de tours de modèle lorsqu'aucun changement ne survient |
Le clavardage parent et chaque étape restent connectés dans les deux sens. Une étape fait un compte rendu vers l'extérieur avec un signal send_message qui transmet la progression, une question ou son résultat. Vous pouvez orienter une étape en cours d'exécution ou en pause à tout moment; consultez Répondre quand une étape a besoin d'une entrée.
Grâce à ces cinq concepts, la figure ci-dessous retrace une exécution à partir du clavardage parent : lancement, étapes dans leurs propres sessions, boucle de révision, retour des artéfacts et synthèse du résultat par l'agent principal. Les deux canaux restent ouverts pendant tout le processus; vous pouvez donc continuer à communiquer dans le clavardage parent et orienter une étape sélectionnée pendant son exécution.
Parent chat
availableYou
Investigate this repository, plan the change, and verify the result.
Kiro
Workflow launched. I will bring the verified result back here.
Background Workflow
delivery‑run
The gate either exits the repeat or follows the loopback.
01Ask and launch. You describe one outcome; the main agent starts a background run.
Simulation. Nothing you type here reaches a real run.
two conversations, one run: evidence flows back to the main agent, and your guidance flows in, typed to a step or relayed from the parent chat
La recette stocke cette structure sous forme d'arborescence JSON ou YAML lisible. Le produit en cours d'exécution présente la même structure sous forme de nœuds imbriqués, avec les métadonnées d'état, d'itération, d'agent, de modèle, d'effort et de durée lorsque celles-ci sont prises en charge.
Un workflow peut réviser le travail restant entre les limites des étapes à mesure que ses agents découvrent de nouvelles informations. Le travail terminé reste intact et l'étape active n'est pas réécrite pendant son exécution.
Kiro crée un point de contrôle de l'exécution aux limites des nœuds. Si une exécution se met en pause ou si le client se reconnecte, le travail terminé n'a pas à être repris depuis le début.
Ces exemples présentent des structures utiles, et non des règles. Modifiez les étapes, les agents, les modèles, les limites et les éléments de preuve d'achèvement en fonction de votre travail.
Analyser et expliquer
Analysez un dépôt inconnu en arrière-plan, rédigez un rapport avec des références et renvoyez les principaux risques et points à modifier au clavardage principal.
Éléments de preuve : artéfact de rapport et synthèse finale
Livrer une fonctionnalité
Passez par les exigences, la révision de la conception, la planification de la mise en œuvre, la programmation, la révision indépendante et la validation finale.
Éléments de preuve : conception approuvée, plan et vérifications
Dépanner jusqu'à la vérification
Reproduisez un échec, diagnostiquez-le, appliquez un correctif et exécutez les tests en boucle jusqu'à ce que la vérification configurée réussisse ou que l'exécution atteigne son plafond.
Éléments de preuve : test reproductible ou résultat lisible par machine
Publier et répondre
Ouvrez une pull request, attendez sans utiliser de tours de modèle, traitez les commentaires sans risque et recevez une pull request approuvée dont les vérifications réussissent, prête à être fusionnée.
Éléments de preuve : état de la révision, vérifications et préparation à la fusion
Consultez les exemples de workflows pour obtenir des squelettes de recettes complets et adaptables.
L'activation des workflows modifie la façon dont la session principale délègue le travail isolé. L'agent principal utilise run_workflow pour les recettes réutilisables et la délégation en arrière-plan à un seul agent. Pour exécuter un agent personnalisé, il peut lancer run_workflow(agent://<name>).
Un workflow à agent unique se comporte comme une délégation isolée ordinaire, mais il s'exécute en arrière-plan : le clavardage parent reste disponible, l'exécution peut être inspectée et les mises à jour sur la progression peuvent être transmises pendant le travail.
| Situation | Comportement de délégation |
|---|---|
| Session principale avec workflows désactivés | L'agent principal peut utiliser invoke_sub_agent pour un travail délégué ciblé |
| Session principale avec workflows activés | L'agent principal utilise run_workflow, y compris agent://<name> pour un agent personnalisé |
| Agent s'exécutant dans un workflow | Cet agent peut toujours utiliser des sous-agents lorsque sa configuration le permet |
| Processus réutilisable en plusieurs étapes | L'environnement d'exécution gère les étapes, les transferts, les boucles, les attentes et la récupération explicites |
Les sous-agents imbriqués aident une étape de workflow à diviser sa propre tâche. Ils ne sont pas des nœuds dans le workflow parent et ne peuvent pas signaler, mettre en pause, terminer ou réviser cette étape en son nom.
Les workflows sont disponibles dans Kiro IDE, Kiro CLI et les sessions infonuagiques de Kiro Web. L'activation, l'accès aux recettes, les points d'entrée de lancement et les commandes diffèrent selon le client.
| Surface | Démarrage | Inspection et interaction | Commandes actuelles |
|---|---|---|---|
| IDE | Demandez à Kiro dans le clavardage parent | Workflows au-dessus du clavardage parent; sélectionnez une étape pour ouvrir son onglet dédié Workflow step | Pause, Reprendre, Arrêter |
| CLI | /workflow run | Historique des workflows et moniteur plein écran | Pause, Reprendre, Arrêter, Réessayer les travaux ayant échoué ou ayant été abandonnés |
| Web | Demandez à Kiro dans une session infonuagique | Workflows, Summary, Files et Artifacts; sélectionnez une étape pour lui envoyer un message | Pause, Reprendre, Arrêter; Réessayer lorsqu'une exécution dans un état final comporte des nœuds en échec pouvant être réessayés |
La disponibilité sur mobile n'est pas documentée ici.
L'exemple investigate lit un projet sans modifier les fichiers sources et rédige un rapport avec des références. Commencez dans le clavardage principal avec un résultat concret :
Utilise un workflow pour déterminer où sont configurés les délais d'expiration des requêtes API. Explique les règles de priorité, cite les fichiers et les symboles pertinents, ne modifie pas le projet et enregistre le rapport sous .kiro/reports/.
Kiro peut lancer l'exécution en arrière-plan et garder le clavardage parent disponible. Suivez l'exécution dans l'interface du client :
Ouvrez Workflows au-dessus du clavardage parent, développez l'exécution et sélectionnez investigate. Kiro ouvre un onglet dédié Workflow step qui présente la session, l'agent, le modèle, l'effort et l'activité de l'étape, ainsi que le champ Message this step's agent. Gardez-le à côté du clavardage parent pour suivre les deux contextes pendant l'exécution.
Les recettes peuvent provenir de votre espace de travail (.kiro/workflows/), de votre configuration utilisateur, de recettes synchronisées pour votre compte ou de l'ensemble fourni avec Kiro; lorsqu'il y a conflit entre les noms, une recette valide d'un niveau supérieur l'emporte. Consultez Créer des workflows pour connaître les fichiers pris en charge, les règles de priorité et l'importation Web.
Les recettes fournies illustrent des structures utiles; ce sont des exemples exécutables, et non une méthodologie obligatoire ou un inventaire garanti pour chaque version du client. Examinez une recette avant de l'exécuter. Les effets secondaires dépendent à la fois de ses requêtes et des outils et autorisations des agents sélectionnés.
Vous n'avez pas à rédiger d'abord une recette à la main. Décrivez le résultat et le degré de structure ou de révision dont vous avez besoin. Kiro peut créer un workflow pour la tâche en question; enregistrez une définition révisée sous .kiro/workflows/ lorsqu'elle mérite d'être réutilisée.
Workflows