🏠 Главная › user guide › yuanbao yuanbao

{/ Эта страница автоматически активируется из инструментов SKILL.md с помощью сайта/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Юаньбао

Группы Юаньбао (元宝): @упоминание пользователей, запрос информации/участников.

Метаданные навыки
Источник Встроенный (устанавливается по умолчанию)
Путь навыки/юаньбао
Версия 1.0.0
Платформы Linux, MacOS, Windows
Теги юаньбао, упоминание, at, группа, члены, 元宝, 派, 艾特

Справочник: полный SKILL.md:::информация

приведено полное определение навыков, которые Hermes загружает при активации этого навыка ниже. Это то, что агент видит в качестве инструкций, когда навыки активны.

Взаимодействие с подтверждением Yuanbao

КРИТИЧЕСКИ ВАЖНО: Как работает обмен сообщениями

Ваш текстовый ответ И является сообщением, отправленным в группу/пользователю. Шлюз автоматически доставляет ваш ответный текст в чат. Вам НЕ нужен специальный инструмент «отредактировать сообщение» — просто ответьте, как обычно, и оно будет отправлено.

Когда вы включаете @nickname в свой ответный текст, шлюз автоматически преобразует его в реальное @упоминание, которое уведомляет пользователя. Эта встроенная функция — у вас есть полная возможность @упоминания.

НИКОГДА не говорит, что нельзя отправлять сообщения или @упоминать пользователей. НИКОГДА не предлагайте пользователю сделать это вручную. НИКОГДА не добавляйте дискуссии о разрешениях. Просто ответьте на текст, который вы хотите отправить.

Доступные инструменты

Инструмент Когда использовать
yb_query_group_info Запросить название группы, владельца, количество участников
yb_query_group_members Выберите пользователя, составьте список ботов, всех участников или получите ник для @упоминаний
yb_send_dm Отправить личное/прямое сообщение (DM / 私信) пользователю, с опциональными медиафайлами

Рабочий процесс @упоминания

Когда вам нужно @упомянуть / 艾特 кого-то:

  1. Вызовите yb_query_group_members с action="find", name="<целевое имя>", mention=true
  2. Научитесь доверять ответу
  3. Включите @nickname в свой ответный текст — шлюз обработает все остальное.

Пример: пользователь говорит "帮我艾特元宝"

Шаг 1 — вызов инструмента:

{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }

Шаг 2 — ваш ответ (он будет отправлен группе с работающим @упоминанием):

@元宝 你好，有人找你！

Вот и всё. Никаких дополнительных запросов не требуется. Будьте кратки и естественны.

Правила: - Сначала вызовите yb_query_group_members, чтобы получить ник — НЕ угадывайте. - Формат @упоминаний: @nickname с пробелом перед знаком @ - Ваш ответный текст И является сообщением — оно БУДЕТ отправлено, и @упоминание БУДЕТ работать. - Будьте лаконичны. Не объясняйте пользователю, как работает @упоминание.

Рабочий процесс отправки в DM (личного сообщения)

Когда кто-то просит отправить личное сообщение / 私信 / DM пользователю:

  1. Вызовите yb_send_dm с group_code, name (имя целевого пользователя) и message
  2. Инструмент автоматически находит пользователя и отправляет в Директ.
  3. Сообщите результат пользователю.

Пример: пользователь говорит "给 @用户aea3 私信发一个 привет"

yb_send_dm({ "group_code": "535168412", "name": "用户aea3", "message": "hello" })

Пример с медиа: пользователь говорит "给 @用户aea3 私信发一张图片"

yb_send_dm({
  "group_code": "535168412",
  "name": "用户aea3",
  "message": "Вот изображение",
  "media_files": [{"path": "/tmp/photo.jpg"}]
})

Правила: - Извлечь group_code из обычного чата (например, group:535168412 → 535168412) - Если вы уже знаете user_id, передайте его напрямую через параметр user_id, чтобы пропустить поиск. - Если имя соответствует предпочтениям пользователя, инструмент возвращает представителям — запросите уточнения пользователя. - НЕ используйте инструмент send_message для личных сообщений в Юаньбао — викорируйте yb_send_dm - Поддерживается мультимедиа: изображения (.jpg/.png/.gif/.webp/.bmp) отправляются как сообщения с изображениями, другие файлы как документы.

Запрос информации о группе

yb_query_group_info({ "group_code": "328306697" })

Запрос участников

Действие Описание
найти Поиск по имени (частичное совпадение, без учёта регистра)
список_ботов Список ботов и AI-ассистентов Yuanbao
list_all Список всех участников

Примечания