Gérer les bots

Utilisez ces guides par tâche pour créer, configurer et maintenir des bots Kiro. Pour une explication de leur architecture et de leur comportement, consultez Fonctionnement des bots.

Vous pouvez créer un bot de deux façons :

Demandez à n'importe quel bot de créer un nouveau bot pour vous. La suite dépend de la présence d'un objectif dans votre requête.

Si vous fournissez seulement un nom, par exemple « Crée un bot nommé Contributor », le bot affiche une carte de guide Créer un bot. Sélectionnez Démarrer pour ouvrir le formulaire de création avec le nom déjà rempli, puis remplissez le formulaire comme décrit dans Option 2. Sélectionnez Ignorer pour annuler. Le bot est créé uniquement lorsque vous confirmez dans le formulaire.

Si vous fournissez un nom et un objectif, par exemple « Crée un bot nommé Contributor dont l'objectif est de m'aider à contribuer régulièrement au projet de logiciel libre Kiro Crew », le bot affiche une carte Nouveau bot. La carte indique le nom, l'objectif, les outils qui s'exécutent sans demander d'autorisation et la raison de la requête du bot. Pour créer le bot :

1. Examinez les outils indiqués sous S'exécute sans demander. Si la carte affiche un avertissement sur les permissions, sélectionnez Je comprends que cela élargit les permissions.
2. Sélectionnez Créer le bot, ou sélectionnez Refuser pour annuler.

La carte indique le temps dont vous disposez pour répondre.

1. Sur la page Bots, sélectionnez Nouveau bot. Si la liste contient déjà des bots, ouvrez le menu + en haut de la liste.
2. Saisissez un Nom. Vous pouvez aussi sélectionner le crayon sur l'avatar pour choisir une icône et une couleur.
3. Pour définir un objectif, un espace de travail, un modèle, des déclencheurs ou une couleur de session, ouvrez Paramètres avancés.
4. Sélectionnez Créer.

Le fil de discussion du nouveau bot s'ouvre. Il vous demande de définir un objectif ou confirme celui que vous avez saisi pendant la création. Examinez la carte de proposition et approuvez-la pour continuer.

Vous pouvez changer le modèle d'un bot de deux façons :

Demandez au bot de changer de modèle. Par exemple :

« Passe au modèle [nom du modèle]. »

Le bot affiche une carte Changement du bot avec le modèle actuel, le nouveau modèle et la raison du changement. Sélectionnez Appliquer le changement pour confirmer, ou Refuser pour conserver le modèle actuel. La carte indique aussi le temps dont vous disposez pour répondre.

1. Ouvrez le fil de discussion du bot et sélectionnez son nom pour ouvrir sa Carte de profil.
2. Dans Profil, sélectionnez Paramètres.
3. Choisissez un modèle et un effort de raisonnement. Le changement est enregistré immédiatement et s'applique au fil de discussion ouvert.

Par défaut, les agents de travail héritent des paramètres de modèle du bot, sauf si un modèle distinct est configuré pour eux. Pour utiliser un modèle distinct pour les tâches déléguées, définissez le modèle des agents de travail et l'effort de raisonnement des agents de travail sur la même page. Ce paramètre s'applique aux nouveaux agents de travail; ceux qui existent déjà conservent le modèle et l'effort de raisonnement avec lesquels ils ont démarré.

Les permissions d'un bot sont définies par son mode d'approbation :

Les nouveaux bots démarrent en mode Trust, sauf ceux importés par une application, qui démarrent en mode Normal. Les changements s'appliquent aux agents de travail en cours d'exécution. La politique de sécurité et les commandes bloquées s'appliquent dans tous les modes. Consultez Permissions.

Vous pouvez changer les permissions d'un bot de deux façons :

Demandez au bot de changer ses permissions. Par exemple :

« Change tes permissions pour le mode Normal. »

Le bot affiche une carte Changement du bot avec le mode d'approbation actuel, le nouveau mode et la raison du changement. Sélectionnez Appliquer le changement pour confirmer, ou Refuser pour conserver le mode actuel. Les permissions ne changent pas tant que vous ne confirmez pas. La carte indique aussi le temps dont vous disposez pour répondre.

1. Ouvrez la Carte de profil du bot.
2. Dans Profil, sélectionnez Paramètres → Permissions.
3. Choisissez Normal, Reads ou Trust. Le changement est enregistré immédiatement.

