Khoá API và cài đặt AI

Cài đặt -> Trí tuệ nhân tạo trong khu quản trị (/admin).

Một số tính năng của hệ thống dùng AI của Google (Gemini), ví dụ hoạt động Hội thoại trong học liệu số và nút AI tạo outline khi soạn khoá học. Mọi tính năng đó đi qua một khoá API của trường.

Khoá API

Cài đặt -> Trí tuệ nhân tạo -> khối Khoá API -> ô Gemini API Key. Cần quyền configure_ai_keys; trong các vai trò có sẵn, chỉ quản trị viên có quyền này.

• Lấy khoá miễn phí tại Google AI Studio (aistudio.google.com/app/apikey) bằng tài khoản Google của trường, dán vào ô, Lưu.
• Để trống thì hệ thống dùng khoá chung của nhà cung cấp (nếu nhà cung cấp có cấu hình). Nếu cả khoá chung cũng không có, mọi tính năng AI báo chưa được cấu hình thay vì chạy.

Khoá của trường, tiền của trường

Khi dùng khoá riêng, lượng dùng và chi phí AI tính vào tài khoản Google của trường. Theo dõi chúng ở trang quản lý của Google (AI Studio hoặc Google Cloud) gắn với khoá đó. Mẫu Trường phổ thông không có màn hình theo dõi chi phí AI bên trong hệ thống.

Khoá miễn phí có hạn mức

Khoá miễn phí của Google giới hạn số lượt gọi theo phút và theo ngày. Cả trường dùng chung một khoá, nên một tiết học cả lớp cùng làm hoạt động Hội thoại có thể chạm trần. Khi đó học sinh thấy lỗi tạm thời; cần nâng hạn mức ở phía Google hoặc dùng khoá trả phí.

Cấu hình từng tính năng

Cùng trang Trí tuệ nhân tạo có các khối cấu hình model cho từng tính năng:

Khối	Dùng cho	Quyền
Hội thoại AI	Model, độ ngẫu nhiên (Temperature), số token tối đa của hoạt động Hội thoại	configure_ai_dialogue
AI Tạo Outline	Model và giới hạn của tính năng AI tạo cấu trúc khoá học khi soạn	configure_ai_course_outline

Hai quyền này có sẵn ở vai trò quản trị viên và người soạn học liệu số (course_manager).

Ô Model là mã định danh của model Gemini (ví dụ gemini-2.5-flash). Chỉ đổi khi bạn chắc khoá API của trường dùng được model đó; gõ sai tên model là tính năng tương ứng ngừng chạy.

Khi AI báo lỗi

Dấu hiệu	Thường do
Mọi tính năng AI báo chưa được cấu hình	Chưa có khoá API nào (cả của trường lẫn của nhà cung cấp)
Học sinh thấy "không kết nối được dịch vụ AI" trên mọi lượt	Khoá sai, khoá bị thu hồi, hoặc đã chạm hạn mức/trần chi tiêu ở phía Google. Kiểm tra khoá trong Google AI Studio trước
Lỗi lác đác, gửi lại thì được	Google quá tải tạm thời. Không cần làm gì
Một tính năng hỏng ngay sau khi sửa ô Model	Tên model sai hoặc khoá không dùng được model đó. Đổi về giá trị cũ