Passer au contenu principal
Afficher en Markdown

Configuration

La majorité de la configuration se gère depuis le panneau Paramètres du tableau de bord. La passerelle surveille config.json et config.local.json, de sorte que la plupart des changements prennent effet dès qu'ils sont enregistrés. Des champs comme la commande slash Slack et mcp.honour_auto_approve portent un badge Les changements nécessitent un redémarrage. Les changements d'identifiants nécessitent également un redémarrage avant que l'intégration concernée se reconnecte.

Panneau Paramètres

SectionCe que vous configurez
OverviewÉtat rapide, heures de programmation et informations système
Import / ExportDonnées provenant d'un autre agent d'IA, et sauvegarde ou restauration de la configuration de Kiro Crew, avec l'historique de clavardage au besoin
Agent HarnessL'agent avec lequel démarrent les nouvelles sessions, Subagent Settings et Pre-started Sessions
ChatMode de mémoire, modèles, comportement du compositeur, motifs de liens et délais d'expiration
DisplayThème, typographie, zoom, terminal et disposition
VoiceFournisseur de dictée, microphone, voix TTS et vitesse
NotificationsPréférences de bannière et d'alertes de bureau
SecretsIdentifiants en écriture seule pour les intégrations gérées, notamment WakaTime
ShortcutsPersonnalisation des raccourcis clavier
SkillsDécouverte des Skills et limites d'injection de déclencheurs
Messaging ChannelsSlack, Discord, Telegram, Teams, Webex, WeCom, WeChat et autres canaux
BrowserParamètres d'automatisation du navigateur
Computer UseAutomatisation du bureau natif
Remote CrewConnexions SSH, AWS SSM et Fargate
SecurityBac à sable, commandes refusées et gouvernance
DeveloperBackends d'agents, télémétrie et Aperçus de fonctionnalités
AboutVersion, canal de publication et mises à jour

