Skip to main content

Как работает Veai

Veai — AI-агент внутри JetBrains IDE. Вы ставите задачу в чате, а агент собирает контекст проекта, выбирает подходящие инструменты IDE, вносит изменения и проверяет результат. Вы контролируете доступ к инструментам и просматриваете правки перед тем, как оставить их в проекте.

Агент и режимы работы​

Режим определяет, на чём агент сосредоточится и какие инструменты сможет использовать.

  • General подходит для большинства задач. Он может подключить специализированных субагентов, если нужно сначала изучить проект, затем изменить код и проверить результат.
  • Ask читает проект, но не изменяет файлы. Используйте его, чтобы разобраться в незнакомом коде или обсудить решение.
  • Code читает и редактирует файлы. Он подходит для обычных изменений в проекте.
  • Debug управляет отладчиком IDE: ставит точки останова, запускает программу и смотрит значения переменных и стек вызовов.
  • Test специализируется на создании тестов.
  • Review сфокусирован на проверке изменений и может использовать инспекции IDE. Основные инструменты редактирования файлов в нём недоступны, но набор инструментов зависит от конфигурации и не даёт строгой технической гарантии режима только для чтения.
  • Plan готовит план с подзадачами и критериями приёмки перед большой работой.
  • Orchestrator распределяет большую задачу между специализированными субагентами.

Полное описание и ограничения каждого режима приведены на странице «Режимы агента».

Откуда агент получает контекст​

К сообщению можно приложить файл, каталог, выделенный фрагмент кода, лог или отчёт. При необходимости агент исследует проект дальше сам: находит объявления и использования символов, читает структуру файлов и проверяет ошибки, которые видит IDE.

Интеграция с IDE даёт агенту факты о текущем проекте, а не только текст файлов. Например, он может:

  • найти использования класса или метода с учётом языка и структуры кода;
  • прочитать код подключённой зависимости и проверить API именно той версии, которая используется в проекте;
  • получить список настроенных конфигураций запуска;
  • использовать результаты инспекций, тестов, покрытия и отладки.

Постоянный контекст проекта можно записать в AGENTS.md, а повторяемые инструкции — в Rules и Skills.

Какие инструменты использует агент​

Агент работает с файлами и инструментами JetBrains IDE. Доступный набор зависит от режима, IDE и языка.

Для изменения кода он может создавать и редактировать файлы, а для переименования символов — применять рефакторинг IDE, который обновляет объявления и использования. Для проверки агент запускает конфигурации IDE, получает структурированные результаты тестов и сборки, собирает покрытие в поддерживаемых IDE. В режиме Debug он работает с точками останова, стеком вызовов и значениями переменных.

Точный список возможностей по IDE и режимам находится в матрице функциональности. Это справочная таблица: начните с этого обзора, а к матрице обращайтесь, когда нужно проверить поддержку конкретного инструмента.

Разрешения и контроль​

Вы можете разрешить или запретить агенту отдельные действия, например запуск команд. Для файлов действуют несколько уровней контроля:

  • Edit Scope разрешает изменения только в выбранных файлах и каталогах текущей задачи;
  • .writeignore запрещает запись и создание файлов по указанным путям, но оставляет их доступными для чтения;
  • .readignore запрещает чтение указанных путей;
  • чтобы полностью закрыть путь и для чтения, и для записи, добавьте его в оба файла;
  • доступ к файлам за пределами проекта настраивается отдельно в параметрах Veai.

Правила ignore-файлов используют gitignore-подобные шаблоны, но документация не обещает поддержку всего синтаксиса .gitignore.

Перед задачей с чувствительными файлами задайте ограничения заранее. Например, можно оставить тесты в .writeignore, если агент должен исправить реализацию, но не менять критерий проверки.

Как проверять результат​

Не считайте ответ в чате готовым результатом сам по себе. Попросите агента запустить подходящую конфигурацию тестов или сборки и сообщить, что именно было проверено. Если ошибка проявляется только во время исполнения, используйте режим Debug.

После изменений:

  1. Откройте Agent Changes и просмотрите diff по каждому файлу.
  2. Отклоните лишние правки или попросите агента их исправить.
  3. Запустите тесты, сборку или проверку покрытия через конфигурации IDE.
  4. Для независимой проверки запустите Auto Review.

Так у задачи появляется проверяемый итог: конкретный diff и результат запуска, а не только описание выполненной работы.

Куда перейти дальше​