1. Dans le fil de discussion du bot, décrivez une responsabilité continue, comme : « Maintiens la réussite des compilations de mon projet. »
2. Examinez et approuvez la carte d'objectif proposée, en la modifiant au besoin.
3. Examinez et approuvez les jalons proposés.
4. Approuvez les suivis suggérés ou configurez-les sous Carte de profil → Objectifs. Configurez Heartbeat séparément sous Horaires.

Vous pouvez aussi commencer sous Objectifs → Créer un objectif → Dites à <name> quel objectif viser. Les suivis sont désactivés par défaut. Consultez Objectifs, jalons et suivis.

1. Ouvrez la Carte de profil de votre bot et sélectionnez Sessions.
2. Sélectionnez la session de l'agent de travail que vous voulez examiner.
3. Examinez sa conversation et ses progrès. Pour interrompre cet agent de travail, utilisez sa commande Arrêter.

Le fil de discussion permanent du bot et les sessions de ses agents de travail sont distincts. Arrêter un agent de travail n'est pas la même chose que désactiver Heartbeat ou un horaire personnalisé.

1. Ouvrez Carte de profil → Horaires pour votre bot.
2. Sous Vos horaires, sélectionnez Nouvel horaire.
3. Saisissez un nom, la requête à exécuter et son moment d'exécution. Confirmez que l'agent sélectionné est votre bot.
4. Examinez le moment d'exécution et la requête, puis créez l'horaire.

Utilisez Tous les horaires pour examiner la liste complète des horaires. Heartbeat se configure séparément dans la première ligne de l'onglet Horaires du bot. Les suivis quotidiens, hebdomadaires et mensuels des objectifs restent sous Objectifs. Les horaires des agents utilisent des crédits lorsqu'ils appellent un modèle; choisissez un moment d'exécution adapté à la tâche.

Utilisez Nouveau départ lorsque vous voulez continuer avec le même bot sans rejouer le contexte de sa conversation actuelle.

1. Terminez ou retirez les messages en attente et le Steering en attente avant de procéder.
2. Dans les commandes du profil du bot, sélectionnez Nouveau départ.
3. Attendez la fin de l'effacement avant d'envoyer la requête suivante. Fournissez le contexte dont la prochaine tâche a besoin.

Nouveau départ arrête un tour en cours et efface la conversation et le plan actifs dans le même fil de discussion. La transcription enregistrée reste sur disque; le tour suivant démarre un nouveau processus d'agent. La mémoire enregistrée, les fichiers de l'espace de travail et les objectifs ne sont pas effacés. Cette action n'arrête pas tous les agents de travail ni tous les horaires. Utilisez leurs propres commandes si vous voulez arrêter le travail en arrière-plan.

Si un agent de travail a besoin d'un outil qui n'est pas accessible, il signale ce besoin à son bot. Le bot peut demander votre approbation au moyen d'une carte. Vous devrez peut-être activer la fonctionnalité en aperçu Capacités dynamiques avant qu'il puisse rechercher des outils.

Pour ajouter des capacités manuellement :

1. Ouvrez la Carte de profil du bot et sélectionnez le crayon (Modifier le bot).
2. Sélectionnez Capacités. Incluses affiche les capacités par défaut des agents de travail; Ajoutées à affiche celles configurées pour ce bot.
3. Sous Ajouter des capacités, sélectionnez un agent pour copier ses outils, ses serveurs MCP et ses Skills.
4. Examinez l'aperçu et sélectionnez Ajouter.

Les ajouts s'appliquent uniquement à ce bot. Les agents de travail les rechargent après leur tour actuel s'ils sont occupés. Si l'agent source comprend des instructions, celles-ci remplacent les directives de comportement existantes du bot. Les capacités ne peuvent pas outrepasser la politique de sécurité.

Vous pouvez toujours demander directement au bot dans le clavardage. Par exemple : « Arrête l'agent de travail qui exécute les tests » ou « Désactive tes suivis planifiés. »

Pour arrêter un bot ou un agent de travail manuellement :

1. Ouvrez Personnaliser → Bots.
2. Sélectionnez Modifier pour le bot que vous voulez supprimer.
3. Sous Zone de danger, sélectionnez Supprimer le bot.

Supprimer un bot le dissocie des nouvelles sessions. Son espace de travail, son espace de stockage de mémoire et ses transcriptions passées sont conservés. Les arbres de travail Git propres sont supprimés; ceux qui contiennent des changements non commités et leurs branches sont conservés. Si vous supprimez le bot intégré, Kiro Crew ne le recrée pas automatiquement.