Commencez à utiliser Kiro Web en vous connectant et en connectant un fournisseur de dépôt. Kiro Web fonctionne avec GitHub et GitLab. Les étapes de configuration diffèrent selon que vous utilisez la connexion sociale, AWS Identity Center ou un fournisseur d'identité externe comme Okta ou Microsoft Entra ID (consultez les prérequis des sessions cloud).
- Accédez à app.kiro.dev et connectez-vous avec GitHub, Google ou votre AWS Builder ID
- Assurez-vous d'avoir un abonnement Kiro payant (Pro ou supérieur). Kiro Web n'est pas disponible sur le niveau gratuit.
- Connectez un fournisseur de dépôt — GitHub ou GitLab — pour donner à l'agent l'accès à vos dépôts
- Votre administrateur doit activer les Cloud Sessions pour votre organisation
- Connectez-vous sur app.kiro.dev en utilisant vos identifiants Identity Center
- Kiro Web nécessite un profil Kiro — il ne fonctionne pas avec les profils Q Developer
- Connectez un fournisseur de dépôt — GitHub ou GitLab — pour donner à l'agent l'accès à vos dépôts
Consultez le guide AWS Identity Center pour plus de détails sur les paramètres partagés et les limitations.
Si Kiro Web affiche access_denied après la saisie de votre mot de passe et de votre MFA, demandez à votre administrateur de suivre Corriger l'accès refusé à Kiro Web.
Connectez votre compte GitHub pour donner à l'agent l'accès à vos dépôts :
- Allez dans Settings > Integrations
- Sous GitHub, cliquez sur Connect GitHub
- Autorisez l'application GitHub Kiro Agent
- Sélectionnez les dépôts auxquels l'agent peut accéder
Vous devez avoir des permissions d'écriture sur les dépôts pour que l'agent puisse créer des branches et ouvrir des pull requests.
Comment fonctionne l'accès aux dépôts : Kiro Web affiche tous les dépôts où les deux conditions suivantes sont remplies :
- Votre utilisateur GitHub a accès au dépôt
- L'application GitHub Kiro Agent a été installée et autorisée pour ce dépôt
Cela signifie que vous verrez des dépôts provenant de comptes personnels, de dépôts partagés et d'organisations — tant que votre utilisateur GitHub et l'application Kiro Agent y ont tous deux accès.
Si Settings > Integrations affiche Finish setup pour une organisation, terminez-la pour que Kiro puisse répondre aux commentaires /kiro et aux libellés dans cette organisation. Consultez Terminer la configuration.
Consultez le guide d'intégration GitHub pour des instructions de configuration détaillées.
Kiro Web se connecte à GitLab à l'aide d'un jeton d'accès personnel (PAT) :
- Dans GitLab, sélectionnez votre avatar et choisissez Preferences, puis allez dans Access > Personal access tokens et sélectionnez Generate token
- Sélectionnez une portée, puis créez le jeton et copiez-le. La portée api donne à Kiro un accès complet; consultez le guide d'intégration GitLab si vous souhaitez restreindre la portée du jeton
- Dans Kiro, allez dans Settings > Integrations
- Sous GitLab, cliquez sur Connect GitLab
- Collez votre jeton d'accès personnel et sélectionnez l'instance GitLab (gitlab.com est renseigné par défaut)
Une fois connectés, vos projets GitLab sont disponibles à la sélection lorsque vous créez une session ou ajoutez un dépôt en cours de session.
Consultez le guide d'intégration GitLab pour des instructions de configuration détaillées.
Une fois que vous avez connecté un fournisseur de dépôt, vous êtes prêt à mettre l'agent au travail.
- Allez sur app.kiro.dev
- Sélectionnez facultativement des dépôts à l'aide de Select repo avant de démarrer votre tâche
Rédigez une description claire de ce que vous voulez que l'agent fasse. Pour votre première tâche, essayez quelque chose de simple comme :
- « Ajouter la gestion des erreurs à la fonction de connexion dans auth.ts »
- « Écrire des tests unitaires pour la classe UserService »
- « Mettre à jour le README avec les instructions d'installation »
Ou essayez quelque chose qui s'étend sur plusieurs dépôts :
- « Ajouter un nouveau point de terminaison API dans le service backend et mettre à jour le client frontend pour l'appeler »
- « Mettre à jour la bibliothèque d'authentification partagée et migrer les applications web et mobile pour utiliser la nouvelle version »
Incluez toute exigence ou contrainte spécifique dans votre description. Vous pouvez toujours préciser ou ajouter plus de détails à mesure que la conversation progresse.
Si vous n'avez pas sélectionné de dépôts au démarrage de la session, vous serez invité à les choisir lorsque vous demandez à l'agent de travailler sur quelque chose. Sélectionnez uniquement les dépôts auxquels vous faites confiance, surtout lorsque vous mélangez des dépôts publics et privés, car l'agent apprend des instructions présentes dans le code du dépôt et les suit, même si ces instructions sont malveillantes.
Une fois que vous avez démarré des sessions depuis le même fournisseur quelques fois, le sélecteur de dépôts affiche une section Recent pour ce fournisseur avec les dépôts que vous avez utilisés le plus récemment, de sorte que vous pouvez en choisir un familier sans faire défiler la liste complète. La section Recent apparaît dès qu'il y a au moins deux dépôts récents à afficher, et elle est masquée pendant que vous effectuez une recherche, afin qu'une recherche affiche une seule liste classée de correspondances.
La façon dont l'agent procède dépend du mode que vous utilisez :
Mode par défaut — L'agent travaille avec vous de manière interactive. Il analyse votre demande, discute de l'approche, et vous itérez ensemble. Lorsque vous êtes satisfait, demandez à l'agent d'ouvrir une pull request ou une merge request.
Mode spec — L'agent transforme votre demande en exigences, en conception technique et en plan de mise en œuvre que vous révisez, puis il met en œuvre les tâches approuvées.
Mode autonome — Activez Autonomous dans la barre de saisie du clavardage. L'agent élabore un plan, exécute le travail avec des sous-agents spécialisés et ouvre des pull requests automatiquement.
Lorsque l'agent ouvre une pull request :
- Vérifiez les modifications de code et l'approche d'implémentation
- Laissez des commentaires avec vos commentaires ou suggestions
- L'agent répond automatiquement à vos commentaires et pousse les mises à jour
Des commentaires comme « toujours utiliser notre gestion des erreurs standard » ou « se rappeler de suivre nos conventions de nommage » aident l'agent à apprendre les habitudes de votre équipe pour les travaux futurs.
- Apprenez-en davantage sur le travail avec l'agent
- Essayez le mode autonome pour l'exécution de tâches de bout en bout
- Configurez le sandbox
- Configurez des fichiers de steering pour guider l'agent
Configuration et première exécution