◈ VisioMind AI Hub
HELP / QUẢN TRỊ HỆ THỐNG

Hiểu cài đặt.
Vận hành đúng.

Tra cứu ý nghĩa, mặc định, giới hạn và cách kiểm chứng từng thay đổi trong VisioMind AI Hub.

53 tham số quản trị47 tham số khởi độngMCP & QVI local

Hỗ trợ tiếng Việt có dấu hoặc không dấu. Có thể dùng Ctrl+F để tìm trong trang.

Đọc và áp dụng cấu hình

Trang này là tài liệu tham chiếu. “Mặc định trong mã” không phải giá trị đang chạy: biến môi trường/.env và bản ghi đè trong cơ sở dữ liệu có thể khác.

Thứ tự cấu hình: mặc định trong config.py → môi trường/.env lúc khởi động → bản ghi đè app_settings do quản trị lưu. Giá trị môi trường tiến trình có thể ưu tiên hơn .env. Reset ↺ bỏ ghi đè và nạp lại giá trị gốc môi trường/.env, không bắt buộc trở về con số in trong Help.

Ở Cấu hình hệ thống, thay ô rồi rời ô sẽ gửi thay đổi (gộp trong khoảng 600 ms); chờ thông báo thành công/lỗi. Các panel Model, MCP, QVI có nút Lưu riêng. Tham số được chấp nhận áp dụng cho yêu cầu mới trong tiến trình Hub; không khởi động lại để chữa một giá trị chưa lưu.

Cấu hình hạ tầng như host allowlist, node cluster, đường dẫn DB và bí mật khởi động cần sửa môi trường/.env rồi restart Hub. Nếu vận hành nhiều process, không giả định một PATCH cập nhật bộ nhớ mọi process; đồng bộ/khởi động lại các worker theo cách triển khai.

  1. Ghi giá trị hiện hành và mục tiêu đo trước khi đổi.
  2. Đổi một nhóm liên quan, chờ lưu thành công.
  3. Thử với cùng dữ liệu/câu hỏi; xem log, độ trễ, nguồn và kết quả.
  4. Nếu không cải thiện, khôi phục giá trị đã ghi hoặc dùng Reset theo đúng ý nghĩa môi trường/.env.

Tài khoản, model và quyền tính năng

Quản trị yêu cầu tài khoản is_admin. Quyền tính năng từng user, giới hạn model và quyền sản xuất theo line là các lớp riêng. Tạo/reset tài khoản và xem hội thoại nhạy cảm yêu cầu mật khẩu riêng theo giao diện.

Tài khoản mặc định được dùng mọi model nếu chưa bật giới hạn. Khi bật giới hạn, chọn đủ model cần dùng; DEFAULT_MODEL toàn cục vẫn dùng được cho mọi người. Quyền gọi @AI trong nhóm là group_ai; model riêng trong nhóm ưu tiên lựa chọn chung khi phù hợp. Khi admin giới hạn model cho nhóm chat (panel Model trong nhóm chat), chỉ các model đó trả lời trong nhóm, bất kể giới hạn model của từng người.

Nhắn tin & nhóm chat (quyền messaging) MẶC ĐỊNH TẮT, kể cả với tài khoản có từ trước khi cập nhật: chưa được bật thì người dùng không thấy mục Tin nhắn, mọi API nhắn tin trả 403, không xuất hiện trong danh bạ nhắn tin của người khác và không được thêm vào nhóm. Admin luôn có quyền. Bật cho từng người ở Quản lý tất cả → Tính năng, hoặc tick sẵn trong Quyền cấp cho tài khoản mới.

Nút Thu hồi quyền tất cả (panel Người dùng gần đây) tắt MỌI tính năng và bỏ mọi model đã cấp của tất cả tài khoản không phải admin, xoá model riêng khi gõ @AI trong nhóm; tuỳ chọn xoá cả quyền theo line QVI. Model trả lời mặc định vẫn dùng được (sàn chung). Không đụng tới admin, mật khẩu, trạng thái duyệt hay dữ liệu. Cần gõ THU HOI và mật khẩu riêng; không hoàn tác được — cấp lại từng người ở Quản lý tất cả → Tính năng / Model.

Danh mục quyền tính năng hiện tại được liệt kê ở phần cuối trang và lấy từ mã nguồn. Bật quyền user không tự bật dịch vụ toàn cục hoặc cài model/driver.

Panel Quyền cấp cho tài khoản mới (mục Tài khoản & quyền) đặt sẵn những tính năng và model mà một tài khoản không phải admin được cấp ở lần duyệt ĐẦU: bấm Duyệt ở danh sách chờ, tự đăng ký khi đang tự động duyệt, hoặc admin tạo tài khoản với ô Đã duyệt. Mẫu tắt (mặc định) giữ hành vi cũ: duyệt là dùng được mọi tính năng và model. Tài khoản đã có và tài khoản bị thu hồi rồi duyệt lại không bị áp mẫu, nên quyền đã chỉnh riêng không bị ghi đè. DEFAULT_MODEL vẫn luôn dùng được dù không tick trong mẫu.

Trường / thao tácGiải thích
Tên đăng nhậpÍt nhất 3 ký tự khi thêm tài khoản; định danh đăng nhập, khác tên hiển thị.
EmailĐịa chỉ email của tài khoản; nhập đúng định dạng, kiểm tra lỗi trùng.
Mật khẩuÍt nhất 6 ký tự theo form; nhập mật khẩu riêng cho tài khoản, không dán token API.
Quyền adminCho phép quản trị toàn Hub; chỉ cấp cho người thực sự quản lý hệ thống.
Đã duyệt / phê duyệtQuyết định tài khoản mới có được dùng hay còn chờ duyệt.
Quyền cấp cho tài khoản mớiMẫu tính năng + model áp một lần khi tài khoản được duyệt lần đầu; sau đó chỉnh riêng từng người ở Quản lý tất cả → Tính năng / Model.
Trạng thái hoạt động / khóaVô hiệu hóa tài khoản chặn truy cập; không xem là thao tác xóa toàn bộ dữ liệu.
Mật khẩu xem hội thoạiKhác mật khẩu đăng nhập; mở khóa phiên audit trong thời hạn, mọi lần xem nội dung có audit log.

Cụm node và quản lý model

Cụm node thể hiện tình trạng backend, tài nguyên và model. Danh sách model có sẵn khác model đang nạp trong bộ nhớ. Node offline không được chữa bằng việc đổi DEFAULT_MODEL sang một tên không tồn tại.

Chọn node đích trước khi tải/nạp/gỡ model. Pull tải dữ liệu model; Load nạp bộ nhớ; Unload giải phóng bộ nhớ; Delete xóa model ở node được chọn. Cùng tên có thể có ở nhiều node. Các thao tác hỗ trợ tùy backend; LM Studio quản lý tải/xóa qua ứng dụng của nó hoặc lms, và có thể JIT load khi nhận request.

Đo GPU/VRAM/queue khi chậm. Tăng context hoặc gọi rerank/memory nền có thể tăng tải dù chỉ một người đang chat. Đổi cụm OLLAMA_NODES cần restart vì cluster được tạo từ cấu hình khởi động.

Trường / thao tácGiải thích
Tên nodeNhãn trong cụm; dùng để xác định đúng máy đích.
typeollama / lmstudio / vllm; khai rõ khi dùng cổng không mặc định.
urlBase URL máy chủ backend, nhìn từ máy Hub; loopback là máy Hub.
tagsDanh sách khả năng/nhóm như general, vision, code để cấu hình tuyến phù hợp.
api_keyTùy chọn cho node có xác thực; lưu bằng cấu hình bảo vệ, không đưa vào ví dụ Help.
Model mặc địnhChọn ID đang online, ai cũng dùng được; lưu bằng nút riêng.

