Agentes ACP
ADHDev incluye un amplio inventario integrado de adaptadores para el Agent Client Protocol (ACP).
WARNING
El inventario ACP es amplio, pero cada proveedor ACP debe tratarse como no verificado hasta que se pruebe explícitamente y se promueva en la documentación de compatibilidad.
¿Qué es ACP?
ACP es un protocolo de agente estructurado. En términos de ADHDev, es la ruta usada cuando un agente se comporta más como un proceso de chat impulsado por protocolo que como una sesión de terminal.
Eso normalmente significa que ADHDev puede:
- lanzar el proceso del agente
- enviar prompts como solicitudes estructuradas
- transmitir respuestas estructuradas de vuelta al panel
- exponer controles de modelo, modo u otra configuración cuando el proveedor los ofrece
ACP vs CLI
Las sesiones ACP suelen entenderse mejor en contraste con las sesiones CLI:
| Superficie | ACP | CLI |
|---|---|---|
| Renderizado principal | Sesión estructurada estilo chat | Sesión PTY orientada a terminal |
| Mejor ajuste | Agentes nativos de protocolo y controles impulsados por esquema | Flujos de trabajo de shell, TUIs y salida de terminal en bruto |
| Controles típicos | Modelo/modo/configuración cuando el proveedor los expone | Entrada de terminal, scrollback y recuperación de session-host |
| Modelo de recuperación | Ciclo de vida de proceso/sesión | Runtime alojado y ciclo de vida de session-host |
Si quieres comportamiento de terminal en bruto, usa la ruta CLI. Si quieres comportamiento de chat estructurado, ACP suele ser el mejor ajuste.
Cómo se ve ACP en el panel
Las sesiones ACP aparecen en el panel como conversaciones estilo chat en lugar de paneles de terminal.
Dependiendo del proveedor, es posible que puedas:
- enviar prompts desde la entrada de chat normal
- leer respuestas de streaming estructuradas
- gestionar aprobaciones desde el panel
- cambiar de modelo o modo
- usar opciones de configuración específicas del proveedor expuestas a través de la barra de controles
Lanzar sesiones ACP
Los proveedores ACP se lanzan desde el mismo flujo de inicio de máquina/workspace usado para otros tipos de sesión:
- Abre una máquina.
- Elige el workspace que quieras.
- Elige la categoría ACP.
- Selecciona el proveedor.
- Lanza la sesión en el panel.
Si no aparecen proveedores ACP, normalmente significa que la máquina seleccionada no tiene un proveedor ACP utilizable instalado o configurado.
Inventario ACP integrado
ADHDev incluye actualmente 35 adaptadores ACP integrados. Los nombres más conocidos del inventario incluyen:
- Gemini CLI
- Codex
- Claude Agent
- Cursor
- Cline
- GitHub Copilot
- Goose
- Kimi CLI
- OpenCode
- Qwen Code
De nuevo, el inventario integrado no significa soporte generalizado.
Autenticación y advertencias
Las herramientas ACP siguen gestionando su propia autenticación y configuración upstream.
Patrones comunes:
- las claves de API siguen perteneciendo a la herramienta upstream
- la falta de autenticación a menudo se ve como un fallo de lanzamiento
- algunas herramientas ACP dependen de flags experimentales upstream o de características de protocolo inestables
- la profundidad de control varía mucho según el proveedor
Por eso ACP es potente pero desigual en todo el inventario.
Cuándo preferir ACP
ACP es una buena opción cuando quieres:
- una sesión estructurada estilo chat en lugar de una terminal
- controles de modelo y modo expuestos por el proveedor en el panel
- una superficie de protocolo más limpia para agentes que ya hablan ACP bien
Si el proveedor es más nativo de terminal, la ruta CLI puede seguir siendo más fiable en la práctica.