Справочник по наборам инструментов
Наборы инструментов — это именованные пакеты инструментов, которые определяют, что может делать агент. Это основной механизм настройки доступности инструментов для конкретной платформы, сеанса или задачи.
Как работают наборы инструментов
Каждый инструмент принадлежит ровно одному набору. Когда вы включаете набор, все инструменты в этом пакете становятся доступны агенту. Наборы инструментов бывают трёх видов:
- Основные (Core) — Одна логическая группа связанных инструментов (например,
fileобъединяетread_file,write_file,patch,search_files). - Составные (Composite) — Объединяют несколько основных наборов для типового сценария (например,
debuggingвключает файловые, терминальные и веб-инструменты). - Платформенные (Platform) — Полная конфигурация инструментов для конкретного контекста развёртывания (например,
vibeos-cliиспользуется по умолчанию для интерактивных сеансов CLI).
Настройка наборов инструментов
Для сеанса (CLI)
vibeos chat --toolsets web,file,terminal
vibeos chat --toolsets debugging # составной — расширяется до file + terminal + web
vibeos chat --toolsets all # всё
Для платформы (config.yaml)
toolsets:
- vibeos-cli # по умолчанию для CLI
# - vibeos-telegram # переопределение для шлюза Telegram
Интерактивное управление
vibeos tools # curses-интерфейс для включения/отключения на платформу
Или внутри сеанса:
/tools list
/tools disable browser
/tools enable homeassistant
Основные наборы инструментов
| Набор | Инструменты | Назначение |
|---|---|---|
browser | browser_back, browser_cdp, browser_click, browser_console, browser_dialog, browser_get_images, browser_navigate, browser_press, browser_scroll, browser_snapshot, browser_type, browser_vision, web_search | Основная автоматизация браузера. Включает web_search как запасной вариант для быстрых запросов. browser_cdp и browser_dialog ограничены во время выполнения — регистрируются только при достижимости конечной точки CDP на старте сеанса (через /browser connect, параметр конфигурации browser.cdp_url, Browserbase или Camofox). browser_dialog работает вместе с полями pending_dialogs и frame_tree, которые browser_snapshot добавляет при подключённом супервизоре CDP. |
clarify | clarify | Задать вопрос пользователю, когда агенту требуется уточнение. |
code_execution | execute_code | Запуск скриптов Python, которые программно вызывают инструменты VibeOS. |
cronjob | cronjob | Планирование и управление повторяющимися задачами. |
debugging | составной (file + terminal + web) | Пакет для отладки — файлы, процессы/терминал, извлечение/поиск в вебе. |
delegation | delegate_task | Создание изолированных экземпляров под-агентов для параллельной работы. |
discord | discord | Основные действия Discord: текст, встраивания, личные сообщения (только для шлюза). Активен в наборе vibeos-discord. |
discord_admin | discord_admin | Модерация Discord (баны, смена ролей, управление каналами). Активен в наборе vibeos-discord; требует, чтобы бот обладал соответствующими разрешениями Discord. |
feishu_doc | feishu_doc_read | Чтение содержимого документов Feishu/Lark. Используется обработчиком интеллектуальных ответов на комментарии в документах Feishu. |
feishu_drive | feishu_drive_add_comment, feishu_drive_list_comments, feishu_drive_list_comment_replies, feishu_drive_reply_comment | Операции с комментариями на диске Feishu/Lark. Ограничены агентом комментариев; не доступны в vibeos-cli или других наборах для обмена сообщениями. |
file | patch, read_file, search_files, write_file | Чтение, запись, поиск и редактирование файлов. |
homeassistant | ha_call_service, ha_get_state, ha_list_entities, ha_list_services | Управление умным домом через Home Assistant. Доступен только при установленном HASS_TOKEN. |
computer_use | computer_use | Фоновое управление рабочим столом через cua-driver — не перехватывает курсор/фокус. Работает с любой моделью, поддерживающей инструменты. macOS, Windows и Linux; требуется cua-driver в $PATH. |
context_engine | (различается) | Инструменты времени выполнения, предоставляемые активным плагином контекстного движка (пуст, пока плагин его не заполнит). |
image_gen | image_generate | Генерация изображений по тексту через FAL.ai (с опциональными бэкендами OpenAI / xAI). |
video_gen | video_generate | Генерация видео по тексту и изображению через зарегистрированные плагинами бэкенды (xAI Grok-Imagine, FAL.ai Veo 3.1 / Pixverse v6 / Kling O3). Передайте image_url для анимации изображения; опустите для генерации видео из текста. |
kanban | kanban_block, kanban_comment, kanban_complete, kanban_create, kanban_heartbeat, kanban_link, kanban_list, kanban_show, kanban_unblock | Инструменты координации нескольких агентов. Регистрируются для рабочих задач, порождённых диспетчером (VIBEOS_KANBAN_TASK), и для профилей, явно указывающих набор kanban по имени (шаблон all/* не включает его). Рабочие отмечают задачи выполненными, блокируют, отправляют пульс, комментируют и создают/связывают последующие задачи; профили-оркестраторы дополнительно получают инструменты маршрутизации досок, такие как list/unblock. |
memory | memory | Постоянное управление памятью между сеансами. |
messaging | send_message | Отправка сообщений на другие платформы (Telegram, Discord и т.д.) из текущего сеанса. |
safe | image_generate, vision_analyze, web_extract, web_search (через includes) | Исследование только для чтения + генерация медиа. Нет записи файлов, терминала или выполнения кода. |
search | web_search | Только веб-поиск (без извлечения). |
session_search | session_search | Поиск по прошлым сеансам разговоров. |
skills | skill_manage, skill_view, skills_list | CRUD для навыков и их просмотр. |
spotify | spotify_albums, spotify_devices, spotify_library, spotify_playback, spotify_playlists, spotify_queue, spotify_search | Нативное управление Spotify (воспроизведение, очередь, поиск, плейлисты, альбомы, библиотека). Регистрируется встроенным плагином spotify. |
terminal | process, terminal | Выполнение команд оболочки и управление фоновыми процессами. |
todo | todo | Управление списком задач в рамках сеанса. |
tts | text_to_speech | Генерация аудио из текста. |
vision | vision_analyze | Анализ изображений с помощью моделей, поддерживающих зрение. |
video | video_analyze | Инструменты анализа и понимания видео (опционально, не входит в набор по умолчанию — добавляйте явно через --toolsets). |
web | web_extract, web_search | Веб-поиск и извлечение содержимого страниц. |
x_search | x_search | Поиск постов и тредов X (Twitter) через встроенный инструмент x_search от xAI. По умолчанию выключен; включите через vibeos tools. Схема регистрируется только при наличии учётных данных xAI (OAuth SuperGrok или XAI_API_KEY). |
yuanbao | yb_query_group_info, yb_query_group_members, yb_search_sticker, yb_send_dm, yb_send_sticker | Действия Yuanbao: личные сообщения, группы и поиск стикеров. Регистрируется только в vibeos-yuanbao. |
Платформенные наборы инструментов
Платформенные наборы инструментов определяют полную конфигурацию инструментов для цели развёртывания. Большинство платформ обмена сообщениями используют тот же набор, что и vibeos-cli:
| Набор | Отличия от vibeos-cli |
|---|---|
vibeos-cli | Полный набор — по умолчанию для интерактивных сеансов CLI. Включает файловые, терминальные, веб-инструменты, браузер, память, навыки, зрение, генерацию изображений, todo, tts, делегирование, выполнение кода, cronjob, поиск по сеансам, уточнение и пакет safe (только чтение), а также стандартные инструменты обмена сообщениями. |
vibeos-acp | Исключает clarify, cronjob, image_generate, send_message, text_to_speech и все четыре инструмента Home Assistant. Ориентирован на задачи кодирования в контексте IDE. |
vibeos-api-server | Исключает clarify, send_message и text_to_speech. Оставляет всё остальное — подходит для программного доступа, где взаимодействие с пользователем невозможно. |
vibeos-cron | То же, что и vibeos-cli. |
vibeos-telegram | То же, что и vibeos-cli. |
vibeos-discord | Добавляет discord и discord_admin поверх vibeos-cli. |
vibeos-slack | То же, что и vibeos-cli. |
vibeos-whatsapp | То же, что и vibeos-cli. |
vibeos-signal | То же, что и vibeos-cli. |
vibeos-matrix | То же, что и vibeos-cli. |
vibeos-mattermost | То же, что и vibeos-cli. |
vibeos-email | То же, что и vibeos-cli. |
vibeos-sms | То же, что и vibeos-cli. |
vibeos-bluebubbles | То же, что и vibeos-cli. |
vibeos-dingtalk | То же, что и vibeos-cli. |
vibeos-feishu | Добавляет пять инструментов feishu_doc_* / feishu_drive_* (используются только обработчиком комментариев к документам, а не обычным адаптером чата). |
vibeos-qqbot | То же, что и vibeos-cli. |
vibeos-wecom | То же, что и vibeos-cli. |
vibeos-wecom-callback | То же, что и vibeos-cli. |
vibeos-weixin | То же, что и vibeos-cli. |
vibeos-yuanbao | Добавляет пять инструментов yb_* (личные сообщения, группы, стикеры) поверх vibeos-cli. |
vibeos-homeassistant | То же, что и vibeos-cli (инструменты Home Assistant уже присутствуют по умолчанию и активируются при установке HASS_TOKEN). |
vibeos-webhook | То же, что и vibeos-cli. |
vibeos-gateway | Внутренний набор инструментов оркестратора шлюза — объединение всех наборов vibeos-<platform>`; используется, когда шлюзу необходимо принимать сообщения из любого источника. |
Динамические наборы инструментов
Наборы инструментов MCP-сервера
Каждый настроенный MCP-сервер генерирует набор mcp-<server> во время выполнения. Например, если вы настроили MCP-сервер github, создаётся набор mcp-github`, содержащий все инструменты, которые предоставляет этот сервер.
# config.yaml
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
Это создаёт набор mcp-github, на который можно ссылаться в --toolsets или конфигурациях платформ.
Наборы инструментов плагинов
Плагины могут регистрировать собственные наборы инструментов через ctx.register_tool() во время инициализации плагина. Они отображаются рядом со встроенными наборами и могут быть включены/отключены таким же образом.
Пользовательские наборы инструментов
Определите пользовательские наборы в config.yaml, чтобы создавать пакеты для конкретных проектов:
toolsets:
- vibeos-cli
custom_toolsets:
data-science:
- file
- terminal
- code_execution
- web
- vision
Шаблоны
allили*— расширяется до каждого зарегистрированного набора (встроенного, динамического и плагинного).
Некоторые инструменты имеют дополнительную проверку доступности помимо членства в наборе и не включаются одним только all/*:
- Инструменты, ограниченные возможностями (браузер,
computer_use,code_execution, Feishu, Home Assistant, cronjob) появляются только при наличии настроенного бэкенда или учётных данных. - Инструменты, ограниченные рабочим процессом — набор
kanban— намеренно требуют явного включения.all/*не включает kanban; вы должны явно указатьkanban(или быть рабочим, порождённым диспетчером, с установленнымVIBEOS_KANBAN_TASK). Инструменты kanban изменяют общее состояние доски, поэтому они остаются выключенными по умолчанию даже приall.
Связь с vibeos tools
Команда vibeos tools предоставляет curses-интерфейс для включения или отключения отдельных инструментов на платформу. Она работает на уровне инструментов (более детально, чем наборы) и сохраняет изменения в config.yaml. Отключённые инструменты отфильтровываются, даже если их набор включён.
См. также: Справочник по инструментам для полного списка отдельных инструментов и их параметров.