La configuration des agents et des crewmates se trouve hors des Paramètres, sous Personnaliser dans la barre latérale (libellé Capacités de l'agent avant la version 0.9). Subagent Settings et la carte Pre-started Sessions (anciennement Warm Pool) ont été déplacés vers Paramètres → Agent Harness.

Import / Export

Paramètres → Import / Export sauvegarde la configuration de Kiro Crew dans une archive et la restaure. Cochez Inclure l'historique de clavardage pour ajouter chaque clavardage de votre liste Sessions à l'exportation. Les clavardages Incognito et Temporaire ne sont jamais inclus. Les clavardages conservent tout ce qui y a été collé, comme des mots de passe ou des clés; gardez donc l'archive privée.

Les clavardages plus anciens qui n'entrent pas dans l'archive sont laissés de côté, et l'exportation les nomme. À l'importation, les clavardages Incognito, Temporaire ou illisibles sont retenus et nommés.

Paramètres de clavardage

  • Paramètres → Chat → Transcription → Verbosité des réponses règle la concision de la prose de l'agent. Une nouvelle installation démarre à Réponse seulement; une configuration existante conserve le niveau enregistré. L'ancien niveau Ultra est retiré, et une configuration qui l'avait enregistré se comporte comme Réponse seulement. À tous les niveaux, le code, les commandes et les chaînes d'erreur restent intacts.
  • Paramètres → Chat → Avancé → Limite de temps de compaction (secondes) (session.compact_wait_secs) est la durée maximale d'une compaction. 0 signifie la valeur par défaut de 300 secondes; sinon de 60 à 3 600 secondes, et une valeur hors de cette plage est ramenée dans la plage. Ce qui se passe au-delà de la limite dépend de qui a lancé la compaction : la compaction automatique et celle de l'exécuteur de tâches redémarrent la session, la compaction en approche de limite d'un canal de clavardage abandonne et conserve la session, et un /compact manuel signale qu'il a expiré.
  • Paramètres → Chat → Sessions → Atténuer les volets inactifs estompe les volets en vue partagée sans focus clavier. Désactivez-le pour garder chaque volet à pleine luminosité; la bordure d'accent marque toujours le volet actif.

Heures de programmation avec WakaTime

L'intégration WakaTime est désactivée par défaut. Lorsqu'elle est activée, Kiro Crew envoie des signaux d'activité de programmation à WakaTime et consulte les statistiques du compte.

  1. Définissez wakatime.enabled à true dans $KIROCREW_HOME/config.json (par défaut : ~/.kiro/crew/config.json).
  2. Ouvrez Paramètres → Secrets et enregistrez la clé API WakaTime sous Utilisés automatiquement par Kiro Crew. L'identifiant WAKATIME_API_KEY est stocké uniquement dans le coffre-fort; Kiro Crew ne le lit pas depuis .env ni config.json.
  3. Ouvrez Paramètres → Aperçu.

Par défaut, la carte affiche 7 derniers jours. Choisissez Aujourd'hui, 7 derniers jours, 30 derniers jours ou 6 derniers mois pour voir le temps total de programmation, la moyenne quotidienne, les projets actifs et la répartition par langage et par projet. Exporter les heures (CSV) et Exporter les heures (JSON) téléchargent les heures regroupées par projet pour la plage de dates sélectionnée.

Obtenez une clé API dans les paramètres du compte WakaTime.

CLI et modification de fichier

bash
kirocrew config get kirocrew config get agent.sandbox kirocrew config set dashboard.bot_name "X" kirocrew config set --local dashboard.bot_name "X" kirocrew config edit

--local écrit dans config.local.json, dont les valeurs remplacent config.json et survivent à une mise à jour. Les deux fichiers utilisent du JSON standard; les clés omises utilisent les valeurs par défaut livrées actuelles. Le chargeur en direct applique les changements ordinaires sans redémarrer les sessions. Lorsqu'un champ est marqué comme nécessitant un redémarrage, redémarrez après l'avoir enregistré.

json
{ "agent": { "approval_mode": "auto", "sandbox": "auto" }, "session": { "timeout_secs": 3600, "autocompact_pct": 70 }, "dashboard": { "default_memory_mode": "persistent" }, "skills": { "max_triggered": 0 } }

Paramètres d'exécution, de clavardage et d'aperçu

CléValeur par défautSignification
agent.chat_turn_timeout_secs14400Durée maximale, en temps réel, d'un tour de clavardage
agent.subagent_timeout_secs10800Durée maximale, en temps réel, d'un sous-agent
agent.subagent_max_turns1000Budget d'appels d'outils par sous-agent, plafonné à 1000
agent.session_controltruePermet aux agents admissibles de créer, lire, contacter et arrêter des sessions pairs
agent.refusal_fallback_model""Modèle utilisé pour une nouvelle tentative après un refus du filtre de contenu; vide désactive la nouvelle tentative
session.timeout_secs3600Délai d'expiration d'une session inactive en secondes; 0 désactive le balayage d'inactivité
session.autocompact_pct70Pourcentage d'utilisation du contexte qui démarre la compaction automatique
orchestrator.max_plan_duration_seconds7200Limite pour l'ensemble d'un plan d'exécution automatique sans supervision; 0 la supprime
agent.sandbox"auto"Choisit auto, strict ou off pour les nouveaux sous-processus d'agent; consultez Sécurité
agent.sandbox_allow_unsandboxed_execfalseAutorise l'exécution sans bac à sable uniquement lorsqu'elle est explicitement activée
agent.deepseek_env{}Associe les noms de variables d'environnement du DeepSeek Harness à des références secret:// du coffre-fort
dashboard.default_memory_mode"persistent"Mode de mémoire des nouveaux clavardages du tableau de bord : persistent, incognito ou temporary
dashboard.model_picker_hidden_models[]Modèles masqués par Modèles sélectionnables; Auto et le modèle actif restent visibles
dashboard.link_patterns[]Paires d'expression régulière JavaScript et de modèle d'URL absolue utilisées par les Motifs de liens texte
dashboard.title_refresh_every_turns0Revérifie un titre généré automatiquement tous les N tours; 0 conserve la cadence intégrée
dashboard.terminal.completion.enabledtrueActive la saisie semi-automatique des commandes et des chemins dans le terminal
memory.persistence_enabledtrueActive les écritures de mémoire automatiques et la consolidation
memory.inject_memorytrueAjoute la mémoire enregistrée au contexte des nouvelles sessions
memory.inject_lessonstrueAjoute les corrections apprises au contexte des nouvelles sessions
memory.inject_activitytrueAjoute les projets récents, l'historique, les faits de tâches et les épisodes passés
mcp.honour_auto_approvetrueRespecte les listes autoApprove écrites par le propriétaire dans les fichiers MCP et d'agent; les listes des applications restent ignorées. Nécessite un redémarrage de la passerelle
monitoring.max_runtime_secs604800Plafond de l'opérateur pour un moniteur nouveau ou mis à jour, jusqu'à trente jours
skills.max_triggered0Nombre maximal de Skills correspondants injectés par message; 0 désactive l'injection de déclencheurs, pas la découverte
wakatime.enabledfalseActive le rapport des heures de programmation une fois la clé API stockée dans le coffre-fort de secrets
telemetry.enabledfalseActive les métriques locales de latence et de taux de défaillance; il ne les exporte pas
auto_updatetrueVérifie les mises à jour des installations source au démarrage et toutes les douze heures
instances.enabledfalseActive la gestion des crews distants et multi-instances
instances.warm_set_cap0Limite fixe de tunnels actifs; 0 la dimensionne automatiquement, plafonnée à 8
capabilities.publishDésactivéeCapacité de gouvernance pour la publication publique d'artefacts
publish.allowed_destinations[]Fournisseurs autorisés sous le plafond de gouvernance de publication

Décisions avec Jev (aperçu)

Activez Paramètres → Développeur → Aperçus de fonctionnalités → Décisions (Jev) uniquement après avoir examiné la destination et les catégories de données indiquées sur la carte. Le consentement est stocké en dehors de config.json, de sorte qu'un agent ne peut pas activer le transfert en modifiant les paramètres.

Activer le commutateur principal n'arme pas chaque comportement. Choisissez Auto (Jev) dans le sélecteur de modèle d'un clavardage pour le routage de modèle par tour, et Auto (Jev) sur le bouton d'envoi occupé pour les décisions Diriger-ou-Mettre-en-file. La sélection automatique de Skills nécessite également skills.max_triggered supérieur à zéro; ce paramètre active globalement l'injection de déclencheurs par message, pas seulement Jev. Le filtrage de la mémoire rappelée et les mesures facultatives de risque d'outil et de compaction ont chacun leur propre commutateur de consentement.

Paramètres pertinents :

CléValeur par défautSignification
decisions.bucket100Pourcentage des sessions autrement admissibles incluses dans l'échantillon stable
decisions.history_budget_chars0Nombre maximal de caractères de conversation antérieure envoyés avec une décision; 0 n'en envoie aucun
decisions.model_route.simple""Modèle pour les messages que Jev classe comme simples; vide conserve le modèle actuel
decisions.model_route.medium""Modèle pour les messages moyens
decisions.model_route.complex""Modèle pour les messages complexes

Une sélection concrète de modèle l'emporte toujours sur Auto (Jev). Les tâches planifiées, les sous-agents, les requêtes d'application et les tours de crews distants conservent leurs propres paramètres de modèle.

Thèmes, zoom et langue

Choisissez un thème, une typographie et une langue d'interface dans Paramètres → Affichage. L'interface est offerte en anglais, allemand, espagnol, français, italien, portugais, russe, hindi, bengali, chinois, coréen et japonais. La langue de réponse de l'agent suit votre conversation plutôt que ce paramètre d'affichage.

Dans l'application de bureau, Paramètres → Affichage → Niveau de zoom accepte un pourcentage exact saisi, limité de 50 à 300 pour cent. Un onglet de navigateur ne peut pas régler le zoom du navigateur lui-même; le paramètre affiche donc plutôt l'indication du raccourci clavier.

Dans Kiro Crew 0.12.0 ou une version ultérieure, Paramètres → Affichage → Thème ajoute Color-blind safe et Amethyst OLED aux thèmes intégrés. Chaque ligne des Paramètres affiche une courte phrase sur son effet; l'explication plus longue se trouve derrière l'infobulle de la ligne.

Seuil de compaction

Paramètres → Chat → Avancé → Seuil de compaction automatique (session.autocompact_pct, par défaut 70) est le pourcentage d'utilisation du contexte à partir duquel la compaction automatique démarre. Dans Kiro Crew 0.12.0 ou une version ultérieure, son option Personnalisé accepte n'importe quel pourcentage exact de 5 à 90. Il ne s'applique pas aux sessions Kiro Agent, qui se compactent d'elles-mêmes.

Notifications

Sous Paramètres → Notifications, dans Kiro Crew 0.12.0 ou une version ultérieure :

  • Notifications poussées → M'avertir même quand Kiro Crew est fermé envoie des alertes à cet appareil après la fermeture de la fenêtre ou de l'onglet Kiro Crew, par le tableau de bord installé comme application Web. La passerelle doit continuer de s'exécuter : une passerelle démarrée par l'application de bureau s'arrête avec elle lorsque Continuer de s'exécuter en arrière-plan après la fermeture de la fenêtre est désactivé. Sur iOS, ajoutez d'abord le tableau de bord à l'écran d'accueil. Lorsque vous activez le commutateur, le navigateur demande d'autoriser les notifications; si vous refusez, le commutateur reste désactivé et l'indique. Les notifications système ordinaires s'arrêtent à la fermeture de Kiro Crew; les alertes poussées continuent par l'application Web installée tant que la passerelle s'exécute, et s'arrêtent quand la passerelle s'arrête, même si l'autorisation du navigateur reste accordée.
  • Sons personnalisés accepte un court fichier MP3, WAV ou OGG pour n'importe quelle catégorie de notification : jusqu'à 5 secondes et 256 Ko.
  • Une approbation qui expire sans réponse laisse une note dans la cloche nommant l'outil. Un clavardage qui s'arrête sur une erreur exigeant votre intervention laisse une entrée Erreurs de clavardage dans la cloche, avec un lien vers celui-ci.

Aperçus de fonctionnalités

Chaque commutateur sous Paramètres → Développeur → Aperçus de fonctionnalités est désactivé par défaut et enregistré sur la passerelle; il s'applique donc dans chaque navigateur et dans l'application de bureau. Deux aperçus ajoutés dans Kiro Crew 0.12.0 n'ont pas de page propre :

  • Shared Crew est un commutateur réservé au propriétaire qui prend effet après un redémarrage de la passerelle. Il active un onglet Personnes, où une carte en deux étapes (Partager cette machine sur Tailscale, puis Leur envoyer le lien Crew) partage cette machine par Tailscale et copie un message d'invitation. Aucun champ de configuration ni aucun agent ne peut activer cet aperçu; seul le propriétaire le peut. Tailscale décide qui entre, y compris toute personne que ses règles d'accès laissent atteindre cette machine, pas seulement les personnes que vous invitez. Chaque personne admise peut voir toutes les sessions et la mémoire du Crew, ouvrir et exécuter des clavardages, et dispose des mêmes droits d'application; il n'y a ni rôles ni contrôles d'accès par session dans cette version. Les cartes d'approbation et de question restent au propriétaire, et seul le propriétaire peut inviter ou révoquer. Pour cesser le partage, révoquez l'invitation de la personne sous Invitations dans l'onglet Personnes, ou retirez-la de votre réseau Tailscale; son travail en cours continue, et sa prochaine requête est refusée.
  • Remote dispatch (work_ledger.remote_dispatch, par défaut false) permet à un clavardage Ultra Mode d'exécuter des tâches sur les machines que vous avez connectées sous Paramètres → Remote Crew. Rien n'est envoyé tant qu'une machine n'est pas connectée.

Ultra Mode lui-même est décrit sous Sessions.

Identifiants des canaux

Les identifiants des canaux se trouvent dans le coffre-fort de secrets chiffré ou dans ~/.kiro/crew/.env, pas dans config.json. Configurez-les dans Paramètres → Canaux de messagerie. Le fichier .env est lisible et modifiable uniquement par son propriétaire.

Variables d'environnement

VariableValeur par défautObjectif
KIROCREW_HOME~/.kiro/crewRépertoire de données pour la configuration, la mémoire, les journaux et les identifiants
KIROCREW_PORT5476Port de la passerelle
KIROCREW_CREW_LOGactivé si non définiDéfinissez à 0 avant le démarrage de la passerelle pour désactiver le journal Crew caviardé et le registre de session par défaut

Définissez-les avant de démarrer la passerelle. Utilisez --port pour remplacer KIROCREW_PORT pour une seule invocation.

Répertoire de données

L'état persistant réside sous ~/.kiro/crew/, sauf si KIROCREW_HOME pointe ailleurs. Consultez Installation pour la disposition des répertoires.

Page mise à jour : 11 novembre 2026