Cấu hình nâng cao

Sau khi điền xong Basic Info/Prompts/Model Config (xem Tạo agent riêng), các mục còn lại trong modal tạo agent đều để mặc định là dùng tốt - trang này giải thích từng mục để bạn biết khi nào nên chỉnh.

Knowledge Base

Chọn phạm vi Knowledge Base agent được phép tra cứu.

• Knowledge Bases - 3 lựa chọn:
  • All Knowledge Bases (mặc định) - agent tra cứu được mọi KB.
  • Selected Knowledge Bases - chỉ tra cứu các KB bạn chọn cụ thể, phù hợp khi muốn agent chỉ trả lời trong phạm vi hẹp.
  • No Knowledge Base - agent chỉ dựa vào kiến thức chung của model (và Web Search nếu bật), không tra cứu KB nào.
• Supported File Types - giới hạn agent chỉ tra cứu một số loại file nhất định trong KB đã chọn; để trống thì hỗ trợ mọi loại.
• Retrieve Only When Mentioned - mặc định tắt (tự tra cứu KB đã cấu hình cho mọi câu hỏi). Bật lên thì agent chỉ tra cứu khi người hỏi chủ động gắn KB bằng @ trong lúc chat.

Retrieval Strategy

Chỉ xuất hiện khi agent có gắn Knowledge Base — tinh chỉnh cách agent tìm và xếp hạng kết quả trong KB.

• Embedding Top K - số kết quả tối đa lấy về từ tìm kiếm vector (mặc định 10).
• Keyword Threshold - điểm liên quan tối thiểu để một kết quả tìm theo từ khoá được chấp nhận (mặc định 0.00 — không lọc).
• Vector Threshold - điểm tương đồng tối thiểu để một kết quả tìm theo vector được chấp nhận (mặc định 0.00 — không lọc).

Khi nào nên chỉnh?

Nếu agent trả lời lan man/lẫn thông tin không liên quan, thử tăng 2 ngưỡng threshold để lọc bớt kết quả yếu. Nếu agent trả lời thiếu ý, thử tăng Embedding Top K. Nếu không gặp vấn đề gì, cứ để mặc định.

Vì Model Config hiện bắt buộc chọn ReRank Model khi agent có tra cứu KB, mục này luôn hiện thêm hai trường Rerank Top K (mặc định 5) và Rerank Threshold (mặc định 0.0).

Nhóm ưu tiên FAQ luôn hiển thị, không riêng cho KB kiểu FAQ:

• Enable FAQ Priority - mặc định bật: câu trả lời từ FAQ được ưu tiên hơn tài liệu thường.
• Direct Answer Threshold - khi độ tương đồng giữa câu hỏi và một câu FAQ vượt ngưỡng này, dùng thẳng câu trả lời FAQ đó (mặc định 0.90).
• FAQ Score Boost - hệ số nhân thêm vào điểm liên quan của kết quả FAQ để xếp hạng ưu tiên hơn (mặc định 1.2x).

Web Search

Cho phép agent tự tìm kiếm trên internet khi cần thông tin mới/không có trong Knowledge Base.

• Web Search - mặc định tắt.
• Search Engine - chọn nhà cung cấp tìm kiếm cụ thể; để trống dùng mặc định của workspace.
• Max Search Results - số kết quả tối đa lấy về mỗi lần tìm (mặc định 5).
• Auto-Fetch Page Content - mặc định tắt. Bật lên, agent sẽ tự mở và đọc nội dung đầy đủ của các trang kết quả hàng đầu (sau khi xếp hạng lại) thay vì chỉ dựa vào đoạn tóm tắt trong kết quả tìm kiếm - trả lời chính xác hơn nhưng chậm hơn.

Attachment Upload

Cấu hình việc người dùng gửi kèm ảnh/tài liệu/audio khi chat với agent.

• Image Upload - mặc định tắt. Bật lên cho phép gửi ảnh trong lúc chat; cần công ty đã cấu hình model VLM (model hiểu ảnh) thì agent mới thực sự "nhìn hiểu" được ảnh.
• Audio Upload - mặc định tắt.
• Attachment Parse Wait Timeout (s) - thời gian tối đa một lượt chat chờ tệp đính kèm phân tích xong trước khi trả lời chỉ với những tệp đã xong (0 = dùng mặc định hệ thống). Tăng lên nếu hay gửi file lớn/quét ảnh.
• Chat Attachment Parsing Policy - chọn engine phân tích riêng cho từng loại file (PDF, Word, Presentation, Excel...) đính kèm trong chat, tương tự Parser Engine của Knowledge Base - mặc định Built-in (Default) là dùng tốt.

Tools (chỉ ở chế độ Smart Reasoning)

Chọn những công cụ agent được phép tự gọi trong lúc suy luận. Đầu trang hiện số KB đang gắn (RAG/Wiki) và cảnh báo nếu có tool đang tick nhưng chưa đủ điều kiện dùng (ví dụ chưa gắn KB phù hợp).

6 nhóm công cụ:

• Basic - công cụ nền tảng, luôn dùng được: tự "suy nghĩ" từng bước (Thinking), lập kế hoạch nghiên cứu (Plan).
• Knowledge Retrieval (RAG) - tra cứu Knowledge Base thông thường: tìm theo từ khoá/ngữ nghĩa, xem nguyên đoạn trích, xem thông tin tài liệu, truy vấn Knowledge Graph, truy vấn dữ liệu bảng - cần KB đã bật chỉ mục vector/từ khoá.
• Wiki Read - tìm và đọc trang Wiki, đọc sâu tài liệu gốc, gắn cờ lỗi trên trang Wiki - cần KB đã bật Wiki.
• Wiki Edit (có cảnh báo "Mutates Wiki content" - công cụ có thể thay đổi dữ liệu) - tạo/ghi đè trang, thay thế đoạn văn bản, đổi tên trang, xoá trang Wiki.
• Wiki Review - xem và cập nhật trạng thái các cờ lỗi đã gắn trên trang Wiki.
• Data Analysis - phân tích file dữ liệu (CSV/Excel) và xem cấu trúc cột dữ liệu.

Cuối trang có mục Effective Tools - tổng hợp chính xác những công cụ agent thực sự dùng được với cấu hình hiện tại (tool nào chưa đủ điều kiện sẽ hiện gạch ngang kèm lý do), giúp bạn kiểm tra nhanh thay vì phải tự suy ra từ từng ô tick.

MCP Services

Kết nối agent với các dịch vụ MCP (Model Context Protocol) mà công ty đã cấu hình sẵn - mở rộng thêm khả năng ngoài công cụ dựng sẵn. Chỉ hiện ở chế độ Smart Reasoning.

• All — dùng mọi dịch vụ MCP công ty đã cấu hình.
• Selected — chỉ dùng dịch vụ bạn chọn cụ thể.
• Disabled (mặc định) — không dùng MCP nào.

Nếu không thấy dịch vụ MCP nào trong danh sách chọn, nghĩa là chưa cấu hình dịch vụ nào.