Skip to main content

Инструменты бота: простое объяснение

Инструменты — это встроенные действия, которые Veles может выполнять сам во время работы. Обычно вам не нужно знать их внутренние названия и вызывать их вручную. Достаточно поставить задачу обычными словами, а бот сам решит, что использовать. Если вам нужен подробный технический список с внутренними именами инструментов и условиями доступности, откройте Инструменты бота: подробный справочник.

Коротко

Инструменты нужны, чтобы бот мог не только писать текст, но и что-то делать. Например:
  • искать информацию;
  • открывать ссылки;
  • читать файлы;
  • редактировать документы и код;
  • запускать команды;
  • искать по документации;
  • возвращаться к истории прошлых сессий;
  • работать с напоминаниями и фоновыми задачами.
Проще говоря, инструмент превращает бота из «просто собеседника» в полноценного рабочего помощника.

Что это значит для пользователя

Когда вы пишете что-то вроде:
  • «Найди это в интернете»;
  • «Прочитай этот файл»;
  • «Исправь ошибку в коде»;
  • «Посмотри, что у нас в папке проекта»;
  • «Напомни мне завтра»;
  • «Найди, где мы это обсуждали раньше»;
бот может использовать один или несколько инструментов, чтобы реально выполнить задачу, а не просто рассуждать о ней.

Какие задачи охватывают инструменты

1. Работа с интернетом

Бот умеет:
  • искать информацию в сети;
  • переходить по ссылкам;
  • читать содержимое страниц;
  • извлекать нужные данные из веб-ресурсов.
Это полезно, когда нужна свежая информация или изучение материала по ссылке.

2. Работа с файлами и папками

Бот умеет:
  • читать файлы;
  • создавать новые файлы;
  • точечно редактировать существующие;
  • просматривать содержимое папок.
Это основа почти всей практической работы с проектом, текстами и кодом.

3. Работа с кодом и системой

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

4. Поиск по знаниям проекта и памяти

Бот может искать:
  • по документации проекта;
  • по сохранённой памяти;
  • по истории завершённых сессий.
Это особенно полезно, когда проект большой и вы не хотите вручную вспоминать, где что лежит и о чём шла речь ранее.

5. Работа в фоне и автоматизация

Бот умеет:
  • создавать фоновых помощников для длительных задач;
  • ставить напоминания и планировать задачи;
  • подключать внешние инструменты, если они настроены.
Это полезно, когда задача требует времени и не должна блокировать основную беседу.

Нужно ли знать названия инструментов

Обычно нет. В большинстве случаев достаточно написать обычный запрос:
  • «Прочитай этот файл»
  • «Найди это в интернете»
  • «Исправь ошибку»
  • «Поищи в документации проекта»
  • «Покажи историю той сессии»
Бот сам выбирает нужные шаги. Точные названия инструментов важны в основном для тех, кто:
  • настраивает бота;
  • пишет документацию;
  • отлаживает поведение;
  • хочет глубже понимать внутреннюю механику.

Важно понимать про доступность

Не все инструменты обязаны быть доступны всегда. Некоторые зависят от конкретных настроек:
  • выполнение команд может быть отключено;
  • умный поиск по памяти и документации может быть деактивирован;
  • планировщик появляется только при соответствующей настройке;
  • внешние MCP-инструменты доступны только если они подключены.
То есть набор возможностей у конкретного экземпляра Veles может немного отличаться.

Безопасность и здравый смысл

Инструменты делают бота сильнее, но это не означает, что нужно поручать ему любую задачу без присмотра. Рекомендуемый подход:
  • чётко формулировать задачи для важных действий;
  • внимательно проверять предлагаемые ботом опасные изменения;
  • просить промежуточные результаты при выполнении больших задач;
  • помнить, что сторонние сайты и сервисы не всегда надёжны.

Когда стоит открыть подробный справочник

Подробная страница полезна, если вы хотите понять:
  • какие именно инструменты реально существуют в Veles;
  • какие из них базовые, а какие подключаемые;
  • как называются внутренние инструменты (internal tools);
  • чем отличаются, например, поиск по памяти, поиск по документации и история сессий;
  • какие возможности доступны только при определённых настройках.
Для этого откройте Инструменты бота: подробный справочник.