Trợ lý AIget Chatbot

Tài liệu chi tiết hướng dẫn cách sử dụng, tùy chỉnh và nhúng AIget Chatbot.

Bong bóng Chatbot của bạn là giao diện chính để khách hàng tương tác trực tiếp với Trợ lý AIget Chatbot. Giao diện này được chia thành hai phần: Khung chứa điều khiển bên ngoài (Hỗ trợ kéo thả, thay đổi kích thước) và Màn hình Chat bên trong (Nhập liệu, gửi giọng nói, đính kèm tài liệu và cấu hình xưng hô).

1. Điều khiển Khung chứa & Kích thước

Bong bóng nổi & Di chuyển

Mở/Đóng nhanh: Bấm vào nút bong bóng tròn có biểu tượng chat ở góc dưới màn hình để hiển thị hoặc ẩn khung chat.
Di chuyển vị trí: Bấm giữ chuột vào Thanh grab-bar màu xám trên đầu khung chat và kéo rê chuột để di chuyển khung chat tới bất kỳ vị trí nào trên màn hình làm việc của bạn.

Thay đổi Kích thước linh hoạt

Hệ thống hỗ trợ thay đổi kích thước cửa sổ chat theo nhiều chiều hướng:

Kéo mép điều chỉnh: Di chuyển chuột tới các mép Trái, Phải, Dưới hoặc các góc của khung chat. Con trỏ chuột sẽ đổi thành mũi tên hai chiều. Bấm giữ chuột và kéo để phóng to/thu nhỏ cửa sổ.
Giới hạn kích thước: Hệ thống tự động chặn giới hạn tối thiểu (Rộng tối thiểu: 300px, Cao tối thiểu: 400px) để đảm bảo các yếu tố giao diện hiển thị rõ ràng nhất.

Các nút thao tác trên Thanh Grab-bar

Phía bên phải của thanh tiêu đề có các nút chức năng nhanh:

Tùy chọn nhanh: Bật/Tắt bảng cấu hình xưng hô và thông số giọng nói (TTS) của trợ lý.
Danh mục: Mở các tùy chọn mở rộng của Chatbot.
Làm mới cuộc trò chuyện: Làm sạch toàn bộ nội dung hội thoại hiện tại để bắt đầu cuộc trò chuyện mới.
Phóng to (Maximize): Mở rộng khung chat toàn màn hình để dễ đọc tài liệu hoặc bảng dữ liệu dài.
Kích thước mặc định: Khôi phục lại kích thước nhỏ gọn ban đầu sau khi đã phóng to.
Đóng: Ẩn khung chat (tương tự việc bấm lại nút bong bóng chat).

2. Cá nhân hóa & Cách xưng hô

Thiết lập Xưng hô trong Tiếng Việt

Để chatbot giao tiếp tự nhiên và lịch sự, bạn có thể thiết lập thông số cá nhân hóa thông qua menu Tùy chọn nhanh:

Độ tuổi (Age Preference):
- Trẻ: AI sẽ xưng hô thân mật, cởi mở hơn.
- Trung niên: AI sẽ xưng hô trang trọng, kính cẩn.
Xưng hô giới tính (Gender Preference):
- Nam: AI sẽ gọi bạn là "Anh".
- Nữ: AI sẽ gọi bạn là "Chị".
- Mặc định: AI sử dụng đại từ trung tính phù hợp số đông (Bạn, Quý khách, Anh/ Chị).

                 Cơ chế hoạt động: Khi bạn thay đổi các tùy chọn này,
                hệ thống sẽ điều chỉnh cách giao tiếp ngay lập tức.
            

3. Trợ lý Giọng nói (STT & TTS)

Nhập liệu bằng Giọng nói (Speech-to-Text)

Thay vì gõ bàn phím, bạn có thể click vào nút "Giọng nói" (có biểu tượng Microphone) ở cạnh ô nhập liệu để đọc tin nhắn. Trình duyệt sẽ yêu cầu quyền truy cập micro, vui lòng chọn "Cho phép" (Allow) để bắt đầu nói. Giọng nói của bạn sẽ được chuyển thành văn bản tức thì.

Phát thanh & Đọc văn bản (Text-to-Speech)

Trợ lý AI hỗ trợ đọc to câu trả lời với giọng nói tự nhiên, độ trễ cực thấp:

