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.

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 outils spécifiques - Définissez quels outils 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

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 outils 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.

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, et toolAliases pour gérer les conflits de nommage.

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.

{
  "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-5",
  "welcomeMessage": "Ready to help. What are you working on?"
}

• 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.

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. Mobile utilise uniquement les agents intégrés de Kiro.

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

Si vous effectuez une mise à niveau depuis IDE 0.x ou CLI 2.x, les configurations d'agent sont rétrocompatibles - les fichiers JSON existants continuent de fonctionner sans modification. Les nouveaux champs (permissions, excludedTools, includeMcpJson, resources avec skill://, format Markdown) sont tous optionnels.

• Référence IDE 0.x - Configuration d'agent personnalisé
• Référence CLI 2.x - Configuration d'agent personnalisé
• Nouveautés de CLI 3.0 - Changements de configuration d'agent
• 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