61 lines
3.6 KiB
Markdown
61 lines
3.6 KiB
Markdown
---
|
|
summary: "Hành vi và cấu hình cho việc xử lý tin nhắn nhóm trên WhatsApp (Mẫu nhắc tên được chia sẻ trên mọi nền tảng)"
|
|
read_when:
|
|
- Bạn muốn cấu hình cách Agent hoạt động trong nhóm hoặc quy tắc nhắc tên (@mention)
|
|
---
|
|
|
|
# Tin nhắn nhóm (WhatsApp Web)
|
|
|
|
Mục tiêu: Cho phép Agent tham gia vào các nhóm WhatsApp, chỉ phản hồi khi được gọi tên (@-mention) và giữ cho các cuộc hội thoại trong nhóm hoàn toàn tách biệt với các cuộc trò chuyện cá nhân của bạn.
|
|
|
|
Lưu ý: Danh sách các mẫu nhắc tên (`mentionPatterns`) hiện được chia sẻ dùng chung cho cả Telegram, Discord, Slack và iMessage.
|
|
|
|
## Các tính năng đã triển khai
|
|
|
|
- **Chế độ kích hoạt**: Bao gồm `mention` (mặc định) hoặc `always`.
|
|
- `mention`: Yêu cầu phải nhắc tên Agent (thông qua @-mention thật của WhatsApp, hoặc các mẫu regex, hoặc số điện thoại của Agent).
|
|
- `always`: Agent sẽ theo dõi tất cả tin nhắn nhưng chỉ phản hồi khi thấy có thông tin giá trị cần đóng góp; nếu không nó sẽ im lặng (trả về mã `NO_REPLY`).
|
|
- Bạn có thể chuyển đổi giữa các chế độ này bằng lệnh `/activation`.
|
|
|
|
- **Chính sách nhóm (Group policy)**: Kiểm soát việc có chấp nhận tin nhắn từ nhóm hay không (`open` - mở cho tất cả, `disabled` - tắt hoàn toàn, hoặc `allowlist` - chỉ cho phép các nhóm nằm trong danh sách trắng).
|
|
|
|
- **Phiên làm việc riêng cho từng nhóm**: Các phiên làm việc nhóm hoàn toàn độc lập với các phiên DM cá nhân. Các lệnh như `/verbose on` hay `/think high` gửi trong nhóm sẽ chỉ có tác dụng trong nhóm đó, không ảnh hưởng đến bộ não của Agent ở nơi khác. Các lượt chạy tự động (heartbeats) sẽ không được thực hiện trong các nhóm chat để tránh làm phiền.
|
|
|
|
- **Nạp ngữ cảnh**: Các tin nhắn chờ trong nhóm chưa được phản hồi sẽ được gộp lại và chèn vào ngữ cảnh dưới nhãn `[Chat messages since your last reply - for context]` (Tin nhắn từ lần trả lời cuối - để lấy ngữ cảnh). Điều này giúp Agent nắm bắt được toàn bộ câu chuyện trong nhóm trước khi đưa ra câu trả lời chính thức cho tin nhắn hiện tại.
|
|
|
|
- **Định danh người gửi**: Mỗi đoạn hội thoại trong nhóm đều được đính kèm nhãn `[from: Tên người gửi (+Số điện thoại)]` ở cuối để Agent biết chính xác ai đang nói chuyện với mình.
|
|
|
|
## Ví dụ cấu hình (Mẫu nhắc tên)
|
|
|
|
Thêm khối `groupChat` vào file `moltbot.json` để Agent có thể nhận diện tên mình ngay cả khi ứng dụng chat lọc bỏ ký hiệu `@`:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"list": [
|
|
{
|
|
"id": "main",
|
|
"groupChat": {
|
|
"historyLimit": 50,
|
|
"mentionPatterns": [
|
|
"@?moltbot",
|
|
"\\+?15555550123"
|
|
]
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Lệnh kích hoạt (Dành cho chủ sở hữu)
|
|
|
|
Sử dụng lệnh sau trong nhóm chat:
|
|
- `/activation mention`: Chỉ phản hồi khi được nhắc tên.
|
|
- `/activation always`: Luôn luôn lắng nghe và phản hồi khi cần.
|
|
|
|
Chỉ người chủ (được khai báo trong danh sách `allowFrom`) mới có quyền thay đổi các cài đặt này.
|
|
|
|
---
|
|
Tài liệu liên quan: [Cấu hình Nhóm (Groups)](./groups.vi.md), [Trạng thái hệ thống](../../cli/status.vi.md).
|