Les agents personnalisés vous permettent d'adapter le comportement de Kiro à des tâches précises en définissant les outils disponibles, les permissions accordées et le contexte automatiquement inclus.
Créez un fichier d'agent directement dans votre projet :
.kiro/agents/ dans votre espace de travail (ou ~/.kiro/agents/ pour les agents globaux)Par exemple, créez .kiro/agents/backend-dev.md :
--- name: backend-dev description: Backend development specialist model: claude-sonnet-4 tools: ["read", "write", "shell"] permissions: rules: - capability: shell match: ["npm *", "git *"] effect: allow --- You are a backend engineer focused on Node.js and TypeScript. Always use async/await. All database queries must be parameterized.
Ensuite, basculez vers celui-ci à l'aide du sélecteur d'agent dans l'en-tête du panneau de clavardage.
Les agents personnalisés sont définis à l'aide de fichiers de configuration JSON. Voici un exemple de base :
{ "name": "my-agent", "description": "A custom agent for my workflow", "tools": ["read", "write"], "allowedTools": ["read"], "resources": [ "file://README.md", "file://.kiro/steering/**/*.md", "skill://.kiro/skills/**/SKILL.md" ], "prompt": "You are a helpful coding assistant", "model": "claude-sonnet-4" }
Consultez la référence de configuration pour tous les détails sur les champs disponibles.
Vous pouvez définir des agents locaux et des agents globaux.
.kiro/agents/
Les agents locaux sont propres à l'espace de travail actuel et disponibles uniquement lorsque vous exécutez Kiro depuis ce répertoire ou ses sous-répertoires.
Exemple :
my-project/ ├── .kiro/ │ └── agents/ │ ├── dev-agent.json │ └── aws-specialist.json └── src/ └── main.py
~/.kiro/agents/
Les agents globaux sont accessibles depuis n'importe quel répertoire.
Exemple :
~/.kiro/agents/ ├── general-assistant.json ├── code-reviewer.json └── documentation-writer.json
Lorsque Kiro recherche un agent :
.kiro/agents/ dans le répertoire actuel~/.kiro/agents/ dans le répertoire HOMESi les deux emplacements contiennent des agents portant le même nom, l'agent local a priorité, avec un message d'avertissement.
Cliquez sur le nom de l'agent (p. ex. « Default ») dans la barre inférieure de la zone de saisie du clavardage pour ouvrir le sélecteur d'agent, puis choisissez votre agent personnalisé dans la liste. Le changement s'applique à la session en cours, et les outils, permissions et requête de votre agent prennent effet à partir du prochain message.
Vous pouvez également choisir un agent personnalisé parmi les options de flux de travail au démarrage d'une nouvelle session.
Création d'agents personnalisés