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é | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
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
- 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.
- Réduction des interruptions - Préapprouvez les opérations fiables pour éliminer les invites de permission pendant les sessions de travail concentré.
- Contexte enrichi - Incluez automatiquement la documentation de projet pertinente, les fichiers de configuration ou les informations système.
- 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.
- 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.
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.
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 :
{ "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?" }
- Agents d'espace de travail (spécifiques au projet) :
.kiro/agents/[name].jsonou.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].jsonou~/.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.
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.
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.
- Référence IDE 0.x - Configuration d'agent personnalisé
- Référence CLI 2.x - Configuration d'agent personnalisé
- Référence de configuration d'agent - Format Markdown
- Nouveautés de IDE 1.0 - Changements de configuration d'agent
- Agents intégrés - agents préconfigurés fournis avec Kiro
- Créer un agent personnalisé
- Référence de configuration - référence complète pour tous les champs de configuration
- Invocation en tant que sous-agents - déléguer des tâches à des agents en parallèle
- Permissions - configurer le contrôle d'accès basé sur les capacités
- Exemples - configurations d'agents concrètes
- Dépannage - problèmes courants et solutions
Agents personnalisés