Le mode par défaut de Kiro Web est collaboratif. Vous travaillez avec l'agent de façon interactive, en itérant ensemble sur un problème. L'agent vous aide à réfléchir aux approches, à écrire du code et à ouvrir des pull requests lorsque vous êtes prêt.
Pour les tâches où vous voulez que l'agent soit responsable du résultat de bout en bout, consultez le mode autonome.
Pour une planification structurée, où vous voulez des exigences, une conception et une liste de tâches avant qu'aucun code ne soit écrit, utilisez les Specs.
Pour une orchestration réutilisable en plusieurs étapes qui s'exécute en arrière-plan tout en laissant le clavardage principal disponible, utilisez les Workflows. Les workflows sont désactivés par défaut : activez Enable workflows dans Agent Config > Workflows. Un workflow peut coordonner des agents isolés, des boucles, des révisions et des attentes externes; examinez ses différentes étapes ou envoyez-leur un message sous Workflows dans les détails de la session.
- Accédez à app.kiro.dev et cliquez sur New session
- Sélectionnez un ou plusieurs dépôts à l'aide de Select repo au bas de la zone de saisie du clavardage. Pour travailler à partir d'une branche autre que la branche par défaut, choisissez-la dans le sélecteur de branche
- Facultativement, sélectionnez Add to group pour choisir ou créer un groupe pour la session
- Décrivez ce sur quoi vous voulez travailler
Si vous ne sélectionnez pas de dépôts au préalable, vous serez invité à les choisir lorsque vous demanderez à l'agent de travailler sur quelque chose.
Dans le mode par défaut, c'est vous qui dirigez la conversation. Clavardez avec l'agent pour :
- Discuter des approches d'implémentation et des compromis
- Poser des questions sur votre base de code
- Faire écrire ou modifier du code par l'agent
- Itérer sur l'implémentation en fonction des commentaires
- Demander à l'agent d'ouvrir une pull request lorsque vous êtes satisfait
L'agent a accès à la recherche Web, au contexte de vos dépôts et aux apprentissages tirés des révisions de code précédentes pour fournir des réponses éclairées.
Les étapes de raisonnement et les appels d'outil consécutifs apparaissent dans un seul bloc réductible pendant que l'agent travaille. Développez le bloc pour examiner les détails.
Les actions de démarrage sont regroupées sous Session setup. Steering, Configuration Sync et les listes de tâches présentent leurs résultats sous forme de résumés lisibles.
Lorsque vous êtes satisfait des changements, demandez à l'agent d'ouvrir une pull request. L'agent crée une branche de fonctionnalité, effectue un commit des changements et ouvre une PR avec une description de ce qui a été fait.
Vous pouvez continuer à fournir des commentaires sur la PR. L'agent répond à vos commentaires et pousse des mises à jour.
Lorsqu'une session comporte des révisions, ouvrez Summary : Reviews s'y trouve aux côtés de Files et Artifacts. Développez Reviews pour afficher la liste sur place; sélectionner Files ou Artifacts ouvre plutôt l'onglet correspondant.
Sélectionnez une révision pour en examiner les détails, y compris ses fichiers modifiés, ses commits et ses commentaires de révision. Back vous ramène à la liste des révisions.
Vous pouvez travailler sur plusieurs dépôts au sein d'une même session. Lorsque vous sélectionnez des dépôts, l'agent les clone dans son sandbox et peut coordonner les changements dans l'ensemble de ceux-ci.
Chaque session comporte un seul fil de conversation. Vous pouvez :
- Orienter l'agent sur l'approche d'implémentation à tout moment
- Fournir des exigences ou des contraintes supplémentaires
- Demander à l'agent de poursuivre le travail après avoir examiné les résultats
Pour travailler sur un sujet différent, démarrez une nouvelle session.
Un modèle de repli prend le relais lorsque le modèle sélectionné ne peut pas traiter une requête. Pour en définir un, ouvrez Agent Config > Model fallback, choisissez un modèle dans la liste, puis choisissez son modèle de repli.
Le rôle du modèle de repli dépend de la raison de l'échec :
- Si le modèle sélectionné est indisponible, le modèle de repli répond à ce tour, et Kiro revient au modèle sélectionné au tour suivant.
- Si le modèle sélectionné refuse la requête, la session reste sur le modèle de repli.
Pour supprimer le modèle de repli que vous avez défini, supprimez son entrée dans Agent Config > Model fallback. Un modèle de repli recommandé par le fournisseur, s'il est disponible, peut toujours s'appliquer aux refus.
Si votre ordinateur se met en veille ou si votre réseau change pendant qu'une session se trouve dans un onglet en arrière-plan, le retour dans l'onglet reconnecte la session et rejoue l'activité reçue pendant que vous étiez déconnecté. Vous n'avez pas à envoyer un autre message pour actualiser la session. Une session dont la connexion est restée ouverte n'a rien à rejouer : y revenir ne change rien.
Lorsque vous rouvrez une session dont le sandbox s'est arrêté, Kiro affiche un aperçu de la conversation enregistrée pendant le démarrage du sandbox. Une fois le sandbox prêt, l'historique complet remplace l'aperçu.
À mesure que votre liste de sessions grandit, vous pouvez les trier en groupes pour garder ensemble les travaux connexes. Les groupes sont facultatifs; une session qui n'est pas dans un groupe reste sous Ungrouped.
Avant de démarrer une session, sélectionnez Add to group dans la zone de saisie pour choisir un groupe existant ou en créer un. Vous pouvez également organiser les sessions plus tard depuis la barre latérale ou la page Sessions.
Dans le panneau Sessions de la barre latérale, basculez vers la vue par groupe et sélectionnez Create group pour en ajouter un. Nommez-le et confirmez, et le groupe vide apparaît aussitôt, avant même que vous y ajoutiez des sessions.
Pour déplacer une session dans un groupe, ouvrez le menu de la session et sélectionnez un groupe sous Move to group, ou sélectionnez New group pour en créer un et déplacer la session en une seule étape. Pour retirer une session d'un groupe, ouvrez son menu et sélectionnez Remove from group; elle retourne sous Ungrouped.
Depuis le menu d'un groupe, vous pouvez :
- Rename group. Les sessions du groupe passent sous le nouveau nom.
- Delete group. Kiro vous demande de confirmer, puis supprime le groupe et déplace ses sessions sous Ungrouped. Supprimer un groupe ne supprime jamais les sessions qu'il contient.
Sur la page Sessions, vous pouvez agir sur plusieurs sessions à la fois. Sélectionnez les sessions voulues, puis utilisez Move to group pour les déplacer toutes dans le même groupe. Pour restreindre la liste à la place, utilisez Filter by group pour n'afficher que les sessions des groupes que vous choisissez; le filtrage fonctionne seul et ne nécessite pas de sélectionner de sessions au préalable.
Kiro génère un titre pour chaque session à partir de votre tâche et l'affiche dans l'en-tête de session et la barre latérale. Si vous renommez une session vous-même, Kiro conserve votre titre et ne l'écrase pas par un titre généré.
Les sessions expirent 90 jours après leur dernière activité. Ouvrir une session ou envoyer un message fait repartir ce délai de 90 jours. Les pull requests, les merge requests, les changements de code et les conversations sur GitHub ou GitLab ne sont pas touchés.
Kiro Web peut effectuer des recherches sur le Web pour accéder à des renseignements actuels en temps réel, ce qui permet d'obtenir des réponses à jour sur des sujets qui pourraient avoir changé depuis la création des données d'entraînement du modèle.
La recherche Web est conçue pour ne pas reproduire de segments de texte significatifs et fonctionne avec des pages accessibles publiquement. Les recherches Web sont enregistrées dans la session avec des citations, afin que vous puissiez voir les sources auxquelles l'agent s'est référé.
Utilisation de l'agent