Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

ACP (Agent Client Protocol) mutlu yolu

Durum: Etkin
Kapsam: IDE konakları için belgelenmiş mutlu yol
Son inceleme: 2026-07-12 Sahip: AX Code runtime

AX Code, IDE’lerin (örneğin Zed) özel bir aktarım olmadan ajanı barındırabilmesi için bir ACP sunucusu sunar.

Gereksinimler

• Desteklenen CLI kurulumu (PATH üzerinde ax-code)
• Yapılandırılmış bir sağlayıcı (ax-code providers login veya ortam anahtarları)

Sunucuyu başlatma

# Current directory as workspace
ax-code acp

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

Initialize + session + prompt (stdio)

ACP, stdio üzerinde JSON-RPC’dir. Asgari mutlu yol:

# 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

Tipik konak sırası:

1. initialize — protokol sürümünü ve ajan yeteneklerini pazarlık eder
2. session/new — cwd proje köküne ayarlı bir oturum oluşturur
3. session/prompt — kullanıcı metnini gönderir; ajan araçları çalıştırır ve bir durma gerekçesi döndürür
4. session/load — konağın bildiği bir oturum kimliğini sürdürür

Zed örneği

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

Bugün çalışanlar

Ayrıntılar ve sınırlar: packages/ax-code/src/acp/README.md.

İsteğe bağlı etkileşimli sorular

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Yalnızca konak arayüzü soru istemlerini yanıtlayabildiğinde açın.