Trang 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

  1. Đăng nhập trang quản trị bằng tài khoản có quyền quản lý cài đặt.
  2. Mở menu EzyAI → Cài đặt (/ezyai/settings).
  3. Sửa các trường cần thay đổi, bấm Lưu hoặc nhấn Ctrl + S
    (Cmd + S trê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ómCài đặtMặc định
Nguồn kiến thứcLoại dữ liệu kiến thứcezyarticle_posts, ecommerce_products
Loại bài viết kiến thứcWIKI, LIBRARY, FAQ, POST, BLOG, NEWS
Tìm kiếmGiới hạn tìm kiếm dữ liệu tri thức10
Giới hạn tìm kiếm dữ liệu index15
Công cụSố lần tương tác tool tối đa2
Chia đoạnĐộ dài tối đa của đoạn kiến thức600 ký tự
Độ dài trích đoạn của đoạn kiến thức160 ký tự
Ký tự phân tách đoạn văndòng trống (nn)
Mẫu regex phân tách câu(?<=[.!?])s+
Giới hạn chủ đềChủ đề được phéptrố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). Xem

Nguồ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_postsBài viết của ezyarticle
ecommerce_productsSản phẩm của ecommerce
  • Bỏ ecommerce_products nếu không muốn AI tư vấn sản phẩm, ví dụ chatbot
    chỉ 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ển
    plugin 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 được
    AI 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,FAQ và 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
1Chỉ 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ênCâ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 quan
    tớ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ệc
tì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ốngGợi ý
Chatbot tư vấn bán hàngGiữ 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ệuChỉ 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ótTă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 AI
khô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".