🏠 Главная › Reference › toolsets reference

sidebar_position: 4 title: "Toolsets Reference" description: "Reference for Hermes core, composite, platform, and dynamic toolsets" lang: ru

Справочник по наборам инструментов

Наборы инструментов — это именованные пакеты инструментов, которые контролируют действия агента. Они являются основным механизмом настройки доступности инструментов для каждой платформы, для каждого сеанса или для каждой задачи.

Как работают наборы инструментов

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

Настройка наборов инструментов

За сеанс (CLI)

hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging        # composite — expands to file + terminal + web
hermes chat --toolsets all              # everything

Для каждой платформы (config.yaml)

toolsets:
  - hermes-cli          # default for CLI
  # - hermes-telegram   # override for Telegram gateway

Интерактивное управление

hermes tools                            # curses UI to enable/disable per platform

Или во время сессии:

/tools list
/tools disable browser
/tools enable rl

Основные наборы инструментов

Набор инструментов Инструменты Цель
browser browser_back, browser_click, browser_console, browser_get_images, browser_navigate, browser_press, browser_scroll, browser_snapshot, browser_type, browser_vision, web_search Автоматизация ядра браузера. Включает web_search в качестве запасного варианта для быстрого поиска. browser_cdp и browser_dialog находятся в отдельном наборе инструментов browser-cdp и регистрируются только тогда, когда конечная точка CDP доступна в начале сеанса — через конфигурацию /browser connect, browser.cdp_url, Browserbase или Camofox. browser_dialog работает вместе с полями pending_dialogs и frame_tree, которые browser_snapshot добавляет при подключении супервизора CDP.
clarify clarify Задайте пользователю вопрос, когда агенту потребуется разъяснение.
code_execution execute_code Запускайте сценарии Python, которые программно вызывают инструменты Hermes.
cronjob cronjob Планируйте и управляйте повторяющимися задачами.
debugging композитный (file + terminal + web) Пакет отладки — файл, процесс/терминал, веб-извлечение/поиск.
delegation delegate_task Создание изолированных экземпляров субагента для параллельной работы.
discord discord Базовый текст Discord/встраивание/действия DM (только для шлюза). Активен в наборе инструментов hermes-discord.
discord_admin discord_admin Модерация Discord (баны, смена ролей, управление каналом). Активен в наборе инструментов hermes-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 управляет операциями по комментированию. Охватывается агентом комментариев; не отображается в hermes-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.
image_gen image_generate Генерация текста в изображение через FAL.ai (с поддержкой OpenAI/xAI).
memory memory Постоянное управление межсессионной памятью.
messaging send_message Отправляйте сообщения на другие платформы (Telegram, Discord и т. д.) внутри сеанса.
moa mixture_of_agents Мультимодельный консенсус через смесь агентов.
rl rl_check_status, rl_edit_config, rl_get_current_config, rl_get_results, rl_list_environments, rl_list_runs, rl_select_environment, rl_start_training, rl_stop_training, rl_test_inference Управление средой обучения RL (Atropos).
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 Анализ изображений с помощью моделей с возможностью машинного зрения.
web web_extract, web_search Поиск в Интернете и извлечение содержимого страниц.
yuanbao yb_query_group_info, yb_query_group_members, yb_search_sticker, yb_send_dm, yb_send_sticker Yuanbao DM/групповые действия и поиск стикеров. Зарегистрировался только на hermes-yuanbao.

Наборы инструментов платформы

Наборы инструментов платформы определяют полную конфигурацию инструмента для цели развертывания. Большинство платформ обмена сообщениями используют тот же набор, что и hermes-cli:

Набор инструментов Отличия от hermes-cli
hermes-cli Полный набор инструментов — 38 инструментов. Значение по умолчанию для интерактивных сеансов CLI.
hermes-acp Удаляет clarify, cronjob, image_generate, send_message, text_to_speech и все четыре инструмента Home Assistant. Сосредоточен на задачах кодирования в контексте IDE.
hermes-api-server Выпадает clarify, send_message и text_to_speech. Сохраняет все остальное — подходит для программного доступа, когда взаимодействие с пользователем невозможно.
hermes-cron То же, что hermes-cli.
hermes-telegram То же, что hermes-cli.
hermes-discord Добавляет discord и discord_admin поверх hermes-cli.
hermes-slack То же, что hermes-cli.
hermes-whatsapp То же, что hermes-cli.
hermes-signal То же, что hermes-cli.
hermes-matrix То же, что hermes-cli.
hermes-mattermost То же, что hermes-cli.
hermes-email То же, что hermes-cli.
hermes-sms То же, что hermes-cli.
hermes-bluebubbles То же, что hermes-cli.
hermes-dingtalk То же, что hermes-cli.
hermes-feishu Добавляет пять инструментов feishu_doc_* / feishu_drive_* (используются только обработчиком комментариев к документу, а не обычным адаптером чата).
hermes-qqbot То же, что hermes-cli.
hermes-wecom То же, что hermes-cli.
hermes-wecom-callback То же, что hermes-cli.
hermes-weixin То же, что hermes-cli.
hermes-yuanbao Добавляет пять инструментов yb_* (DM/группа/стикер) поверх hermes-cli.
hermes-homeassistant То же, что hermes-cli (инструменты Home Assistant уже присутствуют по умолчанию и активируются, когда установлен HASS_TOKEN).
hermes-webhook То же, что hermes-cli.
hermes-gateway Набор инструментов оркестратора внутреннего шлюза — объединение всех наборов инструментов hermes-<platform>; используется, когда шлюзу необходимо принять любой источник сообщений.

Динамические наборы инструментов

Наборы инструментов сервера MCP

Каждый настроенный сервер MCP генерирует набор инструментов mcp-<server> во время выполнения. Например, если вы настраиваете сервер github MCP, создается набор инструментов mcp-github, содержащий все инструменты, предоставляемые сервером.

# config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]

При этом создается набор инструментов mcp-github, на который можно ссылаться в --toolsets или в конфигурациях платформы.

Наборы инструментов плагина

Плагины могут регистрировать свои собственные наборы инструментов через ctx.register_tool() во время инициализации плагина. Они появляются рядом со встроенными наборами инструментов и могут быть включены/отключены таким же образом.

Пользовательские наборы инструментов

Определите пользовательские наборы инструментов в config.yaml для создания пакетов для конкретного проекта:

toolsets:
  - hermes-cli
custom_toolsets:
  data-science:
    - file
    - terminal
    - code_execution
    - web
    - vision

Подстановочные знаки

Связь с hermes tools

Команда hermes tools предоставляет пользовательский интерфейс на основе проклятий для включения или выключения отдельных инструментов для каждой платформы. Это работает на уровне инструмента (более тонком, чем наборы инструментов) и сохраняется до config.yaml. Отключенные инструменты отфильтровываются, даже если их набор инструментов включен.

См. также: Справочник по инструментам для получения полного списка отдельных инструментов и их параметров.