Nhà cung cấp AI qua API

Panel Nhà cung cấp AI hỗ trợ loại provider theo preset sẵn có. API key được mã hóa khi lưu; UI chỉ hiển thị dạng che. Sau khi lưu, bấm Nạp model để cập nhật danh sách rồi thử một câu hỏi ngắn.

Base URL phải theo API tương thích của provider, không phải địa chỉ trang web đăng nhập. Danh sách model và khả năng phụ thuộc tài khoản/provider. Thao tác nạp model không phải huấn luyện hoặc tải trọng số về Hub. Khi lỗi, kiểm tra key, URL, quota/quyền ở tài khoản nhà cung cấp và log.

Trường / thao tácGiải thích
LoạiChọn đúng preset/giao thức API.
Tên hiển thịPhân biệt các cấu hình cùng provider.
Base URLĐể trống dùng mặc định preset. Custom gateway phải hỗ trợ giao thức tương ứng.
API KeyBí mật xác thực của provider; sửa theo quy trình form, không chép giá trị đã che thành key mới.
Model mặc địnhID tùy chọn của provider, phải thực sự được phục vụ.
BậtCho phép cấu hình tham gia sử dụng; tắt không đồng nghĩa hủy tài khoản nhà cung cấp.

Nguồn dữ liệu MCP: giải thích từng trường

Nguồn MCP cho phép Hub gọi những tool đã khai rõ. Allowlist là điều kiện bắt buộc; thêm tên vào danh sách không tạo tool bên server. Transport hiện hỗ trợ streamable-http.

MCP_ALLOWED_HOSTS ở môi trường/.env kiểm soát host đích. Local có thể khai 127.0.0.1,localhost rồi restart Hub. HTTP chỉ cho loopback; nguồn ngoài loopback yêu cầu HTTPS. Không dùng 0.0.0.0 như URL đích.

Với nguồn thường, token là bí mật xác thực theo nguồn. Với QVI, token là khóa ký dùng để Hub phát JWT ngắn hạn theo user/line; không phải Bearer tĩnh gửi khóa thô. Giá trị token lưu bằng giao diện được mã hóa; nguồn có thể đọc biến môi trường token_env. Không đổi SECRET_KEY tùy ý vì nó liên quan khóa mã hóa của Hub.

Bấm Thử sau khi lưu. Nguồn QVI cần đăng ký instance và quyền line để probe có ký; nếu một nguồn gắn nhiều instance, dùng Thử từng QVI để tránh định tuyến mơ hồ. Đọc danh sách tool thiếu và lỗi xác thực thay vì chỉ xem server có online.

Trường / thao tácGiải thích
id2…64 ký tự; a-z, 0-9, _ và -, bắt đầu bằng chữ/số; được chuẩn hóa chữ thường. Ví dụ qvi-local.
nameTên hiển thị 1…128 ký tự.
urlhttp(s)://host:port/mcp; bắt buộc hậu tố /mcp. URL ngoài loopback dùng https.
token_envTên biến viết hoa, kết thúc _TOKEN; ví dụ QVI_LOCAL_SIGNING_TOKEN. Đây là tên biến, không phải giá trị khóa.
TokenGiá trị bí mật để lưu mã hóa. Để trống khi dùng biến môi trường; không dán chữ đã che từ UI.
tool_allowlist1…100 tên duy nhất; ký tự chữ/số/._-; mỗi tên tối đa 128 ký tự. Giao diện nhập cách nhau dấu phẩy. Dùng mẫu QVI để lấy đủ tên.
timeoutGiây. Schema nguồn: >0…300; ô giao diện nhập từ 1. Mặc định nguồn 8; mẫu QVI 145 để bao test deadline 130.
enabledBật nguồn để định tuyến. Tắt chặn lời gọi mới, không dừng production Runtime.
expected_schema_versionTùy chọn trong định nghĩa nguồn, tối đa 32 ký tự; đối chiếu schema khi nguồn có khai yêu cầu.

QVI local: đăng ký, quyền và phê duyệt

Ví dụ local: Hub http://127.0.0.1:8000; QVI Runtime http://127.0.0.1:8080; QVI MCP http://127.0.0.1:8100/mcp. Cổng 8100 là MCP, 8080 là Runtime.

Ở QVI Manager: Runtime và MCP dùng cùng QVI_CONTROL_TOKEN; MCP dùng QVI_RUNTIME_URL trỏ về Runtime. QVI_MCP_SIGNING_KEY là khóa riêng ≥32 ký tự, khớp token nguồn QVI bên Hub. ID/line khớp từng ký tự. Khởi động Runtime trước rồi MCP.

Lưu quyền thay thế toàn bộ tập vai trò của user trên line được chọn. Bỏ hết tick là thu hồi. Admin toàn Hub vẫn cần grant line. Runtime tiếp tục độc lập khi Hub hoặc MCP dừng; đổi transport không tự dừng inspection.

DRAFT → VALIDATED → TESTED → APPROVED → DEPLOYING → DEPLOYED → RUNNING. AI có thể tạo/test nhưng không được approve/deploy. Người dùng mở Phê duyệt QVI, review đúng revision và xác nhận. Revision bị thay đổi/đã dùng/hết hạn không được âm thầm duyệt lại.

Patch cần base_version; bản đã duyệt/đang chạy cần clone. Rollback tạo DRAFT mới, không tự đổi production. Deploy timeout phải đọc runtime.status và audit theo request_id/approval_id để xác định kết quả; không tự retry hoặc chuyển CLI.

Thử kết nối đạt xác nhận đường điều khiển, quyền và catalog; chưa chứng minh model chat tạo đúng workflow, độ chính xác kiểm tra ảnh hoặc camera vật lý đã đạt. CLI MCP mặc định có simulation bindings; camera thật cần host cung cấp CameraManager/SDK.

  1. Tạo nguồn MCP bằng Dùng mẫu QVI, sửa ID/URL/token phù hợp.
  2. Thêm QVI, chọn nguồn và khai ID/line khớp server.
  3. Cấp tập quyền cho user theo line, kể cả admin đang sử dụng.
  4. Đặt transport=mcp, lưu và bấm Thử.
  5. Chọn line trong chat; thử đọc trạng thái trước, sau đó draft/validate/test trên ảnh mẫu.
  6. Review bằng chứng và revision trước khi xác nhận phê duyệt triển khai.
Trường / thao tácGiải thích
id QVI1…128 ký tự chữ/số/._-; bằng QVI_INSTANCE_ID. Ví dụ qvi-01.
Tên QVI1…128 ký tự, nhãn hiển thị.
line_id1…128 ký tự chữ/số/._-; bằng QVI_LINE_ID. Ví dụ Line01.
Tên line1…128 ký tự. Chỉnh cập nhật tên line được dùng chung.
source_idChọn nguồn MCP đã đăng ký; khác ID máy QVI.
Bật instanceCho phép định tuyến instance; nguồn MCP cũng phải bật.
QVI_TRANSPORTmcp thêm QVI của từng line qua MCP; cli chỉ dùng QVI mặc định trên máy chủ.
VIEWĐọc trạng thái/danh mục/workflow/lịch sử; một số diagnose thử thu ảnh.
OPERATEĐọc và start/stop Runtime, connect/disconnect camera theo chính sách.
EDITĐọc và sửa draft/validate/test/capture/trigger/tham số camera được cho phép.
APPROVEĐọc, duyệt và deploy với actor human; không bao gồm quyền EDIT.
ADMIN theo lineMọi nhóm quyền trong line đã cấp; không tự có quyền line khác.

