Passer au contenu principal
Afficher en Markdown

Portées de configuration

Kiro utilise un système de configuration en couches avec trois portées. La configuration la plus proche de votre contexte actuel a priorité sur les paramètres plus généraux.

FonctionnalitéIDECLIWebMobile
Portée globale (~/.kiro/)✓✓——
Configuration infonuagiqueSur activationSur activation✓✓
Portée projet (.kiro/)✓✓✓✓
Portée agent (.kiro/agents/ ou ~/.kiro/agents/)✓✓——

Portées

  1. Globale — s'applique à tous les projets. Stockée dans ~/.kiro/.
  2. Projet — spécifique à un espace de travail. Stockée dans <project-root>/.kiro/.
  3. Agent — définie par agent dans ~/.kiro/agents/ (globale) ou .kiro/agents/ (projet).

Inspecter la configuration dans V3

Dans une session V3 locale ou cloud, exécutez /config pour examiner la configuration utilisée par cette session :

bash
# Open the category summary /config # Open a category directly /config steering

Le sommaire couvre les agents, les serveurs MCP, les Powers, le Steering, les Skills et les Hooks. Il affiche le nombre ou l'état des éléments configurés et vous permet d'ouvrir chaque catégorie. /config n'est pas disponible dans V1 ou V2.

Étiquettes de source

Lorsque Kiro dispose d'informations sur l'origine de la configuration, la colonne Source identifie les éléments comme local, cloud ou local + cloud. Si une session locale ne contient d'informations de source pour aucun élément, Kiro omet la colonne au lieu d'attribuer une origine sans certitude. Dans une session cloud, la configuration de la session est indiquée comme provenant du cloud.

Une étiquette cloud indique la provenance de la configuration active. L'ouverture de /config ne téléverse pas vos fichiers locaux et ne les synchronise pas avec la configuration cloud. Si la configuration cloud n'est pas activée pour votre compte, le panneau reste disponible et affiche la configuration locale sans éléments provenant du cloud.

Appliquer la configuration infonuagique aux sessions locales

Utilisez la synchronisation de la configuration dans Kiro Web pour téléverser les dossiers pris en charge depuis votre répertoire .kiro personnel. La configuration téléversée s'applique automatiquement aux sessions cloud.

Pour utiliser la copie infonuagique dans votre travail local, activez Apply your cloud configuration to local sessions sur la page Configuration Sync. Les nouvelles sessions CLI locales chargent alors vos fichiers de Steering, agents personnalisés, Skills, Powers et Hooks infonuagiques. Cette option n'écrit pas le contenu infonuagique dans votre répertoire .kiro local et ne remplace pas les fichiers locaux existants.

Vues en lecture seule et redirigées

Le sommaire des catégories et les listes de Powers, de Steering et de Skills dans le panneau sont en lecture seule. La sélection d'Agents ouvre le sélecteur d'agents existant, dans lequel vous pouvez changer d'agent. Les serveurs MCP et les Hooks ouvrent leurs panneaux existants. /config ne modifie ni ne téléverse les fichiers de configuration, mais certaines vues liées sont interactives.

Chemins de fichiers

ConfigurationPortée globalePortée projet
Serveurs MCP~/.kiro/settings/mcp.json.kiro/settings/mcp.json
Permissions~/.kiro/settings/permissions.yaml~/.kiro/workspace-roots/<hash>/permissions.yaml (par utilisateur, hors du dépôt)
Bac à sable des commandes locales~/.kiro/settings/sandbox.json.kiro/settings/sandbox.json
Agents personnalisés~/.kiro/agents/.kiro/agents/
Steering~/.kiro/steering/.kiro/steering/
Skills~/.kiro/skills/.kiro/skills/
Hooks~/.kiro/hooks/.kiro/hooks/
Powers~/.kiro/powers/—
Specs—.kiro/specs/
Workflows~/.kiro/workflows/.kiro/workflows/
Paramètres (CLI)~/.kiro/settings/cli.json—

Ce que chaque portée prend en charge

Toutes les fonctionnalités ne sont pas disponibles à toutes les portées. Le tableau ci-dessous montre où chaque configuration peut être définie et si elle peut être intégrée dans un profil d'agent.

