---
url: https://docs.nemo12.com/reference/ai-registry.md
description: >-
  AI Registry: danh sách đầy đủ những nơi hệ thống gọi LLM, model và việc nào,
  để đối chiếu với code theo QG-010.
---

# AI Registry

Danh sách **đầy đủ** những nơi Nemo12 gọi mô hình ngôn ngữ. Nếu code gọi LLM mà không có trong bảng này thì hoặc là bảng lỗi thời, hoặc là PR đó sai (QG-010).

## 1. Đang gọi ở đâu

| Nơi | Model | Việc |
| --- | --- | --- |
| `modules/coral/routes.ts` (~196) | `@cf/meta/llama-3.3-70b-instruct-fp8-fast` | Hỗ trợ soạn/đánh giá nội dung trong Coral |
| `modules/coral/routes.ts` (~283) | như trên | Chạy theo lô trên nhiều mục nội dung |

**Chỉ có vậy.** Toàn bộ Learner Intelligence — mastery, retention, goal, readiness, chọn bài — là **thuật toán tất định, không LLM** ([engines](engines.md)).

## 2. Vì sao Learner Model không dùng LLM

| | Engine tất định | LLM |
| --- | --- | --- |
| Cùng input → cùng output | ✅ | ❌ |
| Giải thích được vì sao | ✅ công thức | ❌ |
| Test hành vi được | ✅ | khó |
| Chạy lại lịch sử ra cùng kết quả | ✅ | ❌ |

Khi hệ thống nói với phụ huynh *"con đang lung lay ở Hằng đẳng thức"*, câu đó phải truy được về từng bằng chứng và từng phép tính. Một mô hình sinh ra câu đó bằng cách đoán chữ tiếp theo thì không thể chịu trách nhiệm cho hệ quả.

**Ranh giới cứng: không có đường nào từ output LLM đi thẳng vào Learner Model.** Nội dung do AI hỗ trợ soạn phải qua vòng chất lượng của Coral (QG-006) rồi mới thành item; chỉ khi học sinh **làm** item đó mới có evidence.

## 3. Luật bắt buộc (QG-010)

1. **100% lời gọi qua AI Gateway `nemo12`** — `{ gateway: { id: c.env.AI_GATEWAY_ID } }`. Không bao giờ hardcode id.
2. **Cấm probe-fallback** (RISK-022): không dò model, không tự tụt xuống model khác khi lỗi. Hỏng thì trả `DEPENDENCY_FAILURE`.
3. **Output quan trọng phải lưu** `model`, `prompt_version`, `input_ref`, `confidence`.
4. **[Context Builder](context-builder.md) là đường duy nhất AI chạm learner data.** Không nhét thẳng dữ liệu học sinh vào prompt ở nơi khác.
5. **Có cost dashboard** — qua AI Gateway analytics.

## 4. Khoảng trống đã biết

| Việc | Trạng thái |
| --- | --- |
| Prompt registry có version | 🕓 chưa — prompt đang inline trong code |
| Lưu `model` + `prompt_version` cùng output | 🕓 chưa đầy đủ |
| Multi-evaluator variance check (QG-006) | 🕓 chưa tự động |

Cho tới khi có prompt registry, mọi thay đổi prompt phải đi kèm ghi chú trong PR — prompt là **cấu hình production**, không phải chuỗi ký tự vô hại.

## Trace

* REQ-PLT-\* (AI Gateway), QG-006 (content quality), QG-010 (AI governance).
* Rủi ro: RISK-022.
* Thiết kế: [SDD-003](../architecture/sdd-003-knowledge-quality.md), [SDD-013](../architecture/sdd-013-coral-content-plane.md), [SDD-014](../architecture/sdd-014-exam-acquisition.md).