Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Percorso di successo di ACP (Agent Client Protocol)

Stato: Attivo
Ambito: percorso di successo documentato per gli host IDE
Ultima revisione: 2026-07-12 Responsabile: runtime di AX Code

AX Code espone un server ACP così che gli IDE (per esempio Zed) possano ospitare l’agente senza un trasporto personalizzato.

Requisiti

• Installazione CLI supportata (ax-code nel PATH)
• Un provider configurato (ax-code providers login oppure chiavi di ambiente)

Avvio del server

# Current directory as workspace
ax-code acp

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

Inizializzazione, sessione e prompt (stdio)

ACP è JSON-RPC su stdio. Percorso di successo minimo:

# 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

Sequenza tipica dell’host:

1. initialize — negozia la versione del protocollo e le capacità dell’agente
2. session/new — crea una sessione con cwd impostato alla radice del progetto
3. session/prompt — invia il testo dell’utente; l’agente esegue gli strumenti e restituisce un motivo di arresto
4. session/load — riprende un id di sessione noto all’host

Esempio con Zed

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

Che cosa funziona oggi

Dettagli e limiti: packages/ax-code/src/acp/README.md.

Domande interattive facoltative

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Attiva questa funzione solo quando l’interfaccia dell’host può rispondere alle richieste di domande.