Skip to main content

​
Навыки Велеса: простое объяснение

Помимо обычных инструментов (например, “прочитать файл” или “найти в поиске”), Велес умеет использовать навыки.

​
В чем отличие навыков от инструментов?

  • Инструмент — это атомарное простое действие. (Например, инструмент view_file читает один файл).
  • Навык — это умная инструкция или специализированный помощник внутри Велеса, который состоит из множества шагов.
Например, навык «Глубокое исследование» (Deep Research). Это не просто один инструмент, а целый алгоритм:
  1. Построить план поиска.
  2. Прочитать 10 сайтов.
  3. Проанализировать информацию.
  4. Выдать готовый отчет на основе множества шагов.

​
Как использовать Навыки

Точно так же, как и инструменты — просто попросите Велеса об этом словами. Вам не нужно писать код для запуска глубокого исследования.
  • «Проведи глубокое исследование по теме внедрения GraphQL».
  • «Запусти навык веб-разработки для создания нового компонента».
  • «Поставь фоновую задачу на сбор аналитики».
Велес сам поймет, какой навык лучше всего подходит для вашей задачи, прочитает его внутренние инструкции и выполнит необходимые действия шаг за шагом.

​
Установка и настройка из маркетплейса

Перед установкой Велес проверяет, объявил ли навык секреты или обычные настройки. Если каких-либо значений ещё нет, интерфейс открывает диалог настройки. Обязательные поля нужно заполнить, а необязательные можно пропустить. Значения по умолчанию показываются в форме и сохраняются только после подтверждения установки. Секреты сохраняются отдельно в зашифрованном хранилище. Обычные значения попадают в skills.entries.<имя-навыка>.config файла config.json. Если навык объявляет секреты или настройки, после установки рядом с ним доступна кнопка их изменения стандартного размера. При отсутствии хотя бы одного обязательного значения кнопка становится янтарной и показывает подсказку «Нужна настройка — редактировать». В форме под полями показываются ограничения значений; некорректный параметр или пустой обязательный секрет выделяется и получает текстовое объяснение, поэтому причина блокировки сохранения видна сразу. Обязательное значение можно заменить, но нельзя удалить; необязательные значения можно изменять и удалять. Если для навыка нужна внешняя командная программа, но Велес не находит её в системном пути запуска, внизу карточки каталога появляется строка вида «Не хватает: CLI: tmux». Предупреждение не мешает установить навык заранее. Велес запоминает результат проверки каждой программы на 30 секунд, повторно использует его для других навыков и перепроверяет программы принудительно при синхронизации маркетплейса.

​
Где посмотреть список Навыков?

Велес постоянно расширяет свои возможности благодаря плагинам и встроенным навыкам. Вы можете ознакомиться с полным каталогом и техническими особенностями в Справочнике Навыков.