Cơ sở tri thức, hàng đợi và Memory

Thêm tri thức bằng tiêu đề/nội dung hoặc tải tệp/ảnh. Tài liệu cần được xử lý và nhúng thành công trước khi có vector để tìm kiếm. Tiêu đề rõ giúp nguồn tham khảo dễ hiểu; không đưa mọi tài liệu dài vào SYSTEM_PROMPT.

Hàng đợi nạp tri thức thể hiện công việc pending/running/failed. Khi failed, đọc lỗi model nhúng/đọc ảnh/định dạng/quyền thư mục rồi mới retry. Bấm làm mới chỉ cập nhật hiển thị, không phải nhúng lại.

Sau khi đổi EMBED_MODEL, dùng Nhúng lại cho các tài liệu bị ảnh hưởng. Kiểm tra vài câu hỏi đã biết đáp án và xem nguồn trước khi dùng đại trà. Tuning thường theo thứ tự chất lượng tài liệu → embedding → candidates/top-k → rerank → threshold → ngân sách prompt.

Memory là ghi nhớ theo người dùng, khác tri thức dùng chung. Thống kê giúp phát hiện tăng nhanh hoặc ghi nhớ không phù hợp; tắt MEMORY_ENABLED/EXTRACT không xóa dữ liệu đã lưu. Chất lượng memory cần kiểm tra trên nội dung thực tế, không chỉ số lượng.

Theo dõi, sao lưu và xử lý lỗi

Theo dõi CPU/RAM/GPU, node và queue cùng thời điểm có triệu chứng. Online gần đây dựa trên hoạt động ghi nhận, không chứng minh người dùng đang nhìn màn hình. Log INFO/WARNING/ERROR hỗ trợ khoanh vùng; giữ thời điểm và request_id khi báo lỗi.

Sao lưu DB bằng cách nhất quán, .env/khóa và các thư mục dữ liệu: uploads, media, workspace, dữ liệu Analyst/Decision, QVI mặc định (qvi_default) và cấu hình Manager. Không đưa các dữ liệu này vào gói cập nhật nguồn.

Nâng cấp Hub bằng ghi đè bổ sung các file ứng dụng. Giữ cấu hình và dữ liệu cũ; restart tiến trình có chủ quản, kiểm tra /health và các tính năng chính. Reset một setting khác với xóa DB hoặc khôi phục toàn bộ hệ thống.

Trường / thao tácGiải thích
401 / 403Đăng nhập, trạng thái tài khoản, is_admin, phiên audit và các lớp quyền riêng. Với QVI kiểm tra thêm khóa ký/ID/line/actor.
429Rate limit Hub hoặc backend quá tải; xem cửa sổ/request và Retry-After nếu có.
Model offline / không thấy modelKiểm tra node, provider Bật, nạp danh sách, giới hạn model và DEFAULT_MODEL.
RAG không trả nguồnKiểm tra KB_ENABLED/quyền, trạng thái nhúng, model vector, ngưỡng và nội dung câu hỏi.
QVI CAPABILITY_NOT_AVAILABLETransport còn cli, thiếu allowlist hoặc server chưa có tool.
QVI_OFFLINE / CAMERA_OFFLINEKiểm tra URL/token/Runtime; camera thiếu driver/manager khác với MCP offline.
WORKFLOW_VERSION_CONFLICTĐọc revision mới và diff; không ghi đè bản cũ mù.
RUNTIME_BUSYĐợi inspection rảnh hoặc dừng nhận chu kỳ theo quy trình.
Deploy TIMEOUTKết quả chưa rõ; đọc Runtime/audit trước khi quyết định thao tác tiếp.

Tham số quản trị có thể lưu qua giao diện

Giới hạn và mặc định lấy từ khai báo cùng phiên bản đang phục vụ Help. Bước nhập hướng dẫn ô số; máy chủ kiểm tra kiểu và khoảng, không phải mọi tổ hợp liên quan đều được kiểm tra tự động.

Tài khoản · Cấu hình hệ thống

Tự động đăng xuất khi không hoạt động (phút)

IDLE_LOGOUT_MINUTES
Mặc định trong mã
60
Kiểu / giới hạn
int · Min: 0 · Max: 1440 · Bước nhập: 5

Đơn vị phút. Giảm để giới hạn phiên trên máy dùng chung; tăng cho ca thao tác dài. 0 tắt bộ đếm không hoạt động nhưng không thay tuổi thọ JWT. Thử bằng một phiên trình duyệt riêng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Tài khoản · Cấu hình hệ thống

Yêu cầu admin phê duyệt tài khoản mới

REQUIRE_APPROVAL
Mặc định trong mã
false — Tắt
Kiểu / giới hạn
bool · Bật / tắt

Bật khi cần kiểm soát tài khoản mới. Tài khoản cũ không bị thu hồi. Ô “Tự động duyệt tài khoản mới” có ý nghĩa đảo ngược: bật tự duyệt tương ứng REQUIRE_APPROVAL=false.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Chống spam · Cấu hình hệ thống

Bật chống spam

RATE_LIMIT_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật giới hạn request theo tài khoản. Khi bị 429, xem lưu lượng và cửa sổ trước khi tắt; tệp/ảnh/video tự tải không tính như thao tác API thông thường.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Chống spam · Cấu hình hệ thống

Số request tối đa mỗi cửa sổ

RATE_LIMIT_REQUESTS
Mặc định trong mã
300
Kiểu / giới hạn
int · Min: 30 · Max: 10000 · Bước nhập: 10

Đơn vị request/cửa sổ/người dùng. Tăng khi nhiều thao tác hợp lệ bị giới hạn; giảm để hạn chế spam. Mốc 300/60 giây là mặc định phần mềm, cần đo theo số thao tác thực tế.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Chống spam · Cấu hình hệ thống

Độ dài cửa sổ (giây)

RATE_LIMIT_WINDOW
Mặc định trong mã
60
Kiểu / giới hạn
int · Min: 5 · Max: 3600 · Bước nhập: 5

Đơn vị giây của cửa sổ trượt. Kết hợp với RATE_LIMIT_REQUESTS: 300 và 60 nghĩa tối đa 300 request trên 60 giây gần nhất; đổi một giá trị sẽ đổi mức thông lượng cho phép.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Nguồn dữ liệu MCP · Panel chuyên dụng

Danh sách nguồn MCP (JSON)

MCP_DATA_SOURCES
Mặc định trong mã
(trống)
Kiểu / giới hạn
text · Tối đa 4000 ký tự

Quản lý trong panel Cơ sở dữ liệu MCP, không dán JSON vào ô cấu hình chung. Mỗi nguồn có ID, URL, token_env, allowlist, timeout và trạng thái bật riêng; xem phần MCP bên dưới.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Nguồn dữ liệu MCP · Panel chuyên dụng

Token nguồn MCP (đã mã hoá)

MCP_SOURCE_TOKENS
Mặc định trong mã
(trống)
Kiểu / giới hạn
text · Tối đa 4000 ký tự

Kho token mã hóa do panel MCP quản lý. Không nhập ciphertext thủ công. Với nguồn QVI, giá trị gốc là khóa ký QVI; API trạng thái chỉ thể hiện có/không có token, không trả khóa rõ.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

RAG Gate · Cấu hình hệ thống

Bật lớp quyết định RAG

