Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

ACP (Agent Client Protocol): штатный сценарий

Статус: активно
Область: документированный штатный сценарий для хостов IDE
Последняя проверка: 2026-07-12 Владелец: среда выполнения AX Code

AX Code предоставляет сервер ACP, чтобы IDE (например, Zed) могли размещать агента без собственного транспорта.

Требования

• Поддерживаемая установка CLI (ax-code в PATH)
• Настроенный провайдер (ax-code providers login или ключи в окружении)

Запуск сервера

# Current directory as workspace
ax-code acp

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

Инициализация, сессия и запрос (stdio)

ACP — это JSON-RPC поверх stdio. Минимальный штатный сценарий:

# 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 — согласовать версию протокола и возможности агента
2. session/new — создать сессию, указав cwd как корень проекта
3. session/prompt — отправить текст пользователя; агент запускает инструменты и возвращает причину остановки
4. session/load — возобновить идентификатор сессии, известный хосту

Пример 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

Включайте только если интерфейс хоста умеет отвечать на запросы с вопросами.