本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。 英文原文

ACP（Agent Client Protocol）順利路徑

狀態：有效
範圍：已記載的 IDE 主機順利路徑
上次審閱：2026-07-12 負責人：AX Code runtime

AX Code 提供 ACP 伺服器，讓 IDE（例如 Zed）不必自訂傳輸就能承載 agent。

需求

• 支援的 CLI 安裝（PATH 上的 ax-code）
• 已設定的供應商（ax-code providers login 或環境金鑰）

啟動伺服器

# Current directory as workspace
ax-code acp

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

初始化、工作階段與提示（stdio）

ACP 是透過 stdio 的 JSON-RPC。最小順利路徑：

# 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

典型主機順序：

1. initialize — 協商協定版本與 agent 能力
2. session/new — 建立工作階段，並把 cwd 設為專案根目錄
3. session/prompt — 送出使用者文字；agent 執行工具並回傳停止原因
4. session/load — 恢復主機已知的工作階段 id

Zed 範例

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

目前可用的能力

細節與限制：packages/ax-code/src/acp/README.md。

選用的互動式問題

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

只有在主機介面能回答問題提示時才啟用。