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 4 bước:

Bước 1: Thông tin cơ bản → Bước 2: Chọn model AI → Bước 3: Viết system prompt → Bước 4: Gắn cơ sở tri thức

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).


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".

  1. Wizard mở ra với 4 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

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

Phạm vi

Ai có thể sử dụng: Công khai (tất cả), Học viên đã ghi danh, hoặc Theo khóa học

Nhấp "Tiếp theo" để sang bước 2.


Bước 2: Chọn model AI

Chọn model AI cho chatbot từ danh sách model có sẵn. Hệ thống tự động chọn model mặc định phù hợp.

Model được chia theo nhà cung cấp:

Nhà cung cấp
Ghi chú

Gradient (DigitalOcean)

Model mặc định, không cần API key riêng

OpenAI

Cần cấu hình API key OpenAI trong cài đặt site

Anthropic

Cần cấu hình API key Anthropic trong cài đặt site

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.

Nhấp "Tiếp theo" để sang bước 3.


Bước 3: Viết system prompt

System prompt là 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 mục đích:

Mẫu
Mục đích

Hỗ trợ (Support)

Trả lời câu hỏi chung của nhân viên

Tùy chỉnh

Viết prompt riêng

Nhấp vào mẫu để áp dụng, sau đó chỉnh sửa cho phù hợp với tổ chức.

Ví dụ system prompt tốt:

Nhấp "Tiếp theo" để sang bước 4.


Bước 4: Gắn cơ sở tri thức (tùy chọn)

Gắn cơ sở tri thức để chatbot tham khảo khi trả lời.

Hai cách:

Cách 1: Chọn cơ sở tri thức có sẵn

  • Đánh dấu checkbox bên cạnh tên cơ sở tri thức

  • Có thể chọn nhiều cơ sở tri thức

Cách 2: Tạo cơ sở tri thức mới

  • Nhập tên vào ô "Tên KB mới..."

  • Nhấp "Thêm"

  • Cơ sở tri thức sẽ được tạo tự động 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. Chatbot vẫn hoạt động nhưng chỉ dựa vào system prompt.

Nhấp "Tạo" để 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

Chatbot mới có trạng thái ban đầu:

  • 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 chỉ hoạt động khi cả hai trạng thái đều sẵn sàng (Hoạt động + Sẵn sà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 yêu cầu API key đượ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

Last updated