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 全文
元宝グループでのやりとり
重要: メッセージ送信の仕組み
返信テキストが、そのままグループやユーザーへ送られるメッセージです。 ゲートウェイが応答テキストをチャットへ自動で届けます。特別な「メッセージ送信」ツールは要りません。普通に返信すれば、それが送信されます。
返信テキストに @nickname を含めると、ゲートウェイがそれを本物の @ メンションに変換し、相手に通知が飛びます。これは最初から備わっている機能です。@ メンションは問題なく使えます。
「メッセージを送れません」「@ メンションできません」と言ってはいけません。ユーザーに手作業でやってくださいと勧めてもいけません。権限についての断り書きを足す必要もありません。送りたいテキストをそのまま返信してください。
使えるツール
| ツール | 使う場面 |
|---|---|
yb_query_group_info |
グループ名、オーナー、メンバー数を調べる |
yb_query_group_members |
ユーザーを探す、bot を一覧する、全メンバーを一覧する、@ メンション用のニックネームを得る |
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": "/path/to/photo.jpg"}]
})ルール:
group_codeは、いまの chat_id から取り出します(例:group:535168412→535168412)- user_id がすでに分かっているなら、
user_idパラメーターで直接渡し、検索を省きます - 名前に一致するユーザーが複数いる場合、ツールは候補を返します。どちらか、ユーザーに確かめてください
- 元宝の DM に
send_messageツールを使ってはいけません。yb_send_dmを使います - メディアに対応しています。画像(.jpg/.png/.gif/.webp/.bmp)は画像メッセージとして、それ以外はファイルとして送られます
グループ情報を調べる
yb_query_group_info({ "group_code": "328306697" })メンバーを調べる
| アクション | 説明 |
|---|---|
find |
名前で検索します(部分一致・大文字小文字は区別しません) |
list_bots |
bot と元宝の AI アシスタントを一覧します |
list_all |
全メンバーを一覧します |
補足
group_codeは chat_id から取れます:group:328306697→328306697- 元宝アプリでは、グループを「派 (Pai)」と呼びます
- メンバーの役割:
user、yuanbao_ai、bot