ENABLE_RAG_GATE
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật: bỏ truy hồi cho câu hỏi phù hợp kiến thức chung, rồi đánh giá điểm ngữ cảnh sau truy hồi. Tắt gate không tắt KB; muốn tắt tri thức toàn cục dùng KB_ENABLED. So sánh trên cùng bộ câu hỏi.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

RAG Gate · Cấu hình hệ thống

Ngưỡng tương đồng

RAG_SIMILARITY_THRESHOLD
Mặc định trong mã
0.6
Kiểu / giới hạn
float · Min: 0 · Max: 1 · Bước nhập: 0.01

Điểm 0…1 không phải phần trăm độ chính xác. Tăng lọc ngữ cảnh yếu mạnh hơn nhưng có thể bỏ đoạn đúng; giảm tăng độ bao phủ nhưng có thể thêm nhiễu. Đo top_score/nguồn tham khảo trên câu hỏi thật. Câu hỏi trực tiếp về tài liệu có ngoại lệ riêng ở RAG gate.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

RAG Gate · Cấu hình hệ thống

Số đoạn tối đa đưa vào prompt

MAX_RETRIEVED_DOCS
Mặc định trong mã
5
Kiểu / giới hạn
int · Min: 1 · Max: 20 · Bước nhập: 1

Trần số đoạn cuối đưa vào prompt sau xếp hạng/lọc. Tăng có thể bổ sung chứng cứ nhưng tốn token. Giảm nếu câu trả lời bị loãng; còn chịu ngân sách prompt và độ dài từng đoạn.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Model mặc định · Panel chuyên dụng

Model trả lời mặc định

DEFAULT_MODEL
Mặc định trong mã
llama3
Kiểu / giới hạn
str · Tối đa 200 ký tự

Đổi tại Quản lý Model, chọn model đang online. Đây là model dùng được cho mọi người kể cả tài khoản bị giới hạn model; vì vậy chọn model có mức tài nguyên/chi phí chấp nhận được cho toàn hệ thống.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Nhóm chat · Panel chuyên dụng

Model mặc định khi gõ @AI trong nhóm

GROUP_AI_DEFAULT_MODEL
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Model dự phòng khi @AI trong nhóm, khi người dùng chưa có lựa chọn riêng hoặc nhắc model ngoài quyền. Trống dùng DEFAULT_MODEL. Đặt ở panel Model trong nhóm chat (mục Model & cụm node); khi nhóm đang giới hạn model thì phải chọn trong danh sách đó, trống = model đầu danh sách. Việc cho phép gọi AI trong nhóm là quyền tính năng group_ai riêng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Nhóm chat · Panel chuyên dụng

Model được phép trong nhóm chat

GROUP_AI_ALLOWED_MODELS
Mặc định trong mã
(trống)
Kiểu / giới hạn
text · Tối đa 4000 ký tự

Một hoặc vài model DUY NHẤT được trả lời trong nhóm chat, chọn ở panel Model trong nhóm chat (mục Model & cụm node). Trống = không giới hạn, theo quyền model của từng tài khoản. Có danh sách thì nó thay giới hạn model riêng của từng người bên trong nhóm (ai có quyền group_ai đều gọi được các model này); nhắc model khác thì model mặc định của nhóm trả lời thay và giao diện báo đã đổi. Gói cá nhân Claude/ChatGPT Subscription không bao giờ dùng được trong nhóm.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Truy hồi · Cấu hình hệ thống

Bật Cơ sở tri thức

KB_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật/tắt khả năng dùng cơ sở tri thức toàn cục. Tắt không xóa tài liệu hay vector đã lưu. Quyền RAG từng người vẫn là lớp kiểm tra riêng; tài liệu cần nhúng thành công mới truy hồi được.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Truy hồi · Cấu hình hệ thống

Top-K đoạn truy hồi

KB_TOP_K
Mặc định trong mã
5
Kiểu / giới hạn
int · Min: 1 · Max: 20 · Bước nhập: 1

Số đoạn giữ lại sau hợp nhất tìm vector và từ khóa. Nên không lớn hơn số ứng viên có thể lấy. Tăng để có thêm ngữ cảnh rồi quan sát nguồn và độ trễ; trần cuối còn chịu MAX_RETRIEVED_DOCS/prompt.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Truy hồi · Cấu hình hệ thống

Số ứng viên trước rerank

KB_CANDIDATES
Mặc định trong mã
20
Kiểu / giới hạn
int · Min: 5 · Max: 60 · Bước nhập: 1

Số ứng viên trước bước chọn/xếp hạng. Đặt ít có thể bỏ lỡ đoạn đúng; đặt nhiều tăng tải tìm kiếm/rerank. Thường cần ít nhất bằng KB_TOP_K; khoảng hợp lệ của từng ô không tự chứng minh tổ hợp tối ưu.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Reranker · Cấu hình hệ thống

Bật xếp hạng lại

RERANK_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật để LLM xếp lại ứng viên trước khi lấy ngữ cảnh cuối. Có thêm lời gọi model nên cần cân bằng độ trễ và chất lượng; tắt tạm để đối chiếu nút thắt tốc độ.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Reranker · Cấu hình hệ thống

Model dùng để rerank

RERANK_MODEL
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Dùng ID model có thể gọi được trong cụm. Trống dùng model chat hiện tại. Đây là rerank bằng LLM, không phải chọn tùy ý tên một embedding/cross-encoder rồi kỳ vọng cùng API.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Cho phép chế độ Agentic RAG

AGENTIC_RAG_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Cho phép chế độ Agentic RAG trong khung chat. Người dùng vẫn phải tự chọn chế độ cho từng lượt; tắt cờ này thì lượt chọn Agentic quay về RAG thường, các cuộc chat khác không đổi. Quyền theo tài khoản nằm ở tính năng "Agentic RAG".

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Nhánh truy hồi

RAG_RETRIEVAL_MODE
Mặc định trong mã
hybrid
Kiểu / giới hạn
str · Lựa chọn: hybrid, vector, keyword · Tối đa 200 ký tự

Nhánh truy hồi của retriever cho cả RAG thường và Agentic: hybrid gộp vector + từ khoá FTS5 (mặc định, nên giữ); vector chỉ ngữ nghĩa; keyword chỉ từ khoá. Dùng vector/keyword để đo so sánh hoặc khi model nhúng tạm không dùng được.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Dùng LLM lập kế hoạch và đánh giá

AGENT_LLM_PLANNING
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật: Agent dùng model để lập kế hoạch truy xuất và đánh giá bằng chứng (thêm khoảng 2 lời gọi LLM mỗi vòng). Tắt: chỉ dùng bộ lập kế hoạch tất định, không thêm lời gọi LLM nào ngoài câu trả lời cuối — nhanh hơn nhưng kém linh hoạt.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Model lập kế hoạch

AGENT_PLANNER_MODEL
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Model riêng cho bước lập kế hoạch/đánh giá của Agent, ví dụ một model nhỏ trả JSON tốt. Trống dùng chính model đang chat. Model khai ở đây vẫn phải nằm trong quyền dùng model của người dùng; không dùng được thì tự quay về model chat.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Số vòng truy xuất tối đa

AGENT_MAX_STEPS
Mặc định trong mã
3
Kiểu / giới hạn
int · Min: 1 · Max: 6 · Bước nhập: 1

Số vòng truy xuất tối đa của một lượt Agent (vòng đầu cộng các vòng bổ sung khi bằng chứng chưa đủ). Mỗi vòng có thể tốn một lời gọi LLM đánh giá. Tăng để tìm sâu hơn, đổi lại độ trễ; Agent còn dừng sớm khi vòng mới không thêm bằng chứng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Số lần gọi công cụ tối đa mỗi lượt

