ACP (Agent Client Protocol) relie un éditeur, une application ou une intégration personnalisée à l'agent Kiro. Kiro IDE, CLI, Web et Mobile l'utilisent pour accéder au même harnais d'agent unifié, ce qui permet de partager la mise en œuvre de l'agent entre toutes les interfaces. Les éditeurs compatibles avec ACP, comme les IDE JetBrains et Zed, se connectent au moyen du même protocole et reçoivent les capacités standard qu'ils mettent en œuvre. Consultez la spécification ACP.
Les applications IDE, CLI, Web et Mobile de Kiro sont des clients du même harnais d'agent unifié. Elles utilisent les méthodes ACP standard pour le cycle de vie des sessions et des requêtes, ainsi que des extensions Kiro pour des capacités comme le Steering en direct, les Specs, les interactions de permission enrichies et le suivi du contexte.
Les éditeurs tiers compatibles peuvent également se connecter à Kiro au moyen d'ACP. Ils reçoivent les capacités standard mises en œuvre par leur client et peuvent utiliser les extensions Kiro facultatives lorsque les deux parties les prennent en charge.
| Type de client | Rôle ACP | Ce qu'il fournit |
|---|---|---|
| Applications Kiro | Clients propriétaires utilisant ACP standard et les extensions Kiro | Expériences propres à Kiro pour les sessions, les permissions et les flux de travail |
| Éditeurs compatibles | Clients tiers utilisant ACP standard et les extensions prises en charge | L'agent Kiro dans un flux de travail d'éditeur existant |
| Intégrations personnalisées | Clients ACP conçus pour un usage précis | Une interface appartenant au client autour des capacités négociées de l'agent Kiro |
ACP et le Model Context Protocol (MCP) se trouvent de part et d'autre du harnais d'agent.
| Protocole | Relie | Question centrale |
|---|---|---|
| ACP | Un éditeur, une application ou un autre client au harnais d'agent Kiro | Comment l'utilisateur interagit-il avec l'agent et le contrôle-t-il? |
| MCP | Le harnais d'agent Kiro aux outils et aux données externes | Quels systèmes supplémentaires l'agent peut-il utiliser? |
Un client envoie des requêtes et reçoit les mises à jour de session par ACP. Le harnais peut ensuite appeler des outils intégrés ou des serveurs MCP pendant son travail. Un client ACP peut donc fournir l'interface, tandis que MCP étend les capacités de l'agent.
Une fois la frontière du protocole établie, voici ce qui relève du harnais et ce dont chaque client est responsable.
Les capacités de l'agent résident dans le harnais plutôt que dans un seul client. Lorsqu'elles sont disponibles pour une session, le harnais applique la même configuration de projet, les mêmes définitions d'agents, le même Steering, les mêmes permissions, Hooks, Skills et serveurs MCP, peu importe le client qui a ouvert la session.
Le client demeure responsable de la présentation de ces capacités et des rappels qui lui appartiennent. Les différences peuvent comprendre :
- La présentation des sessions et des appels d'outils
- Les interfaces de permission et de saisie structurée
- Les rappels natifs de l'éditeur pour les fichiers, le terminal et l'intelligence du code
- Le transport local ou distant
- La prise en charge des extensions Kiro facultatives
Consultez les renseignements sur la disponibilité de chaque fonctionnalité avant de présumer qu'elle fonctionne dans tous les clients.
| Je veux... | Consulter |
|---|---|
| Utiliser Kiro dans les IDE JetBrains, Zed ou un autre éditeur compatible | Guide de configuration de l'éditeur |
| Mettre à niveau un client ACP existant du serveur CLI v2 vers CLI V3 | Migration d'un client ACP |
| Créer un client ACP | Spécification ACP et les conseils sur les capacités de cette page |
| Comprendre l'architecture des clients et du harnais Kiro | Comment fonctionne Kiro |
| Connecter l'agent Kiro à des outils et des données externes | MCP |
ACP standard couvre le contrat portable entre le client et l'agent, notamment l'initialisation, les sessions, les requêtes, l'annulation, les mises à jour et les demandes de permission. Un client compatible peut utiliser Kiro sans mettre en œuvre une interface propre à Kiro.
Les extensions Kiro ajoutent des capacités qui vont au-delà du protocole standard. Kiro annonce les méthodes de requête facultatives dans agentCapabilities._meta.kiro.extensionMethods et peut joindre des métadonnées Kiro aux messages ACP standard.
Si vous créez un client ACP, suivez ces règles :
- Lire les capacités retournées par
initialize. - Activer un comportement facultatif uniquement lorsque le serveur en cours d'exécution l'annonce.
- Ignorer les méthodes et les métadonnées inconnues.
- Retourner une erreur JSON-RPC explicite pour les requêtes agent-vers-client non prises en charge plutôt que de laisser l'agent en attente.
L'annonce des capacités du serveur en cours d'exécution fait autorité. Ne déduisez pas la prise en charge d'une version de Kiro CLI, d'un nom de produit ou d'un catalogue de méthodes fixe.
Agent Client Protocol (ACP)