Bài này viết cho người chưa từng dùng API bao giờ. Bạn sẽ đi qua đúng bốn phần: Jev sinh ra để làm gì, cài nó thế nào (mô tả từng nút bấm), dùng thử ngay trên web không cần code, rồi mới tới phần nối nó vào công việc thật. Cuối bài có bảng những việc không nên giao cho nó — phần đó quan trọng ngang phần hướng dẫn.
1. Vấn đề Jev sinh ra để giải
Giả sử bạn bán hàng online. Mỗi ngày có 200 tin nhắn về. Bạn muốn máy tự chia chúng thành ba nhóm: hỏi giá, hỏi tình trạng đơn, khiếu nại. Khiếu nại thì báo bạn ngay, hai loại kia để bot trả lời.
Cách cũ là dò từ khoá:
nếu tin nhắn chứa "bao nhiêu tiền" → hỏi giá nếu tin nhắn chứa "đơn hàng" → hỏi tình trạng đơn nếu tin nhắn chứa "kém" → khiếu nại
Chạy được vài hôm. Rồi khách nhắn "cái này giá sao shop", "em đặt hôm kia giờ tới đâu rồi ạ", "mua về xài hai ngày hỏng luôn" — không câu nào khớp từ khoá. Bạn thêm từ khoá, danh sách phình ra, rồi tới lúc nó bắt nhầm câu "hàng tốt lắm không có gì để chê kém" thành khiếu nại.
Cách từ 2023 tới nay là gọi ChatGPT hay Claude, hỏi "tin này thuộc nhóm nào". Tốt hơn hẳn. Nhưng để trả về đúng hai chữ hỏi giá, mô hình vẫn phải sinh chữ theo cơ chế của nó — chậm vài giây, tốn tiền cả chiều vào lẫn chiều ra, và thỉnh thoảng nó trả lời dài dòng làm phần mềm của bạn đọc không ra.
Jev sinh ra cho đúng chỗ này. Nguyên lý gọn một câu: khi bạn đã biết trước mọi đáp án có thể có, bắt mô hình viết chữ là việc thừa.
2. Nó khác ChatGPT chỗ nào
| ChatGPT / Claude / Gemini | Jev | |
|---|---|---|
| Trả về cái gì | Chữ — bạn tự đọc rồi tự bóc ra | Đáp án đã đóng khung sẵn + xác suất |
| Viết được không | Có | Không. Một chữ cũng không |
| Nhanh cỡ nào | 3 – 300 giây | 0,07 – 0,5 giây |
| Giá chữ vào | 0,2 – 10 đô/triệu | 0,042 đô/triệu |
| Giá chữ ra | Thường đắt gấp 5 lần chiều vào | Miễn phí |
| Có nói nó chắc chắn bao nhiêu không | Không | Có — khác biệt lớn nhất |
| Nhận ảnh không | Thường có | Không. Chỉ chữ |
Hai dòng cuối quan trọng hơn dòng giá. Ta sẽ quay lại ở phần 7.
3. Ba việc ai cũng áp được ngay
Trước khi cài, hãy hình dung nó dùng vào đâu trong nghề của bạn.
Shop bán hàng online
Mỗi tin nhắn tới, hỏi một lượt: thuộc nhóm nào (hỏi giá / hỏi đơn / khiếu nại / hỏi kỹ thuật), khách đang bực tới đâu (bình thường / khó chịu / rất giận), có đang đòi trả hàng không. Bực từ mức 2 trở lên thì đẩy thẳng cho bạn, đừng để bot trả lời. Ba câu hỏi này gửi trong một lượt, tốn chưa tới một đồng.
Trung tâm dạy học / phòng khám / spa
Khách để lại thông tin trên form. Hỏi: khách này đang ở bước nào (mới tìm hiểu / đang so sánh giá / sẵn sàng đăng ký), có nêu thời hạn cụ thể không, mức độ phù hợp với dịch vụ mình đang có. Ai ở bước "sẵn sàng đăng ký" thì gọi trong 5 phút, còn lại đưa vào danh sách nuôi dưỡng.
Người làm nội dung, làm dịch vụ
Có 300 bình luận dưới bài quảng cáo. Hỏi từng cái: đây là khách tiềm năng, là câu hỏi, là spam, hay là công kích. Lọc xong còn 20 cái đáng trả lời. Việc mà trước đây bạn ngồi cuộn chuột cả tiếng.
2. Một người biết việc đọc 3 giây là quyết được, không cần ngồi suy luận.
3. Việc đó lặp lại nhiều lần — hàng chục, hàng trăm lần mỗi ngày.
Thiếu một trong ba thì chưa phải lúc dùng Jev.
4. Cài đặt — 5 phút, không cần thẻ ngân hàng
Toàn bộ phần này làm trên trình duyệt. Chưa cần cài gì vào máy.
Bước 1 — Đăng ký
Vào console.typesafe.ai. Màn hình hiện "Welcome to TypeSafe" với hai lựa chọn: Continue with Google hoặc nhập email. Bấm Google cho nhanh.
Không có hàng đợi chờ duyệt, không hỏi thẻ tín dụng. Đăng nhập xong là vào được luôn.
Bước 2 — Qua trang giới thiệu
Lần đầu vào, nó hiện một trang dài giới thiệu "Meet Jev". Cuộn xuống cuối, bấm nút Enter console ở góc phải.
Bước 3 — Trả lời câu đố chặn cửa
Đây là chỗ nhiều người khựng lại. Nó bật lên một hộp:
POP QUIZ: PASS TO CONTINUE
Can you chat with Jev, TypeSafe's new model?
[ ✓ Yes ] [ ✗ No ]
Đáp án là "No". Vì Jev không chat được — đó chính là bài học đầu tiên họ muốn bạn nhớ. Bấm No, nó hiện "That's correct — TypeSafe only responds with structured decisions", rồi bấm Close.
Bước 4 — Lấy chìa khoá
Cột trái có 5 mục: Home · Playground · Usage · API Keys · Documentation. Bấm API Keys → hiện dòng "No API keys yet" → bấm nút đen + Create key.
Chìa khoá hiện ra đúng một lần. Chép lại ngay và cất vào chỗ an toàn.
· Đừng dán nó vào khung chat của bất kỳ AI nào, đừng gửi qua Zalo, đừng để trong file dùng chung. Ai cầm được chìa khoá là tiêu tiền của bạn được.
· Lỡ để lộ thì vào lại API Keys, xoá cái cũ rồi tạo cái mới. Mất 30 giây.
Bước 5 — Kiểm tra đồng hồ tiền
Bấm mục Usage. Bạn sẽ thấy ba biểu đồ: Spend (tiền), Tokens (số chữ), Requests (số lượt hỏi). Lúc mới đăng ký cả ba đều bằng 0. Đây là chỗ bạn quay lại xem mỗi tuần để biết mình đang tiêu bao nhiêu.
5. Dùng thử ngay — không cần code một dòng nào
Bấm mục Playground ở cột trái. Đây là phòng thử: bạn dán tình huống vào một ô, viết câu hỏi vào ô kia, bấm chạy.
Jev chỉ có ba kiểu câu hỏi. Hết.
Đây là toàn bộ thứ bạn cần học. Nhớ ba cái này là dùng được mọi thứ.
Kiểu 1 — noul: đúng hay sai
Trả về một con số từ 0 đến 1 = khả năng "đúng".
Tình huống: "Mua về xài hai ngày hỏng luôn, shop tính sao đây"
Câu hỏi:
{
"doi_tra_hang": {
"type": "noul",
"instructions": "Khách có đang đòi trả hàng hoặc hoàn tiền không?"
}
}
Trả về: { "noul": 0.87 }
0,87 tức là "rất có khả năng đúng". Phần mềm của bạn đặt ngưỡng, ví dụ trên 0,7 thì báo cho bộ phận chăm sóc khách.
noul = 0.5 nghĩa là "đúng và sai ngang nhau" — KHÔNG phải "mức trung bình".Muốn đo mức độ (khách bực ít hay bực nhiều) thì phải dùng kiểu
score bên dưới. Đọc 0,5 thành "trung bình" là hiểu sai bản chất, và mọi ngưỡng bạn đặt sau đó sẽ sai theo.
Kiểu 2 — choice: chọn một trong danh sách
Trả về đáp án thắng, xác suất của tất cả lựa chọn, và độ chắc chắn. Tối đa 255 lựa chọn.
Tình huống: "em đặt hôm kia giờ tới đâu rồi ạ"
Câu hỏi:
{
"nhom": {
"type": "choice",
"instructions": "Tin nhắn này thuộc nhóm nào?",
"criteria": {
"hoi_gia": "Hỏi giá bán, khuyến mãi, phí ship",
"hoi_don": "Hỏi đơn đã đặt: tới đâu, khi nào nhận",
"khieu_nai": "Phàn nàn về hàng hoặc dịch vụ",
"khac": "Không thuộc ba nhóm trên"
}
}
}
Trả về:
{ "choice": "hoi_don",
"probabilities": { "hoi_don": 0.94, "khac": 0.04, "hoi_gia": 0.02, "khieu_nai": 0 },
"confidence": 0.91 }
2. Mô tả cả cái KHÔNG thuộc về. Thay vì chỉ ghi "hỏi giá", ghi rõ "hỏi giá bán, khuyến mãi, phí ship — KHÔNG bao gồm hỏi đơn đã đặt". Ranh giới giữa các nhóm sắc hẳn lên.
Kiểu 3 — score: chấm theo thang
Trả về một điểm số (rơi được vào giữa hai mức) kèm xác suất từng mức. Từ 2 đến 10 mức.
Tình huống: "Mua về xài hai ngày hỏng luôn, shop tính sao đây"
Câu hỏi:
{
"muc_buc": {
"type": "score",
"instructions": "Khách đang bực tới mức nào?",
"criteria": ["Bình thường, chỉ hỏi cho biết",
"Khó chịu nhưng còn lịch sự",
"Rất giận, dùng từ nặng"]
}
}
Trả về: { "score": 1.12, "confidence": 0.88 }
1,12 nghĩa là "khó chịu, hơi nghiêng về mức nặng hơn một chút". Bạn đặt luật: trên 1,5 thì chuyển người thật.
6. Luật quan trọng nhất: nhồi hết câu hỏi vào MỘT lượt
Đây là chỗ người mới đốt tiền oan nhiều nhất, và nó ngược với trực giác.
Khi bạn gửi một tình huống kèm câu hỏi, tình huống bị tính tiền đúng một lần — dù bạn hỏi một câu hay ba mươi câu. Mọi câu hỏi được trả lời song song, nên hỏi thêm gần như không làm chậm đi.
Tài liệu chính hãng đo được: gộp 13 câu vào một lượt thì rẻ hơn 12,2 lần và nhanh hơn 10 lần so với gọi 13 lượt riêng — đáp án y hệt.
Nên thay vì hỏi ba lượt, hãy hỏi một lượt ba câu:
Tình huống: "Mua về xài hai ngày hỏng luôn, shop tính sao đây"
{
"nhom": { "type": "choice", ... },
"muc_buc": { "type": "score", ... },
"doi_tra_hang": { "type": "noul", ... }
}
Còn nếu thiếu câu hỏi đó, bạn phải gọi lượt thứ hai — và lượt hai tính lại tiền cả tình huống từ đầu.
7. Độ chắc chắn — thứ ChatGPT không cho bạn
Đây mới là lý do thật sự để dùng Jev, không phải chuyện nhanh với rẻ.
Khi bạn hỏi ChatGPT "tin này thuộc nhóm nào", nó trả lời "hỏi đơn". Dứt khoát. Bạn không cách nào biết nó chắc chắn hay đang đoán mò.
Jev trả về cả hai. Nhìn hai kết quả này — cả hai đều chọn "hỏi đơn":
Kết quả A Kết quả B hỏi đơn 0.94 hỏi đơn 0.52 khác 0.04 khiếu nại 0.46 hỏi giá 0.02 hỏi giá 0.02 độ chắc 0.91 độ chắc 0.18
A thắng cách biệt. B thắng sát nút — nó rất có thể là khiếu nại. Cho bot tự trả lời kết quả B là liều. Phần mềm của bạn nên đẩy B cho người thật xem.
Ngưỡng không phải một con số dùng chung
Đây là điều nhiều người làm sai: đặt một ngưỡng duy nhất cho cả hệ thống. Đúng ra mỗi hành động một ngưỡng, theo mức thiệt hại nếu sai:
| Hành động | Ngưỡng nên đặt | Vì sao |
|---|---|---|
| Gắn nhãn, xếp loại, hiển thị bảng | 0,65 | Sai thì sửa tay, không mất gì |
| Bot tự nhắn trả lời khách | 0,85 | Sai là khách đọc mất rồi |
| Tự hoàn tiền, tự huỷ đơn, tự xoá | 0,90 trở lên | Không lùi lại được |
| Dưới 0,50 — mọi trường hợp | Chuyển người | Mô hình đang thật sự không biết |
Những con số trên là điểm khởi đầu bảo thủ, không phải chuẩn. Chính TypeSafe nói rõ: phải tự đo trên dữ liệu của mình rồi mới chỉnh.
Một lỗi đúng-khuôn vẫn hoàn tiền nhầm người, vẫn để lọt một khiếu nại nặng. Câu nói an toàn hơn: "Jev không phá được khuôn đầu ra, nhưng vẫn sai được." Vì thế mới cần ngưỡng.
8. Nối vào công việc thật
Thử xong trên Playground rồi, giờ mới tới lúc đưa vào hệ thống. Có ba đường, chọn theo trình độ.
Đường A — nhờ AI viết code hộ (dễ nhất)
Nếu bạn dùng Claude hoặc Cowork, TypeSafe có sẵn bộ kỹ năng cài bằng hai lệnh:
claude plugin marketplace add typesafe-ai/skills claude plugin install typesafe@typesafe-ai
Cài xong, gõ /typesafe:typesafe-ai trong phiên rồi bảo nó: "đọc dự án của tôi, tìm những chỗ đang dùng câu lệnh nếu-thì cứng nhắc mà đáng lẽ nên thay bằng một phán đoán".
Đường B — nối qua n8n, Make, Zapier (không cần biết code)
Các công cụ tự động hoá này đều có khối HTTP Request. Điền đúng bốn ô:
| Ô | Điền gì |
|---|---|
| Method | POST |
| URL | https://api.typesafe.ai/v1/systemone |
| Header | Authorization: Bearer <chìa khoá của bạn>Content-Type: application/json |
| Body | Đoạn JSON y như bạn đã thử trên Playground |
Kết quả trả về là JSON, các khối sau trong luồng đọc thẳng được. Đây là cách một shop nối Jev vào giữa "nhận tin nhắn Facebook" và "gửi cho bot trả lời" mà không cần lập trình viên.
Đường C — viết code (Python)
pip install typesafe-sdk # cần Python từ 3.10 trở lên
from typesafe_sdk import TypeSafeClient, Choice, Score, Noul
client = TypeSafeClient(model="jev-1.13.0") # ghim số bản, xem lưu ý bên dưới
r = client.system_one(
state="Mua về xài hai ngày hỏng luôn, shop tính sao đây",
questions={
"nhom": Choice(
instructions="Tin nhắn này thuộc nhóm nào?",
criteria={"hoi_gia": "Hỏi giá, khuyến mãi, phí ship",
"hoi_don": "Hỏi đơn đã đặt",
"khieu_nai": "Phàn nàn về hàng hoặc dịch vụ",
"khac": "Không thuộc ba nhóm trên"}),
"muc_buc": Score(
instructions="Khách đang bực tới mức nào?",
criteria=["Bình thường", "Khó chịu", "Rất giận"]),
},
)
nhom = r.answers["nhom"]
if nhom.confidence < 0.5:
chuyen_nguoi() # mô hình không chắc
elif nhom.choice == "khieu_nai" or r.answers["muc_buc"].score > 1.5:
bao_chu_shop() # việc gấp
else:
bot_tra_loi(nhom.choice)
Chỉ cần đặt chìa khoá vào biến môi trường TYPESAFE_API_KEY là thư viện tự đọc.
Bốn thói quen nên tập từ ngày đầu
| Việc | Vì sao |
|---|---|
Ghim số bản jev-1.13.0, đừng dùng jev-latest | Tên "latest" tự nhảy sang bản mới khi họ cập nhật. Mọi ngưỡng bạn đã chỉnh sẽ hết đúng mà bạn không sửa một dòng nào |
| Ghi lại số bản và số chữ mỗi lượt gọi | Khi kết quả đổi tính nết, đây là bằng chứng duy nhất cho biết mô hình có đổi hay không |
| Chạy song song một tuần, không cho nó đổi gì | So kết quả của nó với cách bạn đang làm. Đúng thì mới bật thật. Gọi là "chạy bóng" |
| Tự động hoá nhánh an toàn nhất trước | Đừng giao cả quy trình ngay. Giao một nhánh, sai thì sửa tay mười phút |
9. Hết bao nhiêu tiền — tính cụ thể
Giá: 0,042 đô cho một triệu chữ đầu vào (khoảng 1.100 đồng), đầu ra miễn phí.
Một tin nhắn khách cộng với bộ câu hỏi thường rơi vào khoảng 400 chữ. Tức là:
| Quy mô | Số lượt/tháng | Tiền/tháng |
|---|---|---|
| Shop nhỏ, 50 tin/ngày | 1.500 | ~700 đồng |
| Shop vừa, 300 tin/ngày | 9.000 | ~4.000 đồng |
| Lọc 10.000 bình luận một đợt | 10.000 | ~4.500 đồng |
Không nhầm số đâu. Đây là mức tiền mà sau một tháng bạn sẽ thôi không nghĩ tới nó nữa. Chỗ bạn thua không phải hoá đơn — mà là ráp sai kiến trúc: gọi một lượt một câu hỏi, hoặc nhét cả tài liệu dài vào làm tình huống.
Giới hạn kỹ thuật cần biết: tối đa 64 nghìn chữ mỗi lượt, 1.200 lượt mỗi phút. Với doanh nghiệp nhỏ thì không bao giờ chạm tới.
10. Những việc TUYỆT ĐỐI không giao cho Jev
TypeSafe có hẳn một trang tự liệt kê điểm yếu của chính mình — chuyện hiếm trong ngành này. Điều đáng chú ý: hầu hết điểm yếu đều cùng một hình dạng — một việc đáng lẽ của phần mềm thường thì lại đem giao cho mô hình.
| Không làm được | Làm thế nào thay vào |
|---|---|
| Viết chữ. Không soạn thư, không tóm tắt, không sinh code | Dùng ChatGPT / Claude |
| Đếm và tính toán. Nó nhận dạng hình dáng đáp án chứ không thực sự đếm — càng nhiều thứ càng sai | Hỏi đúng/sai cho từng món rồi tự cộng bằng phần mềm |
| So ngày tháng. Nó đọc ngày như chữ, không như số. Ngày nào trước, cách nhau mấy hôm — không tin được | Hỏi tách từng phần (tháng nào, ngày nào) rồi tự ráp và so |
| Đọc tài liệu dài lẫn nhiều thứ không liên quan. Chi tiết thừa làm giảm độ chính xác | Lọc trước, chỉ gửi đúng đoạn câu hỏi cần |
| Chống lại chữ gài bẫy. Nội dung viết để lừa nó có thể lái được đáp án | Thử các ca xấu trước khi mở cho khách dùng |
| Hiểu ý ngầm. Nó trả lời câu bạn viết, không phải câu bạn định nói | Viết câu hỏi thật rõ. Xem hộp bên dưới |
Nghĩa là: đáp án sai gần như luôn là lỗi của câu hỏi, không phải lỗi của mô hình. Sửa câu hỏi, đừng đổ cho công cụ.
noul và hỏi bằng choice có–không sẽ cho hai con số khác hẳn nhau. Tài liệu đưa ví dụ thật: cùng câu "khách có đòi hoàn tiền không" — noul trả 0,22 còn choice trả 1% có / 99% không.Lý do: choice là tương đối (đáp án nào thắng), noul là tuyệt đối (có thể thấp cho tất cả). Hai câu hỏi khác nhau.
Nên: đừng bao giờ bê ngưỡng đã chỉnh cho noul sang dùng cho choice.
11. Một lưu ý riêng cho người Việt
Tài liệu nói thẳng: tiếng Anh là ngôn ngữ huấn luyện chính. Các ngôn ngữ khác — kể cả tiếng Trung, Nhật, Hàn — "xử lý được nhưng không tốt bằng", và họ bắt buộc bạn tự kiểm trên nội dung của mình trước khi tin.
Cách kiểm rất đơn giản, làm trong 15 phút:
- Lấy 10 tin nhắn thật của khách bạn, tự tay ghi đáp án đúng ra giấy
- Cho Jev chạy 10 tin đó
- Đếm nó đúng mấy cái
Đúng 9–10 thì dùng được. 6–8 thì sửa lại mô tả các lựa chọn cho sắc hơn rồi đo lại. Dưới 6 thì thử viết phần câu hỏi bằng tiếng Anh, giữ nội dung tin nhắn bằng tiếng Việt — rồi đo lại lần nữa.
Bước này tốn vài chục đồng và 15 phút. Bỏ qua nó là tự đưa mình vào chỗ mù.
12. Vậy có nên dùng không
Thành thật: Jev mới ra được vài ngày tính tới lúc bài này lên. Chưa ai chạy nó đủ lâu để biết nó hỏng kiểu gì.
Nhưng thứ đáng chú ý không chỉ là công cụ. Nó là một hướng đi mới: suốt mấy năm qua chúng ta bắt mô hình AI làm mọi loại việc thông qua chữ nghĩa — kể cả những việc chỉ cần một phán đoán ngắn mà phần mềm dùng được ngay. Rất nhiều hệ thống thật không cần thêm chữ, chỉ cần một quyết định nhỏ, nhanh và đáng tin.
Nếu Jev không phải là thứ thắng cuộc, thì một mô hình khác cùng kiểu sẽ thắng. Hiểu nguyên lý bây giờ là khoản đầu tư không mất đi.
2. Vào Playground, dán một tin nhắn thật của khách, thử một câu
choice (10 phút)3. Lấy 10 tin nhắn đã biết đáp án, đo độ chính xác (15 phút)
4. Chọn một quyết định nhỏ, rủi ro thấp — ví dụ chỉ gắn nhãn, chưa tự trả lời khách
5. Chạy song song một tuần, không cho nó đổi gì. So kết quả
6. Đúng thì bật thật một nhánh. Sai thì sửa câu hỏi rồi lặp lại bước 3
Và một luật không bao giờ sai: nếu một câu lệnh nếu-thì bình thường đã chạy đúng rồi, hãy giữ nguyên nó. Phần mềm thường nhanh hơn, rẻ hơn, và kiểm thử được. Jev chỉ nên vào chỗ mà câu lệnh thường hiểu được giá trị nhưng không hiểu được ý nghĩa.
Khoá học 2 ngày của tôi dựng dây chuyền vận hành cho doanh nghiệp một người: bộ não nhớ bảng giá và giọng viết của bạn, đội AI lo từng mảng việc, tác vụ hẹn giờ gom kết quả về mỗi sáng. Bạn duyệt, không phải làm.
Xem khoá học & gói Đồng hành →Nguồn: TypeSafe AI — bài ra mắt "Introducing System One Models & Jev" (15/09/2026) và tài liệu chính thức tại docs.typesafe.ai, gồm trang models (giá 0,042 đô/triệu chữ vào · đầu ra miễn phí · 64 nghìn chữ mỗi lượt · 1.200 lượt/phút · chỉ nhận chữ · tiếng Anh cho độ chính xác tốt nhất), trang confidence, trang primitives (ba kiểu câu hỏi, tối đa 255 lựa chọn cho choice và 2–10 mức cho score), trang model-jaggedness/jev-1.13 (danh sách điểm yếu chính hãng công bố, rà soát 17/09/2026) và cookbook Parallel questions (con số 12,2 lần). Các bước cài đặt trong bài được thực hiện và kiểm chứng trực tiếp ngày 21/09/2026.
Theo dõi Master Cường BossNhận bài mới và video phân tích trên Facebook, YouTube.