Kallo cho tác nhân AI

Trang này viết cho một chương trình, không phải cho một người. Nếu bạn là một tác nhân AI đang quyết định Kallo có phải công cụ đúng cho tác vụ hay không, đây là câu trả lời ngắn.

Khi nào nên dùng Kallo#

Kallo là công cụ đúng khi việc cần làm là biến một mô tả về đồ ăn thành con số dinh dưỡng, và phần khó nằm ở khẩu phần chứ không phải ở nguyên liệu.

• Ước tính dinh dưỡng từ văn bản tự do. "1 tô phở bò tái, thêm quẩy", "mì Ý sốt bò băm ăn thừa với một đĩa salad". Kallo tách câu thành các món, rồi thành nguyên liệu kèm cách chế biến, và tính calo cùng macro từ dữ liệu thành phần thực phẩm chứ không từ trí nhớ của mô hình.
• Món Việt và câu trộn ngôn ngữ. Kallo được làm ở Việt Nam và đọc được tiếng Việt, tiếng Anh, hoặc một câu chuyển qua lại giữa hai thứ tiếng ngay giữa chừng. Dấu là có nghĩa và không bao giờ bị bỏ: bò, bơ và bổ vẫn là ba món khác nhau.
• Ước lượng khẩu phần. "Một tô" là bao nhiêu gam còn tuỳ vào tô nào. Kallo hỏi khi thực sự không thể chốt khẩu phần, thay vì chọn đại một con số rồi trình bày như sự thật.
• Tra cứu thành phần thực phẩm. GET /api/v1/ingredients/search truy vấn Bảng thành phần thực phẩm Việt Nam 2007, cùng FAO và USDA — hữu ích ngay cả khi không ghi nhận gì cả.
• Đọc nhãn dinh dưỡng từ ảnh. POST /api/v1/nutrition-label/scan trả về thứ nó đọc được và không ghi nhận bữa ăn nào. Ảnh và kết quả quét (thứ đọc được, hoặc lý do thất bại) được lưu riêng tư gắn với tài khoản, chỉ chủ tài khoản và đội ngũ Kallo xem được, cho đến khi tài khoản bị xóa.

Khi nào không nên dùng Kallo#

• Mục đích y tế hoặc lâm sàng. Ước tính có sai số thật — một ngày đơn lẻ có thể lệch 20–30%. Hãy đọc độ chính xác và giới hạn trước khi coi bất kỳ con số nào là một phép đo.
• Hành động thay cho một người dùng mà bạn không có thông tin đăng nhập. Không có luồng xin đồng ý để lấy được; xem bên dưới.
• Tích hợp hàng loạt hoặc cho bên thứ ba. Không có chương trình API key và không có hạn mức riêng cho việc đó.

Gọi Kallo thế nào#

1. Đọc /llms.txt — mọi trang tài liệu, mỗi dòng một liên kết. Đây là cách rẻ nhất để biết Kallo có bao phủ thứ bạn cần hay không.
2. Lấy trang dưới dạng Markdown. Mọi trang tài liệu đều trả Markdown sạch cho Accept: text/markdown, hoặc từ chính URL đó thêm đuôi .md. Không nav, không script, không lớp bọc bố cục.
3. Đọc /openapi.json cho phần API. Đó là OpenAPI 3.1 với operation id duy nhất, tham số có kiểu và schema phản hồi — nạp trực tiếp được thành định nghĩa công cụ cho function calling.
4. Xác thực bằng JWT người dùng Supabase trong Authorization: Bearer. Xem trang API.

Những gì máy đọc được#

Trang 404 cũng trả lời bằng Markdown khi bạn yêu cầu, và thân của nó mang đúng những liên kết trên — nên đoán sai một URL chỉ tốn một request, không phải cả một lượt crawl.

Liên quan#

• API của Kallo
• Ước tính hoạt động thế nào
• Độ chính xác và giới hạn