Clef: model quyết định của Workers AI
Clef và Clef-flash (Cloudflare, ra mắt 01.10.2026) không sinh chữ. Bạn đưa vào một state (văn bản, JSON, tối đa 4 ảnh base64) và một bộ câu hỏi có kiểu (noul có/không, choice chọn một, score theo mức). Model trả xác suất đã hiệu chỉnh cho từng đáp án. Clef-flash (@cf/cloudflare/clef-flash) có độ trễ trung vị khoảng 39ms, và token đầu ra không tính tiền.
Nó hợp với những chỗ trước đây bắt một LLM sinh chữ chỉ để chọn một nhãn.
Cổng duy nhất
Mọi lượt gọi đi qua api.conan.school/src/shared/ai/clef.ts (clefDecide). Lỗi trả null, không ném ra ngoài, vì ở mọi chỗ dùng hiện nay Clef chỉ là tín hiệu phụ.
Chỗ đang dùng (chạy thử từ 10.2026)
| Chỗ | Clef làm gì | Có đổi quyết định không |
|---|---|---|
Góp ý người học (member-feedback) | Gợi ý loại + xác suất khẩn, ghi ai_category, ai_confidence, ai_urgent | Không. Loại người học chọn vẫn giữ nguyên |
Biên lai Pro (ocrReceipt) | Ba câu có/không về ảnh, ghi vào receipt_ocr.clef | Không. Chỉ ghi lại |
| Chấm Task phòng học trực tiếp | Chấm bóng theo rubric, ghi live_task_evaluations.clef_scores | Không. Người học vẫn thấy điểm của LLM |
Ran (ai/chat.ts) | Phân loại ý định, ghi log ran_intent (không ghi nội dung câu hỏi) | Không. Đường trả lời giữ nguyên |
Chưa dùng ở auditCourse và kiểm chéo đáp án của content-ops: đổi hay thêm model ở đó làm lệch dữ liệu so sánh của course_content_runs. Muốn thử thì làm thành một lớp kiểm thêm vào, có lượt chạy riêng.
Ba điều phải nhớ
- Clef luôn chọn một đáp án, kể cả với đầu vào vô nghĩa, khi đó độ tin chỉ còn khoảng 0,02-0,16. Chỗ gọi phải tự đặt ngưỡng (
confidentChoice), dưới ngưỡng thì coi là "không biết". - Quá ngữ cảnh thì phần CUỐI của
statebị cắt. Đặt thứ quan trọng lên đầu. - Biên lai có quyền tự duyệt Pro (đọc ra số tiền ≥ ngưỡng với độ tin ≥ 0,5). Muốn để Clef tham gia thì chỉ được siết (ví dụ đòi
is_transfer_receiptcao mới cho tự duyệt), không bao giờ nới, và chỉ sau khi đã có số liệu từ cột ghi bóng.
Bước tiếp theo
Sau vài tuần, so ai_category với category, so clef_scores với điểm LLM, và đếm ran_intent theo loại. Chỗ nào khớp tốt thì mới chuyển từ ghi bóng sang dùng thật.