Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Đường thuận ACP (Agent Client Protocol)

Trạng thái: Đang hoạt động
Phạm vi: đường thuận đã ghi cho máy chủ IDE
Xem xét lần cuối: 2026-07-12 Chủ sở hữu: AX Code runtime

AX Code lộ một máy chủ ACP để các IDE (ví dụ Zed) có thể lưu trữ tác nhân mà không cần truyền tải tùy chỉnh.

Yêu cầu

• Bản cài CLI được hỗ trợ (ax-code trên PATH)
• Một nhà cung cấp đã cấu hình (ax-code providers login hoặc khóa môi trường)

Khởi động máy chủ

# Current directory as workspace
ax-code acp

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

Khởi tạo + phiên + lời nhắc (stdio)

ACP là JSON-RPC trên stdio. Đường thuận tối thiểu:

# 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

Chuỗi máy chủ điển hình:

1. initialize — thương lượng phiên bản giao thức và khả năng của tác nhân
2. session/new — tạo một phiên với cwd đặt tới gốc dự án
3. session/prompt — gửi văn bản người dùng; tác nhân chạy công cụ và trả lý do dừng
4. session/load — tiếp tục một mã phiên mà máy chủ đã biết

Ví dụ Zed

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

Những gì hoạt động hôm nay

Chi tiết và giới hạn: packages/ax-code/src/acp/README.md.

Câu hỏi tương tác tùy chọn

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

Chỉ bật khi giao diện máy chủ có thể trả lời các lời nhắc câu hỏi.