# Tạo chatbot > Tạo chatbot AI mới để hỗ trợ nhân viên trả lời câu hỏi tự động. **Quyền truy cập:** Cần quyền **Tạo Chatbot** **Điều hướng:** `Trợ lý AI > Danh sách` hoặc `/manage/ai/chatbots` *** ## Tổng quan Trợ lý AI là chatbot có thể trả lời câu hỏi của nhân viên dựa trên cơ sở tri thức (tài liệu) bạn cung cấp. Mỗi site được tạo tối đa **10 chatbot**. Quy trình tạo chatbot gồm 3 bước: ``` Bước 1: Thông tin cơ bản → Bước 2: Cơ sở tri thức → Bước 3: Cấu hình trợ lý (Model + System Prompt) ``` *** ## Giao diện Trang **Trợ lý AI** có 3 tab: | Tab | Chức năng | | --------------------------- | ---------------------------------------------------------------- | | **Tổng quan** | Thống kê tổng quan: số chatbot, số phiên chat, credit sử dụng | | **Danh sách** | Danh sách chatbot, tìm kiếm, tạo mới | | **Cài đặt hiển thị Widget** | Tùy chỉnh giao diện chat widget (cần quyền **Cập nhật Chatbot**) | Thanh trên cùng của tab Danh sách hiển thị số chatbot đã tạo / giới hạn (ví dụ: `Đã tạo: 3/10`). Tab Danh sách có bộ lọc nhanh theo loại chatbot: | Tùy chọn lọc | Hiển thị | | ------------- | --------------------------------------------- | | **Tất cả** | Toàn bộ chatbot (kèm tổng số) | | **Trợ lý AI** | Chatbot do người dùng tạo | | **Hệ thống** | Chatbot hệ thống (không có nút Cài đặt / Xóa) | *** ## Tạo chatbot mới ### Điều kiện * Có quyền **Tạo Chatbot** * Chưa đạt giới hạn 10 chatbot * Site đã kích hoạt tính năng AI (`ALLOW_AI_FEATURE=Yes`) ### Các bước 1. Điều hướng đến `Trợ lý AI > Danh sách` 2. Nhấp **"Tạo Trợ lý AI"** ở góc phải trên > **Lưu ý:** Nút bị vô hiệu hóa nếu đã đạt giới hạn 10 chatbot. Di chuột vào nút sẽ thấy thông báo "Đã đạt giới hạn 10 Trợ lý AI". 3. Wizard mở ra với 3 bước: *** ### Bước 1: Thông tin cơ bản Điền các trường: | Trường | Bắt buộc | Mô tả | | --------- | -------- | -------------------------------------------- | | **Tên** | Có | Tên hiển thị của chatbot, ví dụ: "Trợ lý HR" | | **Mô tả** | Không | Mô tả ngắn về mục đích chatbot | Nhấp **"Tiếp tục"** để sang bước 2. *** ### Bước 2: Cơ sở tri thức (tùy chọn) Gắn cơ sở tri thức để chatbot tham khảo khi trả lời. Giao diện chia hai cột: **Cột trái — Danh sách cơ sở tri thức có sẵn:** * Tìm kiếm theo tên * Đánh dấu checkbox để chọn, có thể chọn nhiều **Cột phải — Tạo cơ sở tri thức mới (tạo nhanh):** * Nhập tên vào ô "Tên Cơ sở tri thức mới" rồi nhấp **"Thêm"** * Cơ sở tri thức sẽ được tạo tự động sau khi hoàn tất wizard > **Lưu ý:** Bạn có thể bỏ qua bước này và gắn cơ sở tri thức sau trong trang cài đặt chatbot. Chatbot vẫn hoạt động nhưng chỉ dựa vào system prompt. Nhấp **"Tiếp tục"** để sang bước 3. *** ### Bước 3: Cấu hình trợ lý (Model + System Prompt) Bước này gộp chung việc chọn model AI và soạn system prompt vào một màn hình hai cột. **Chọn model AI** Giao diện chọn model gồm thanh tab nhà cung cấp ở trên và danh sách model bên dưới. Model được chia theo nhà cung cấp: | Nhà cung cấp | Ghi chú | | -------------------------- | ----------------------------------------------------------------------- | | **Gradient** (Open Source) | Model mặc định, không cần API key riêng, chạy qua Gradient/DigitalOcean | | **OpenAI** | Cần cấu hình `OPENAI_API_KEY` trong cài đặt site | | **Anthropic** | Cần cấu hình `ANTHROPIC_API_KEY` trong cài đặt site | | **Moonshot** | Cần cấu hình `MOONSHOT_API_KEY` trong cài đặt site | | **DeepSeek** | Cần cấu hình `DEEPSEEK_API_KEY` trong cài đặt site | | **Z.AI** | Cần cấu hình `ZAI_API_KEY` trong cài đặt site | | **MiniMax** | Cần cấu hình `MINIMAX_API_KEY` trong cài đặt site | **Chế độ thực thi (Execution Mode)** Hệ thống tự động xác định chế độ thực thi dựa trên nhà cung cấp bạn chọn: | Chế độ | Áp dụng khi | Ý nghĩa | | ---------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | **Agent** | Chọn model Gradient | Chatbot được khởi tạo qua Gradient agent. Sau khi tạo, hệ thống cần vài phút để cấp phát endpoint. | | **Direct** | Chọn model OpenAI, Anthropic, Moonshot, DeepSeek, Z.AI, MiniMax | Chatbot gọi API trực tiếp tới nhà cung cấp. Không cần khởi tạo agent, hoạt động ngay sau khi tạo. | > **Lưu ý:** Chatbot Direct Mode hiển thị badge **"Direct"** màu xanh bên cạnh tên model trong danh sách. **Sắp xếp và lọc model** * Nhấp vào tab nhà cung cấp (Tất cả / Gradient / OpenAI / ...) để lọc danh sách theo nhà cung cấp. Số trong ngoặc cho biết số model khả dụng. * Nhấp nút **"Giá"** để sắp xếp danh sách model theo giá từ thấp đến cao. * Mỗi model hiển thị giá Input và Output tính theo 1K tokens. > **Lưu ý:** Nếu model đang chọn có trạng thái `deprecated`, hệ thống hiển thị cảnh báo "Model deprecated — nên chọn model khác." Hãy chuyển sang model mới hơn của cùng nhà cung cấp. > **Lưu ý:** Mỗi model có mức giá khác nhau (tính theo 1K tokens). Xem chi tiết giá tại `Trợ lý AI > Bảng giá Model AI`. > **Lưu ý:** Nếu bạn muốn dùng chatbot cho AI Admin Assistant (tool calling), chọn model có hỗ trợ tool calling. **Viết system prompt** Cột phải của bước 3 dùng để soạn system prompt — hướng dẫn cho chatbot biết cách hoạt động, vai trò và phong cách trả lời. **Giới hạn:** Tối đa 1.600 ký tự (giới hạn cứng: 2.000 ký tự). **Mẫu có sẵn:** Hệ thống cung cấp các mẫu prompt theo loại trợ lý: | Mẫu | Mục đích | | -------------------- | ---------------------------------------- | | **Tổng quát** | Đa mục đích, trả lời mọi chủ đề | | **Hỗ trợ nội bộ** | Trả lời câu hỏi, hướng dẫn xử lý vấn đề | | **FAQ / Tra cứu** | Trả lời nhanh từ cơ sở tri thức | | **Onboarding** | Hướng dẫn nhân viên mới | | **Chính sách HR** | Giải đáp chính sách, quy định, quyền lợi | | **Đào tạo** | Giải thích bài học, hỗ trợ tự học | | **Thông tin nội bộ** | Quy trình, hệ thống, liên hệ nội bộ | Chọn mẫu để áp dụng, sau đó chỉnh sửa cho phù hợp với tổ chức. Hệ thống cũng tự động gợi ý (đề xuất) model phù hợp với từng loại trợ lý. Nhấp **"Tạo Trợ lý"** để hoàn tất. *** ### Sau khi tạo Hệ thống thực hiện tuần tự: 1. **Tạo chatbot** — Lưu thông tin vào hệ thống 2. **Tạo cơ sở tri thức mới** (nếu có) — Tạo từng KB 3. **Gắn cơ sở tri thức** — Liên kết KB với chatbot 4. **Cấp phát endpoint** — Hệ thống tự động tạo endpoint cho chatbot Trạng thái ban đầu phụ thuộc vào chế độ thực thi: **Chế độ Agent (model Gradient):** * **status:** **Đang khởi tạo** (đang khởi tạo agent) * **endpointStatus:** **Đang tạo endpoint** (đang tạo endpoint) Sau vài phút, nếu thành công: * **status** chuyển thành **Hoạt động** * **endpointStatus** chuyển thành **Sẵn sàng** > **Quan trọng:** Chatbot Agent Mode chỉ hoạt động khi **cả hai** trạng thái đều sẵn sàng (**Hoạt động** + **Sẵn sàng**). **Chế độ Direct (model OpenAI, Anthropic, Moonshot, DeepSeek, Z.AI, MiniMax):** * Chatbot hoạt động ngay sau khi tạo, không cần chờ khởi tạo agent. * Không có trạng thái endpoint riêng. *** ## Trang cài đặt chatbot Nhấp vào chatbot trong danh sách để mở trang cài đặt chi tiết tại `/manage/ai/chatbots/:id/setting`. Trang gồm 4 tab: | Tab | Mô tả | | -------------------- | --------------------------------------------- | | **Tổng quan** | Thông tin cơ bản, trạng thái, model, endpoint | | **Cơ sở tri thức** | Quản lý cơ sở tri thức gắn với chatbot | | **Thiết lập trợ lý** | Playground thử nghiệm và cấu hình nâng cao | | **Phạm vi hiển thị** | Cài đặt hiển thị và giới hạn đối tượng | ### Tab Tổng quan Hiển thị và cho phép chỉnh sửa thông tin cơ bản: | Trường | Mô tả | | ----------------- | ------------------------------------------------------- | | **Tên** | Tên hiển thị của chatbot | | **Mô tả** | Mô tả ngắn | | **Ảnh đại diện** | Ảnh thumbnail chatbot (chọn từ thư viện media) | | **Model AI** | Model đang sử dụng | | **Phạm vi** | Tất cả mọi người / Học viên đã đăng ký / Trong khoá học | | **System Prompt** | Hướng dẫn hành vi cho chatbot | Phía dưới hiển thị: * **Trạng thái chatbot** -- Trạng thái hoạt động hiện tại * **Trạng thái endpoint** -- Trạng thái kết nối * Nút **"Dừng"** / **"Kích hoạt"** / **"Tạo lại Endpoint"** tuỳ theo trạng thái * Nút **"Xoá chatbot"** để xoá vĩnh viễn Nhấp **"Lưu"** sau khi chỉnh sửa. ### Tab Cơ sở tri thức Quản lý danh sách cơ sở tri thức gắn với chatbot: * **Chọn KB** -- Dropdown chọn cơ sở tri thức từ danh sách có sẵn * **Gắn KB** -- Nhấp **"Thêm"** để gắn KB đã chọn vào chatbot * **Danh sách KB đã gắn** -- Hiển thị tên, trạng thái, số tài liệu * **Gỡ KB** -- Nhấp **"Gỡ"** để bỏ liên kết KB khỏi chatbot * **Mở cài đặt KB** -- Nhấp vào tên KB để mở trang cài đặt cơ sở tri thức ### Tab Thiết lập trợ lý Giao diện chia 2 phần: **Bên trái (7 cột) -- Playground:** Console thử nghiệm cho phép gửi tin nhắn và xem phản hồi trực tiếp từ chatbot. **Bên phải (5 cột) -- Cấu hình:** Có 2 sub-tab: **Hướng dẫn** (Instructions) và **Nâng cao** (Advanced). **Sub-tab Hướng dẫn:** | Trường | Mô tả | | ----------------- | --------------------------------------------------------------------- | | **System Prompt** | Soạn thảo hướng dẫn cho chatbot (tối đa 2.000 ký tự). Có mẫu mặc định | | **Model AI** | Chọn lại model AI | **Sub-tab Nâng cao:** | Trường | Mô tả | Mặc định | | ------------------------- | ----------------------------------------- | ------------------ | | **Max Tokens** | Số token tối đa cho mỗi phản hồi | 4096 | | **Temperature** | Độ sáng tạo (0 = chính xác, 1 = sáng tạo) | 0.2 | | **Top P** | Xác suất tích luỹ lấy mẫu | 1.0 | | **Top K** | Số lượng token ứng viên | 0 | | **Phương thức truy xuất** | Cách trích dẫn nguồn: bao gồm trích dẫn | include\_citations | ### Tab Phạm vi hiển thị Cấu hình chatbot hiển thị cho ai: | Trường | Mô tả | | --------------------- | ----------------------------------------- | | **Hiển thị** | Bật/tắt hiển thị chatbot trên widget | | **Độ ưu tiên** | Số thứ tự hiển thị (số nhỏ = ưu tiên cao) | | **Ẩn khi hết credit** | Tự động ẩn chatbot khi hạn mức credit hết | **Giới hạn đối tượng:** Cho phép giới hạn chatbot chỉ hiển thị cho một số người dùng, nhóm hoặc khoá học cụ thể: | Loại | Mô tả | | -------------- | -------------------------------------------- | | **Người dùng** | Tìm và chọn người dùng cụ thể theo tên/email | | **Nhóm** | Chọn nhóm người dùng | | **Khoá học** | Chọn khoá học cụ thể | Nếu không thiết lập giới hạn, chatbot hiển thị cho tất cả người dùng theo phạm vi đã chọn. *** ## Trạng thái chatbot | Trạng thái | Ý nghĩa | Hành động | | ------------------ | --------------------- | ----------------------------------------- | | **Chưa kích hoạt** | Chưa kích hoạt | Nhấp "Tạo Endpoint" trong cài đặt chatbot | | **Đang khởi tạo** | Đang tạo agent | Đợi 1-3 phút | | **Hoạt động** | Đang hoạt động | Sẵn sàng sử dụng | | **Đang dừng** | Đang dừng | Đợi | | **Đã dừng** | Đã dừng | Có thể xóa hoặc tái kích hoạt | | **Khởi tạo lỗi** | Tạo endpoint thất bại | Nhấp "Tạo lại Endpoint" | | **Agent lỗi** | Agent bị lỗi | Kiểm tra cấu hình model, thử tạo lại | | **Lỗi** | Lỗi chung | Liên hệ quản trị viên hệ thống | *** ## Trạng thái endpoint | Trạng thái | Ý nghĩa | | --------------------- | ----------------------------------------- | | **Chưa khởi tạo** | Chưa tạo endpoint | | **Đang tạo endpoint** | Đang tạo endpoint | | **Sẵn sàng** | Endpoint sẵn sàng, chatbot có thể trả lời | | **Thất bại** | Tạo endpoint thất bại | Nếu endpoint ở trạng thái **Thất bại**, nhấp **"Tạo lại Endpoint"** (Reprovision) trong trang cài đặt chatbot. *** ## Lưu ý * **Giới hạn 10 chatbot** mỗi site. Xóa chatbot cũ nếu cần tạo thêm. * **Model OpenAI, Anthropic, Moonshot, DeepSeek, Z.AI, MiniMax** yêu cầu API key tương ứng được cấu hình sẵn ở cấp site. Liên hệ quản trị viên nếu cần. * **System prompt** nên ngắn gọn, rõ ràng. Prompt quá dài có thể gây tốn token không cần thiết. * **Cơ sở tri thức** cần thời gian indexing sau khi tải tài liệu lên. Chatbot chưa thể trả lời chính xác cho đến khi indexing hoàn tất. * **Chi phí:** Mỗi tin nhắn tiêu tốn credit dựa trên model được chọn. Theo dõi tại `Trợ lý AI > Sử dụng Credit`. *** ## Xem thêm * [Cơ sở tri thức](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/co-so-tri-thuc) — Tải lên tài liệu cho chatbot * [Cấu hình hiển thị](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/cau-hinh-hien-thi) — Cài đặt display rules và widget appearance * [Credits và chi phí](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/credits) — Quản lý hạn mức và ví credit