Skip to main content

Агенты

Плагин Veai работает с агентами по протоколу ACP (Agent Client Protocol) — общему языку, на котором редактор разговаривает с любым совместимым AI-агентом. Благодаря этому агента можно заменить, не меняя интерфейс. Агент (в файле настроек backends.json он называется backend) — отдельная программа, которую плагин запускает и с которой общается: он читает код, выполняет команды и правит файлы, а плагин показывает результат в чате.

Какие агенты доступны​

АгентКак запускаетсяПодписка и вход
Veai (рекомендуется)veai acp из установки агента VeaiАккаунт Veai: тарифы Free, Personal, Professional, Ultra или свой ключ
Claude Codenpx -y @agentclientprotocol/claude-agent-acpСвоя авторизация и подписка Claude
Codexnpx -y @agentclientprotocol/codex-acpСвоя авторизация и подписка OpenAI
Любой ACP-агентКоманда, которую вы укажете в backends.jsonКак настроено у самого агента

Агент Veai — тот же агент, что и Veai CLI. Установка у них общая: если вы уже пользуетесь CLI, плагин использует её же. Для Claude Code и Codex нужны установленные сами агенты (команды claude и codex) и Node.js, потому что адаптеры запускаются через npx. Для агента Veai Node.js ставить не нужно: плагин подготовит свою копию.

Аккаунт Veai нужен и с Claude Code или Codex: плагин требует входа для своей работы, подойдёт бесплатный тариф Free. Авторизация и подписка самих агентов при этом остаются их собственными.

Выбор агента​

Агент выбирается в нижней строке под полем ввода, рядом с выбором модели и режима. Рядом с каждым агентом показан статус:

СтатусЧто означает
In useАгент выбран в этом чате
ConnectedПлагин уже запустил агента и подключился к нему
ReadyАгент установлен и готов к запуску
ConnectingИдёт подключение
Not installedАгент не установлен; у Claude Code и Codex — не найдена команда claude или codex
DisconnectedСоединение разорвано
Connection failedЗапустить или подключить агента не удалось

Агента можно сменить, пока в чате нет сообщений. История начатого чата хранится у его агента, и другой агент не может её продолжить; чтобы поработать с другим, откройте новый чат.

Впервые агента выбирают при первоначальной настройке.

Панель Agents​

Панель Agents открывается кнопкой Agents в заголовке окна чата или из выбора агента. В ней можно:

  • найти агента в поле Search agents;
  • установить агента Veai кнопкой Install или обновить его кнопкой Update (метка Update available), отменить установку кнопкой Cancel, повторить кнопкой Retry;
  • для Claude Code и Codex — открыть инструкцию по установке кнопкой Install guide, если агент не найден, или добавить найденного агента в backends.json кнопкой Configure. Войти в сами агенты можно командами claude auth login и codex login;
  • открыть запись агента в конфигурации кнопкой Open in backends.json;
  • добавить своего агента кнопкой Add agent manually;
  • перечитать список кнопкой Refresh agents.

Агент Veai ставится только по кнопке Install: плагин скачивает установщик, готовит собственную копию Node.js и активирует установку. Для этого нужен доступ в интернет. Обычно это занимает около минуты. Когда выходит новая версия, IDE показывает уведомление Agent update available с кнопкой Install. Кроме того, агент Veai обновляется сам, как описано в установке Veai CLI.

Файл backends.json​

Список агентов хранится в ~/.neo/backends.json в домашней папке. Файл общий для всех проектов. Если его нет, плагин создаст его с агентами Veai, Claude Code и Codex.

{
  "backends": {
    "opencode-acp": {
      "displayName": "OpenCode",
      "command": "opencode",
      "args": ["acp"],
      "env": {}
    }
  }
}
  • Ключ (opencode-acp) — идентификатор агента.
  • command — команда запуска, обязательна.
  • displayName, args и env — необязательны. В env задаются переменные окружения, например путь к исполняемому файлу.
  • Порядок записей — порядок в списке агентов. Первая запись выбирается по умолчанию.

Плагин не следит за файлом на лету: после правки нажмите Refresh agents или заново откройте выбор агента. Если в файле ошибка, панель покажет её и предложит Edit config или Restore initial defaults — во втором случае плагин сохранит резервную копию старого файла.

Как подключить своего агента​

  1. Найдите ACP-адаптер для вашего агента. Например, у OpenCode это команда opencode acp.
  2. Установите агента и проверьте, что команда запускается в терминале.
  3. В панели Agents нажмите Add agent manually — откроется backends.json.
  4. Добавьте запись с этой командой, сохраните файл и нажмите Refresh agents.

Модели, вход и настройки такого агента задаются у самого агента. Возможности чата зависят от того, что агент сообщает плагину: например, режимы и уровни рассуждений появятся, только если агент их поддерживает.

Связанные страницы​