Passer au contenu principal
Afficher en Markdown

Agents personnalisés

Les agents personnalisés offrent une façon de personnaliser le comportement de Kiro en définissant des configurations spécifiques pour différents cas d'utilisation. Chaque agent personnalisé est défini par un fichier de configuration qui précise à quels outils l'agent peut accéder, quelles permissions il possède et quel contexte il doit inclure.

CapacitéIDECLIWebMobile
Agents au niveau du projet (.kiro/agents/)✓✓✓✓
Agents globaux (~/.kiro/agents/)✓✓——
Changement d'agent via l'UI✓✓——
Modifier les paramètres de l'agent✓✓——

Par défaut, Kiro offre l'accès à tous les outils disponibles, mais exige une confirmation de l'utilisateur pour la plupart des opérations. Cette approche privilégie la sécurité, mais peut interrompre votre flux de travail avec des invites de permission fréquentes.

Les agents personnalisés résolvent ce problème en vous permettant de :

  • Préapprouver des opérations fiables - Définissez quelles opérations peuvent s'exécuter sans invite
  • Limiter l'accès aux outils - Restreignez les outils disponibles pour réduire la complexité
  • Inclure le contexte pertinent - Chargez automatiquement des fichiers de projet, de la documentation ou des informations système
  • Configurer le comportement des outils - Définissez des paramètres précis pour le fonctionnement des outils

Avantages de l'utilisation des agents personnalisés

  1. Optimisation du flux de travail - Créez des agents personnalisés adaptés à des tâches spécifiques comme la gestion de l'infrastructure AWS, les revues de code ou les sessions de débogage.
  2. Réduction des interruptions - Préapprouvez les opérations fiables pour éliminer les invites de permission pendant les sessions de travail concentré.
  3. Contexte enrichi - Incluez automatiquement la documentation de projet pertinente, les fichiers de configuration ou les informations système.
  4. Collaboration d'équipe - Partagez les configurations d'agents personnalisés avec les membres de l'équipe pour garantir des environnements de développement cohérents.
  5. Contrôle de la sécurité - Limitez l'accès aux outils à ce qui est nécessaire pour des flux de travail précis, réduisant les risques de sécurité potentiels.

Relation avec MCP et les outils intégrés

Les agents personnalisés fonctionnent avec les outils intégrés et les outils externes des serveurs MCP. Utilisez le champ tools pour préciser exactement quels outils de chaque source sont disponibles. Dans CLI V3, conservez les sélecteurs MCP complets au lieu de vous appuyer sur le champ toolAliases de CLI 2.x.

Formats des fichiers de configuration

Les configurations d'agent prennent en charge deux formats - JSON et Markdown. Les deux prennent en charge des champs identiques. Utilisez Markdown lorsque votre requête système est longue ou bénéficie d'une lisibilité humaine; JSON convient bien aux configurations générées de façon programmatique.

.kiro/agents/my-agent.json :

json
{ "name": "my-agent", "description": "A custom agent for my workflow", "tools": ["read", "write", "shell"], "excludedTools": ["knowledge"], "includeMcpJson": true, "includePowers": false, "resources": [ "file://./ARCHITECTURE.md", "skill://backend-patterns" ], "permissions": { "rules": [ { "capability": "shell", "match": ["npm *", "git *"], "effect": "allow" } ] }, "prompt": "You are a helpful coding assistant", "model": "claude-sonnet-4.6", "welcomeMessage": "Ready to help. What are you working on?" }

Emplacements de stockage

  • Agents d'espace de travail (spécifiques au projet) : .kiro/agents/[name].json ou .kiro/agents/[name].md — partagés via le contrôle de version, chargés uniquement si l'espace de travail est de confiance
  • Agents globaux (à l'échelle de l'utilisateur) : ~/.kiro/agents/[name].json ou ~/.kiro/agents/[name].md — disponibles pour tous les projets

Lorsque les deux emplacements ont des agents portant le même nom, les agents de l'espace de travail sont prioritaires.

Les répertoires imbriqués sont pris en charge. Le nom de l'agent est le chemin relatif au répertoire des agents, sans l'extension : ~/.kiro/agents/team/planner.md devient team/planner.

Comportement selon la plateforme

L'IDE et la CLI peuvent sélectionner un agent personnalisé comme agent principal de la session. Kiro Web charge les agents personnalisés de projet commis dans .kiro/agents/ et peut les invoquer pour déléguer des tâches à des sous-agents. Vous ne pouvez toutefois pas en sélectionner un comme agent principal d'une session Web. Les sessions que vous démarrez depuis Mobile se comportent de la même façon que les sessions Kiro Web.

Pour utiliser des agents personnalisés personnels dans les sessions cloud, téléversez-les depuis Agent Config > Cloud Config dans Kiro Web, puis gérez-les sous Agent Config > Agents.

Versions précédentes

Si vous effectuez une mise à niveau depuis IDE 0.x, les profils JSON existants continuent de fonctionner. Pour CLI 2.x, les profils qui utilisent encore allowedTools ou toolsSettings sans bloc permissions doivent être convertis avec /upgrade-agent avant que CLI V3 puisse les charger; les autres champs pris en charge sont conservés. Les champs optionnels actuels comprennent permissions, excludedTools, includeMcpJson, resources avec skill:// et le format Markdown.

Prochaines étapes

Page mise à jour : 12 novembre 2026