Kiro CLI exécute chaque conversation sur un harnais d'agent, le processus qui planifie, appelle les outils et dialogue avec le modèle. Dans Kiro CLI 3.0.0 ou une version ultérieure, un clavardage interactif qui ne nomme aucun harnais démarre le harnais V3 sur une machine capable de l'exécuter. Utilisez cette page pour savoir quel harnais un lancement démarre, en choisir un pour une seule exécution ou l'enregistrer comme valeur par défaut, confirmer le choix et revenir à V2. V2 s'exécute toujours, mais ne reçoit aucune nouvelle fonctionnalité. L'interface classique ne s'exécute plus pour le clavardage interactif.
| Harnais | État dans Kiro CLI 3.0.0 ou une version ultérieure | Le choisir lorsque |
|---|---|---|
| V3 | Valeur par défaut pour le clavardage interactif sur une machine capable de l'exécuter. Le même harnais d'agent unifié que Kiro IDE et Kiro Web | Vous voulez les fonctionnalités actuelles de la CLI, comme Approve for me, la Memory et les sessions dans le nuage |
| V2 | Disponible sur choix explicite. Ne reçoit aucune nouvelle fonctionnalité | Un script ou une configuration dépend encore du comportement de 2.x, ou votre machine Linux ne peut pas exécuter V3 |
| Classique | Retirée pour le clavardage interactif | Jamais pour un nouveau travail. Un lancement qui sélectionne encore l'interface classique se voit proposer V3; consultez Si un lancement sélectionne encore l'interface classique |
Privilégiez V3 à moins qu'un flux de travail dont vous dépendez ait encore besoin de V2, et gardez kiro-cli --v2 à portée de main jusqu'à ce que vos vérifications V3 réussissent. Si vous migrez depuis Kiro CLI 2.x, suivez Mettre à niveau depuis CLI 2.x après avoir lu cette page.
Lorsque rien sur la ligne de lancement ni dans vos paramètres ne nomme un harnais, Kiro CLI en choisit un selon le type de lancement :
| Lancement | Harnais par défaut |
|---|---|
Clavardage interactif (kiro-cli ou kiro-cli chat) | V3 sur une machine capable de l'exécuter. Sur une machine Linux avec une glibc plus ancienne, V2; consultez Machines Linux avec une glibc plus ancienne |
Exécution locale sans interface (--no-interactive, ou une entrée standard qui n'est pas un terminal) | V2, avec les exceptions énumérées sous Scripts et CI : --trust-all-tools prend la valeur par défaut interactive, et --cloud, --repo ou un ID de session V3 sélectionne V3 |
Client ACP (kiro-cli acp) | V3 sur une machine capable de l'exécuter, avec les exceptions énumérées sous Clients ACP |
--cloud ou --repo | V3 |
--resume-id nommant une session créée par V1 ou V2 | V2 |
Un choix explicite remplace ces valeurs par défaut ordinaires. Kiro CLI résout le harnais dans cet ordre :
--v3 ou --v2 sur la ligne de lancement.kiro-cli chat --agent-engine <value>.--cloud ou --repo.chat.agentEngine enregistré.Deux types de lancement s'exécutent uniquement sur V3. --cloud et --repo rejettent un choix explicite de V1 ou V2. --sessions a sa propre règle : lorsque rien d'explicite ou d'enregistré ne sélectionne V1 ou V2, il ouvre le tableau de bord des sessions sur V3; lorsqu'un indicateur ou le paramètre chat.agentEngine enregistré sélectionne V1 ou V2, le lancement s'arrête et vous indique d'exécuter avec --v3.
Les valeurs exactes des indicateurs, leurs conflits et les valeurs acceptées du paramètre se trouvent dans Commandes CLI et Paramètres.
Transmettez --v3 ou --v2 à kiro-cli ou à kiro-cli chat. L'indicateur s'applique à cette exécution et laisse votre valeur par défaut enregistrée inchangée.
# Start this session on V3 kiro-cli --v3 # Start this session on V2 kiro-cli --v2
--v2 et --v3 ne peuvent pas être combinés, et ni l'un ni l'autre ne peut être combiné avec --agent-engine ou --legacy-ui.
Pour vérifier, lisez les premières lignes de la session. Une session V3 s'ouvre avec Welcome to Kiro CLI V3. Une session V2 s'ouvre avec Kiro CLI V3 is here; consultez Confirmer quel harnais s'exécute.
Ensuite, enregistrez le harnais souhaité comme valeur par défaut afin de pouvoir omettre l'indicateur.
Enregistrez le harnais pour chaque lancement interactif avec le paramètre global chat.agentEngine; un espace de travail ne peut pas le remplacer. Pour un harnais actuel, enregistrez v3 ou v2. Le paramètre accepte aussi la valeur retirée v1; consultez Paramètres.
# Start every interactive session on V3 kiro-cli settings chat.agentEngine v3 # Start every interactive session on V2 kiro-cli settings chat.agentEngine v2
Pour vérifier, exécutez kiro-cli settings chat.agentEngine et confirmez la valeur que vous avez enregistrée. Un indicateur --v2 ou --v3 lors d'un lancement ultérieur l'emporte toujours pour cette exécution.
Pour les clients ACP, enregistrez plutôt le harnais avec acp.agentEngine; consultez Clients ACP.
Dans Kiro CLI 3.0.0 ou une version ultérieure, le premier lancement interactif après la mise à niveau pose la question avant que V3 s'applique si vous avez des sessions Kiro CLI 2.x enregistrées et n'avez jamais choisi de harnais. Une nouvelle installation, ou une mise à niveau sans sessions enregistrées, démarre V3 sans demander. L'invite propose trois réponses :
| Réponse | Ce qui se passe |
|---|---|
| Continue with V3 | Enregistre chat.agentEngine comme v3 et démarre cette session sur V3 |
| Stay on V2, remind me later | Enregistre chat.agentEngine comme v2, démarre cette session sur V2 et pose la question de nouveau après 14 jours |
| Stay on V2, don't ask again | Enregistre chat.agentEngine comme v2 et démarre cette session sur V2 |
Si vous aviez déjà enregistré chat.agentEngine comme v2 avant la mise à niveau, vous voyez plutôt un avis unique, avec Switch to V3 et Keep V2.
Kiro CLI saute l'invite lorsque le lancement nomme déjà un harnais (ainsi, kiro-cli --v3 démarre V3 sans demander et n'enregistre aucune valeur par défaut), lorsqu'il reprend une session avec --resume-id, lorsqu'il ouvre le tableau de bord des sessions avec --sessions, lorsqu'il s'exécute sans interface ou sur une machine qui ne peut pas exécuter V3.
Lorsque V3 démarre, il met à niveau automatiquement vos configurations d'agent V2, sauf si chat.enableAutoAgentUpgrade est false. Consultez Mise à niveau des configurations d'agent pour savoir ce que la mise à niveau change et comment la passer en revue.
Pour vérifier votre réponse, exécutez kiro-cli settings chat.agentEngine. Pour la changer plus tard, suivez Enregistrer un harnais par défaut.
Une exécution locale sans interface sans harnais explicite ou enregistré exécute V2, avec trois exceptions : --trust-all-tools prend la valeur par défaut interactive (V3 sur une machine capable de l'exécuter), --cloud ou --repo sélectionne V3, et un --resume-id qui nomme une session V3 sélectionne V3. Nommez le harnais dans chaque script afin qu'un changement des valeurs par défaut ne modifie pas votre pipeline :
# Headless run on V3 kiro-cli chat --v3 --no-interactive "your prompt here" # Headless run on V2 kiro-cli chat --v2 --no-interactive "your prompt here"
Une exécution sans interface qui sélectionne l'interface classique est déplacée vers la valeur par défaut sans interface et affiche un avis.
Pour vérifier, examinez la sortie de l'exécution pour le harnais attendu. Pour les indicateurs qui contrôlent les approbations et la sortie d'une exécution sans interface, consultez Mode sans interface.
Dans Kiro CLI 3.0.0 ou une version ultérieure, kiro-cli acp démarre le harnais V3 lorsque ni l'indicateur --agent-engine ni le paramètre acp.agentEngine n'en nomme un, avec trois exceptions :
--agent, --model, --effort, --trust-all-tools ou --trust-tools. L'exécution reste sur V2.Un harnais nommé l'emporte toujours. Avec --agent-engine v3, les indicateurs réservés à V2 sont rejetés. chat.agentEngine n'est jamais consulté pour kiro-cli acp.
Pour choisir explicitement, enregistrez le paramètre ou transmettez l'indicateur dans les arguments de commande de votre éditeur :
kiro-cli settings acp.agentEngine v3
Pour vérifier, exécutez kiro-cli settings acp.agentEngine. Pour la configuration de l'éditeur et la liste complète des indicateurs, consultez ACP et kiro-cli acp. Pour savoir ce qui change lorsqu'un client passe à V3, consultez Migrer un client ACP vers CLI V3.
Dans Kiro CLI 3.0.0 ou une version ultérieure, l'interface classique ne s'exécute plus pour le clavardage interactif. Un lancement qui la sélectionne encore, par --classic ou --legacy-ui, --agent-engine v1, la variable d'environnement KIRO_CHAT_UI, le paramètre chat.ui ou chat.agentEngine défini à v1, affiche le message de Kiro CLI 3.0 et propose deux choix :
chat.agentEngine et relance le lancement dans l'interface utilisateur du terminal.Sur une machine qui ne peut pas exécuter V3, le bouton indique Switch to the terminal UI and launch et enregistre chat.agentEngine comme v2.
Une valeur v2 ou v3 enregistrée dans chat.agentEngine l'emporte sur un indicateur classique laissé dans un alias du shell; ainsi, après avoir choisi Continue with V3 une fois, l'alias continue de fonctionner. Si l'interface utilisateur du terminal est absente de l'installation, ce lancement affiche un message de réinstallation qui renvoie à Installation au lieu de démarrer un clavardage.
Pour vérifier, lancez de nouveau et confirmez que la session s'ouvre dans l'interface utilisateur du terminal avec l'un des messages de bienvenue indiqués sous Confirmer quel harnais s'exécute.
Sur une machine Linux dont la glibc est plus ancienne que ce que le harnais V3 exige, un lancement qui ne nomme aucun harnais ouvre l'interface utilisateur du terminal avec le harnais V2 et le message de bienvenue V2 ordinaire. Seul un lancement qui a sélectionné l'interface classique affiche un message indiquant que cette machine ne peut pas exécuter l'agent 3.0. kiro-cli --v3 sur une telle machine s'arrête avec V3 is currently not supported on this system. Les machines macOS et Windows peuvent toujours exécuter V3.
Pour vérifier, lisez le message de bienvenue. Pour les options d'installation sur Linux, consultez Installation.
Lisez les premières lignes de la session :
kiro-cli --v2 comme façon de lancer plutôt l'expérience précédente.Les deux messages renvoient à Mettre à niveau depuis CLI 2.x.
Pour confirmer votre valeur par défaut enregistrée, exécutez kiro-cli settings chat.agentEngine, ou kiro-cli settings acp.agentEngine pour les clients ACP.
Pour exécuter V2 une fois, lancez avec kiro-cli --v2. Pour faire de V2 votre valeur par défaut, exécutez kiro-cli settings chat.agentEngine v2. Aucune de ces commandes ne modifie vos sessions ou votre configuration V3.
V3 et V2 conservent des magasins de sessions distincts. V3 peut reprendre une session V2 sous forme de copie V3; V2 ne peut pas ouvrir une session V3. Consultez Démarrer V3 et garder les sessions V2 accessibles pour les commandes de reprise.
Pour vérifier, démarrez une session et confirmez qu'elle s'ouvre avec Kiro CLI V3 is here.
Démarrez une session V3 avec kiro-cli --v3 et suivez Mettre à niveau depuis CLI 2.x pour migrer vos sessions, vos configurations d'agent, vos permissions et vos Hooks.
Choisir un harnais d'agent