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:
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ấ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
Điều hướng đến
Trợ lý AI > Danh sáchNhấ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".
Wizard mở ra với 3 bước:
Bước 1: Thông tin cơ bản
Điền các trường:
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:
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:
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ý:
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ự:
Tạo chatbot — Lưu thông tin vào hệ thống
Tạo cơ sở tri thức mới (nếu có) — Tạo từng KB
Gắn cơ sở tri thức — Liên kết KB với chatbot
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:
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:
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:
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:
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:
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ể:
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
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
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 — Tải lên tài liệu cho chatbot
Cấu hình hiển thị — Cài đặt display rules và widget appearance
Credits và chi phí — Quản lý hạn mức và ví credit
Last updated