Меню Tools

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

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

Категории инструментов

Инструменты сгруппированы по назначению:

Категория	Для чего используется
Exploring Tools	Читать файлы и каталоги, искать код, объявления и использования, изучать структуру проекта и зависимости
Editing Tools	Создавать и редактировать файлы, переименовывать и перемещать элементы проекта
Terminal Tools	Выполнять команды и управлять процессами в терминале
Analysis Tools	Запускать проверки кода и другие доступные в IDE операции анализа
Web Tools	Искать информацию в интернете и читать страницы
Configuration tools	Находить и запускать конфигурации IDE

Analysis Tools разрешайте, когда агент должен проверить код средствами IDE, например перед завершением реализации или во время ревью. Для минимального доступа оставьте только нужные операции анализа и включите подтверждение для действий, которые могут запустить код. Подробнее о доступных проверках см. в каталоге инструментов.

Web Tools разрешайте, когда для задачи нужны актуальные внешние сведения или чтение известного первоисточника. Оставьте только поиск или загрузку страницы — в зависимости от того, известен ли URL. Различия между этими сценариями описаны на странице «Поиск в интернете».

Configuration tools разрешайте, когда агент должен выбрать существующую конфигурацию IDE и запустить сборку, тест или приложение с настроенными SDK, classpath и переменными окружения. Минимальный набор — получение списка конфигураций и запуск выбранной конфигурации; для запуска оставьте подтверждение, если он может изменить файлы или внешние системы. Подробнее см. «Запуск конфигураций».

Ниже встроенных категорий меню показывает подключённые MCP-серверы, например chrome или searxng. Их инструменты настраиваются отдельно от встроенных. Используйте Add more tools, когда встроенных возможностей недостаточно и агенту нужен доступ к внешней системе, например трекеру задач или браузеру. Откройте Add more tools, подключите нужный MCP-сервер и разрешите только его инструменты, необходимые для текущей задачи. Настройка серверов описана на странице MCP.

Состав категорий зависит от версии Veai, выбранного режима агента, IDE и подключённых MCP-серверов. Если нужного инструмента нет в меню, проверьте матрицу функциональности, режим агента и настройки MCP.

Режим доступа к инструменту

Для инструмента можно выбрать один из трёх вариантов:

Настройка	Что произойдёт
Разрешён без подтверждения	Агент может вызвать инструмент и продолжить работу без остановки
Спрашивать подтверждение	Перед вызовом агент остановится и попросит разрешение пользователя
Запрещён	Агент не сможет вызвать инструмент в этом чате

Если для инструмента включено подтверждение, Veai останавливается именно перед его вызовом. После ответа пользователя агент либо выполняет действие, либо продолжает без него, если задача допускает другой путь.

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

Как настроить Tools перед задачей

1. Откройте меню Tools.
2. Раскройте нужную категорию.
3. Запретите инструменты, которые не нужны для задачи.
4. Для действий, которые хотите контролировать, включите запрос подтверждения.
5. Оставьте вызов без подтверждения только для тех действий, последствия которых вам понятны.

Примеры:

• для объяснения кода можно оставить Exploring Tools и запретить Editing Tools и Terminal Tools;
• для небольшой правки разрешить чтение и редактирование, но оставить подтверждение для терминала и запусков;
• перед работой с продуктивной системой запретить терминал, браузерные инструменты и конфигурации, которые могут обращаться к ней.

Чем Tools отличается от других ограничений

Меню Tools отвечает за тип действия, а остальные механизмы — за файлы и инструкции:

• Edit Scope ограничивает, какие файлы и каталоги можно изменять в текущей задаче;
• .readignore и .writeignore постоянно запрещают чтение или запись по указанным путям;
• режим агента задаёт роль и базовый набор доступных инструментов;
• Rules, Skills и AGENTS.md дают агенту инструкции, но сами по себе не включают и не отключают инструменты.

Для чувствительной задачи используйте ограничения вместе: выберите подходящий режим агента, настройте Tools, задайте Edit Scope и закройте секреты через .readignore.

Если агент остановился и спрашивает разрешение

Проверьте:

1. какой инструмент собирается вызвать агент;
2. какие параметры или команда указаны в карточке вызова;
3. какие файлы, процессы или внешние системы может изменить действие;
4. нужен ли этот вызов для вашей задачи.

Разрешайте действие только после проверки. Если одинаковый безопасный вызов повторяется и вы не хотите подтверждать его каждый раз, измените настройку этого инструмента в меню Tools. Для опасных и необратимых действий не отключайте подтверждение ради удобства.

Подробнее о чтении, записи, запусках и проверке изменений см. на странице «Разрешения и безопасность».