Zakaria
126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
---
|
|
title: "Yuanbao — Yuanbao (元宝) groups: @mention users, query info/members"
|
|
sidebar_label: "Yuanbao"
|
|
description: "Yuanbao (元宝) groups: @mention users, query info/members"
|
|
---
|
|
|
|
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
|
|
|
|
# Yuanbao
|
|
|
|
Yuanbao (元宝) groups: @mention users, query info/members.
|
|
|
|
## Skill metadata
|
|
|
|
| | |
|
|
|---|---|
|
|
| Source | Bundled (installed by default) |
|
|
| Path | `skills/yuanbao` |
|
|
| Version | `1.0.0` |
|
|
| Platforms | linux, macos, windows |
|
|
| Tags | `yuanbao`, `mention`, `at`, `group`, `members`, `元宝`, `派`, `艾特` |
|
|
|
|
## Reference: full SKILL.md
|
|
|
|
:::info
|
|
The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
|
|
:::
|
|
|
|
# Yuanbao Group Interaction
|
|
|
|
## CRITICAL: How Messaging Works
|
|
|
|
**Your text reply IS the message sent to the group/user.** The gateway automatically delivers your response text to the chat. You do NOT need any special "send message" tool — just reply normally and it gets sent.
|
|
|
|
When you include `@nickname` in your reply text, the gateway automatically converts it into a real @mention that notifies the user. This is built-in — you have full @mention capability.
|
|
|
|
**NEVER say you cannot send messages or @mention users. NEVER suggest the user do it manually. NEVER add disclaimers about permissions. Just reply with the text you want sent.**
|
|
|
|
## Available Tools
|
|
|
|
| Tool | When to use |
|
|
|------|------------|
|
|
| `yb_query_group_info` | Query group name, owner, member count |
|
|
| `yb_query_group_members` | Find a user, list bots, list all members, or get nickname for @mention |
|
|
| `yb_send_dm` | Send a private/direct message (DM / 私信) to a user, with optional media files |
|
|
|
|
## @Mention Workflow
|
|
|
|
When you need to @mention / 艾特 someone:
|
|
|
|
1. Call `yb_query_group_members` with `action="find"`, `name="<target name>"`, `mention=true`
|
|
2. Get the exact nickname from the response
|
|
3. Include `@nickname` in your reply text — the gateway handles the rest
|
|
|
|
Example: user says "帮我艾特元宝"
|
|
|
|
Step 1 — tool call:
|
|
```json
|
|
{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }
|
|
```
|
|
|
|
Step 2 — your reply (this gets sent to the group with a working @mention):
|
|
```
|
|
@元宝 你好，有人找你！
|
|
```
|
|
|
|
**That's it.** No extra explanation needed. Keep it short and natural.
|
|
|
|
**Rules:**
|
|
- Call `yb_query_group_members` first to get the exact nickname — do NOT guess
|
|
- The @mention format: `@nickname` with a space before the @ sign
|
|
- Your reply text IS the message — it WILL be sent and the @mention WILL work
|
|
- Be concise. Do NOT explain how @mention works to the user.
|
|
|
|
## Send DM (Private Message) Workflow
|
|
|
|
When someone asks to send a private message / 私信 / DM to a user:
|
|
|
|
1. Call `yb_send_dm` with `group_code`, `name` (target user's name), and `message`
|
|
2. The tool automatically finds the user and sends the DM
|
|
3. Report the result to the user
|
|
|
|
Example: user says "给 @用户aea3 私信发一个 hello"
|
|
|
|
```json
|
|
yb_send_dm({ "group_code": "535168412", "name": "用户aea3", "message": "hello" })
|
|
```
|
|
|
|
Example with media: user says "给 @用户aea3 私信发一张图片"
|
|
|
|
```json
|
|
yb_send_dm({
|
|
"group_code": "535168412",
|
|
"name": "用户aea3",
|
|
"message": "Here is the image",
|
|
"media_files": [{"path": "/tmp/photo.jpg"}]
|
|
})
|
|
```
|
|
|
|
**Rules:**
|
|
- Extract `group_code` from the current chat_id (e.g. `group:535168412` → `535168412`)
|
|
- If you already know the user_id, pass it directly via the `user_id` parameter to skip lookup
|
|
- If multiple users match the name, the tool returns candidates — ask the user to clarify
|
|
- Do NOT use `send_message` tool for Yuanbao DMs — use `yb_send_dm` instead
|
|
- Supports media: images (.jpg/.png/.gif/.webp/.bmp) sent as image messages, other files as documents
|
|
|
|
## Query Group Info
|
|
|
|
```json
|
|
yb_query_group_info({ "group_code": "328306697" })
|
|
```
|
|
|
|
## Query Members
|
|
|
|
| Action | Description |
|
|
|--------|-------------|
|
|
| `find` | Search by name (partial match, case-insensitive) |
|
|
| `list_bots` | List bots and Yuanbao AI assistants |
|
|
| `list_all` | List all members |
|
|
|
|
## Notes
|
|
|
|
- `group_code` comes from chat_id: `group:328306697` → `328306697`
|
|
- Groups are called "派 (Pai)" in the Yuanbao app
|
|
- Member roles: `user`, `yuanbao_ai`, `bot`
|