Passer au contenu principal
Afficher en Markdown

Agents

Un agent est une configuration qui indique à Kiro Crew comment se comporter : quel modèle utiliser, quelle requête système suivre, quels outils il peut appeler et quels serveurs MCP créer. Chaque session s'exécute sous un agent.

Gestion des agents

Depuis le tableau de bord (recommandé)

Ouvrez Customize → Agents. Vous pouvez :

  • Afficher tous les agents configurés
  • Modifier le modèle, la requête et la liste d'outils de n'importe quel agent
  • Créer de nouveaux agents
  • Changer l'agent actif pour une session
  • Réinitialiser un agent géré à ses valeurs par défaut

L'agent par défaut

Kiro Crew est livré avec un agent kirocrew qui comprend :

  • Modèle — auto (utilise le modèle configuré dans kiro-cli)
  • Requête système — comportement d'assistant à usage général
  • Serveurs MCP — kirocrew-core (spawn, learn, task, wait, messaging) et kirocrew-cron (outils de planification)
  • Outils — accès complet aux outils (lecture/écriture de fichiers, shell, web, MCP)

C'est ce qui s'exécute lorsque vous ne spécifiez pas d'agent. Cela couvre la plupart des cas d'utilisation.

Création d'un agent personnalisé

Depuis le panneau Agents, cliquez sur Create. Définissez :

  • Name — identifiant utilisé pour référencer l'agent
  • Model — quel modèle de langage utiliser (ou auto pour la valeur par défaut)
  • Prompt — la requête système qui façonne le comportement
  • Tools — quels outils l'agent peut appeler

Pour une configuration basée sur des fichiers, créez un fichier JSON :

json
{ "name": "reviewer", "description": "Independent code reviewer", "model": "auto", "prompt": "You are a code reviewer. Focus on correctness, security, and clarity.", "tools": ["fs_read", "grep"] }

Placez-le sous ~/.kiro/agents/ ou référencez-le depuis le tableau de bord.

Modes d'approbation

Contrôlez la façon dont l'agent obtient la permission d'utiliser les outils. Configurez cela globalement depuis Settings → Security ou par session avec le commutateur Autopilot.

ModeComportement
Automatic (par défaut)Les appels d'outils qui passent les vérifications de refus, de gouvernance et de bac à sable se déroulent sans invite individuelle
InteractiveLes appels d'outils demandent une approbation sur une interface pouvant présenter l'invite
Trust this commandApprobation automatique limitée à la session, correspondance exacte
Trust this toolApprobation automatique limitée à la session, quels que soient les arguments
AutopilotTous les outils sont approuvés automatiquement pour cette session

Les commandes refusées et les blocages de chemins sensibles s'appliquent toujours, même en mode Autopilot.

Quand créer un agent personnalisé

  • Accès aux outils plus restreint — un agent « reviewer » qui ne peut que lire des fichiers, pas les écrire
  • Requête différente — un agent adapté à un domaine précis (analyse de données, rédaction, opérations)
  • Modèle différent — utiliser un modèle précis pour certains types de travaux
  • Portée restreinte — limiter ce que l'agent peut faire pour les flux de travail sensibles à la sécurité

Modèles d'agent et héritage

Un agent peut suivre un modèle parent. Pour chaque capacité définie par le modèle, l'agent choisit Inherited, Override ou Removed. Lorsque le modèle change, l'agent voit les changements entrants et peut les réviser avant de les appliquer.

Si vous personnalisez un agent basé sur un modèle partagé, Kiro Crew vous permet de dupliquer une copie privée de sorte que vos modifications restent indépendantes des futures mises à jour du modèle.

Mates (aperçu)

Dans Kiro Crew 0.11, activez Settings → Developer → Feature Previews → Mates. Ouvrez ensuite Mates dans la barre latérale pour atteindre la page Mates et ses fils de mates. Chaque mate, appelé crewmate ci-dessous, a un nom d'affichage, une mémoire privée, un espace de travail, un modèle d'agent, un modèle par défaut et des déclencheurs facultatifs. Son identifiant stable continue de piloter les planifications et les commandes de la CLI lorsque son nom d'affichage change.

Dans Customize → Agents, sélectionnez Edit avatar sur un crewmate. Choisissez un Ghost face, téléversez une Picture ou faites un choix dans la Library. Le volet Reactions définit le mouvement et un son facultatif pour les états Working, Finished et Failed.

Ouvrir un crewmate

