Passer au contenu principal
Afficher en Markdown

Agent Client Protocol (ACP)

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.

Qu'est-ce que l'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.

Démarrage rapide

Exécutez Kiro comme agent ACP :

bash
kiro-cli acp

Pour utiliser une configuration d'agent précise :

bash
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.

Choisir le harnais d'agent

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.

bash
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.

Se connecter à partir d'un client ACP

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 initialize se 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 norme clientCapabilities._meta["terminal-auth"]: true ou un objet capabilities.auth.terminal d'ACP v2.
  • Un client qui n'en déclare aucune se voit offrir une méthode qui vous demande d'exécuter kiro-cli login vous-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.

Configuration de l'éditeur

Kiro CLI peut être utilisé comme agent ACP dans n'importe quel éditeur qui prend en charge le protocole.

IDE JetBrains

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é :

  1. Ouvrez la fenêtre d'outil AI Chat
  2. Cliquez sur le bouton des paramètres et sélectionnez Add Custom Agent
  3. Ajoutez ce qui suit à ~/.jetbrains/acp.json :
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

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) :

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.

Autres éditeurs

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.

Méthodes ACP prises en charge

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.

Protocole de base

MéthodeDescription
initializeInitialise la connexion et échange les capacités
session/newCrée une nouvelle session de clavardage
session/loadCharge une session existante par ID
session/promptEnvoie une requête à l'agent
session/cancelAnnule l'opération en cours
session/set_modeChange le mode de l'agent (p. ex., différentes configurations d'agent)
session/set_modelChange le modèle pour la session (CLI v2 uniquement — CLI V3 utilise session/set_config_option)

Capacités de l'agent

L'agent ACP de Kiro annonce ces capacités lors de l'initialisation :

  • loadSession: true - Prend en charge le chargement de sessions existantes
  • promptCapabilities.image: true - Prend en charge le contenu image dans les requêtes

Mises à jour de session

L'agent envoie ces types de mises à jour de session via session/notification :

Type de mise à jourDescription
AgentMessageChunkTexte/contenu diffusé en continu depuis l'agent
ToolCallInvocation d'outil avec nom, paramètres, état
ToolCallUpdateMises à jour de progression pour les outils en cours d'exécution
TurnEndSignale 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.

Extensions Kiro

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.

Commandes slash

MéthodeTypeDescription
_kiro.dev/commands/executeRequêteExécute une commande slash (p. ex., /agent swap, /context add)
_kiro.dev/commands/optionsRequêteObtient des suggestions de saisie automatique pour une commande partielle
_kiro.dev/commands/availableNotificationEnvoyée après la création de la session avec la liste des commandes disponibles

Événements du serveur MCP

MéthodeTypeDescription
_kiro.dev/mcp/oauth_requestNotificationFournit l'URL OAuth lorsqu'un serveur MCP nécessite une authentification
_kiro.dev/mcp/server_initializedNotificationIndique qu'un serveur MCP a terminé son initialisation et que ses outils sont disponibles

Gestion de session

MéthodeTypeDescription
_kiro.dev/compaction/statusNotificationSignale la progression de la compaction du contexte de conversation
_kiro.dev/clear/statusNotificationSignale l'état lors de l'effacement de l'historique de session
_session/terminateNotificationMet fin à une session de sous-agent

Exemple : Initialiser une connexion

Voici comment un client ACP initialise une connexion avec Kiro :

json
// 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 :

json
// 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" } ] } }

Journalisation

Les journaux de l'agent ACP sont écrits à l'emplacement standard des journaux de Kiro :

PlateformeEmplacement
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 :

bash
KIRO_LOG_LEVEL=debug kiro-cli acp KIRO_CHAT_LOG_FILE=/path/to/custom.log kiro-cli acp

Voir aussi

Page mise à jour : 11 novembre 2026