Kích hoạt: Trong menu Tùy chọn nhanh, tích chọn nút bật "Trợ lý nói" (AI Speak). AI sẽ tự động đọc to mọi câu trả lời sau khi trả lời xong.
Chọn Giọng đọc: Sử dụng thanh trượt giới tính để chọn giữa giọng Nữ (`HoaiMyNeural` - mặc định) hoặc Nam (`NamMinhNeural`).
Điều chỉnh tốc độ & Âm lượng: Di chuyển thanh trượt Tốc độ (-50% đến 100%) và Âm lượng (0% đến 100%) để đạt được trải nghiệm nghe thoải mái nhất.
Dừng phát âm nhanh: Click nút Dừng (nút màu đỏ cạnh AI Speak) để tắt âm thanh ngay lập tức nếu không muốn tiếp tục nghe.

4. Đính kèm & Lệnh Slash /db

Đính kèm Tài liệu & Hình ảnh

Bấm nút "Đính kèm" bên cạnh microphone để hiển thị khung tải tài liệu lên. Bạn có thể kéo thả trực tiếp hoặc chọn file từ thiết bị:

File hình ảnh: `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp` (Dùng để gửi ảnh minh họa).
Tài liệu văn bản: `.txt`, `.pdf` (Cung cấp thêm ngữ cảnh cho AI xử lý).

Lệnh hệ thống `/db`

Khi bạn cần truy vấn dữ liệu có cấu trúc (từ các tệp dữ liệu dạng bảng đã được chủ Tài khoản tải lên):

Gõ dấu gạch chéo / vào ô nhập tin nhắn để hiển thị Menu lệnh nhanh.
Chọn lệnh /db hoặc ấn phím TAB.
Một badge màu xanh [ /db ] xuất hiện trong ô nhập liệu. Lúc này, mọi câu hỏi tiếp theo của bạn bằng ngôn ngữ thông thường, ví dụ: "Cho biết 5 mặt hàng rẻ nhất", sẽ được định hướng tới module phân tích SQL để truy xuất thông tin chính xác từ bảng dữ liệu.

Lệnh tìm kiếm `/s`

Khi bạn muốn tìm kiếm trực tiếp sản phẩm trên website cửa hàng:

Gõ dấu gạch chéo / vào ô nhập tin nhắn để hiển thị Menu lệnh nhanh.
Chọn lệnh /s hoặc gõ trực tiếp /s (kèm khoảng trắng) kèm theo từ khóa sản phẩm cần tìm.
Một badge màu xanh [ /s ] xuất hiện (nếu chọn từ menu). Gõ từ khóa tìm kiếm (ví dụ: /s Dell) để trợ lý tự động hiển thị danh sách sản phẩm trực quan kèm hình ảnh và giá cả.

Các lệnh khác

Các lệnh tại các nút bấm cũng hiển thị tại đây để thao tác nhanh

Vào lại

Bấm // hoặc / rồi chọn trên Menu để khởi động lại Chatbot với lời chào hỏi ban đầu

5. Hướng dẫn Nhúng Website

Nhúng bằng Iframe Đơn giản

Phù hợp khi bạn muốn đặt chatbot cố định vào một trang cụ thể (như trang Liên hệ/Hỗ trợ):

                <iframe
                src="https://www.aiget.art/mychat?api_key=MÃ_API_CỦA_BẠN"
                style="position: fixed; bottom: 20px; left: 20px; width: 400px; height: 690px; border: none;
                border-radius: 16px; box-shadow: 0 12px 48px rgba(0,0,0,0.2); z-index: 99999;"
                allow="microphone; camera">
                </iframe>
            

Widget Nổi Cao cấp (Floating Widget)

Tạo một nút bong bóng chat đẹp mắt ở góc màn hình, tự động thu gọn và hỗ trợ các tính năng di chuyển, phóng to, thay đổi kích thước động. Bạn chỉ cần copy đoạn mã JavaScript hiển thị ở tab "Widget nổi (Cao cấp)" trên trang quản trị của mình và dán vào trước thẻ đóng </body> trên trang web của bạn.

             Bảo mật & Whitelisting: Chatbot của bạn chỉ hoạt động khi
            được nhúng từ các tên miền được khai báo hợp lệ trong mục Cài đặt (Website / Check IP). Nếu
            nhúng chatbot vào các trang web chưa đăng ký sẽ hiển thị thông báo "🚫 No Service".
        