Les profils d'agent sont rétrocompatibles — les configurations existantes continuent de fonctionner. Le harnais d'agent unifié ajoute de nouveaux champs facultatifs et une option de format Markdown.
JSON — nouveaux champs à ajouter aux configurations .kiro/agents/*.json existantes :
{ "excludedTools": ["knowledge"], "includeMcpJson": true, "includePowers": false, "resources": ["file://./ARCHITECTURE.md", "skill://backend-patterns"], "permissions": { "rules": [ { "capability": "shell", "match": ["npm *", "node *"], "effect": "allow" } ] }, "welcomeMessage": "Ready to work on the backend. What do you need?" }
(Tous les autres champs — name, description, prompt, model, tools, mcpServers — sont inchangés.)
Les deux formats prennent en charge des champs identiques. Utilisez Markdown lorsque votre requête système est longue ou bénéficie d'une meilleure lisibilité humaine; JSON convient bien à la génération programmatique. Le mélange de formats entre agents dans le même espace de travail est pris en charge.
Markdown (.kiro/agents/my-agent.md) — en-tête pour la configuration, corps pour la requête système :
--- name: my-agent description: Specialized for backend work model: claude-sonnet-4-20250514 tools: ["read", "write", "shell", "web_fetch"] excludedTools: ["knowledge"] includeMcpJson: true includePowers: false mcpServers: db-server: command: npx args: ["-y", "@org/db-mcp"] env: DB_URL: "${DATABASE_URL}" resources: - file://./ARCHITECTURE.md - skill://backend-patterns permissions: rules: - capability: shell match: ["npm *", "node *"] effect: allow - capability: fs_write match: ["src/**"] effect: allow welcomeMessage: "Ready to work on the backend. What do you need?" --- You are a backend engineer focused on Node.js and TypeScript services. ## Guidelines - Use async/await, never callbacks - All database queries must be parameterized - Write tests for every new function
| Champ | Type | Nouveau dans 1.0 | Description |
|---|---|---|---|
name | string | Identifiant de l'agent | |
description | string | Affiché dans le sélecteur d'agent | |
prompt | string | Requête système — chaîne intégrée ou URI file:// (JSON seulement; en Markdown, utilisez le corps) | |
model | string | Substitution du modèle (p. ex. claude-sonnet-4-20250514) | |
tools | string[] | "*" | Outils autorisés. "*" = tous les outils disponibles | |
excludedTools | string[] | ✓ | Outils à exclure même si tools les autorise |
includeMcpJson | boolean | ✓ | Inclure les serveurs .kiro/settings/mcp.json de l'espace de travail |
includePowers | boolean | ✓ | Inclure les powers installés dans l'IDE |
mcpServers | object | Définitions de serveurs MCP intégrées (stdio ou HTTP) | |
resources | string[] | ✓ | URI à charger dans le contexte : file://, skill:// |
permissions | object | ✓ | Règles de politique intégrées (portée agent, prend en charge tous les effets) |
welcomeMessage | string | ✓ | Message d'accueil personnalisé au démarrage de la session |
hooks | object | ✓ | CLI seulement — définitions de hooks intégrées (même schéma que .kiro/hooks/). L'IDE ignore les agents contenant ce champ. |
Serveurs stdio :
{ "command": "npx", "args": ["-y", "@org/server"], "env": {}, "timeout": 30000 }
Serveurs HTTP/SSE :
{ "url": "https://api.example.com/mcp", "headers": { "Authorization": "Bearer ${TOKEN}" } }
Les variables d'environnement utilisent la syntaxe ${VAR} et sont développées à l'exécution.
Le champ resources charge du contexte dans l'agent au démarrage de la session :
| Schéma d'URI | Exemple | Charge |
|---|---|---|
file:// | file://./docs/ARCH.md | Contenu de fichier relatif à la racine de l'espace de travail |
skill:// | skill://backend-patterns | Skill provenant de .kiro/skills/backend-patterns/SKILL.md |
Ces champs fonctionnent exactement comme avant — aucun changement de comportement :
name, description, prompt, model, tools, mcpServersexcludedTools est utile lorsque tools: "*" mais que vous voulez bloquer des outils précispermissions intégré dans un profil d'agent utilise la portée agent (prend en charge deny, ask et allow)resources remplace la copie manuelle du contexte dans la requête — le harnais les charge et les actualise
Modifications de la configuration de l'agent