AGENT_MAX_TOOL_CALLS
Mặc định trong mã
8
Kiểu / giới hạn
int · Min: 1 · Max: 30 · Bước nhập: 1

Tổng số lần gọi công cụ (tìm tri thức, đồ thị, tệp dự án, MCP, Internet) trong một lượt. Là trần cứng chống lặp vô hạn và chống dội tải lên nguồn MCP; hết lượt thì Agent dừng với lý do tool_budget và trả lời bằng bằng chứng đã có.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Số truy vấn tri thức mỗi vòng

AGENT_MAX_QUERIES_PER_STEP
Mặc định trong mã
3
Kiểu / giới hạn
int · Min: 1 · Max: 6 · Bước nhập: 1

Số truy vấn tìm tri thức (kb_search) tối đa trong mỗi vòng: câu hỏi gốc luôn chạy trước, sau đó là các truy vấn viết lại/câu hỏi con. Tăng giúp phủ câu hỏi nhiều ý nhưng tốn thêm thời gian nhúng và truy hồi.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Trần thời gian pha Agent (giây)

AGENT_TIMEOUT_SECONDS
Mặc định trong mã
90.0
Kiểu / giới hạn
float · Min: 10 · Max: 600 · Bước nhập: 5

Trần thời gian của cả pha Agent trước khi sinh câu trả lời. Hết giờ không phải lỗi: Agent dừng, dùng bằng chứng đã thu và nói rõ trạng thái. Đặt theo tốc độ model cục bộ; model nghĩ dài (Qwen3) cần trần cao hơn.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Ngân sách token cho bằng chứng

RAG_MAX_CONTEXT_TOKENS
Mặc định trong mã
3000
Kiểu / giới hạn
int · Min: 500 · Max: 32000 · Bước nhập: 250

Ngân sách token (ước lượng) cho gói bằng chứng mà Agent đưa vào prompt. Bằng chứng xếp theo mức liên quan; phần vượt ngân sách không được đánh số nên không thể bị trích dẫn. Phải nhỏ hơn đáng kể so với PROMPT_MAX_TOKENS.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Ngưỡng độ phủ bằng chứng

RAG_MIN_EVIDENCE_THRESHOLD
Mặc định trong mã
0.5
Kiểu / giới hạn
float · Min: 0 · Max: 1 · Bước nhập: 0.05

Ngưỡng độ phủ thuật ngữ (0–1): tỉ lệ thuật ngữ chính của câu hỏi có mặt trong bằng chứng. Đây là chỉ số thô, KHÔNG phải xác suất câu trả lời đúng. Dưới ngưỡng thì Agent được phép truy xuất bổ sung; khi bật LLM đánh giá thì ý kiến của model được ưu tiên.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Tự đồng bộ tri thức dự án sau khi sửa tệp (giây)

PROJECT_KB_AUTOSYNC_SECONDS
Mặc định trong mã
20.0
Kiểu / giới hạn
float · Min: 0 · Max: 3600 · Bước nhập: 5

Dự án đã bấm "Lập chỉ mục" sẽ tự đồng bộ tri thức sau khi tệp được sửa trong IDE (tạo/sửa/xoá/đổi tên/tải lên/khôi phục phiên bản/AI sinh-sửa), sau khoảng yên lặng này; các lần sửa liên tiếp gộp làm một job bền vững. Chỉ tệp thật sự đổi được nhúng lại. 0 = tắt, chỉ đồng bộ khi bấm nút.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Agentic RAG · Cấu hình hệ thống

Lưu trace Agent

RAG_TRACE_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Lưu trace từng lượt Agent vào bảng agent_runs: phân loại, kế hoạch, công cụ đã gọi và kết quả theo mã, số vòng, số lời gọi, thời gian, lý do dừng. Không lưu nội dung bằng chứng; chuỗi tự do được che bí mật. Xem trace bằng nút "Xem trace" dưới câu trả lời.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Bật bộ nhớ dài hạn

MEMORY_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Cho phép dùng ghi nhớ dài hạn trong hội thoại. Tắt không phải thao tác xóa dữ liệu memory. Kiểm tra quyền memory của user và giới hạn prompt khi không thấy ghi nhớ được dùng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Tự trích xuất ghi nhớ

MEMORY_EXTRACT_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Cho phép công việc nền rút ghi nhớ sau câu trả lời. Tắt dừng cơ chế tự trích; không đồng nghĩa xóa hoặc vô hiệu mọi ghi nhớ cũ. Theo dõi tải model và chất lượng ghi nhớ tạo ra.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Lọc heuristic trước khi gọi LLM

MEMORY_EXTRACT_HEURISTIC
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Bật để lọc lượt ít dấu hiệu cần ghi nhớ trước khi gọi model; giảm tải GPU. Tắt sẽ phân tích nhiều lượt hơn, hữu ích khi kiểm tra thông tin bị bỏ sót nhưng tăng công việc nền.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Gom lô: gọi LLM mỗi N lượt

MEMORY_EXTRACT_EVERY_TURNS
Mặc định trong mã
3
Kiểu / giới hạn
int · Min: 1 · Max: 20 · Bước nhập: 1

Số lượt gom lô cho tín hiệu nhẹ. Tăng giảm tần suất gọi LLM; giảm giúp cập nhật sớm hơn. Thông tin mạnh như tên/nghề/sở thích vẫn có thể được trích ngay, nên đây không phải chu kỳ cứng cho mọi lượt.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Số ghi nhớ đưa vào prompt

MEMORY_TOP_K
Mặc định trong mã
8
Kiểu / giới hạn
int · Min: 1 · Max: 20 · Bước nhập: 1

Số ghi nhớ phù hợp tối đa đưa vào prompt. Tăng có thể giúp nhớ nhiều hơn nhưng lấy bớt ngân sách lịch sử/KB; kiểm tra nội dung thực tế có liên quan thay vì chỉ tăng số lượng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Bộ nhớ · Cấu hình hệ thống

Ngưỡng gộp ghi nhớ trùng nghĩa

MEMORY_DEDUPE_THRESHOLD
Mặc định trong mã
0.86
Kiểu / giới hạn
float · Min: 0.5 · Max: 1 · Bước nhập: 0.01

Ngưỡng tương đồng để gộp ghi nhớ. Tăng chỉ gộp các mục rất giống nhau; giảm dễ gộp hơn và có nguy cơ nhập nhầm hai ý khác nhau. Đánh giá trên ghi nhớ đã xem và giữ lịch sử thay đổi.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

QVI · Panel chuyên dụng

Đường điều khiển QVI

QVI_TRANSPORT
Mặc định trong mã
cli
Kiểu / giới hạn
str · Lựa chọn: cli, mcp · Tối đa 200 ký tự

Chỉnh tại Kết nối QVI. mcp thêm QVI của từng line đã đăng ký; cli chỉ dùng QVI mặc định trên máy chủ. Đổi áp dụng ngay và không tự dừng Runtime. Khi cli, API điều khiển QVI MCP trả CAPABILITY_NOT_AVAILABLE.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Suy nghĩ · Cấu hình hệ thống

Chế độ suy nghĩ

THINK_MODE
Mặc định trong mã
auto
Kiểu / giới hạn
str · Tối đa 200 ký tự

Giá trị sử dụng là auto hoặc off. auto yêu cầu thinking khi model Ollama hỗ trợ; off tắt yêu cầu đó. Không phải số token suy nghĩ và không bảo đảm mọi nhà cung cấp đều có cùng hành vi.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Prompt · Cấu hình hệ thống

