- Mở phiên tạm không cần tài khoản ·
start_guest_session - Người dùng cần tra kho chung, tính hoặc lấy Excel mà chưa kết nối tài khoản; không gọi khi đã có phiên còn hạn.
Kết quả: accessToken/tokenType/expiresAt/expiresIn/scopes; phiên30phút chỉ giữ hash token và hạn dùng trong bộ nhớ tạm của máy chủ, không tạo User/Session/Ration. - Đọc hướng dẫn sử dụng ·
get_workflow - Bắt đầu hoặc cần hiểu quy trình/tham số/lỗi.
Kết quả: menuSchema là hợp đồng đầu vào; toolGuide giải thích từng công cụ; recipes là các luồng; recovery hướng dẫn xử lý lỗi. - Tìm thực phẩm hoặc món VDD ·
search_foods - Cần nguyên liệu; hoặc món hoàn chỉnh VDD với type=MA, source=VDD.
Kết quả: items[] là Food có id/name/unit/source/nutrients/nutrientBasis; total và nextOffset để phân trang. nutrientBasis.status=per100 ghi amount=100 và unit g/ml; unverified là chưa biết mẫu số, không phải số theo một suất. - Đọc thực phẩm theo ID ·
get_food - Đã chọn ứng viên thật hoặc cần đủ vi chất/đơn vị/nguồn.
Kết quả: Một Food trực tiếp, không có items: id/name/unit/nutrients/source/nutrientBasis. Chỉ status=per100 mới cho biết số theo100g/100ml; VDD MA có status=unverified, amount=null: nutrients=null; số gốc chỉ nằm ở unverifiedSourceNutrients để đối soát, chưa được nhân theo gram hoặc coi là một suất. null là thiếu. - Tìm công thức món RNI ·
search_dishes - Lập thực đơn mới: ưu tiên tìm công thức RNI có sẵn phù hợp trước khi tự xây dựng món.
Kết quả: items[] gồm ứng viên có id/name/source; không phải khẩu phần đã tính. - Đọc công thức và nguyên liệu ·
get_dish - Cần thành phần của một món RNI đã tìm thấy.
Kết quả: Một món trực tiếp với ingredients[] và liên kết food. Đọc số lượng/cơ sở nguồn; mục chưa liên kết cần làm rõ. - Tìm mã chế độ ăn ·
search_diet_codes - Người dùng có bệnh lý/chỉ định và cần tra mã, tên hoặc nhóm đối tượng.
Kết quả: items[] gồm id/code/name/targetGroup/diseaseGroup; total/nextOffset. Không phải chỉ định điều trị. - Đọc mã chế độ ăn và ghi chú ·
get_diet_code - Đã có ID ứng viên hoặc mã do người dùng cung cấp cần kiểm chứng.
Kết quả: Một mã trực tiếp: id/code/name/ranges/note/source/qualityWarnings/rawWater. ranges là khoảng tham khảo, không tự thành mục tiêu cá nhân. - Tìm trong thư viện riêng ·
list_personal_library - Người dùng muốn dùng lại thực phẩm hoặc món của họ.
Kết quả: Danh sách mục riêng theo chủ, chưa phải đầu vào đã duyệt. - Đọc thực phẩm hoặc món riêng ·
get_personal_library_item - Đã chọn ID thuộc thư viện người đang kết nối.
Kết quả: content của mục: food dùng như customFood; dish có content.days[0].rows. - Chuẩn bị bản để duyệt ·
prepare_menu - Đã có đầu vào theo menuSchema; cần kiểm phần thiếu hoặc chuẩn bị chốt.
Kết quả: input chuẩn hóa, preview.missingInputs, review.text, review.truncated, confirmationToken và expiresAt. Đây chưa phải người dùng đồng ý. Có webUrl/webExpiresAt để mở bản nháp và sửa trên web, không cần đăng nhập; đầu vào được giữ tạm30phút, chưa phải bản đã chốt. - Tính và trả báo cáo, không lưu ·
calculate_menu - Người dùng đã đồng ý bản prepare hiện hành; cần xem số liệu.
Kết quả: chatReport.summaryText/text, totals/dayTotals/analysis/clinicalAssessment cùng webUrl/webExpiresAt. Link mở bản tạm đã tính, xem/sửa/tính lại không cần đăng nhập; lưu đầu vào30phút, không tạo Ration. Không có link Excel nếu chưa xuất. - Lưu hoặc cập nhật thực đơn riêng ·
save_menu - Chỉ khi người dùng yêu cầu lưu vào tài khoản; cần nutrition:write.
Kết quả: ration.id/title/revision/url và input/preview; ration.url là link lâu dài yêu cầu đăng nhập đúng chủ. - Tìm thực đơn đã lưu ·
list_saved_menus - Người dùng muốn mở/dùng lại bản trong tài khoản.
Kết quả: items[] và nextOffset; chỉ bản thuộc người đang kết nối. - Mở và tính lại bản đã lưu ·
get_saved_menu - Có ID bản riêng cần đọc hoặc dùng lại.
Kết quả: ration/input/preview/review/confirmationToken/sourceChanged/history; nguồn hiện tại có thể khác lần lưu. - Tạo link tải Excel ·
export_workbook - Người dùng yêu cầu file Excel của bản đã xác nhận; cần nutrition:export.
Kết quả: downloadUrl/expiresAt/filename; savedMenuUrl có thể null. Link tải tạm10phút; không cần tải file vào chat để hoàn tất. Đồng thời có webUrl/webExpiresAt để xem/sửa bản tạm trên web không cần tài khoản; đây không phải savedMenuUrl lâu dài.