Configuration et première exécution

Commencez à utiliser Kiro Web (Preview) 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 ou AWS Identity Center.

1. Accédez à app.kiro.dev et connectez-vous avec votre AWS Builder ID
2. Assurez-vous d'avoir un abonnement Kiro payant (Pro ou supérieur). Kiro Web n'est pas disponible sur le niveau gratuit.
3. Connectez un fournisseur de dépôt — GitHub ou GitLab — pour donner à l'agent l'accès à vos dépôts

1. Votre administrateur doit activer les Cloud Sessions pour votre organisation
2. Connectez-vous sur app.kiro.dev en utilisant vos identifiants Identity Center
3. Kiro Web nécessite un profil Kiro — il ne fonctionne pas avec les profils Q Developer
4. 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.

Connectez votre compte GitHub pour donner à l'agent l'accès à vos dépôts :

1. Allez dans Settings et sélectionnez l'onglet Agent
2. Sous GitHub, cliquez sur Connect GitHub
3. Autorisez l'application GitHub Kiro Agent
4. 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 :

1. Votre utilisateur GitHub a accès au dépôt
2. 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.

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) :

1. Dans GitLab, sélectionnez votre avatar et choisissez Preferences, puis allez dans Access > Personal access tokens et sélectionnez Generate token
2. 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
3. Dans Kiro, allez dans Settings et sélectionnez l'onglet Agent
4. Sous GitLab, cliquez sur Connect GitLab
5. 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.

1. Allez sur app.kiro.dev
2. 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.

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.

Mode autonome — Activez Autonomous dans la barre de saisie du clavardage. L'agent pose des questions de clarification, é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 :

1. Vérifiez les modifications de code et l'approche d'implémentation
2. Laissez des commentaires avec vos commentaires ou suggestions
3. 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