Trần token cho prompt

PROMPT_MAX_TOKENS
Mặc định trong mã
6000
Kiểu / giới hạn
int · Min: 1000 · Max: 128000 · Bước nhập: 500

Ngân sách token dựng prompt. Tăng chỉ khi context và VRAM của model đáp ứng; chừa chỗ cho câu trả lời. Thử cùng câu hỏi dài để xem cảnh báo/nguồn trước khi kết luận tăng ngân sách cải thiện chất lượng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Prompt · Cấu hình hệ thống

Số tin nhắn lịch sử tối đa

PROMPT_MAX_HISTORY_MESSAGES
Mặc định trong mã
20
Kiểu / giới hạn
int · Min: 2 · Max: 100 · Bước nhập: 2

Trần số message lịch sử được đưa vào ngữ cảnh. Message không đồng nghĩa một cặp hỏi/đáp. Tăng giữ nhiều lịch sử hơn, nhưng token vẫn bị giới hạn bởi ngân sách tổng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Prompt · Cấu hình hệ thống

Ngưỡng cảnh báo cửa sổ ngữ cảnh

PROMPT_CONTEXT_WARN_RATIO
Mặc định trong mã
0.9
Kiểu / giới hạn
float · Min: 0.5 · Max: 1 · Bước nhập: 0.05

Tỷ lệ cảnh báo theo prompt token thực tế so với context window. 0.9 nghĩa cảnh báo từ 90%. Hạ để cảnh báo sớm; đây không phải lệnh tăng context của model hoặc ngưỡng cắt nội dung.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Prompt · Cấu hình hệ thống

Cửa sổ ngữ cảnh mặc định (dự phòng)

DEFAULT_CONTEXT_WINDOW
Mặc định trong mã
8192
Kiểu / giới hạn
int · Min: 1024 · Max: 1e+06 · Bước nhập: 1024

Số token context dùng làm mốc dự phòng khi không dò được từ model. Đặt theo model/server thực tế. Chỉ đổi cách tính cảnh báo, không tự cấu hình context window trên LM Studio/Ollama.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Prompt · Cấu hình hệ thống

System Prompt

SYSTEM_PROMPT
Mặc định trong mã
Xem mặc định đầy đủ
Bạn là VisioMind AI Hub — trợ lý AI chạy cục bộ. Trả lời chính xác, hữu ích, bằng ngôn ngữ của người dùng.
Bạn có thể trả lời MỌI loại câu hỏi bằng kiến thức sẵn có của mình: viết code, dịch thuật, giải thích khái niệm, gợi ý thực đơn, lập kế hoạch, sáng tạo nội dung...
Nếu có phần TRI THỨC được cung cấp và nó liên quan tới câu hỏi, hãy dùng và trích dẫn [Nguồn N]. Nếu không có hoặc không liên quan, cứ trả lời bình thường — KHÔNG được từ chối chỉ vì thiếu tài liệu. Chỉ nói không biết khi bạn thực sự không biết.
Khi bạn tạo NHIỀU file mã nguồn cho một dự án, hãy MỞ mỗi khối mã bằng cú pháp ```<ngôn ngữ> <đường-dẫn-file> (ví dụ: ```python app/main.py). Nhờ đó người dùng có thể bấm 'Tải project (.zip)' để tải toàn bộ file đúng cấu trúc thư mục.
Kiểu / giới hạn
text · Tối đa 4000 ký tự

Chỉ dẫn nền dùng rộng trong trả lời. Viết mục tiêu, ngôn ngữ và quy tắc nguồn rõ ràng; tránh đặt nội dung tri thức dài luôn lặp lại. Lưu bản cũ trước khi sửa và thử với vài tình huống tiêu biểu.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Nhúng · Cấu hình hệ thống

Model nhúng (embedding)

EMBED_MODEL
Mặc định trong mã
bge-m3
Kiểu / giới hạn
str · Tối đa 200 ký tự

ID model embedding, mặc định bge-m3 trong mã nguồn. Đổi model làm vector cũ không còn tương thích; nhúng lại tất cả tài liệu bị ảnh hưởng rồi thử truy hồi. Không dùng model chat làm embedding nếu backend không hỗ trợ.

Hiệu lực: Cần bấm 'Nhúng lại' cho tất cả tài liệu sau khi đổi.

Nhúng · Cấu hình hệ thống

Model vision đọc ảnh

KB_VISION_MODEL
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Model có khả năng đọc ảnh dùng khi nạp tri thức ảnh. Trống tự dò trong cụm. Đổi lựa chọn không tự viết lại nội dung OCR/vision đã lưu; nạp/nhúng lại dữ liệu cần cập nhật theo quy trình KB.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Bật AI Vision Agent

VISION_AGENT_ENABLED
Mặc định trong mã
true — Bật
Kiểu / giới hạn
bool · Bật / tắt

Cờ toàn cục cho AI Vision Agent: chat tạo thuật toán vision, tạo ứng dụng vision và tải cả dự án bằng QVI mặc định trên máy chủ. Quyền tính năng từng user là cấu hình riêng; tắt cờ thì mục “QVI mặc định (máy chủ)” biến khỏi ô QVI / Line.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Model mặc định cho Agent

VISION_AGENT_MODEL
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Model hiểu yêu cầu và lập workflow QVI (JSON). Trống dùng model mặc định của user. Chọn model tuân thủ schema và kiểm thử thực tế; endpoint online chưa chứng minh model chọn đúng tool/port của QVI.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Đường dẫn QVI mặc định

QVI_DEFAULT_PATH
Mặc định trong mã
auto
Kiểu / giới hạn
str · Tối đa 200 ký tự

