Kiro CLI met en œuvre le Agent Client Protocol (ACP), une norme ouverte qui permet aux agents d'IA de fonctionner avec n'importe quel éditeur compatible. Cela signifie que vous pouvez utiliser les capacités d'intelligence artificielle agentive de Kiro dans les IDE JetBrains, Zed et d'autres éditeurs compatibles avec ACP.
ACP (Agent Client Protocol) normalise la façon dont les éditeurs se connectent aux agents d'IA, comme le Language Server Protocol (LSP) a normalisé l'intégration des serveurs de langage. Kiro CLI met en œuvre ACP afin que vous puissiez l'utiliser dans un éditeur compatible sans intégration personnalisée pour chaque agent. Consultez Agent Client Protocol pour comprendre l'architecture des clients et du harnais.
Exécutez Kiro comme agent ACP :
kiro-cli acp
Pour utiliser une configuration d'agent précise :
kiro-cli acp --agent my-agent
L'agent communique via stdin/stdout en utilisant JSON-RPC 2.0. Configurez votre éditeur pour qu'il lance cette commande, et vous êtes prêt à commencer.
Le harnais que kiro-cli acp démarre lorsque rien n'en nomme un, et les indicateurs qui gardent un client sur V2, sont couverts sous Clients ACP. Dans Kiro CLI 2.36 ou une version ultérieure, définissez le harnais une seule fois avec le paramètre acp.agentEngine, ou passez --agent-engine dans les arguments de commande de votre éditeur; l'indicateur remplace le paramètre. Les valeurs valides sont v1, v2 et v3. Le paramètre chat.agentEngine s'applique à kiro-cli chat et ne change pas kiro-cli acp.
kiro-cli settings acp.agentEngine v3 kiro-cli acp --agent-engine=v2
Pour confirmer la valeur enregistrée, exécutez kiro-cli settings acp.agentEngine. Dans Kiro CLI 3.2.0 ou une version ultérieure, kiro-cli acp ignore une valeur enregistrée qui n'est pas v1, v2 ou v3 et, lorsque la valeur provient de vos propres paramètres, affiche sur stderr un avertissement qui nomme le paramètre, mais pas la valeur. Pour chaque indicateur de kiro-cli acp, consultez Commandes CLI. Pour savoir ce qui change lorsqu'un client passe au harnais V3, consultez Migrer un client ACP vers CLI V3.
kiro-cli acp a besoin d'un compte Kiro connecté. Dans Kiro CLI 2.37 ou une version ultérieure, s'il démarre alors que vous êtes déconnecté, il répond à la requête initialize du client avec une seule méthode d'authentification et renvoie une erreur d'authentification requise pour toute autre requête jusqu'à ce que vous vous connectiez.
- Un client qui déclare l'authentification par terminal dans
initializese voit offrir une méthode de terminal nommée Log in to Kiro. La choisir exécute la connexion à Kiro dans un terminal que le client ouvre. Kiro accepte l'une des trois formes de déclaration :clientCapabilities.auth.terminal: true, la forme antérieure à la normeclientCapabilities._meta["terminal-auth"]: trueou un objetcapabilities.auth.terminald'ACP v2. - Un client qui n'en déclare aucune se voit offrir une méthode qui vous demande d'exécuter
kiro-cli loginvous-même.
Une fois la connexion terminée, reconnectez-vous à partir du client. Le nouveau processus kiro-cli acp trouve vos identifiants et démarre l'agent. Pour le confirmer, créez une session : session/new réussit au lieu de renvoyer l'erreur d'authentification requise.
Kiro CLI peut être utilisé comme agent ACP dans n'importe quel éditeur qui prend en charge le protocole.
Les IDE JetBrains (IntelliJ IDEA, WebStorm, PyCharm, etc.) prennent en charge l'ACP par l'intermédiaire d'AI Assistant. Consultez la documentation ACP de JetBrains pour tous les détails.
Pour ajouter Kiro comme agent personnalisé :
- Ouvrez la fenêtre d'outil AI Chat
- Cliquez sur le bouton des paramètres et sélectionnez Add Custom Agent
- Ajoutez ce qui suit à
~/.jetbrains/acp.json:
{ "agent_servers": { "Kiro Agent": { "command": "/full/path/to/kiro-cli", "args": ["acp"] } } }
L'agent apparaîtra dans le sélecteur de mode d'AI Chat.
Zed prend en charge nativement les agents ACP. Consultez la documentation sur les agents externes de Zed pour tous les détails. Ajoutez ce qui suit à vos paramètres Zed (~/.config/zed/settings.json) :
{ "agent_servers": { "Kiro Agent": { "type": "custom", "command": "~/.local/bin/kiro-cli", "args": ["acp"], "env": {} } } }
Sélectionnez « Kiro Agent » dans le sélecteur d'agent du panneau d'IA de Zed.
Tout éditeur prenant en charge l'ACP peut intégrer Kiro en lançant kiro-cli acp et en communiquant via JSON-RPC sur stdio. Consultez la spécification ACP pour les détails du protocole.
Kiro CLI met en œuvre les méthodes ACP suivantes, vous donnant accès à la gestion des sessions, à la sélection du modèle et à la diffusion en continu des réponses lorsque vous utilisez Kiro par l'intermédiaire de n'importe quel éditeur compatible avec l'ACP.
| Méthode | Description |
|---|---|
initialize | Initialise la connexion et échange les capacités |
session/new | Crée une nouvelle session de clavardage |
session/load | Charge une session existante par ID |
session/prompt | Envoie une requête à l'agent |
session/cancel | Annule l'opération en cours |
session/set_mode | Change le mode de l'agent (p. ex., différentes configurations d'agent) |
session/set_model | Change le modèle pour la session (CLI v2 uniquement — CLI V3 utilise session/set_config_option) |
L'agent ACP de Kiro annonce ces capacités lors de l'initialisation :
loadSession: true- Prend en charge le chargement de sessions existantespromptCapabilities.image: true- Prend en charge le contenu image dans les requêtes
L'agent envoie ces types de mises à jour de session via session/notification :
| Type de mise à jour | Description |
|---|---|
AgentMessageChunk | Texte/contenu diffusé en continu depuis l'agent |
ToolCall | Invocation d'outil avec nom, paramètres, état |
ToolCallUpdate | Mises à jour de progression pour les outils en cours d'exécution |
TurnEnd | Signale que le tour de l'agent est terminé (CLI v2 uniquement — CLI V3 termine les tours depuis la réponse session/prompt) |
Pour CLI v2, une réponse finale faisant l'objet d'un filtrage de contenu se termine par stopReason: refusal plutôt que par end_turn. Les clients ACP peuvent la présenter comme un refus plutôt que comme une fin normale, sans exposer de détails internes.
Kiro étend le serveur ACP CLI v2 avec des méthodes personnalisées (préfixées par _kiro.dev/ conformément à la spécification ACP) pour exposer des fonctionnalités propres à Kiro comme les commandes slash, les serveurs MCP et la compaction du contexte. Les clients qui ne prennent pas en charge ces extensions peuvent les ignorer sans problème — il s'agit d'améliorations facultatives sur le serveur v2.
| Méthode | Type | Description |
|---|---|---|
_kiro.dev/commands/execute | Requête | Exécute une commande slash (p. ex., /agent swap, /context add) |
_kiro.dev/commands/options | Requête | Obtient des suggestions de saisie automatique pour une commande partielle |
_kiro.dev/commands/available | Notification | Envoyée après la création de la session avec la liste des commandes disponibles |
| Méthode | Type | Description |
|---|---|---|
_kiro.dev/mcp/oauth_request | Notification | Fournit l'URL OAuth lorsqu'un serveur MCP nécessite une authentification |
_kiro.dev/mcp/server_initialized | Notification | Indique qu'un serveur MCP a terminé son initialisation et que ses outils sont disponibles |
| Méthode | Type | Description |
|---|---|---|
_kiro.dev/compaction/status | Notification | Signale la progression de la compaction du contexte de conversation |
_kiro.dev/clear/status | Notification | Signale l'état lors de l'effacement de l'historique de session |
_session/terminate | Notification | Met fin à une session de sous-agent |
Voici comment un client ACP initialise une connexion avec Kiro :
// Client sends initialize request { "jsonrpc": "2.0", "id": 0, "method": "initialize", "params": { "protocolVersion": 1, "clientCapabilities": { "fs": { "readTextFile": true, "writeTextFile": true }, "terminal": true }, "clientInfo": { "name": "my-editor", "version": "1.0.0" } } } // Kiro responds with capabilities { "jsonrpc": "2.0", "id": 0, "result": { "protocolVersion": 1, "agentCapabilities": { "loadSession": true, "promptCapabilities": { "image": true } }, "agentInfo": { "name": "kiro-cli", "version": "1.5.0" } } }
Après l'initialisation, créez une session et commencez à envoyer des requêtes :
// Create a new session { "jsonrpc": "2.0", "id": 1, "method": "session/new", "params": { "cwd": "/home/user/my-project", "mcpServers": [] } } // Send a prompt { "jsonrpc": "2.0", "id": 2, "method": "session/prompt", "params": { "sessionId": "sess_abc123", "content": [ { "type": "text", "text": "Explain this codebase" } ] } }
Les journaux de l'agent ACP sont écrits à l'emplacement standard des journaux de Kiro :
| Plateforme | Emplacement |
|---|---|
| macOS | $TMPDIR/kiro-log/kiro-chat.log |
| Linux | $XDG_RUNTIME_DIR/kiro-log/kiro-chat.log |
Contrôlez le niveau de verbosité des journaux avec des variables d'environnement :
KIRO_LOG_LEVEL=debug kiro-cli acp KIRO_CHAT_LOG_FILE=/path/to/custom.log kiro-cli acp
- Agent Client Protocol (ACP) — comment ACP relie les clients au harnais d'agent unifié
- Migrer un client ACP vers CLI V3 — migrer depuis le serveur ACP CLI v2
- Clavardage interactif - Utilise l'ACP en interne
- Intégration MCP - Les serveurs MCP peuvent être transmis aux sessions ACP
- Référence des commandes CLI
Agent Client Protocol (ACP)