Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Jalur lancar ACP (Agent Client Protocol)

Status: Aktif
Cakupan: jalur lancar yang terdokumentasi untuk host IDE
Terakhir ditinjau: 2026-07-12 Pemilik: AX Code runtime

AX Code menyediakan server ACP agar IDE (misalnya Zed) dapat menjadi host agen tanpa transport khusus.

Persyaratan

• Pemasangan CLI yang didukung (ax-code pada PATH)
• Penyedia yang sudah dikonfigurasi (ax-code providers login atau kunci lingkungan)

Menjalankan server

# Current directory as workspace
ax-code acp

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

Inisialisasi + sesi + prompt (stdio)

ACP adalah JSON-RPC melalui stdio. Jalur lancar minimal:

# 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

Urutan host yang umum:

1. initialize — menegosiasikan versi protokol dan kapabilitas agen
2. session/new — membuat sesi dengan cwd yang menunjuk ke akar proyek
3. session/prompt — mengirim teks pengguna; agen menjalankan alat lalu mengembalikan alasan berhenti
4. session/load — melanjutkan id sesi yang dikenal host

Contoh Zed

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

Yang berfungsi saat ini

Rincian dan batasan: packages/ax-code/src/acp/README.md.

Pertanyaan interaktif opsional

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Aktifkan hanya jika antarmuka host dapat menjawab prompt pertanyaan.