Ouvrir le fil d'un crewmate peut afficher une carte, lue depuis le registre de travail du crewmate, sans ajouter un tour de clavardage ni appeler le modèle.

  • Pendant qu'un objectif est en cours, une carte de reprise affiche l'objectif, ce qui est terminé, en cours ou en attente de vous, et une prochaine étape.
  • Lorsqu'aucun objectif n'est en cours et que le fil est nouveau ou inactif depuis six heures ou plus, une carte d'accueil récapitule les objectifs laissés ouverts par le crewmate et ses sessions récentes.

Une carte que vous avez vue il y a quelques instants n'est pas affichée de nouveau à l'ouverture suivante, et aucune carte n'apparaît pendant que le crewmate est au milieu d'un tour.

L'en-tête du fil et la carte Profile

La pastille en haut du fil d'un crewmate indique ce qu'il fait en ce moment. Sélectionnez-la pour ouvrir la carte Profile, qui compte quatre onglets :

  • Profile résume le crewmate et mène à sa Memory, à son Workspace et à ses Notes. Il contient aussi les réglages Permissions, Model et Reasoning effort propres au crewmate, qui s'appliquent à chaque clavardage avec ce crewmate.
  • Schedules liste ce qui réveille le crewmate de lui-même. New schedule y crée une planification qui s'exécute en tant que ce crewmate, liée à sa mémoire privée.
  • Sessions liste les sessions que le crewmate pilote.
  • Goals est un espace réservé. Les objectifs ne sont pas encore disponibles.

Le crayon sur la carte ouvre Edit crewmate.

La liste des membres

Par défaut, la liste affiche les crewmates avec lesquels vous avez clavardé ou que vous avez marqués d'une étoile. Le crewmate que vous avez ouvert reste listé tant que la zone de recherche est vide. Taper une recherche atteint chaque crewmate, y compris les masqués, et la recherche seule décide de ce qui s'affiche.

Lorsqu'un fil est ouvert, la liste se replie en un sélecteur de visages dans l'en-tête du fil. Choisissez Show the full roster pour ramener la colonne de la liste. La vue d'état de la liste affiche la présence, l'état de patrouille, le prochain réveil et la raison de l'arrêt d'une boucle.

Le panneau latéral

Le panneau latéral d'un crewmate comporte un onglet Dashboard et le navigateur de fichiers Workspace. L'onglet Dashboard affiche la page ou la vue en direct que le crewmate publie. Avec l'aperçu Tableau de bord dynamique activé, il affiche plutôt le tableau de bord dynamique du crewmate. Lisez les notes du crewmate depuis la carte Profile.

Le contrôle Cloud de l'en-tête de page gère un seul déploiement à l'échelle de la crew, pas un seul crewmate. Ses actions mènent à Settings → Remote Crew. Sur ordinateur, activez Crew Companion depuis Apps → Library pour afficher l'avatar d'un crewmate sur tous vos écrans.

Équipes

Choisissez + → New team dans l'en-tête de la liste pour en créer une. Ouvrir une équipe affiche l'état des crewmates, les questions qui vous attendent et l'activité récente. Utilisez Edit team pour la renommer, modifier sa composition ou la supprimer. Supprimer une équipe conserve ses crewmates et leurs clavardages.

Pour créer un crewmate à partir d'un modèle, consultez Modèles d'agent.

Tableau de bord dynamique (aperçu)

Activez Settings → Developer → Feature Previews → Dynamic Dashboard pour remplir l'onglet Dashboard d'un crewmate avec une page construite à partir de son propre enregistrement. L'onglet affiche un rapport de projet par défaut. Douze pages sont livrées avec Kiro Crew, dont un point quotidien, une feuille de route et un kanban du travail du crewmate.

Pour changer la page, demandez-le au crewmate dans le clavardage. Il prévisualise la page demandée et l'applique. Dans Kiro Crew 0.11, il peut aussi construire et habiller une page qui lui est propre. La page est mise en ligne lorsqu'elle est appliquée. Une seule action l'annule.

Chaque chiffre d'une page provient de l'un de deux endroits : un repli du journal Crew du crewmate, ou une valeur que le crewmate a écrite lui-même, qui porte l'étiquette crewmate wrote this. Un coût que personne n'a mesuré affiche un tiret plutôt que 0.

Le même aperçu ajoute une rangée d'état au-dessus du compositeur et une page All Dashboards. Son commutateur Automatic cards for all sessions conserve un résumé du travail récent et des prochaines étapes de chaque session.

Avec l'aperçu désactivé, l'onglet Dashboard continue d'afficher la page ou la vue en direct que le crewmate publie.

Page mise à jour : 11 novembre 2026