Passer au contenu principal
Afficher en Markdown

Création d'agents personnalisés

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.

Démarrage rapide

Créez un fichier d'agent directement dans votre projet :

  1. Créez un répertoire .kiro/agents/ dans votre espace de travail (ou ~/.kiro/agents/ pour les agents globaux)
  2. Ajoutez un fichier Markdown ou JSON - le nom du fichier devient le nom de l'agent

Par exemple, créez .kiro/agents/backend-dev.md :

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

Fichier de configuration de l'agent

Les agents personnalisés sont définis à l'aide de fichiers de configuration JSON. Voici un exemple de base :

json
{ "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.

Emplacements des fichiers

Vous pouvez définir des agents locaux et des agents globaux.

Agents locaux (propres au projet)

.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

Agents globaux (propres à l'utilisateur)

~/.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

Priorité des agents

Lorsque Kiro recherche un agent :

  1. Local en premier : vérifie .kiro/agents/ dans le répertoire actuel
  2. Repli global : vérifie ~/.kiro/agents/ dans le répertoire HOME

Si les deux emplacements contiennent des agents portant le même nom, l'agent local a priorité, avec un message d'avertissement.

Utilisation de votre agent personnalisé

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.

Prochaines étapes

Page mise à jour : 11 août 2026