ConfigurationGlobaleProjetPortée agent
Serveurs MCP✓✓✓ (champ mcpServers ou includeMcpJson)
Permissions✓✓✓ (champ permissions)
Bac à sable des commandes locales✓✓—
Agents personnalisés✓✓N/A
Steering✓✓✓ (champ resources)
Skills✓✓✓ (champ resources)
Hooks✓✓✓ (CLI seulement, champ hooks)
Powers✓—✓ (champ includePowers)
Specs—✓—
Workflows✓✓—
Paramètres✓——

Résolution des conflits

Lorsque la même configuration existe dans plusieurs portées, la portée la plus proche de votre contexte actuel l'emporte :

ConfigurationPriorité (la plus élevée → la plus faible)
Serveurs MCPAgent > Projet > Global
Permissionsle refus l'emporte peu importe la portée (algorithme deny-overrides)
Bac à sable des commandes localesUne politique globale active constitue le plancher; un projet peut l'activer ou la resserrer, mais ne peut pas l'affaiblir
Agents personnalisésProjet > Global (même nom : le projet l'emporte avec un avertissement)
SteeringToutes les portées fusionnées (aucune n'est remplacée)
SkillsToutes les portées fusionnées
HooksToutes les portées fusionnées
WorkflowsProjet > Global > recettes de compte synchronisées > recettes intégrées

Une recette de workflow non valide de priorité supérieure ne masque pas une recette valide de priorité inférieure portant le même nom. Les recettes synchronisées et intégrées disponibles peuvent varier selon le compte et la version du client.

Comme les serveurs MCP peuvent être configurés dans trois portées et que les agents ont un paramètre includeMcpJson, la résolution des serveurs MCP comporte des règles supplémentaires. Consultez Priorité de chargement des serveurs MCP pour en savoir plus.

Web et Mobile

Web et Mobile lisent la configuration de projet indiquée ci-dessous à partir de dépôts clonés. Les sessions que vous démarrez depuis Mobile sont des sessions cloud de Kiro Web; les deux surfaces chargent donc la même configuration. Aucune de ces surfaces ne lit la configuration globale ~/.kiro/, puisqu'elles n'ont pas de système de fichiers local.

ConfigurationWebMobile
Steering de projet (.kiro/steering/)✓✓
Skills de projet (.kiro/skills/)✓✓
Serveurs MCP de projet (.kiro/settings/mcp.json)✓✓
Agents personnalisés de projet (.kiro/agents/, délégation aux sous-agents)✓✓
Hooks de projet (.kiro/hooks/)✓✓
MCP en bac à sable (configuré via les paramètres Web)✓✓
Autorisations YAML et approbations interactives——

Workflows téléversés dans le compte

Dans Kiro Web, les workflows utilisent un chemin de téléversement dans le compte distinct :

MéthodeWebMobile
Téléverser une recette par Agent Config > Workflows✓—
Importer .kiro/workflows/ au moyen de Configuration Sync✓—

Pour les sessions cloud, ouvrez Agent Config > Cloud Config dans Kiro Web afin de téléverser votre Steering personnel, vos agents personnalisés, vos Hooks, vos Skills, vos Powers, vos paramètres MCP ou un dossier .kiro/workflows/ complet. Gérez les éléments téléversés depuis les pages de paramètres propres à chaque fonctionnalité. Cette configuration infonuagique gérée est distincte du répertoire ~/.kiro/ de votre ordinateur et ne modifie pas vos fichiers locaux.

Consultez Agents personnalisés : comportement selon la surface pour en savoir plus sur les limitations de Web et Mobile.

Prochaines étapes

  • Workflows — orchestrer le travail réutilisable des agents en plusieurs étapes
  • Synchronisation de la configuration - téléverser la configuration personnelle pour les sessions cloud
  • Agents personnalisés — créer et configurer des agents spécialisés
  • Steering — contexte et conventions du projet
  • Permissions — contrôle d'accès basé sur les capacités
  • Configuration MCP — connecter des outils externes
  • Hooks — automatiser des flux de travail avec des actions déclenchées par des événements
  • Skills — modules d'instructions réutilisables
  • Powers — étendre avec des serveurs MCP et de la documentation intégrés
Page mise à jour : 12 novembre 2026