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,mcpServers
- Les configurations JSON existantes fonctionnent sans modification
- Les nouveaux champs sont tous facultatifs — adoptez-les progressivement
excludedToolsest utile lorsquetools: "*"mais que vous voulez bloquer des outils précispermissionsintégré dans un profil d'agent utilise la portée agent (prend en chargedeny,asketallow)resourcesremplace la copie manuelle du contexte dans la requête — le harnais les charge et les actualise
Modifications de la configuration de l'agent