Passer au contenu principal
Afficher en Markdown

Agents intégrés

Kiro est fourni avec des agents intégrés pour les flux de travail de développement courants. Ceux-ci utilisent le même cadre d'agent que les agents personnalisés, mais sont préconfigurés et maintenus par Kiro. Vous pouvez basculer entre les agents principaux pendant une session ou les invoquer avec des contrôles d'interface utilisateur dédiés et des commandes à barre oblique. Kiro dispose aussi de sous-agents intégrés qu'il invoque de lui-même. Dans Kiro CLI V3, le sous-agent Introspect répond aux questions sur Kiro. Dans Kiro CLI V3 et Kiro IDE, le sous-agent de validation vérifie une modification plus importante une fois celle-ci terminée.

AgentIDECLIObjectif
Default✓✓Assistant de programmation à usage général
Spec✓✓Développement de fonctionnalités structuré (exigences, conception, tâches)
Quick Spec✓✓Flux de travail Spec rapide - génère automatiquement toutes les phases sans portes d'approbation
Bug Fix✓✓Investigation et résolution structurées des bogues
Plan✓✓Planification en lecture seule avant l'exécution
Guide—✓Aide CLI ancrée dans la documentation (interface terminale)
Help—✓Aide CLI ancrée dans la documentation (interface classique)

Agent Default

L'agent Default est l'assistant à usage général qui démarre avec chaque session. Il a accès à tous les outils intégrés, aux serveurs MCP et au contexte de votre espace de travail. La plupart des tâches de développement - écrire du code, déboguer, refactoriser, répondre à des questions - se déroulent ici.

Vous n'avez pas besoin de l'invoquer explicitement; c'est le point de départ de toutes les sessions.

Agents Spec

Les agents Spec, Quick Spec et Bug Fix produisent des documents formels d'exigences, de conception et de tâches stockés dans .kiro/specs/. Ils vous guident à travers des phases structurées avec des portes d'approbation entre chacune.

Au démarrage d'une nouvelle session, l'écran « Let's build » affiche des options de flux de travail sous « Start with a workflow » :

Flux de travailCe qu'il produit
SpecExigences → conception → tâches avec portes d'approbation entre les phases
Quick SpecLes trois phases sont générées automatiquement sans portes - le chemin le plus rapide vers l'implémentation
Bug FixAnalyse des causes profondes → conception du correctif → tâches d'implémentation

Sélectionnez un flux de travail pour démarrer une session avec cet agent. Vous pouvez également invoquer les specs en cours de session en cliquant sur Build with spec dans la zone de saisie du clavardage.

Pour le guide complet sur les flux de travail de développement structuré, voir Specs.

Agent Plan

Le mode Plan vous aide à réfléchir avant d'agir. Il fonctionne en mode lecture seule - explorant votre base de code, recueillant les exigences et produisant des plans d'implémentation sans effectuer de modifications. Une fois que vous approuvez, il transfère le contrôle à l'agent Default pour l'exécution.

Sélectionnez Plan dans le sélecteur de flux de travail au démarrage d'une nouvelle session, ou basculez vers celui-ci en cours de session à l'aide du sélecteur d'agent dans la barre de saisie du clavardage (cliquez sur le nom de l'agent, p. ex. « Default », et sélectionnez Plan).

Ce que le mode Plan peut accéder

OpérationDisponible
Lecture de fichiers, intelligence du code, recherche✓
Recherche Web✓
Écriture de fichiers, exécution de commandes, outils MCP—

Pour le flux de travail complet du mode Plan et les meilleures pratiques, voir Mode Plan.

Sous-agent Introspect

Dans une session Kiro CLI V3, posez des questions à Kiro sur ses propres fonctionnalités, par exemple quel déclencheur de Hook se déclenche à quel moment ou ce que fait un paramètre, et Kiro peut invoquer le sous-agent Introspect intégré, qui répond à partir de la documentation officielle de Kiro. Kiro décide s'il délègue la question; vous ne basculez pas vers ce sous-agent, de sorte qu'il n'apparaît pas dans le tableau ci-dessus. Il lit les pages de documentation avec les outils web_fetch et read_file et on lui indique quel client Kiro vous utilisez, de sorte que ses réponses correspondent à la CLI. Il ne modifie pas votre configuration : pour créer ou modifier des agents, des Hooks ou des fichiers Steering, adressez-vous à l'agent par défaut.

Sous-agent de validation

Le sous-agent de validation vérifie une modification que l'agent par défaut a terminée par rapport à ce que vous avez demandé. Il s'exécute dans son propre contexte, séparé de la conversation de l'agent par défaut, et signale toute exigence que la modification a manquée avant que le travail soit déclaré terminé. Tous les comptes ne l'ont pas encore; consultez Disponibilité.

Après que l'agent par défaut a terminé une modification, il décide si celle-ci a besoin d'une validation. Il est conçu pour effectuer la vérification seulement lorsque la modification est substantielle et pas encore vérifiée. Substantielle signifie qu'elle touche trois fichiers ou plus, ajoute un nouveau module ou couvre plusieurs exigences distinctes. Pas encore vérifiée signifie que l'agent n'a pas déjà contrôlé chaque exigence. Les réponses en lecture seule, les modifications cosmétiques et les petites modifications à but unique ne déclenchent pas cette vérification. Les agents Plan, Spec, Quick Spec et Bug Fix ne l'utilisent pas.

