Mục tiêu Workflow
Phân tích lệnh kho nhiều dòng, cập nhật tồn và phản hồi.
Điều kiện đầu vào
- Telegram Bot: phải có nguồn, người cập nhật và trạng thái xác minh.
- Item catalog: phải có nguồn, người cập nhật và trạng thái xác minh.
- Stock ledger: phải có nguồn, người cập nhật và trạng thái xác minh.
- Syntax rules: phải có nguồn, người cập nhật và trạng thái xác minh.
Công cụ và kết nối
- n8n
- Telegram
- Google Sheets
- LLM parser
Nguyên tắc cấu hình: lưu credential trong kho bí mật/credential manager của nền tảng; không ghi API key trực tiếp trong Prompt, Sheet hoặc log công khai.
Đầu ra cần nghiệm thu
- Stock transaction
- Updated balance
- Receipt
- Error log
Quy trình triển khai chi tiết
- Nhận lệnh
Tập hợp Telegram Bot, Item catalog và Stock ledger; đặt tên file/record thống nhất, loại bản trùng và đánh dấu mục thiếu. Chỉ chuyển bước khi nguồn, người sở hữu và thời điểm cập nhật đã được ghi rõ.
- Nhận diện loại giao dịch
Tập hợp Telegram Bot, Item catalog và Stock ledger; đặt tên file/record thống nhất, loại bản trùng và đánh dấu mục thiếu. Chỉ chuyển bước khi nguồn, người sở hữu và thời điểm cập nhật đã được ghi rõ.
- Parse dòng hàng
Thực hiện “Parse dòng hàng” bằng n8n, Telegram và Google Sheets; ghi rõ dữ liệu vào, dữ liệu ra, điều kiện thành công và nhánh lỗi. Kiểm tra kết quả mẫu trước khi xử lý hàng loạt.
- Map SKU/alias
Áp dụng quy tắc phân loại theo mục tiêu “Phân tích lệnh kho nhiều dòng, cập nhật tồn và phản hồi”. Mỗi record phải có lý do được chọn/loại, nhánh xử lý tiếp theo và người chịu trách nhiệm.
- Validate quantity
Đối chiếu dữ liệu với nguồn gốc, chuẩn hóa định dạng và tạo danh sách lỗi. Mục không xác minh được phải gắn trạng thái CẦN BỔ SUNG, không để AI tự suy đoán.
- Update ledger
Đẩy đầu ra qua n8n, Telegram và Google Sheets sau khi kiểm tra quyền truy cập và consent. Ghi response ID, URL/kết quả, thời điểm, trạng thái và mã lỗi; không đánh dấu hoàn thành nếu hệ thống đích chưa xác nhận.
- Compute balance
Thực hiện “Compute balance” bằng n8n, Telegram và Google Sheets; ghi rõ dữ liệu vào, dữ liệu ra, điều kiện thành công và nhánh lỗi. Kiểm tra kết quả mẫu trước khi xử lý hàng loạt.
- Reply receipt
Nghiệm thu Stock transaction, Updated balance và Receipt; đối chiếu với yêu cầu ban đầu, lưu version cuối và log toàn bộ ngoại lệ. Chỉ đóng workflow khi owner xác nhận kết quả có thể sử dụng.
Xử lý lỗi và chạy lại
- Lỗi dữ liệu: chuyển record sang trạng thái
NEEDS_INPUT, ghi trường thiếu và không gọi AI/API tiếp. - Lỗi API tạm thời: retry tối đa 3 lần với backoff; lỗi xác thực hoặc quota phải dừng và cảnh báo Admin.
- Lỗi từng record không được làm dừng toàn bộ lô; lưu record lỗi vào hàng đợi kiểm tra lại.
- Mỗi lần chạy phải có run ID, thời điểm, input reference, output reference và thông báo kết quả.
Quality Gate trước khi dùng thật
- Test tối thiểu 3 tình huống: dữ liệu chuẩn, thiếu dữ liệu và API trả lỗi.
- Đối chiếu số record đầu vào, thành công, bỏ qua và thất bại; tổng phải khớp.
- Kiểm tra quyền riêng tư, consent, bản quyền, claim và thông tin nhạy cảm theo đúng loại nội dung.
- Chạy thử với phạm vi nhỏ, có người duyệt; sau đó mới bật lịch hoặc xử lý hàng loạt.
Thời lượng dự kiến: 30–60 phút thiết lập · Độ khó: Nâng cao.
