Passer au contenu principal
Afficher en Markdown

Modifications de la configuration de l'agent

Aperçu

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.

Options de format

JSON — nouveaux champs à ajouter aux configurations .kiro/agents/*.json existantes :

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

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

Référence des champs

ChampTypeNouveau dans 1.0Description
namestringIdentifiant de l'agent
descriptionstringAffiché dans le sélecteur d'agent
promptstringRequête système — chaîne intégrée ou URI file:// (JSON seulement; en Markdown, utilisez le corps)
modelstringSubstitution du modèle (p. ex. claude-sonnet-4-20250514)
toolsstring[] | "*"Outils autorisés. "*" = tous les outils disponibles
excludedToolsstring[]✓Outils à exclure même si tools les autorise
includeMcpJsonboolean✓Inclure les serveurs .kiro/settings/mcp.json de l'espace de travail
includePowersboolean✓Inclure les powers installés dans l'IDE
mcpServersobjectDéfinitions de serveurs MCP intégrées (stdio ou HTTP)
resourcesstring[]✓URI à charger dans le contexte : file://, skill://
permissionsobject✓Règles de politique intégrées (portée agent, prend en charge tous les effets)
welcomeMessagestring✓Message d'accueil personnalisé au démarrage de la session
hooksobject✓CLI seulement — définitions de hooks intégrées (même schéma que .kiro/hooks/). L'IDE ignore les agents contenant ce champ.

Configuration du serveur MCP

Serveurs stdio :

json
{ "command": "npx", "args": ["-y", "@org/server"], "env": {}, "timeout": 30000 }

Serveurs HTTP/SSE :

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

Resources

Le champ resources charge du contexte dans l'agent au démarrage de la session :

Schéma d'URIExempleCharge
file://file://./docs/ARCH.mdContenu de fichier relatif à la racine de l'espace de travail
skill://skill://backend-patternsSkill provenant de .kiro/skills/backend-patterns/SKILL.md

Ce qui est inchangé

Ces champs fonctionnent exactement comme avant — aucun changement de comportement :

  • name, description, prompt, model, tools, mcpServers

Notes de migration

  • Les configurations JSON existantes fonctionnent sans modification
  • Les nouveaux champs sont tous facultatifs — adoptez-les progressivement
  • excludedTools est utile lorsque tools: "*" mais que vous voulez bloquer des outils précis
  • permissions 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
Page mise à jour : 11 août 2026