Cấu hình AI
CQA sử dụng AI để đọc và đánh giá cuộc chat. Bạn cần cấu hình AI provider và API key trước khi sử dụng.
Cấu hình AI Provider
Vào menu Cài đặt > tab Cấu hình AI.
Bước 1: Chọn Provider
| Provider | Ưu điểm | Nhược điểm |
|---|---|---|
| Claude (Anthropic) | Phân tích tiếng Việt tốt, chính xác cao | Giá cao hơn Gemini |
| Gemini (Google) | Giá rẻ, tốc độ nhanh | Độ chính xác thấp hơn Claude |
| ChatGPT (OpenAI) | Phổ biến, nhiều người đã có sẵn tài khoản | Cần thử với dữ liệu thật để so chất lượng tiếng Việt |
| Grok (xAI) | Giá cạnh tranh | Ít được kiểm chứng với việc chấm chất lượng chat tiếng Việt |
Dùng được cả proxy
Mục Tùy chỉnh API URL cho phép trỏ sang proxy hoặc máy chủ tự dựng thay vì gọi thẳng nhà cung cấp: OpenRouter, LiteLLM, CLIProxy, AI gateway nội bộ. ChatGPT và Grok dùng chung một chuẩn giao tiếp nên mọi proxy theo chuẩn OpenAI đều chạy được — chọn ChatGPT rồi điền URL của proxy.
Sau khi điền URL và lưu cài đặt, bấm nút làm mới cạnh ô Model AI: danh sách model sẽ được lấy từ chính proxy đó, nên bạn thấy đúng những model proxy của mình hỗ trợ.
Bước 2: Chọn Model
Danh sách model trong ô chọn được lấy trực tiếp từ nhà cung cấp bằng chính API key của bạn, nên model mới ra sẽ tự xuất hiện. Danh sách được lưu lại và làm mới mỗi ngày; muốn cập nhật ngay thì bấm nút làm mới cạnh ô chọn model. Khi chưa có API key hoặc không gọi được nhà cung cấp, CQA hiển thị danh sách kèm sẵn trong bản cài đặt.
Model bạn đang dùng luôn có mặt trong danh sách, kể cả khi nhà cung cấp đã gỡ nó — để bạn không bị mất lựa chọn hiện tại.
Giá dưới đây tính theo USD cho mỗi 1 triệu token, đối chiếu bảng giá chính thức ngày 15/09/2026. Nhà cung cấp có thể đổi giá, hãy kiểm tra lại trước khi tính toán chi phí dài hạn.
Claude:
| Model | Giá vào / ra | Phù hợp |
|---|---|---|
| Claude Sonnet 5 | $2 / $10 | Khuyến nghị cho hầu hết trường hợp |
| Claude Haiku 4.5 | $1 / $5 | Số lượng chat lớn, ngân sách hạn chế |
| Claude Opus 5 | $5 / $25 | Yêu cầu phân tích phức tạp |
| Claude Sonnet 4.6 | $3 / $15 | Thế hệ cũ, giữ cho ai đang dùng |
| Claude Opus 4.6 | $5 / $25 | Thế hệ cũ |
ChatGPT (OpenAI):
| Model | Giá vào / ra | Phù hợp |
|---|---|---|
| GPT-5 | $1.25 / $10 | Khuyến nghị |
| GPT-5 mini | $0.25 / $2 | Số lượng lớn, ngân sách hạn chế |
| o3 | $2 / $8 | Yêu cầu suy luận sâu |
Grok (xAI):
| Model | Giá vào / ra | Phù hợp |
|---|---|---|
| Grok 4 | $1.25 / $2.50 | Khuyến nghị |
| Grok 3 | $1.25 / $2.50 | Thế hệ cũ |
Gemini:
| Model | Giá vào / ra | Phù hợp |
|---|---|---|
| Gemini 3.8 Flash | $0.75 / $3.75 | Khuyến nghị, mới nhất |
| Gemini 3.1 Flash Lite | $0.25 / $1.50 | Rẻ nhất, phân loại đơn giản |
| Gemini 3.5 Flash Lite | $0.30 / $2.50 | Rẻ |
| Gemini 3.5 Flash | $1.50 / $9 | Mạnh hơn |
| Gemini 2.5 Pro | $1.25 / $10 | Thế hệ cũ |
| Gemini 2.5 Flash | $0.30 / $2.50 | Thế hệ cũ |
Gemini 2.0 Flash đã ngừng hoạt động
Google đã dừng model này. Nếu cấu hình của bạn còn đang chọn nó, hãy đổi sang một model Gemini 3.x ở bảng trên.
Giá của Gemini 3.8, 3.7 và 3.6 Flash đang trong giai đoạn ưu đãi và sẽ tăng gấp đôi từ 01/01/2027.
Bước 3: Nhập API Key
- Claude: Lấy key tại console.anthropic.com/settings/keys
- Gemini: Lấy key tại aistudio.google.com/apikey
Nhập key vào ô API Key rồi bấm Lưu cài đặt.
Sau đó bấm Kiểm tra API Key. Nút này gọi thật một lượt tới nhà cung cấp bằng key vừa lưu (tốn vài token, không đáng kể), nên kết quả phản ánh đúng tình trạng key:
| Thông báo | Ý nghĩa |
|---|---|
| Kết nối thành công | Key dùng được với model đang chọn |
| API key không hợp lệ hoặc không có quyền truy cập | Key sai, đã bị thu hồi, hoặc không có quyền |
| API key đã hết hạn mức hoặc bị giới hạn tần suất | Thường gặp với key miễn phí — chờ hạn mức khôi phục hoặc nâng cấp tài khoản |
| Model đang chọn không dùng được với API key này | Đổi sang model khác |
| Không kết nối được tới nhà cung cấp | Mạng hoặc tường lửa chặn |
| Không giải mã được API key đã lưu | Xem mục bên dưới |
Đã lưu key rồi thì không phải nhập lại
Ô API Key hiển thị •••••••• nghĩa là đã có key lưu sẵn. Muốn đổi model hay cỡ lô, cứ để nguyên ô đó rồi Lưu cài đặt — key cũ được giữ nguyên. Chỉ nhập lại khi muốn thay key.
Không giải mã được API key đã lưu
Key được mã hoá bằng ENCRYPTION_KEY trong file .env. Nếu giá trị này bị đổi (cài lại, sinh key mới, khôi phục nhầm bản .env) thì mọi thứ đã mã hoá trước đó — API key lẫn thông tin kết nối kênh chat — không giải mã được nữa, trong khi giao diện vẫn hiển thị •••••••• như thể đã cấu hình xong.
Cách xử lý: nhập lại API key và kết nối lại các kênh chat. Sau đó giữ nguyên ENCRYPTION_KEY, đừng đổi nữa.
Batch Mode
Batch mode gom nhiều cuộc chat vào 1 lần gọi AI, giúp tiết kiệm token đáng kể.
Cách hoạt động
- Tắt batch: Mỗi cuộc chat = 1 lần gọi API → chính xác nhất nhưng tốn token
- Bật batch: Gom N cuộc chat = 1 lần gọi API → tiết kiệm 60-80% token
Cấu hình Batch
- Bật Chế độ Batch
- Chọn Batch Size (số cuộc chat gom lại):
| Batch Size | Tiết kiệm | Rủi ro | Khuyến nghị |
|---|---|---|---|
| 3 | ~40% | Thấp | Mới bắt đầu |
| 5 | ~60% | Thấp | Khuyến nghị chung |
| 10 | ~75% | Trung bình | Đã quen, chat đơn giản |
| 15-20 | ~80% | Cao | Chat ngắn, phân loại đơn giản |
| 30 | ~85% | Cao | Chỉ dùng cho phân loại |
Khuyến nghị
Bắt đầu với batch size 5. Sau khi kiểm tra kết quả chính xác, tăng lên 10. Với công việc Phân loại (không cần chấm điểm chi tiết), có thể dùng 10-20.
Lưu ý
Batch size lớn = nếu API lỗi, mất kết quả nhiều cuộc chat cùng lúc. Nên giữ ở mức 5-10 cho an toàn.
So sánh chi phí thực tế
Ví dụ đánh giá 100 cuộc chat:
| Chế độ | Số lần gọi API | Chi phí ước tính (Claude Sonnet) |
|---|---|---|
| Không batch | 100 lần | ~$2.00 |
| Batch 5 | 20 lần | ~$0.80 |
| Batch 10 | 10 lần | ~$0.50 |
Chi phí thực tế phụ thuộc vào độ dài cuộc chat.