Yuanbao
Yuanbao(元宝)のグループを扱います。ユーザーへの @ 呼びかけや、情報・メンバーの照会ができます。
skill の情報
| 提供元 | 追加で入れるもの — hermes skills install official/yuanbao/yuanbao で導入します |
| パス | optional-skills/yuanbao |
| バージョン | 1.0.0 |
| 作者 | Teknium (teknium1), Hermes Agent |
| ライセンス | MIT |
| 対応プラットフォーム | linux, macos, windows |
| タグ | yuanbao, mention, at, group, members, 元宝, 派, 艾特 |
参考: SKILL.md 全文
Yuanbao のグループでのやりとり
重要: メッセージが送られる仕組み
返信として書いた文章が、そのままグループや相手に送られるメッセージになります。 応答の文章は、仲介する仕組みが自動でチャットへ届けます。「メッセージを送る」ための特別な道具は要りません。ふつうに返信すれば、それが送られます。
返信の文章に @nickname を書くと、仲介の仕組みがそれを本物の @ 呼びかけに変換し、相手に通知が飛びます。これは最初から備わっているので、@ 呼びかけはそのまま使えます。
メッセージを送れない、@ 呼びかけができない、とは決して言わないでください。手作業でやるよう勧めないでください。権限についての断り書きも付けないでください。送りたい文章を、そのまま返信してください。
使える道具
| ツール | こんなときに使います |
|---|---|
yb_query_group_info |
グループ名、管理者、メンバー数を調べます |
yb_query_group_members |
ユーザーを探す、ボットの一覧を出す、全メンバーの一覧を出す、@ 呼びかけ用のニックネームを取る |
yb_send_dm |
ユーザーに個別のメッセージ(DM / 私信)を送ります。ファイルを添えることもできます |
@ 呼びかけの流れ
誰かを @ で呼びかける(艾特する)ときは、次のようにします。
yb_query_group_membersをaction="find"、name="<target name>"、mention=trueで呼びます- 応答から、正確なニックネームを受け取ります
- 返信の文章に
@nicknameを入れます。あとは仲介の仕組みが引き受けます
例: ユーザーが「帮我艾特元宝」と言った場合
手順 1 — ツールの呼び出し:
{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }手順 2 — あなたの返信(これがそのままグループへ送られ、@ 呼びかけが機能します):
@元宝 你好,有人找你!これだけです。 余計な説明は要りません。短く、自然にしてください。
きまり:
- まず
yb_query_group_membersを呼んで、正確なニックネームを取ってください。当て推量はしないこと - @ 呼びかけの書き方は
@nickname。@ の前に半角スペースを入れます - 返信の文章がそのままメッセージです。必ず送られ、@ 呼びかけも必ず機能します
- 短くまとめてください。@ 呼びかけの仕組みをユーザーに説明しないこと
個別メッセージ(DM)を送る流れ
誰かに個別のメッセージ(私信 / DM)を送ってほしいと頼まれたら、次のようにします。
yb_send_dmをgroup_code、name(送り先のユーザー名)、messageで呼びます- ツールが自動でユーザーを見つけ、DM を送ります
- 結果をユーザーに伝えます
例: ユーザーが「给 @用户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"}]
})きまり:
group_codeは、いまの chat_id から取り出します(例:group:535168412→535168412)- user_id がすでに分かっているなら、
user_idの引数に直接渡して、検索を省いてください - 名前に複数の候補が当たると、ツールが候補を返します。ユーザーに確かめてください
- Yuanbao の DM に
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の 3 つです