SuperAPI AI 工具集

yuanbao

办公与效率

查看项目

更新于 10-16 11:25

技能介绍

Yuanbao(元宝)群组交互技能用于在元宝群聊环境中处理 @提及、群信息查询、成员查询与私信发送。

用途 该技能面向元宝群组(在元宝应用中群组被称为“派 / Pai”)的交互场景,帮助 AI 在群聊中完成提及用户、查询群资料、查找成员以及发送私信等任务。

消息发送机制 该技能的关键机制是:AI 的文本回复本身就是发送到群组或用户的消息,网关会自动将回复文本投递到聊天中,因此不需要任何专门的“发送消息”工具,正常回复即可被发送。当回复文本中包含 @昵称 时,网关会自动将其转换为真实的 @提及并通知对应用户,这是内置能力。因此不应声称无法发送消息或 @提及用户,也不应建议用户手动操作或添加权限相关的免责声明,只需回复想要发送的文本即可。

主要能力与工具 技能提供以下工具:

  • yb_query_group_info:查询群名称、群主、成员数量。
  • yb_query_group_members:查找用户、列出机器人、列出全部成员,或获取用于 @提及的昵称。
  • yb_send_dm:向用户发送私信(DM / 私信),可选附带媒体文件。

@提及工作流程 当需要 @提及某人时:

  1. 调用 yb_query_group_members,参数为 action="find"、name="<目标名称>"、mention=true。
  2. 从返回结果中获取准确昵称。
  3. 在回复文本中包含 @昵称,网关会处理其余部分。

示例:用户说“帮我艾特元宝” 步骤 1 — 工具调用: { "group_code": "328306697", "action": "find", "name": "元宝", "mention": true } 步骤 2 — 回复(该文本会被发送到群组并产生有效的 @提及): @元宝 你好,有人找你!

规则:

  • 先调用 yb_query_group_members 获取准确昵称,不要猜测。
  • @提及格式为 @昵称,@ 符号前有一个空格。
  • 回复文本即为消息,会被发送且 @提及会生效。
  • 保持简洁,不要向用户解释 @提及的工作原理。

发送私信(DM)工作流程 当有人要求向某用户发送私信 / DM 时:

  1. 调用 yb_send_dm,传入 group_code、name(目标用户名)和 message。
  2. 工具会自动查找用户并发送私信。
  3. 向用户报告结果。

示例:用户说“给 @用户aea3 私信发一个 hello” 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": "/tmp/photo.jpg"}] })

私信规则:

  • 从当前 chat_id 中提取 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" })

查询成员 支持的操作:

  • find:按名称搜索(部分匹配,不区分大小写)。
  • list_bots:列出机器人和元宝 AI 助手。
  • list_all:列出全部成员。

说明

  • group_code 来自 chat_id:group:328306697 → 328306697。
  • 群组在元宝应用中被称为“派(Pai)”。
  • 成员角色包括:user、yuanbao_ai、bot。

适用场景 适用于元宝群聊中的成员提及、群资料查询、成员检索以及一对一私信发送等交互任务。

限制 资料未提供该技能在元宝之外平台的使用说明、收费或价格信息、具体部署与安装步骤,以及除上述工具与规则之外的其他功能,这些内容暂未提供。