yuanbao

Yuanbao 群组交互

关键：消息的工作方式

你的文本回复就是发送到群组/用户的消息。 网关会自动将你的回复文本送达聊天。你不需要任何特殊的“发送消息”工具——只需正常回复即可发送。

当你在回复文本中包含 @nickname 时，网关会自动将其转换为真实的 @提及，从而通知用户。这是内置功能——你拥有完整的 @提及能力。

绝不要说无法发送消息或 @提及用户。绝不要建议用户手动操作。绝不要添加有关权限的免责声明。只需回复你想发送的文本。

可用工具

工具	何时使用
yb_query_group_info	查询群组名称、群主和成员数
yb_query_group_members	查找用户、列出机器人、列出所有成员，或获取用于 @提及的昵称
yb_send_dm	向用户发送私密/直接消息（DM / 私信），并可附带媒体文件

@提及工作流

需要 @提及 / 艾特某人时：

1. 调用 yb_query_group_members，参数为 action="find"、name="<target name>"、mention=true
2. 获取响应中的准确昵称
3. 在回复文本中包含 @nickname——其余交由网关处理

示例：用户说“帮我艾特元宝”

第 1 步——工具调用：

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

第 2 步——你的回复（这会发送到群组，并带有有效的 @提及）：

@元宝 你好，有人找你！

仅此而已。 无需额外说明。保持简短自然。

规则：

• 先调用 yb_query_group_members 获取准确昵称——不要猜测
• @提及格式：@nickname，@ 符号前留一个空格
• 你的回复文本就是消息——它会被发送，@提及也会生效
• 保持简洁。不要向用户解释 @提及的工作方式

发送私信工作流

当有人要求向用户发送私密消息 / 私信 / 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": "Here is the image",
  "media_files": [{"path": "/path/to/photo.jpg"}]
})

规则：

• 从当前 chat_id 中提取 group_code（例如：group:535168412 → 535168412）
• 如果已经知道 user_id，可直接通过 user_id 参数传入，以跳过查找
• 如果有多个用户与名称匹配，工具会返回候选用户——请让用户明确选择
• Yuanbao 私信不要使用 send_message 工具——请改用 yb_send_dm
• 支持发送媒体：图片（.jpg/.png/.gif/.webp/.bmp）作为图片消息发送，其他文件作为文档发送

查询群组信息

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

查询成员

操作	说明
find	按名称搜索（部分匹配，不区分大小写）
list_bots	列出机器人和 Yuanbao AI 助手
list_all	列出所有成员

注意事项

• group_code 来自 chat_id：group:328306697 → 328306697
• 在 Yuanbao 应用中，群组称为“派（Pai）”
• 成员角色：user、yuanbao_ai、bot