Pour l'exécuter sur demande, demandez-le dans votre requête :

Add retries to the upload client and a flag to turn them off, then invoke the validation sub-agent

Le sous-agent de validation part de votre requête initiale, d'un court résumé de ce qui a changé et des tests que l'agent par défaut a déjà exécutés. Il est conçu pour :

  • Décomposer votre requête en quelques affirmations concrètes, au plus cinq.
  • Vérifier chaque affirmation à l'aide d'éléments probants tirés de l'espace de travail ou d'un test ciblé. Lorsqu'aucun test ne convient, il peut écrire une courte vérification, l'exécuter, puis la supprimer. Pour une affirmation qualitative, il s'appuie sur son propre jugement en dernier recours.
  • Réutiliser les résultats de tests dont l'agent par défaut dispose déjà, et éviter d'exécuter votre build ou votre suite de tests au complet.
  • Noter les échecs qui semblent préexistants ou liés à l'environnement sans les signaler comme des problèmes de la modification.

Il rapporte ensuite une réussite, ou un échec avec une raison d'une ligne pour chaque exigence non satisfaite. En cas d'échec, l'agent par défaut effectue une seule passe de correction limitée, puis s'arrête. Il n'exécute pas de nouveau le sous-agent de validation sur la même modification. L'agent par défaut rapporte toute exigence qu'il n'a pas pu corriger dans les mots mêmes du sous-agent, de sorte que la décision finale vous revient. Le sous-agent de validation ne remplace pas vos propres tests ni votre revue de code. Une réussite signifie que les vérifications qu'il a choisies n'ont trouvé aucune lacune, et non que la modification est correcte.

L'étiquette diffère selon le client. Dans l'IDE, il apparaît comme une étape de sous-agent intitulée Sub-agent: validation. Dans la CLI, l'étape porte l'étiquette Subagent avec validation comme cible.

Le démarrage du sous-agent de validation ne vous demande aucune confirmation. Ses propres modifications de fichiers et commandes shell suivent les mêmes approbations que l'agent par défaut. Il n'a aucune permission propre et hérite de la politique de la session, de sorte qu'il ne peut rien faire que l'agent par défaut ne pourrait pas faire. Pour savoir comment Kiro approuve les appels d'outils des sous-agents, consultez Permissions des sous-agents.

Disponibilité

Kiro déploie progressivement le sous-agent de validation dans Kiro CLI V3 et Kiro IDE. Vous n'avez aucun paramètre à modifier. Lorsque le déploiement atteint votre compte, l'agent par défaut peut commencer à l'utiliser. D'ici là, Kiro ne l'offre pas, et le demander n'a aucun effet. Les sessions Kiro CLI 2.x et Kiro Web ne font pas partie de ce déploiement.

Agent Guide (CLI seulement)

L'agent Guide fournit des réponses ancrées dans la documentation à propos de Kiro. Contrairement aux connaissances générales de l'agent Default, l'agent Guide effectue une recherche dans la documentation indexée correspondant à votre version installée.

bash
> /guide

Appuyez sur Shift+Tab pour revenir à votre agent précédent.

Ce que vous pouvez demander

  • Commandes - commandes à barre oblique, commandes CLI, leurs options et comportements
  • Paramètres - options de configuration disponibles
  • Fonctionnalités - MCP, hooks, steering, agents personnalisés, sous-agents, intelligence du code
  • Créer des fichiers - générer des configurations d'agent, des requêtes et des fichiers steering dans .kiro/

L'agent Guide utilise l'outil introspect - une recherche hybride (sémantique + BM25) sur la documentation indexée intégrée au moment de la compilation.

Agent Help (CLI seulement)

L'agent Help fournit la même assistance ancrée dans la documentation que l'agent Guide, mais dans l'interface classique (non-TUI). Invoquez avec /help ou /help <question>.

Basculer entre les agents

Lorsque vous ouvrez une nouvelle session, l'écran « Let's build » propose des options de flux de travail :

  • Spec - Développement de fonctionnalités structuré
  • Plan - Mode planification seulement (lecture seule, aucune modification)
  • Bug Fix - Investigation structurée des bogues
  • Quick Spec - Flux de travail Spec rapide sans portes d'approbation

La sélection d'un flux de travail change automatiquement l'agent actif pour cette session. Vous pouvez également changer d'agent en cours de session en cliquant sur le nom de l'agent (p. ex. « Default ») dans la barre inférieure du panneau de clavardage pour ouvrir le sélecteur d'agent.

Créer vos propres agents

Les agents intégrés démontrent comment Kiro utilise les configurations d'agent pour des flux de travail spécialisés. Vous pouvez créer vos propres agents avec les mêmes capacités - outils, permissions, requêtes et modèles adaptés à vos flux de travail spécifiques.

Voir Créer des agents personnalisés pour commencer.

Si vous utilisez CLI 2.x, consultez les noms intégrés dans la référence de CLI 2.x.

Page mise à jour : 13 novembre 2026