Appearance
Cài đặt trí tuệ nhân tạo: khoá API và các khối AI
Cài đặt → Trí tuệ nhân tạo (/admin/settings/ai), tiêu đề trang Cài đặt trí tuệ nhân tạo.
Mọi cấu hình AI của tổ chức nằm trên một trang, chia thành nhiều tab (khối). Mỗi khối do một module nộp vào: module nào tắt thì khối đó biến mất. Trang này giải thích khoá API, cách đọc trang, và trỏ tới trang hướng dẫn chi tiết của từng khối.
Khoá Gemini là thứ phải có trước tiên. Không có nó, mọi khối còn lại chỉ là cấu hình cho những lời gọi không bao giờ thành công.
Ai dùng trang này
| Vai trò mặc định | Thấy khối nào |
|---|---|
Quản trị viên (admin) | Tất cả |
Người soạn khoá học (course_manager) | Hội thoại AI, AI Tạo Outline, AI Quiz Generator, AI viết nội dung, Phân tích bài thi, Chấm bài AI |
Marketing (marketer) | Tư vấn viên khóa học |
Quản trị đào tạo doanh nghiệp (hr_admin) | AI của kho tri thức |
Mỗi khối gác bằng một quyền configure_… riêng (cột Quyền ở bảng dưới). Người chỉ có quyền của vài khối thì chỉ thấy vài tab đó. Không có quyền nào thì mục Trí tuệ nhân tạo không hiện trong nhóm menu Cài đặt.
Khoá API, hạn mức và giọng đọc chỉ quản trị viên chỉnh được
configure_ai_keys, configure_ai_credits và configure_speech không được cấp cho vai trò nào ngoài quản trị viên: đổi chúng là đổi tiền của tổ chức. Muốn giao cho người khác thì cấp riêng ở Vai trò — xem Vai trò và phân quyền.
Khoá API
Tab đầu tiên, Khoá API (?tab=ai_keys), quyền configure_ai_keys.
| Ô | Ý nghĩa |
|---|---|
| Gemini API Key | Khoá của Google Gemini. Nuôi mọi tính năng AI của tổ chức: hội thoại, chatbot, lộ trình học cá nhân hoá, chấm bài tự động, sinh quiz, trợ lý tư vấn… |
Lấy khoá:
- Vào Google AI Studio (
aistudio.google.com/app/apikey) bằng tài khoản Google của tổ chức. - Tạo khoá API, sao chép.
- Dán vào ô Gemini API Key → Lưu.
Để trống thì hệ thống dùng khoá chung của nhà cung cấp dịch vụ. Nếu khoá chung cũng chưa có, mọi tính năng AI báo "chưa được cấu hình" thay vì chạy. Muốn biết tổ chức bạn đang chạy bằng khoá chung hay không, và chi phí của khoá chung được tính thế nào, hỏi nhà cung cấp dịch vụ.
Đổi khoá Gemini không cần lập lại chỉ mục, đổi khoá Pinecone thì có
Khoá Gemini chỉ dùng lúc gọi. Khoá Pinecone (kho vector của chatbot, trợ lý tư vấn và Hỏi kho tri thức) thì giữ dữ liệu đã lập chỉ mục. Ô Pinecone không nằm ở đây mà ở Cài đặt → Chatbot & Tư vấn AI — xem Chatbot học tập. Đổi Pinecone của tổ chức theo đúng thứ tự trong AI của kho tri thức → Tắt hẳn.
Hai khoá khác cũng không nằm ở tab này:
- Azure Speech (chấm phát âm): ở khối Giọng đọc — xem Giọng đọc và chấm phát âm.
- Pinecone: ở trang Chatbot & Tư vấn AI như trên. Trang đó có nút Khoá API dẫn ngược về tab này.
Các khối trên trang
Thứ tự dưới đây là thứ tự tab trên trang. Mở thẳng một tab bằng /admin/settings/ai?tab=<khoá>.
| Tab | Khoá | Module | Quyền | Hướng dẫn |
|---|---|---|---|---|
| Khoá API | ai_keys | (luôn có) | configure_ai_keys | mục trên |
| Hội thoại AI | ai_dialogue | CourseManagement | configure_ai_dialogue | — |
| AI Tạo Outline | ai_course_outline | CourseManagement | configure_ai_course_outline | Dùng AI soạn khoá học |
| Phân tích bài thi | ai_exam_feedback | AIExamFeedback | configure_ai_exam_feedback | — |
| AI Quiz Generator | ai_quiz | QuizGenerator | configure_ai_quiz | Dùng AI soạn khoá học |
| Chấm bài AI | ai_grading | AIGrading | configure_ai_grading | Chấm bài tự động |
| AI viết nội dung | ai_content | ContentGenerator | configure_ai_content | Dùng AI soạn khoá học |
| Tư vấn viên khóa học | ai_advisor | CourseAdvisor | configure_advisor | Trợ lý tư vấn |
| AI Lộ trình học tập | ai_roadmap | LearningRoadmap | configure_ai_roadmap | — |
| AI công cụ CV | ai_cv | CvBuilder | configure_ai_cv | Công cụ CV |
| Trợ lý lộ trình cho khách | ai_roadmap_funnel | RoadmapFunnel | configure_roadmap_funnel_ai | Trợ lý lộ trình AI |
| CV Reviewer | ai_cv_reviewer | CvReviewer | configure_cv_reviewer_ai | — |
| Hạn mức credits AI | ai_credits | AiCredits | configure_ai_credits | Credits AI |
| Giọng đọc | speech | SpeechServices | configure_speech | Giọng đọc và chấm phát âm |
| AI của kho tri thức | knowledge_ai | KnowledgeHub | configure_knowledge_hub | AI của kho tri thức |
Ô "—" ở cột cuối: khối đó chưa có trang hướng dẫn riêng; các ô trong khối có chú thích ngay trên giao diện.
Chatbot học tập không có tab ở đây: nó có trang riêng Cài đặt → Chatbot & Tư vấn AI, vì trang đó còn là nơi lập chỉ mục nội dung. Xem Chatbot học tập.
Chọn model
Phần lớn khối có bộ ô giống nhau: model, độ sáng tạo (temperature), độ dài tối đa của câu trả lời (max tokens), và với tính năng sinh nội dung, số lượt sinh tối đa mỗi giờ. Mỗi khối chọn model riêng — đổi model ở khối Chấm bài AI không đổi model của AI viết nội dung.
Đổi sang model mới: kiểm trang chi phí ngay sau đó
Bảng giá của hệ thống chỉ biết những model đã được khai. Dùng một model chưa có trong bảng thì lượt gọi vẫn chạy, nhưng chi phí hiện "Chưa định giá" — không phải 0 đồng. Sau khi đổi model, mở Báo cáo & Phân tích → Tổng quan sử dụng AI và xem có cảnh báo "chưa định giá" không. Chi tiết: Theo dõi chi phí AI.
Lưu
Một lần bấm Lưu ghi mọi khối bạn đang thấy, không chỉ tab đang mở. Hệ quả: một ô bắt buộc bị bỏ trống ở tab khác sẽ chặn cả lần lưu, và lỗi hiện ở tab đó. Gặp lỗi khi lưu mà tab đang mở trông ổn, hãy lướt qua các tab còn lại.
Hai loại "giá"
| Credits | Chi phí (USD) | |
|---|---|---|
| Là gì | Giá tổ chức bán cho người dùng | Giá tổ chức trả cho nhà cung cấp AI |
| Đặt ở đâu | AI → Giá credits theo tính năng, và khối Hạn mức credits AI | Do bảng giá của hệ thống tính theo model và lượng dùng |
| Đọc ở đâu | Ví của từng người — xem Credits AI | Theo dõi chi phí AI |
Câu hỏi thường gặp
Mọi tính năng AI báo "chưa được cấu hình". Tab Khoá API đang trống và tổ chức không có khoá chung. Điền Gemini API Key.
Một tính năng AI báo đang quá tải / tạm thời không khả dụng. Lỗi phía Google, thường tự hết sau ít phút. Người dùng không bị trừ credits cho lượt lỗi. Lặp lại liên tục nhiều giờ thì kiểm khoá (hết hạn mức của Google, khoá bị thu hồi) và báo nhà cung cấp dịch vụ.
Học viên báo "Tính năng AI này hiện đang tắt". Dòng của tính năng đó ở AI → Giá credits theo tính năng đang tắt. Xem Credits AI → Giá theo tính năng.
Không thấy một tab mà trang hướng dẫn nhắc tới. Hoặc module của khối đó chưa bật cho tổ chức, hoặc vai trò của bạn thiếu quyền configure_… tương ứng (bảng Các khối trên trang).