AI Settings

Cấu hình nhà cung cấp AI (OpenAI/Gemini)—khóa API, model; cần quyền quản trị cài đặt và gói AI.

AI Settings (/setting/aitool) cấu hình các LLM provider mà tenant dùng cho cả module AI: API key, model, parameters mặc định.

AI Tools > AI Settings. Đường dẫn: /setting/aitool (mặc định tab General); đổi tab qua /setting/aitool/tab/{tên_tab}.

Chỉ người có quyền Cài đặt công ty / quản trị cài đặt mới vào được; menu chỉ hiện khi gói đã bật AI.

Tabs

<Tabs type="card" rootClassName="page-setting-tabs" destroyInactiveTabPane={true}>:

Tab	Nhãn	Khi nào có tab
`general`	Chung	Luôn có khi vào được trang
`openai`	OpenAI	Khi gói bật tích hợp OpenAI văn bản (`INTEGRATION_OPENAI_TEXT`)
`gemini`	Gemini	Khi gói bật tích hợp Gemini ảnh (`INTEGRATION_GEMINI_PHOTO`)

UI hiện chỉ bật 3 tab general, openai, gemini.

onChangeTab(newTab) → navigate(/setting/aitool/tab/{newTab}, {replace: true}) - URL sync với tab active.

useEffect set activeTab từ pathParams.tab để hỗ trợ deep-link.

SettingModel.getAiToolSchemas() định nghĩa các field cần lưu. Mỗi tab render UI cho subset của schema:

General: tên trợ lý AI (chat assistant name), model mặc định, default temperature, ...
OpenAI: API key (encrypted), model GPT (gpt-4o, gpt-4o-mini, gpt-3.5-turbo), Organization ID (optional), Base URL (override cho proxy/Azure OpenAI), max tokens default.
Gemini: API key, model (gemini-2.5-pro, gemini-2.5-flash, ...), project ID, region.

Submit qua SettingRepository.saveItems(SettingModel.buildSaveRequestItems(schemas, formData)).

<FormLayoutSectionButtons> - nút Lưu cài đặt floating cuối form.

Khi tenant đăng ký AI tier - paste API key OpenAI/Gemini lần đầu.
Đổi model default (vd downgrade từ gpt-4o sang gpt-4o-mini để giảm cost).
Cấu hình base URL cho Azure OpenAI hoặc OpenAI-compatible proxy (LiteLLM, OneAPI).
Đổi tên trợ lý AI (hiện trong AI Assistant Chat header).

Không thấy tab OpenAI / Gemini: gói chưa bật tích hợp tương ứng (OpenAI văn bản / Gemini ảnh).
Save thành công nhưng AI vẫn lỗi: API key sai/expire, hoặc base URL sai. Kiểm tra AI Request Log.
Đổi tab làm mất nội dung chưa lưu: giao diện có thể huỷ phần nhập ở tab cũ. Nên Lưu từng tab trước khi chuyển tab.
API key: hệ thống nên lưu mã hoá và chỉ hiển thị dạng masked khi đọc lại từ server.
Cờ AI_ASSISTANT (9003): dự phòng; tab chung vẫn có thể chứa tên trợ lý và thông số dùng cho Chat.

Mở trang và Lưu: người có quyền Cài đặt công ty và gói đã bật AI.
Tab OpenAI / Gemini: chỉ hiện khi gói bật đủ tích hợp tương ứng (xem bảng tab).