Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Camino feliz de ACP (Agent Client Protocol)

Estado: Activo Alcance: camino feliz documentado para hosts de IDE Última revisión: 2026-07-12 Responsable: entorno de ejecución de AX Code

AX Code expone un servidor ACP para que los IDE (por ejemplo Zed) puedan alojar el agente sin un transporte personalizado.

Requisitos

• Instalación de CLI compatible (ax-code en PATH)
• Un proveedor configurado (ax-code providers login o claves de entorno)

Iniciar el servidor

# Current directory as workspace
ax-code acp

# Explicit workspace
ax-code acp --dir /path/to/project

Inicializar, sesión y prompt (stdio)

ACP es JSON-RPC sobre stdio. Camino feliz mínimo:

# One-shot style example (hosts normally keep the process open)
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{}}}' \
  | ax-code acp

Secuencia habitual del host:

1. initialize: negociar la versión del protocolo y las capacidades del agente
2. session/new: crear una sesión con cwd definido en la raíz del proyecto
3. session/prompt: enviar el texto del usuario; el agente ejecuta herramientas y devuelve un motivo de parada
4. session/load: reanudar un id de sesión conocido por el host

Ejemplo de Zed

{
  "agent_servers": {
    "AX Code": {
      "command": "ax-code",
      "args": ["acp"]
    }
  }
}

Qué funciona hoy

Detalles y limitaciones: packages/ax-code/src/acp/README.md.

Preguntas interactivas opcionales

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Actívalo solo cuando la interfaz del host pueda responder a los avisos de preguntas.