ACP agents de codage
Le protocole Agent Client connecte une interface de codage à un agent de codage. L’interface peut être un éditeur, une application de bureau, CLI, ou un autre agent ADK-Rust. L’agent de codage est un processus séparé qui raisonne sur un projet et communique son travail via une session partagée.
ADK-Rust implémente les deux côtés de la version 1 du protocole stable ACP :
- utiliser un agent de codage externe ACP depuis une application ADK-Rust ;
- exposer un agent ADK-Rust comme un processus ACP qu’un éditeur peut démarrer.
L’implémentation utilise le agent-client-protocol officiel pour Rust SDK. La version du crate SDK et la version de trame ACP sont distinctes : ADK-Rust utilise actuellement SDK 1.2 tout en négociant la version 1 du protocole pendant initialize.
Lire cette section
- Architecture and concepts explique les deux rôles et le flux complet des requêtes.
- Build an ACP client or host couvre la délégation en une seule fois, les sessions persistantes, le streaming, l’annulation, les permissions, les fichiers, les terminaux et les serveurs de session MCP.
- Expose an ADK-Rust ACP agent couvre la construction du serveur, le mappage du cycle de vie, le streaming des événements, la persistance de session et le déploiement.
- Testing and support matrix liste le comportement vérifié et les fonctionnalités que ADK-Rust n’annonce délibérément pas.
Quel protocole devrais-je utiliser ?
| Boundary | Utilisez-le pour |
|---|---|
| ACP | Une interface de codage interactive travaillant avec un agent de codage dans une session de projet |
| A2A | Des agents métier déployés indépendamment échangeant des tâches et des artefacts à distance |
| MCP | Outils, invites et ressources mis à disposition derrière un agent |
ACP peut transporter la configuration du serveur MCP lorsqu’une session de codage s’ouvre. Cela ne rend pas ACP et MCP interchangeables : ACP possède la conversation de l’agent de codage ; MCP fournit les outils et les ressources utilisés pendant cette conversation.
Exemples
| Exemple | Ce que cela prouve |
|---|---|
examples/acp_client_host | UI client en flux continu, permissions asynchrones et système de fichiers en lecture seule limité à un workspace |
examples/acp_kiro | Délégation directe, un agent ACP comme outil ADK, des sessions persistantes, la configuration de l’environnement et l’annulation concurrente |
examples/acp_server | Un agent ADK-Rust LLM utilisant des outils exposé aux éditeurs via ACP v1 |
examples/acp_full_protocol | Référence en processus, sans clé API, adossée à Runner, exerçant toute la surface serveur de la phase 2 (prompts de ressources intégrées + image/audio, pont d’autorisations, relecture session/load, mises à jour d’utilisation/appels d’outils) avec un test de validation |
Précédent : ← Benchmarking | Suivant : Retry & Reflect →