ACP agentes de programación
Agent Client Protocol conecta una interfaz de programación con un agente de programación. La interfaz puede ser un editor, una aplicación de escritorio, CLI, u otro agente ADK-Rust. El agente de programación es un proceso separado que razona sobre un proyecto y reporta su trabajo a través de una sesión compartida.
ADK-Rust implementa ambos lados de la versión 1 del protocolo estable de ACP:
- usar un agente de programación externo ACP desde una aplicación ADK-Rust;
- exponer un agente ADK-Rust como un proceso ACP que un editor puede iniciar.
La implementación usa la agent-client-protocol Rust SDK oficial. La versión del crate SDK
y la versión en red ACP son separadas: ADK-Rust actualmente usa SDK
1.2 mientras negocia la versión del protocolo 1 durante initialize.
Lee esta sección
- Arquitectura y conceptos explica los dos roles y el flujo completo de solicitudes.
- Construir un cliente o host ACP cubre la delegación de una sola vez, sesiones persistentes, streaming, cancelación, permisos, archivos, terminales y servidores de sesión MCP.
- Exponer un agente ADK-Rust ACP cubre la construcción del servidor, el mapeo del ciclo de vida, el streaming de eventos, la persistencia de sesiones y el despliegue.
- Pruebas y matriz de soporte enumera el comportamiento verificado y las funciones que ADK-Rust deliberadamente no anuncia.
¿Qué protocolo debo usar?
| Boundary | Úsalo para |
|---|---|
| ACP | Una interfaz de programación interactiva que trabaja con un agente de programación dentro de una sesión de proyecto |
| A2A | Agentes empresariales desplegados de forma independiente que intercambian tareas y artefactos remotos |
| MCP | Herramientas, prompts y recursos puestos a disposición detrás de un agente |
ACP puede llevar la configuración del servidor MCP cuando se abre una sesión de programación. Eso no hace que ACP y MCP sean intercambiables: ACP posee la conversación del agente de codificación; MCP proporciona las herramientas y recursos usados durante esa conversación.
Ejemplos
| Ejemplo | Lo que demuestra |
|---|---|
examples/acp_client_host | Interfaz de cliente transmitida, permisos asíncronos y un sistema de archivos de solo lectura limitado al espacio de trabajo |
examples/acp_kiro | Delegación directa, un agente ACP como una herramienta ADK, sesiones persistentes, configuración del entorno y cancelación concurrente |
examples/acp_server | Un agente que usa herramientas, ADK-Rust, LLM expuesto a editores a través de ACP v1 |
examples/acp_full_protocol | Referencia en proceso, sin clave API, respaldada por Runner, que ejercita toda la superficie del servidor de la Fase 2 (embedded-resource + image/audio prompts, puente de permisos, reproducción de session/load, actualizaciones de uso/llamadas a herramientas) con una prueba de validación |
Anterior: ← Evaluación comparativa | Siguiente: Reintentar y reflexionar →