Tính năng AI

Trợ lý AI

Mỗi vai trò có system prompt riêng, nên trợ lý trả lời theo nhu cầu của người dùng.

// src/app/(dashboard)/layout.tsx: có trong mọi trang tổng quan
<ChatWidget />

// Tùy chọn: truyền ngữ cảnh khóa học và bài học
<ChatWidget context={{ courseId, courseName, lessonId, lessonTitle }} />

Chèn ngữ cảnh

Mỗi lần bạn gửi tin nhắn, LLM nhận:

1. System prompt theo vai trò của người dùng.
2. Tên khóa học và bài học hiện tại, nếu widget được truyền ngữ cảnh.
3. Tối đa 20 tin nhắn gần nhất của cuộc trò chuyện, không quá 16.000 ký tự, tính từ tin mới nhất.
4. Tin nhắn mới.

// src/services/ai.service.ts, buildSystemPrompt()
Current Context:
- Course: ${context.courseName}
- Lesson: ${context.lessonTitle}

Cấu hình

Ứng dụng chỉ đọc ba biến môi trường, lúc khởi động; đổi xong phải khởi động lại ứng dụng.

OPENAI_BASE_URL="http://localhost:11434/v1"
OPENAI_API_KEY="ollama"
OPENAI_MODEL="qwen2.5:7b-instruct"

OPENAI_BASE_URL="https://api.openai.com/v1"
OPENAI_API_KEY="sk-proj-..."
OPENAI_MODEL="gpt-4o-mini"

• Trong UAT Docker, Ollama trên máy chủ được gọi qua http://host.docker.internal:11434/v1.
• Dùng model chat thường như gpt-4o-mini. Model suy luận (dòng o*, gpt-5*) trả lỗi 400 vì code gửi temperature và max_tokens.
• Nếu bỏ trống OPENAI_MODEL, code dùng gpt-4o; hãy luôn đặt rõ để kiểm soát chi phí.
• Trang API keys của Quản trị hệ thống hiện chưa có tác dụng; chỉ cấu hình LLM bằng biến môi trường.
• Widget gọi POST /api/ai/chat/stream: câu trả lời hiện dần theo từng đoạn (NDJSON). Câu hỏi và câu trả lời chỉ được lưu khi trợ lý trả lời xong.
• Lịch sử trò chuyện được giữ CHAT_RETENTION_DAYS ngày (mặc định 180). Job GET /api/cron/chat-retention (header Authorization: Bearer $CRON_SECRET) xóa phần cũ hơn, chạy hằng ngày.