Mô tả tính năng cài đặt của EzyAI
Back to ezyaiTrang Cài đặt của EzyAI cho phép quản trị viên điều chỉnh cách AI tra
cứu dữ liệu của hệ thống, cách nội dung được chia nhỏ trước khi gửi cho AI,
số lần AI được gọi công cụ và các chủ đề AI được phép trả lời. Các cài đặt
ở đây áp dụng chung cho mọi dịch vụ AI và mọi chat profile.
Mở trang cài đặt
- Đăng nhập trang quản trị bằng tài khoản có quyền quản lý cài đặt.
- Mở menu EzyAI → Cài đặt (
/ezyai/settings). - Sửa các trường cần thay đổi, bấm Lưu hoặc nhấn
Ctrl + S(Cmd + Strên macOS).
Cài đặt có hiệu lực ngay ở lượt chat tiếp theo, không cần khởi động lại
hệ thống.
Các cài đặt tác động ở đâu
flowchart LR
U["Người dùng<br/>gửi tin nhắn"] --> TG["Giới hạn chủ đề<br/>Chủ đề được phép<br/>Thông báo từ chối"]
TG --> AI["AI"]
AI -->|"gọi tool tìm kiếm<br/>(tối đa: Số lần tương tác tool)"| S["Tìm kiếm kiến thức<br/>Loại dữ liệu kiến thức<br/>Loại bài viết kiến thức<br/>Giới hạn tìm kiếm"]
S --> C["Chia đoạn kiến thức<br/>Độ dài tối đa<br/>Độ dài trích đoạn<br/>Ký tự tách đoạn, regex tách câu"]
C -->|"các đoạn liên quan"| AI
AI --> R["Câu trả lời"]
Bảng tổng hợp:
| Nhóm | Cài đặt | Mặc định |
|---|---|---|
| Nguồn kiến thức | Loại dữ liệu kiến thức | ezyarticle_posts, ecommerce_products |
| Loại bài viết kiến thức | WIKI, LIBRARY, FAQ, POST, BLOG, NEWS | |
| Tìm kiếm | Giới hạn tìm kiếm dữ liệu tri thức | 10 |
| Giới hạn tìm kiếm dữ liệu index | 15 | |
| Công cụ | Số lần tương tác tool tối đa | 2 |
| Chia đoạn | Độ dài tối đa của đoạn kiến thức | 600 ký tự |
| Độ dài trích đoạn của đoạn kiến thức | 160 ký tự | |
| Ký tự phân tách đoạn văn | dòng trống (nn) | |
| Mẫu regex phân tách câu | (?<=[.!?])s+ | |
| Giới hạn chủ đề | Chủ đề được phép | trống (tắt) |
| Thông báo từ chối khi ngoài chủ đề | câu từ chối mặc định bằng tiếng Anh |
Các cài đặt về kiến thức chỉ có tác dụng khi chat profile được gắn kỹ năng
cho phép dùng tool tìm kiếm (
search_knowledge_data_list,search_knowledge_data_by_type_and_id). XemNguồn kiến thức
Loại dữ liệu kiến thức
Danh sách loại dữ liệu mà AI được tra cứu, phân tách bằng dấu phẩy.
| Giá trị | Dữ liệu |
|---|---|
ezyarticle_posts | Bài viết của ezyarticle |
ecommerce_products | Sản phẩm của ecommerce |
- Bỏ
ecommerce_productsnếu không muốn AI tư vấn sản phẩm, ví dụ chatbotchỉ hỗ trợ kỹ thuật. - Plugin khác có thể cung cấp thêm loại dữ liệu, khi đó nhà phát triểnplugin sẽ cho biết giá trị cần thêm vào đây.
Loại bài viết kiến thức
Danh sách loại bài viết của ezyarticle được dùng làm kiến thức, phân tách
bằng dấu phẩy, ví dụ
WIKI,LIBRARY,FAQ.- Chỉ bài viết đã xuất bản và thuộc các loại trong danh sách mới đượcAI tìm thấy.
- Thu hẹp danh sách để AI chỉ trả lời từ nội dung chính thống, ví dụ chỉgiữ
WIKI,FAQvà bỏNEWS,BLOGđể tránh trả lời theo tin tức cũ. - Cài đặt này chỉ có tác dụng khi Loại dữ liệu kiến thức có
ezyarticle_posts.
Tìm kiếm
Giới hạn tìm kiếm dữ liệu tri thức
Số đoạn kiến thức tối đa trả về cho AI ở mỗi lần tìm, khi AI không tự chỉ
định số lượng.
- Tăng lên khi câu trả lời hay thiếu thông tin.
- Giảm xuống để câu trả lời nhanh hơn và tốn ít token hơn.
Giới hạn tìm kiếm dữ liệu index
Số bản ghi tối đa được lấy ra từ chỉ mục tìm kiếm trước khi chọn lọc thành
các đoạn kiến thức. Giá trị thực tế dùng là số lớn hơn giữa cài đặt này và
số lượng AI yêu cầu.
- Nên đặt lớn hơn hoặc bằng Giới hạn tìm kiếm dữ liệu tri thức, để cóđủ ứng viên cho việc chọn lọc.
- Tăng lên khi kho dữ liệu lớn và AI hay bỏ sót bài liên quan.
Công cụ
Số lần tương tác tool tối đa
Số vòng AI được gọi công cụ (tìm kiếm, lấy chi tiết, ...) trong một lượt
trả lời. Hết số vòng này, AI buộc phải trả lời bằng những gì đã có.
| Giá trị | Phù hợp khi |
|---|---|
1 | Chỉ cần tìm một lần rồi trả lời, nhanh và tiết kiệm |
2 (mặc định) | Tìm danh sách rồi xem chi tiết một mục |
3 trở lên | Câu hỏi phức tạp cần tra nhiều nơi; câu trả lời chậm hơn và tốn nhiều token hơn |
Mỗi vòng là một lần gọi tới nhà cung cấp AI, nên số vòng càng lớn thì chi
phí và thời gian chờ càng tăng.
Chia đoạn kiến thức
Bài viết dài được chia thành nhiều đoạn nhỏ, chỉ những đoạn liên quan tới
câu hỏi mới được gửi cho AI. Cách này giúp giảm token và giúp AI tập trung
vào đúng nội dung.
flowchart LR
B["Bài viết"] --> L{"Dài hơn<br/>độ dài tối đa?"}
L -->|Không| ONE["Giữ nguyên 1 đoạn"]
L -->|Có| P["Tách theo<br/>ký tự phân tách đoạn văn"]
P --> P2{"Đoạn văn vẫn<br/>quá dài?"}
P2 -->|Không| G["Gộp các đoạn văn<br/>thành đoạn kiến thức"]
P2 -->|Có| SEN["Tách theo<br/>regex phân tách câu"]
SEN --> G
G --> EX["Mỗi đoạn có tiêu đề (1/n)<br/>và trích đoạn"]
Độ dài tối đa của đoạn kiến thức
Số ký tự tối đa của một đoạn. Bài viết dài hơn giá trị này sẽ được chia
nhỏ.
- Tăng lên (ví dụ
1000–1500) khi nội dung có nhiều bước liên tiếp vàbị cắt rời làm AI hiểu thiếu. - Giảm xuống (ví dụ
400) khi bài viết dài, chỉ một phần nhỏ liên quantới câu hỏi.
Độ dài trích đoạn của đoạn kiến thức
Số ký tự đầu của mỗi đoạn được dùng làm trích đoạn, hiển thị trong danh
sách kết quả tìm kiếm gửi cho AI.
Ký tự phân tách đoạn văn
Chuỗi dùng để nhận biết ranh giới giữa các đoạn văn. Mặc định là một dòng
trống. Để trống thì dùng giá trị mặc định.
Mẫu regex phân tách câu
Biểu thức chính quy dùng để tách một đoạn văn quá dài thành các câu. Mặc
định tách sau dấu
., !, ?.Chỉ nên đổi khi nội dung dùng dấu câu khác, ví dụ thêm dấu chấm của tiếng
Nhật, tiếng Trung:
(?<=[.!?。!?])s*. Regex sai cú pháp có thể làm việctìm kiếm kiến thức bị lỗi, hãy chat thử ngay sau khi đổi.
Giới hạn chủ đề
Dùng khi muốn chatbot chỉ trả lời trong phạm vi nhất định, ví dụ chatbot
bán hàng không trả lời các câu hỏi về chính trị, làm bài tập hộ hay viết
code.
Chủ đề được phép
Mô tả các chủ đề AI được phép trả lời, viết tự nhiên. Để trống để tắt
tính năng này.
Ví dụ:
- Sản phẩm, giá, khuyến mãi của cửa hàng - Đặt hàng, thanh toán, giao hàng, đổi trả - Hướng dẫn sử dụng sản phẩm đã mua
AI xét câu hỏi cùng với ngữ cảnh cuộc trò chuyện, nên câu hỏi nối tiếp như
"còn màu khác không?" vẫn được trả lời bình thường.
Thông báo từ chối khi ngoài chủ đề
Câu AI dùng để từ chối khi câu hỏi nằm ngoài chủ đề hoặc không phù hợp. AI
trả lời bằng câu tương tự, có thể diễn đạt lại cho tự nhiên. Mặc định là:
Sorry, I can only provide assistance on the topics configured for this assistant.
Nên đổi sang tiếng Việt nếu người dùng chủ yếu nói tiếng Việt, ví dụ:
Xin lỗi, mình chỉ có thể hỗ trợ các câu hỏi về sản phẩm và đơn hàng của cửa hàng.
Giới hạn chủ đề là chỉ dẫn gửi cho AI, giúp giảm phần lớn câu trả lời lạc
đề nhưng không đảm bảo tuyệt đối.
Gợi ý cấu hình theo tình huống
| Tình huống | Gợi ý |
|---|---|
| Chatbot tư vấn bán hàng | Giữ ecommerce_products; chủ đề được phép là sản phẩm, đơn hàng; số lần tương tác tool 2 |
| Chatbot hỗ trợ kỹ thuật từ tài liệu | Chỉ giữ ezyarticle_posts; loại bài viết WIKI,FAQ,LIBRARY; tăng độ dài tối đa của đoạn lên 1000 |
| Muốn trả lời nhanh, tiết kiệm chi phí | Số lần tương tác tool 1; giới hạn tìm kiếm dữ liệu tri thức 5 |
| Kho bài viết lớn, AI hay bỏ sót | Tăng giới hạn tìm kiếm dữ liệu index lên 30–50 |
Câu hỏi thường gặp
Thay đổi cài đặt có ảnh hưởng tới cuộc trò chuyện đang diễn ra không?
Có, cài đặt mới được áp dụng từ tin nhắn tiếp theo.
Có thể cài đặt khác nhau cho từng chat profile không?
Không, các cài đặt ở trang này dùng chung. Để AI của từng profile hành xử
khác nhau, dùng kỹ năng AI gắn riêng cho từng profile.
Để trống một ô số thì sao?
Không nên để trống hoặc nhập
0 cho các ô số. Giá trị 0 có thể khiến AIkhông tìm được kiến thức hoặc không gọi được công cụ nào. Muốn quay về mặc
định, nhập lại giá trị mặc định trong bảng tổng hợp ở trên.
AI vẫn trả lời lạc đề dù đã bật giới hạn chủ đề?
Mô tả chủ đề cụ thể hơn và bổ sung chỉ dẫn trong kỹ năng AI của profile,
ví dụ "Chỉ trả lời dựa trên dữ liệu tìm được".