Каталог инструментов Veai
Инструменты дают агенту доступ к проекту, JetBrains IDE, терминалу и внешним сервисам. Конкретный набор зависит от выбранного режима агента, IDE, языка и подключённых MCP-серверов.
Эта страница помогает понять назначение инструментов. Настройка доступа и подтверждений описана отдельно — в меню Tools.
Исследование проекта
| Инструмент или группа | Что делает | Меняет состояние |
|---|---|---|
| Чтение файлов | Открывает содержимое файла или выбранный диапазон строк | Нет |
| Просмотр каталогов | Показывает структуру файлов и папок | Нет |
| Структура файла | Показывает классы, методы и другие элементы без чтения всего файла | Нет |
| Поиск текста и файлов | Ищет имена файлов и текстовые совпадения | Нет |
| Поиск объявлений и использований | Использует индексы IDE, чтобы находить символы, реализации и ссылки на них | Нет |
| Чтение зависимостей | Открывает исходный или декомпилированный код подключённой версии библиотеки | Нет |
Подробнее: поиск по индексам IDE и чтение кода зависимостей.
Изменение проекта
| Инструмент или группа | Что делает | На что обратить внимание |
|---|---|---|
| Создание и редактирование файлов | Добавляет или заменяет содержимое файлов | Ограничьте область через Edit Scope |
| Переименование символа | Запускает рефакторинг IDE и обновляет связанные использования | Проверьте публичный API и внешний код |
Для структурных изменений предпочтительны рефакторинги IDE, а не текстовая замена. После работы просмотрите результат в Agent Changes.
Запуски и анализ в IDE
| Инструмент или группа | Что делает | Доступность |
|---|---|---|
| Конфигурации запуска | Получает список настроенных запусков, запускает приложение, тесты или сборку | Зависит от IDE и языка |
| Тестовые результаты | Возвращает структурированный результат тестов и ошибки | Для поддерживаемых конфигураций |
| Покрытие | Измеряет покрытие выбранных файлов и веток | Поддержка различается по IDE |
| Инспекции IDE | Ищет ошибки, предупреждения и антипаттерны | Используются режимом Review |
| Отладчик | Ставит точки останова, запускает отладку, читает значения и стек вызовов | Используется режимом Debug |
| Ошибки файла | Получает известные IDE ошибки в исходном файле | Зависит от поддержки языка |
Подробности: конфигурации запуска, режимы агента и матрица функциональности.
Терминал
Терминальные инструменты выполняют команды и управляют процессами. Они нужны, если подходящей конфигурации IDE нет или задача относится к внешней утилите.
Команда может менять файлы, базу данных, окружение или удалённую систему. Перед запуском проверяйте:
- саму команду и рабочий каталог;
- используемое окружение;
- возможность записи или удаления данных;
- подключение к внешним системам;
- способ остановки фонового процесса.
Точные правила автоматического разрешения терминальных команд зависят от настройки инструмента. Проверяйте фактическое состояние в меню Tools.
Интернет и браузер
| Инструмент или группа | Что делает | Особенности |
|---|---|---|
| Web Search | Ищет источники в интернете | Результат поиска нужно проверять по первоисточнику |
| Web Fetch | Читает доступную страницу | Не заменяет интерактивный браузер |
| Браузерные MCP-инструменты | Открывают страницы, заполняют формы, нажимают элементы, читают сеть и консоль | Могут изменять данные во внешнем сервисе |
Подробнее: Web Search и MCP.
MCP-инструменты
После подключения MCP-сервера его инструменты появляются в меню Tools отдельной группой. Названия, параметры и последствия вызова определяет сам сервер, поэтому общего полного каталога для них нет.
Перед использованием MCP:
- проверьте источник сервера;
- выдайте минимальные права;
- посмотрите список инструментов;
- оставьте подтверждение для действий, которые меняют внешние данные;
- выполните первый запрос в безопасном тестовом окружении.
Какие инструменты доступны режимам
Кратко:
- Ask и Review не редактируют файлы;
- Debug управляет отладчиком;
- Review может вызывать инспекции IDE;
- General может передавать подзадачи субагентам;
- Orchestrator координирует субагентов, но не выполняет обычные инструменты напрямую.
Точная таблица доступности находится в разделе «Режимы работы». Доступность функции в конкретной IDE проверяйте в остальных таблицах матрицы.
Доступ и подтверждения
Наличие инструмента у режима ещё не означает, что любой вызов выполнится автоматически. Для отдельного инструмента могут быть выбраны разрешение без подтверждения, запрос подтверждения или запрет.
Документация не фиксирует единые значения по умолчанию для всех версий и конфигураций Veai. Перед чувствительной задачей откройте меню Tools и проверьте фактические настройки.
Дополнительные ограничения:
- Edit Scope — область изменения файлов в текущей задаче;
.readignoreи.writeignore— постоянный запрет чтения или записи путей;- разрешения и безопасность — общая модель контроля действий.