{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}
Nguyên bảo
Nhóm Yuanbao (元宝): @đề cập đến người dùng, truy vấn thông tin/thành viên.
Siêu dữ liệu kỹ năng
| Nguồn | Đi kèm (được cài đặt theo mặc định) |
| Đường dẫn |
skills/yuanbao ` | | Phiên bản |
1.0.0 ` | | Nền tảng | Linux, macOS, Windows | | Thẻ |
yuanbao
, `mention
, `at
, `group
, `members
,
元宝
,
派
,
艾特 ` |
Tham khảo: đầy đủ SKILL.md
Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.
Tương tác nhóm Yuanbao
QUAN TRỌNG: Cách hoạt động của tính năng nhắn tin`Tin nhắn trả lời của bạn LÀ tin nhắn được gửi đến nhóm/người dùng. Cổng tự động gửi văn bản trả lời của bạn đến cuộc trò chuyện. Bạn KHÔNG cần bất kỳ công cụ "gửi tin nhắn" đặc biệt nào - chỉ cần trả lời bình thường và tin nhắn sẽ được gửi.
Khi bạn đưa
@nickname ` vào văn bản trả lời của mình, cổng sẽ tự động chuyển đổi nó thành @mention thực để thông báo cho người dùng. Tính năng này được tích hợp sẵn — bạn có đầy đủ khả năng @mention.
KHÔNG BAO GIỜ nói rằng bạn không thể gửi tin nhắn hoặc @mention người dùng. KHÔNG BAO GIỜ đề nghị người dùng thực hiện thủ công. KHÔNG BAO GIỜ thêm tuyên bố từ chối trách nhiệm về quyền. Chỉ cần trả lời bằng nội dung bạn muốn gửi.
Công cụ có sẵn
| Công cụ | Khi nào nên sử dụng |
|---|---|
| `yb_query_group_info | |
| ` | Tên nhóm truy vấn, chủ sở hữu, số lượng thành viên |
| `yb_query_group_members | |
| ` | Tìm người dùng, liệt kê bot, liệt kê tất cả thành viên hoặc lấy biệt hiệu cho @mention |
| `yb_send_dm | |
| ` | Gửi tin nhắn riêng tư/trực tiếp (DM / 私信) cho người dùng, với các tệp phương tiện tùy chọn |
@Mention Quy trình làm việc
Khi bạn cần @mention/艾特 ai đó:
- Gọi
yb_query_group_membersvới `action="find"
, `name="<target name"
, `mention=true
- Lấy biệt danh chính xác từ phản hồi
- Bao gồm
@nickname ` trong văn bản trả lời của bạn — cổng sẽ xử lý phần còn lại
Ví dụ: người dùng nói "帮我艾特元宝"
Bước 1 - gọi công cụ:
`
{ "group_code": "328306697", "action": "find", "name": "元宝", "mention": true }
`
``Bước 2 — câu trả lời của bạn (câu trả lời này sẽ được gửi đến nhóm có @mention đang hoạt động):
`
@元宝 你好，有人找你！
`
``**Chỉ vậy thôi.** Không cần giải thích thêm. Giữ nó ngắn gọn và tự nhiên.
**Quy tắc:**
- Gọi
`yb_query_group_members
` trước để biết tên chính xác - KHÔNG đoán
- Định dạng @mention:
@nickname
` có dấu cách trước ký hiệu @
- Văn bản trả lời của bạn LÀ tin nhắn — nó SẼ được gửi và @đề cập SẼ hoạt động
- Hãy ngắn gọn. KHÔNG giải thích cách hoạt động của @mention cho người dùng.
## Quy trình gửi DM (Tin nhắn riêng tư)
Khi ai đó yêu cầu gửi tin nhắn riêng / 私信 / DM cho người dùng:
1. Gọi
`yb_send_dm
` với
`group_code
,
`name
` (tên người dùng mục tiêu) và
`message
2. Công cụ tự động tìm người dùng và gửi DM
3. Báo cáo kết quả cho người dùng
Ví dụ: người dùng nói "给 @用户aea3 私信发一个 xin chào"
``` json
yb_send_dm({ "group_code": "535168412", "name": "用户aea3", "message": "hello" })
`
``Ví dụ với media: người dùng nói "给 @用户aea3 私信发一张图片"
`JSON
yb_send_dm({
"group_code": "535168412",
"name": "用户aea3",
"message": "Here is the image",
"media_files": [\{"path": "/tmp/photo.jpg"}]
})
`
``**Quy tắc:**
- Trích xuất
`group_code
` từ chat_id hiện tại (ví dụ:
`group:535168412
` →
`535168412
)
- Nếu bạn đã biết user_id thì chuyển trực tiếp qua tham số
`user_id
` để bỏ qua việc tra cứu
- Nếu nhiều người dùng trùng tên, công cụ sẽ trả về tên ứng viên — yêu cầu người dùng làm rõ
- KHÔNG sử dụng công cụ
`send_message
` cho Yuanbao DM - thay vào đó hãy sử dụng
`yb_send_dm
- Hỗ trợ media: hình ảnh (.jpg/.png/.gif/.webp/.bmp) được gửi dưới dạng tin nhắn hình ảnh, các tệp khác dưới dạng tài liệu
## Thông tin nhóm truy vấn
``` json
yb_query_group_info({ "group_code": "328306697" })
`
## Truy vấn thành viên
| Hành động | Mô tả |
|--------|-------------|
|
`find
` | Tìm kiếm theo tên (khớp một phần, không phân biệt chữ hoa chữ thường) |
|
`list_bots
` | Liệt kê các bot và trợ lý AI Yuanbao |
|
`list_all
` | Liệt kê tất cả thành viên |
## Ghi chú
-
`group_code
` xuất phát từ chat_id:
`group:328306697
` →
`328306697
`
- Các nhóm được gọi là "派 (Pai)" trong ứng dụng Yuanbao
- Vai trò thành viên:
`user
,
`yuanbao_ai
,
`bot
`