Trợ lý Mina trong ứng dụng
Xem dạng Markdown
**Mina** là trợ lý AI tích hợp sẵn ngay trong OmnyBot. Mina vừa có thể giải đáp thắc mắc cách sử dụng hệ thống dựa trên tài liệu ứng dụng, vừa có thể trực tiếp thực hiện các tác vụ quản trị (tìm kiếm/cập nhật Kho tri thức, kiểm tra tình trạng kênh, đọc hội thoại chưa đọc, quản lý Bot AI và thẻ phân loại) tùy theo quyền của bạn trong Workspace.
:::note[Quyền truy cập & Gói dịch vụ]
- **Mọi thành viên** trong Workspace ở **mọi gói dịch vụ** đều có thể mở và trò chuyện với Mina (hỏi đáp hướng dẫn sử dụng không cần quyền đặc biệt).
- Các công cụ **ghi/chỉnh sửa Kho tri thức** và cấu hình Bot yêu cầu quyền **`workspace:manage`** cùng khả năng `aiReply` của gói dịch vụ. Các công cụ tác vụ khác (như đọc hội thoại, tạo/đổi tên thẻ, kiểm tra tình trạng kênh, kết nối tài khoản) chỉ khả dụng khi thành viên có đúng quyền tương ứng trong Workspace.
:::
## Cách mở Mina
Bạn có thể làm việc với Mina tại 3 điểm truy cập:
1. **Trang chủ (`/{slug}/`)** — Giao diện làm việc mặc định của Workspace tích hợp sẵn Mina.
2. **Trang toàn màn hình Agent (`/{slug}/ai-chats` và `/{slug}/ai-chats/{threadId}`)** — Mở từ mục **Agent** trên thanh điều hướng bên trái để tập trung trao đổi dài và xem lại lịch sử hội thoại.
3. **Bảng trượt bên phải (Side Panel)** — Có thể bật ở bất kỳ trang nào trong ứng dụng. Trên máy tính, bạn có thể kéo mép trái để điều chỉnh chiều rộng (từ **360px** đến **1100px**); trên thiết bị di động, bảng mở toàn màn hình. Mỗi lần mở mới bảng trượt sẽ lưu trữ cuộc trò chuyện cũ vào lịch sử và tạo phiên trống mới.
## Chế độ hoạt động & Nhắc đến ngữ cảnh
- **Chế độ `Agent` và `Ask`**: Bạn có thể chuyển đổi chế độ hoạt động của Mina ngay trên thanh nhập liệu (mặc định là `agent`, lưu theo trình duyệt).
- **Lịch sử hội thoại & Đánh giá**: Xem lại hoặc mở lại các cuộc trò chuyện trước đó qua danh sách lịch sử (`/threads`, `/threads/:id/activate`), tải thêm tin nhắn cũ và đánh giá phản hồi (**hữu ích / chưa hữu ích**).
- **Truyền phát thời gian thực (SSE)**: Mina hiển thị từng bước xử lý công cụ (tool steps) và kết quả trung gian ngay khi đang chạy.
## Các nhóm công cụ Mina hỗ trợ
Tùy thuộc vào vai trò và quyền của bạn, Mina có thể gọi các công cụ sau:
| Nhóm công cụ | Khả năng chính |
|---|---|
| **Hỗ trợ & Tài liệu ứng dụng** | `search_docs` — tra cứu tài liệu hướng dẫn OmnyBot kèm ngữ cảnh trang bạn đang mở |
| **Kho tri thức & Lỗ hổng** | `search_knowledge`, `read_knowledge`, `create_knowledge`, `batch_create_knowledge` (tối đa 15 bài/lần), `update_knowledge`, `delete_knowledge`, `crawl_website_knowledge`, `manage_kb_collection`, `review_knowledge_base`, `list_gaps`, `resolve_gap` |
| **Quản lý & Thử nghiệm Bot AI** | `manage_ai_bot`, `test_bot_reply` |
| **Kênh kết nối & Hội thoại** | `nick_health` (kiểm tra trạng thái/lỗi kênh Zalo, Facebook, WhatsApp), `read_unread_conversations`, `read_conversation` (đọc & tìm tin trong một hội thoại cụ thể), `connect_account` (hiển thị lựa chọn/mã QR kết nối ngay trong khung chat) |
| **Thẻ phân loại (Tags)** | `create_tag`, `rename_tag` |
:::note[Giới hạn độ dài khi Mina viết bài tri thức]
Khi Mina tự tạo hoặc cập nhật nguồn tri thức (`FAQ`, `POLICY`, `PRODUCT`), tiêu đề tối đa **200 ký tự** và nội dung tối đa **8.000 ký tự** để đảm bảo chất lượng truy xuất vector.
:::
## Cơ chế Xác nhận (Confirmation) & Hoàn tác (Undo)
- **Duyệt trước khi ghi**: Với các thao tác làm thay đổi dữ liệu được thiết lập quyền **Hỏi trước (`ask`)**, Mina sẽ tóm tắt hành động dự kiến và chờ bạn nhấn xác nhận hoặc từ chối trước khi thực thi. Quyền từng công cụ (`always` / `ask` / `deny`) được cấu hình dùng chung với trang [Kết nối AI (MCP)](/mina-mcp/mcp-server/).
- **Hoàn tác (Undo)**: Các hành động ghi đã áp dụng (`APPLIED`) hiển thị thẻ hành động kèm nút **Hoàn tác** (`POST /actions/:id/undo`) để khôi phục dữ liệu về trạng thái trước đó. Các hành động mang tính kết nối kênh như đăng nhập QR (`NICK_QR_LOGIN`, `NICK_CONNECT_OPTIONS`) không hỗ trợ hoàn tác.
## Hạn mức sử dụng mặc định hàng ngày
Để tránh vòng lặp bất thường hoặc lạm dụng tài nguyên, hệ thống áp dụng các ngưỡng bảo vệ theo ngày (có thể thay đổi qua cấu hình máy chủ):
- **Số tin nhắn / thành viên / ngày**: mặc định **300** tin nhắn.
- **Số tin nhắn / Workspace / ngày**: mặc định **1.000** tin nhắn.
- **Tổng token xử lý / Workspace / ngày**: mặc định **5.000.000** token.
- **Số thao tác ghi / Workspace / ngày**: mặc định **200** thao tác.
- **Khởi tạo phiên QR qua chat**: tối đa **5 lần / 10 phút** mỗi thành viên.
Mina là trợ lý AI tích hợp sẵn ngay trong OmnyBot. Mina vừa có thể giải đáp thắc mắc cách sử dụng hệ thống dựa trên tài liệu ứng dụng, vừa có thể trực tiếp thực hiện các tác vụ quản trị (tìm kiếm/cập nhật Kho tri thức, kiểm tra tình trạng kênh, đọc hội thoại chưa đọc, quản lý Bot AI và thẻ phân loại) tùy theo quyền của bạn trong Workspace.
Cách mở Mina
Phần tiêu đề “Cách mở Mina”Bạn có thể làm việc với Mina tại 3 điểm truy cập:
- Trang chủ (
/{slug}/) — Giao diện làm việc mặc định của Workspace tích hợp sẵn Mina. - Trang toàn màn hình Agent (
/{slug}/ai-chatsvà/{slug}/ai-chats/{threadId}) — Mở từ mục Agent trên thanh điều hướng bên trái để tập trung trao đổi dài và xem lại lịch sử hội thoại. - Bảng trượt bên phải (Side Panel) — Có thể bật ở bất kỳ trang nào trong ứng dụng. Trên máy tính, bạn có thể kéo mép trái để điều chỉnh chiều rộng (từ 360px đến 1100px); trên thiết bị di động, bảng mở toàn màn hình. Mỗi lần mở mới bảng trượt sẽ lưu trữ cuộc trò chuyện cũ vào lịch sử và tạo phiên trống mới.
Chế độ hoạt động & Nhắc đến ngữ cảnh
Phần tiêu đề “Chế độ hoạt động & Nhắc đến ngữ cảnh”- Chế độ
AgentvàAsk: Bạn có thể chuyển đổi chế độ hoạt động của Mina ngay trên thanh nhập liệu (mặc định làagent, lưu theo trình duyệt). - Lịch sử hội thoại & Đánh giá: Xem lại hoặc mở lại các cuộc trò chuyện trước đó qua danh sách lịch sử (
/threads,/threads/:id/activate), tải thêm tin nhắn cũ và đánh giá phản hồi (hữu ích / chưa hữu ích). - Truyền phát thời gian thực (SSE): Mina hiển thị từng bước xử lý công cụ (tool steps) và kết quả trung gian ngay khi đang chạy.
Các nhóm công cụ Mina hỗ trợ
Phần tiêu đề “Các nhóm công cụ Mina hỗ trợ”Tùy thuộc vào vai trò và quyền của bạn, Mina có thể gọi các công cụ sau:
| Nhóm công cụ | Khả năng chính |
|---|---|
| Hỗ trợ & Tài liệu ứng dụng | search_docs — tra cứu tài liệu hướng dẫn OmnyBot kèm ngữ cảnh trang bạn đang mở |
| Kho tri thức & Lỗ hổng | search_knowledge, read_knowledge, create_knowledge, batch_create_knowledge (tối đa 15 bài/lần), update_knowledge, delete_knowledge, crawl_website_knowledge, manage_kb_collection, review_knowledge_base, list_gaps, resolve_gap |
| Quản lý & Thử nghiệm Bot AI | manage_ai_bot, test_bot_reply |
| Kênh kết nối & Hội thoại | nick_health (kiểm tra trạng thái/lỗi kênh Zalo, Facebook, WhatsApp), read_unread_conversations, read_conversation (đọc & tìm tin trong một hội thoại cụ thể), connect_account (hiển thị lựa chọn/mã QR kết nối ngay trong khung chat) |
| Thẻ phân loại (Tags) | create_tag, rename_tag |
Cơ chế Xác nhận (Confirmation) & Hoàn tác (Undo)
Phần tiêu đề “Cơ chế Xác nhận (Confirmation) & Hoàn tác (Undo)”- Duyệt trước khi ghi: Với các thao tác làm thay đổi dữ liệu được thiết lập quyền Hỏi trước (
ask), Mina sẽ tóm tắt hành động dự kiến và chờ bạn nhấn xác nhận hoặc từ chối trước khi thực thi. Quyền từng công cụ (always/ask/deny) được cấu hình dùng chung với trang Kết nối AI (MCP). - Hoàn tác (Undo): Các hành động ghi đã áp dụng (
APPLIED) hiển thị thẻ hành động kèm nút Hoàn tác (POST /actions/:id/undo) để khôi phục dữ liệu về trạng thái trước đó. Các hành động mang tính kết nối kênh như đăng nhập QR (NICK_QR_LOGIN,NICK_CONNECT_OPTIONS) không hỗ trợ hoàn tác.
Hạn mức sử dụng mặc định hàng ngày
Phần tiêu đề “Hạn mức sử dụng mặc định hàng ngày”Để tránh vòng lặp bất thường hoặc lạm dụng tài nguyên, hệ thống áp dụng các ngưỡng bảo vệ theo ngày (có thể thay đổi qua cấu hình máy chủ):
- Số tin nhắn / thành viên / ngày: mặc định 300 tin nhắn.
- Số tin nhắn / Workspace / ngày: mặc định 1.000 tin nhắn.
- Tổng token xử lý / Workspace / ngày: mặc định 5.000.000 token.
- Số thao tác ghi / Workspace / ngày: mặc định 200 thao tác.
- Khởi tạo phiên QR qua chat: tối đa 5 lần / 10 phút mỗi thành viên.