QVI cài trên chính máy chạy Hub, không phải máy mở trình duyệt. Nhận thư mục QVI portable hoặc QVI.exe, thư mục release QVI (có portable, python, sdk: đủ build cả ứng dụng Python lẫn C#) hoặc mã nguồn QVI có .venv. auto = apps\QVI cạnh Hub trong gói ReleaseAll. Bấm Kiểm tra QVI mặc định để chạy thật và xem bộ công cụ build.

Hiệu lực: Áp dụng ngay cho các yêu cầu mới; không cần khởi động lại.

Vision Agent · Cấu hình hệ thống

Thư mục làm việc của QVI mặc định

QVI_DEFAULT_WORKDIR
Mặc định trong mã
./qvi_default
Kiểu / giới hạn
str · Tối đa 200 ký tự

Thư mục Hub giữ kho thuật toán riêng của từng người (u<id>/control) và ZIP dự án đã xuất. Là dữ liệu chạy: có trong sao lưu, không có trong gói phát hành. Đổi vị trí không tự chuyển dữ liệu cũ.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Thư mục dự án ứng dụng

QVI_DEFAULT_APPS_ROOT
Mặc định trong mã
(trống)
Kiểu / giới hạn
str · Tối đa 200 ký tự

Nơi QVI App Builder dựng và build dự án ứng dụng. Trống dùng mặc định của QVI (%LOCALAPPDATA%\QVI\apps) và bộ wheel đã chuẩn bị ở đó. Thư mục khác cần chuẩn bị wheel riêng (qvi app toolchain --prepare). Giữ đường dẫn ngắn vì giới hạn 260 ký tự của Windows.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Timeout mỗi thao tác QVI (giây)

QVI_DEFAULT_TIMEOUT
Mặc định trong mã
180.0
Kiểu / giới hạn
float · Min: 30 · Max: 1800 · Bước nhập: 10

Đơn vị giây cho một thao tác của QVI mặc định (đọc tool, tạo/sửa/kiểm tra/chạy thử workflow, dò thuật toán từ ảnh). Phải lớn hơn QVI_ASSISTANT_DEADLINE; không áp dụng cho build ứng dụng.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Timeout tạo ứng dụng (giây)

QVI_APP_BUILD_TIMEOUT
Mặc định trong mã
2400
Kiểu / giới hạn
int · Min: 300 · Max: 14400 · Bước nhập: 60

Đơn vị giây cho một lần tạo ứng dụng: sinh mã, cài phụ thuộc, test, đóng gói EXE, chạy thử. Ứng dụng Python đo được khoảng 3–4 phút; C# lâu hơn. Quá hạn thì build bị dừng và báo thất bại.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Vision Agent · Cấu hình hệ thống

Số ứng dụng build cùng lúc

QVI_APP_BUILD_CONCURRENCY
Mặc định trong mã
1
Kiểu / giới hạn
int · Min: 1 · Max: 4 · Bước nhập: 1

Số ứng dụng build cùng lúc trên máy chủ. Mỗi build chạy pip/PyInstaller/dotnet và tốn CPU, RAM, đĩa; yêu cầu vượt mức xếp hàng. Mỗi người chỉ có một build chạy một lúc.

Hiệu lực: Áp dụng cho yêu cầu mới sau khi lưu thành công.

Cấu hình khởi động liên quan đến quản trị

Các tham số hạ tầng thường dùng cùng panel quản trị. Các trang tính năng chuyên biệt có thể có cấu hình riêng ngoài phạm vi panel này.

MCP · Môi trường / .env

MCP_ALLOWED_HOSTS

Mặc định trong mã
(trống)

Danh sách host đích được cho phép, phân cách dấu phẩy. Local: 127.0.0.1,localhost; restart Hub sau khi đổi. Không phải URL và không nhập /mcp. Trống không áp thêm bộ lọc host này; quy tắc HTTPS ngoài loopback vẫn còn. Nên khai rõ host được phép khi triển khai.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

MCP · Môi trường / .env

MCP_DEFAULT_TIMEOUT

Mặc định trong mã
8.0

Timeout mặc định giây cho các đường gọi nguồn dùng giá trị chung; timeout riêng của định nghĩa nguồn có thể khác. QVI cần timeout bao test phù hợp.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Cụm model · Môi trường / .env

OLLAMA_BASE_URL

Mặc định trong mã
http://localhost:11434

URL node dự phòng khi không có danh sách OLLAMA_NODES hợp lệ. Loopback là máy Hub.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Cụm model · Môi trường / .env

OLLAMA_NODES

Mặc định trong mã
(trống)

JSON danh sách name/url/type/tags/api_key. Khai type ollama/lmstudio/vllm rõ ràng; config có cơ chế đoán theo cổng và fallback khi danh sách sai/rỗng.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Cụm model · Môi trường / .env

OLLAMA_TIMEOUT

Mặc định trong mã
300.0

Giây chờ sinh câu trả lời dài. Tăng chỉ khi backend khỏe và tác vụ cần thời gian; không sửa được URL sai hoặc model hết VRAM.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Cụm model · Môi trường / .env

CLUSTER_PROBE_INTERVAL

Mặc định trong mã
15.0

Giây giữa các vòng dò nền. Giảm cập nhật nhanh hơn nhưng tăng request quản lý; không phải timeout chat.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Máy chủ · Môi trường / .env

HOST

Mặc định trong mã
0.0.0.0

Địa chỉ bind nếu launcher sử dụng config này. Khi chạy uvicorn với --host rõ ràng, cờ CLI quyết định bind thực tế.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Máy chủ · Môi trường / .env

PORT

Mặc định trong mã
8000

Cổng nếu launcher sử dụng config này; cờ uvicorn --port có thể quyết định cổng thực tế.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Máy chủ · Môi trường / .env

DEBUG

Mặc định trong mã
true — Bật

Cờ debug ứng dụng; kiểm tra cách launcher triển khai. Không dùng thay cho quyền admin hoặc cấu hình log.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Máy chủ · Môi trường / .env

DATABASE_URL

Mặc định trong mã
sqlite+aiosqlite:///./database/visiomind.db

Chuỗi kết nối DB; đường SQLite tương đối tính từ thư mục chạy. Đổi không tự di chuyển dữ liệu. Sao lưu nhất quán trước khi migration.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Xác thực · Môi trường / .env

SECRET_KEY

Mặc định trong mã
Bí mật riêng của hệ thống; không dùng giá trị mẫu

Bí mật ký/mã hóa của Hub, phải thay mẫu mặc định khi triển khai thật. Giữ ổn định và sao lưu bảo vệ; đổi có thể làm phiên/token mã hóa cũ không còn đọc được. Help không hiển thị bí mật đang dùng.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Xác thực · Môi trường / .env

ALGORITHM

Mặc định trong mã
HS256

Thuật toán JWT được app cấu hình; không đổi tùy ý nếu các bộ phát/kiểm tra credential không thống nhất.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Xác thực · Môi trường / .env

ACCESS_TOKEN_EXPIRE_MINUTES

Mặc định trong mã
10080

Thời hạn JWT đăng nhập, phút; khác bộ đếm không hoạt động của trình duyệt.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Xác thực · Môi trường / .env

AUDIT_TOKEN_EXPIRE_MINUTES

Mặc định trong mã
20

Thời hạn phiên mở khóa xem hội thoại, phút; hết hạn cần xác thực mật khẩu riêng lại.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Xác thực · Môi trường / .env

CONV_LOCK_TOKEN_MINUTES

Mặc định trong mã
30

Thời hạn quyền mở khóa hội thoại có bảo vệ, phút; không phải thời gian giữ dữ liệu hội thoại.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Máy chủ · Môi trường / .env

CORS_ORIGINS

Mặc định trong mã
["*"]

Danh sách origin trình duyệt được cho phép. Origin gồm scheme/host/port, khác host allowlist MCP. Khai đúng frontend triển khai.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Dữ liệu · Môi trường / .env

LOG_DIR

Mặc định trong mã
./logs

Thư mục log, cần quyền ghi/dung lượng và chính sách lưu trữ của máy chủ.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Dữ liệu · Môi trường / .env

LOG_LEVEL

Mặc định trong mã
INFO

Mức log như INFO để theo dõi; DEBUG tăng chi tiết và dung lượng. Giữ log không chứa khóa trước khi gửi hỗ trợ.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Dữ liệu · Môi trường / .env

UPLOAD_DIR

Mặc định trong mã
./uploads

Thư mục tệp tải lên; đổi không tự chuyển file cũ.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Dữ liệu · Môi trường / .env

WORKSPACE_DIR

Mặc định trong mã
./workspace

Gốc dữ liệu project/workspace; sao lưu cùng DB vì DB có thể tham chiếu file.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Dữ liệu · Môi trường / .env

MAX_UPLOAD_SIZE

Mặc định trong mã
209715200

Giới hạn upload theo byte, không phải MB. Reverse proxy có thể đặt giới hạn nhỏ hơn ứng dụng.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

KB_CHUNK_TOKENS

Mặc định trong mã
400

Kích thước đoạn khi nạp tài liệu, ước lượng token. Quá nhỏ mất ngữ cảnh, quá lớn khó chọn đoạn liên quan; thay đổi cần xử lý lại tài liệu muốn cập nhật.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

KB_CHUNK_OVERLAP

Mặc định trong mã
70

Số token chồng lấn giữa đoạn; nên nhỏ hơn chunk size. Tăng giữ nối mạch nhưng tăng số vector/trùng nội dung.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

KB_MAX_CONTEXT_CHARS

Mặc định trong mã
8000

Trần ký tự cho khối KB. Có thể cắt ngữ cảnh dù top-k cho phép nhiều đoạn.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

EMBED_TIMEOUT

Mặc định trong mã
120.0

Giây chờ embedding. Đổi không thay tên model hoặc nhúng lại dữ liệu.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

RERANK_TIMEOUT

Mặc định trong mã
45.0

Giây chờ lời gọi rerank; quan sát backend khi câu hỏi thường bị chậm ở bước này.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Tri thức · Môi trường / .env

RERANK_MAX_CHARS

Mặc định trong mã
400

Trần ký tự mỗi đoạn gửi rerank. Đo trên dữ liệu thật để tránh cắt phần chứa thông tin quyết định.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Ngữ cảnh · Môi trường / .env

PROMPT_RESERVE_TOKENS

Mặc định trong mã
1200

Token dành cho câu trả lời khi tính ngân sách; phối hợp với PROMPT_MAX_TOKENS/context model.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Ngữ cảnh · Môi trường / .env

PROMPT_CONTEXT_PLACEMENT

Mặc định trong mã
user

user đặt ngữ cảnh cùng lượt câu hỏi; system đặt vào system prompt đầu. Không tự chèn system message giữa cuộc chat.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Ngữ cảnh · Môi trường / .env

OLLAMA_AUTO_NUM_CTX

Mặc định trong mã
true — Bật

Cho phép gửi num_ctx thích ứng theo prompt cho Ollama, trong trần được cấu hình; tăng context tiêu tốn VRAM.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Ngữ cảnh · Môi trường / .env

OLLAMA_NUM_CTX_MIN

Mặc định trong mã
4096

Ngưỡng dưới context yêu cầu, token; phối hợp MIN ≤ MAX và khả năng model.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Ngữ cảnh · Môi trường / .env

OLLAMA_NUM_CTX_MAX

Mặc định trong mã
16384

Trần context tự yêu cầu, token; không thể nâng giới hạn huấn luyện/khả năng server bằng một con số tùy ý.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Nhóm chat · Môi trường / .env

GROUP_AI_SERIALIZE

Mặc định trong mã
true — Bật

Chạy các lượt AI trong một nhóm lần lượt để giữ thứ tự và giảm tranh tài nguyên.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Nhóm chat · Môi trường / .env

GROUP_AI_CONTEXT_MESSAGES

Mặc định trong mã
400

Trần số message đọc làm ngữ cảnh nhóm; ngân sách token vẫn quyết định phần gửi model.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Nhóm chat · Môi trường / .env

GROUP_AI_MAX_TOKENS

Mặc định trong mã
16000

Ngân sách token cho AI nhóm; model nhỏ có thể cần giảm theo context/VRAM.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Nhóm chat · Môi trường / .env

SYSTEM_KNOWLEDGE_MAX_TOKENS

Mặc định trong mã
2000

Trần tri thức hệ thống luôn áp dụng; nên giữ gọn vì lặp lại trên nhiều request.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Memory · Môi trường / .env

MEMORY_EXTRACT_MODEL

Mặc định trong mã
(trống)

Model trích xuất ghi nhớ; trống dùng model chat. Khác model embedding và model rerank.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Memory · Môi trường / .env

MEMORY_MAX_PER_USER

Mặc định trong mã
500

Trần số ghi nhớ mỗi tài khoản; theo dõi chất lượng và chính sách dữ liệu trước khi tăng.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Memory · Môi trường / .env

MEMORY_MIN_SCORE

Mặc định trong mã
0.25

Ngưỡng điểm chọn ghi nhớ; tăng giảm ghi nhớ yếu nhưng có thể bỏ thông tin cần thiết.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Memory · Môi trường / .env

MEMORY_KEEP_HISTORY

Mặc định trong mã
5

Số giá trị cũ giữ cho mỗi ghi nhớ, phục vụ truy vết thay đổi.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

AGENT_TOOL_TIMEOUT

Mặc định trong mã
30.0

Trần thời gian (giây) của MỘT lần gọi công cụ Agent; công cụ quá giờ được ghi lỗi TOOL_TIMEOUT, Agent đi tiếp.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

AGENT_LLM_TIMEOUT

Mặc định trong mã
45.0

Trần thời gian (giây) của MỘT lời gọi LLM lập kế hoạch/đánh giá; quá giờ thì dùng kế hoạch/đánh giá tất định.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

AGENT_TRACE_RETENTION_DAYS

Mặc định trong mã
30

Số ngày giữ trace trong agent_runs; trace cũ hơn được dọn khi ghi trace mới. 0 = giữ mãi.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

KNOWLEDGE_FOLDERS

Mặc định trong mã
(trống)

JSON [{"id","path","title"}] các thư mục trên máy chủ được nạp vào tri thức chung (mã nguồn, README, tài liệu API, log). Chỉ đường dẫn khai ở đây mới đọc được.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

FOLDER_KB_MAX_FILE_BYTES

Mặc định trong mã
512000

Kích thước tối đa một tệp khi nạp thư mục; tệp lớn hơn bị bỏ qua và liệt kê trong báo cáo đồng bộ.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

FOLDER_KB_MAX_FILES

Mặc định trong mã
2000

Số tệp tối đa mỗi lần đồng bộ thư mục; vượt thì dừng quét và KHÔNG xoá tài liệu nào.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Agentic RAG · Môi trường / .env

FOLDER_KB_MAX_TOTAL_BYTES

Mặc định trong mã
64000000

Tổng dung lượng tối đa mỗi lần đồng bộ thư mục; vượt thì dừng quét và KHÔNG xoá tài liệu nào.

Sửa cấu hình khởi động rồi khởi động lại dịch vụ liên quan. Các khóa này không thuộc API Cấu hình hệ thống.

Danh mục quyền tính năng theo tài khoản

Bật/tắt ở Quản lý người dùng → Tính năng. Đây là quyền user; vẫn cần dịch vụ/cờ toàn cục tương ứng hoạt động.

KhóaChức năng
internet_searchTìm kiếm Internet
ragCơ sở tri thức (RAG)
projectTạo & dùng Project
memoryBộ nhớ dài hạn
image_genTạo ảnh (Stable Diffusion)
chartTạo biểu đồ bằng AI
analystPhân tích dữ liệu bằng AI
decisionDecision Logic Builder (Machine Vision)
graphVisionGraphRAG (Knowledge Graph)
skillsKỹ năng chuyên môn (Agent Skills)
videoAI Video (sinh video bằng AI)
sandboxWorkspace Sandbox (Runner có kiểm soát)
visionVision Inference (detect qua VisioMind Studio)
studioQuản lý VisioMind Studio (dataset / train / model)
vision_agentAI Vision Agent (chat tạo thuật toán, ứng dụng vision trên QVI)
line_anomalyDữ liệu bất thường 75 dây chuyền
messagingNhắn tin & nhóm chat (giao diện Tin nhắn)
group_aiGọi AI bằng @ trong nhóm chat
ai_gatewayAI Gateway (dùng model từ Claude Code / Codex CLI / Cline…)
graph_chatGraphRAG trong chat thường
agentic_ragAgentic RAG (truy xuất nhiều bước, có kiểm chứng bằng chứng)
sandbox_executeChạy mã trong Sandbox (quyền hệ điều hành của máy chủ — chỉ cấp cho người tin cậy)