Nghiên cứu điển hình · Atravesar Services · atravesar.ca
Một lớp trợ lý AI đặt trên hoạt động sửa chữa và logistics ngược thực tế
Cho Atravesar Services—công ty sửa chữa, tân trang và logistics ngược thiết bị điện tử tại Canada—SolvoSync đã xây dựng website công khai, nền tảng nghiệp vụ bên dưới và một trợ lý AI trả lời khách hàng bằng chín ngôn ngữ thông qua retrieval-augmented generation và các công cụ Model Context Protocol. Được trình bày trực tiếp tại NATEA Toronto ngày 21 tháng 10 năm 2026.
- dịch vụ nội bộ
- 9
- dòng mã Python
- ~175K
- ngôn ngữ, một cơ sở tri thức duy nhất
- 9
- công cụ trợ lý trong danh sách cho phép
- 10
- mỗi câu trả lời AI theo giá niêm yết
- US$0.004
- mã nguồn là lớp AI
- ≈3%
Khách hàng
Từ hàng trả về của khách đến trả hàng lại cho khách
Atravesar Services là công ty sửa chữa, tân trang và logistics ngược thiết bị điện tử tại Canada, có văn phòng ở Richmond Hill, xưởng sửa chữa và kho ở Markham, phục vụ toàn quốc qua chuyển phát nhanh. Công ty vận hành các chương trình sửa chữa và đổi trả B2B cho nhà sản xuất và nhà bán lẻ, cùng dịch vụ sửa chữa gửi qua bưu điện cho người tiêu dùng, và là nhà cung cấp dịch vụ hậu mãi được ủy quyền độc quyền của Narwal tại Canada, đồng thời hỗ trợ ECOVACS và Segway/Ninebot.
Mỗi ngày đội ngũ trả lời cùng những câu hỏi: Gói hàng của tôi đang ở đâu? Mã lỗi E12 nghĩa là gì? Sửa chữa ở Québec tính cả thuế là bao nhiêu? Lệnh công việc của tôi đã vào sửa chưa? Mọi câu trả lời đều đã có sẵn—trong một tài liệu, một cơ sở dữ liệu hoặc API của hãng vận chuyển. Yêu cầu: để phần mềm trả lời chúng, an toàn, suốt ngày đêm, bằng ngôn ngữ của khách hàng.
-
Văn phòng Richmond Hill · Xưởng sửa chữa và kho Markham · Phục vụ toàn Canada qua chuyển phát nhanh
-
Nhà cung cấp hậu mãi ủy quyền độc quyền của Narwal tại Canada · Hỗ trợ ECOVACS và Segway/Ninebot
-
Robot hút bụi · xe scooter điện · điện thoại thông minh · máy tính bảng · laptop · máy chơi game · thiết bị gia dụng nhỏ
-
EN简体繁體日本語한국어Tiếng ViệtESITFR
Nguyên tắc thiết kế
AI đọc, hiểu và trò chuyện. Phần mềm quyết định, ghi nhận và thanh toán.
Kiến trúc vạch ra một ranh giới rõ ràng. Lớp trợ lý nằm trên quy trình làm việc hằng ngày và chỉ tiếp cận nghiệp vụ qua những cánh cửa hẹp, có tên, có nhật ký—công cụ và API. Bên dưới, phần mềm thông thường với xác thực, phân quyền và kiểm toán quyết định giá, ghi nhận lệnh công việc và luân chuyển tiền.
-
Lớp trợ lý AI
Đọc, hiểu, tra cứu và trả lời mọi người—bằng ngôn ngữ của họ, suốt ngày đêm.
-
Những cánh cửa hẹp, có tên, có nhật ký
Đơn hàng, thanh toán, kho, vận chuyển, theo dõi và hỗ trợ chỉ có thể tiếp cận qua các công cụ trong danh sách cho phép với JSON schema. Mô hình không bao giờ chạm vào cơ sở dữ liệu.
-
Bảo mật & kiểm soát
Xác thực (bạn là ai?), phân quyền (bạn được xem hoặc làm gì?) và kiểm toán (điều gì đã xảy ra—được ghi nhật ký và có thể kiểm tra).
Những gì vốn đã vận hành doanh nghiệp
Chín dịch vụ, khoảng 175.000 dòng Python
Website chỉ là phần nhìn thấy được. Phía sau, SolvoSync thiết kế và vận hành nền tảng chạy toàn bộ công ty—quản lý kho và RMA, vận chuyển đa hãng, thanh toán và thuế, định danh, kiểm tra thiết bị và tích hợp với nhà sản xuất. Lớp AI chiếm khoảng 3% mã nguồn; tất cả phần còn lại là kỷ luật mà nó kế thừa.
-
7.7K LOC
www · Website công khai
9 ngôn ngữ · trang dịch vụ và hướng dẫn · biểu mẫu ngoài bảo hành · widget chatbot · tải tri thức cho quản trị viên · llms.txt
-
59.5K LOC
Flow · WMS / RMA
Nhập kho · tồn kho · linh kiện · RMA · lệnh giao hàng · pallet · ECOVACS ESB · Mammotion FS Cloud · LSS · 31 tệp kiểm thử
-
50.6K LOC
Fulfill · Vận chuyển
UPS · Canpar · Canada Post · Purolator (ShipEngine) · Freightcom · cước phí, nhãn, lấy hàng, manifest, theo dõi · kiểm toán hóa đơn EDI 210
-
5.2K LOC
Payment · Thanh toán & thuế
Stripe Checkout + webhooks · thuế Canada theo mã bưu chính (GST/HST/PST/QST) · hóa đơn lưu S3 · báo cáo hằng tuần
-
2.6K LOC
SSO · Định danh
Tài khoản · OAuth2 client-credentials · vai trò ADMIN, CUSTOMER, DEALER, RECEIVER, REPAIR, TECH, SHIPPER · phạm vi theo nhà cung cấp
-
35.4K LOC
Track · Hệ thống số
Hệ thống tồn kho / RMA thế hệ trước · giao diện React + TypeScript
-
10.0K LOC
Maintain · Kiểm tra thiết bị
Danh sách kiểm tra, ảnh, chữ ký, báo cáo theo lịch
-
2.8K LOC
Mammotion · Script nhà sản xuất
Sửa chữa tại kho FS Cloud, phụ tùng, RMA và xuất danh sách chờ giao
-
0.6K LOC
Kiểm kê
Quét nhãn AVS ↔ EAN, đánh dấu thiết bị thiếu, xuất Excel
- AWS EC2 (Ubuntu)
- RDS MySQL
- S3
- Redis
- nginx + gunicorn
- Flask
- React + TypeScript
- Qdrant
- Gemini API
- Stripe
- Google Places
LOC = số dòng Python không tính môi trường ảo, migration và gói bên thứ ba, thống kê tháng 10/2026.
Lớp trợ lý AI
Gemini + RAG + MCP: trợ lý được gắn vào đâu
Trợ lý AVS hoạt động trên www.atravesar.ca, được bảo vệ bởi token gắn với phiên và giới hạn tần suất. Nó chạy trên Gemini Flash với function calling—tối đa bốn vòng công cụ mỗi câu trả lời—truy xuất tri thức từ cơ sở dữ liệu vector Qdrant và tiếp cận vận chuyển, thuế, định danh qua các endpoint MCP và hàm, mỗi endpoint có xác thực, giới hạn và nhật ký riêng.
-
1
Trợ lý tri thức (RAG)
Nhân viên tải lên PDF, Markdown hoặc văn bản từ trang quản trị. Tài liệu được chia đoạn (≈1.000 ký tự, chồng lấn 150), nhúng bằng gemini-embedding-001 thành vector 768 chiều và lưu trong Qdrant. Mỗi câu hỏi truy xuất năm đoạn phù hợp nhất theo độ tương đồng cosine và mô hình trả lời dựa trên chúng, nêu rõ nguồn. Tài liệu tiếng Anh trả lời được câu hỏi bằng chín ngôn ngữ.
-
2
Trợ lý dùng công cụ (function calling & MCP)
Một công cụ gồm tên, mô tả và JSON schema. Mô hình chọn công cụ và tham số, mã của chúng tôi thực thi với token dịch vụ OAuth2, rồi mô hình giải thích kết quả. Máy chủ MCP vận chuyển dùng MCP qua Streamable HTTP (JSON-RPC 2.0), nên một tích hợp duy nhất phục vụ chatbot website hôm nay, trợ lý desktop cho nhân viên ngày mai và các agent đối tác với khóa giới hạn phạm vi sau này.
-
3
Tự động hóa quy trình (không dùng mô hình)
Thanh toán xác nhận → tạo nhãn → tạo lệnh công việc → gửi email. Quy tắc về giá, thuế, đánh số và chuyển giai đoạn nằm trong mã xác định, đã kiểm thử—đây là nơi tiền và hồ sơ luân chuyển.
Danh mục công cụ đã triển khai
Quy tắc thiết kế số 1: mô hình không bao giờ chạm vào cơ sở dữ liệu—nó yêu cầu công cụ.
| Công cụ | Chạy tại | Chức năng | Rào chắn |
|---|---|---|---|
| search_knowledge_base | www → Qdrant | Tìm kiếm ngữ nghĩa; trả về năm đoạn phù hợp nhất kèm nguồn và tiêu đề. | Chỉ đọc; mô hình được yêu cầu trích dẫn và không bao giờ bịa đặt. |
| share_oow_webform | www | Trả về URL biểu mẫu ngoài bảo hành bằng ngôn ngữ của người dùng. | Mô hình không được thu thập các trường biểu mẫu trong chat. |
| list_provincial_tax_rates calculate_tax |
Payment | GST/HST/PST/QST theo tỉnh hoặc mã bưu chính; phân biệt hàng hóa và dịch vụ. | Phép tính Decimal xác định; mô hình không bao giờ tự tính thuế. |
| rate_shipment track_shipment |
Shipment MCP (fulfillapi) | Cước phí hãng vận chuyển; theo dõi bằng UPS 1Z / Canpar D / PIN Canada Post hoặc mã tham chiếu khách hàng. | Token dịch vụ OAuth2; chỉ đọc. |
| email_waybill validate_address |
Shipment MCP (fulfillapi) | Gửi lại nhãn tới địa chỉ đã lưu; đối chiếu địa chỉ được Google xác minh. | Chỉ gửi email tới liên hệ của chính lô hàng; chỉ Canada/Mỹ. |
| get_account_info get_account_access |
SSO MCP | Hồ sơ tài khoản và dữ liệu của những nhà cung cấp nào người dùng được xem. | Token phía máy chủ; giới hạn theo nhà cung cấp. |
| clear_chat_history | www | Xóa cuộc trò chuyện của trình duyệt này. | Chỉ trong phạm vi phiên. |
Giới hạn: tối đa 4 vòng công cụ mỗi câu trả lời · mỗi kết quả công cụ ≤ 12.000 ký tự · 5 đoạn mỗi lần tìm kiếm · không công cụ nào ghi vào cơ sở dữ liệu · không công cụ nào luân chuyển tiền.
Một quy trình, từ đầu đến cuối
Hành trình sửa chữa ngoài bảo hành
AI ở đầu và cuối—phần trò chuyện. Ở giữa là phần mềm thông thường, có thể kiểm thử. Do một đội ngũ nhỏ xây dựng trên những hệ thống công ty đã có.
-
Khách hàng hỏi trợ lý: “Narwal của tôi hết bảo hành rồi—các bạn sửa được không?” Công cụ share_oow_webform trả về liên kết biểu mẫu bằng ngôn ngữ của khách; không thu thập dữ liệu cá nhân trong chat.
-
Biểu mẫu bốn bước thu thập thiết bị, sự cố và địa chỉ—được xác minh bằng Google Places—với lựa chọn mang đến trực tiếp hoặc gửi hàng.
-
Báo giá do mã tính toán: phí kiểm tra $40, thuế theo mã bưu chính từ dịch vụ Thanh toán và cước chuyển phát trực tiếp thấp nhất (truy vấn các hãng song song) cộng một mức cộng thêm cố định.
-
Stripe Checkout thu phí kiểm tra và vận chuyển; hóa đơn PDF với kỳ hạn 15 ngày được gửi qua email.
-
Một webhook đã xác minh tạo lệnh công việc AVSOOW{YYMMDD}#### và mở nó trong Flow ở giai đoạn “Receiving”; nhãn gửi hàng của hãng rẻ nhất cùng mã QR được gửi email cho khách.
-
Thiết bị được tiếp nhận và kiểm tra, báo giá sửa chữa được phát hành và thanh toán qua lần thanh toán Stripe thứ hai, lệnh công việc chuyển sang “Repair”.
-
Thiết bị đã sửa được gửi trả kèm mã theo dõi qua email—và trong suốt quá trình, trợ lý trả lời “Lô hàng của tôi đang ở đâu?” thông qua MCP vận chuyển.
Tự động hóa đơn giản mang lại phần lớn giá trị
Những nơi chúng tôi chủ ý không dùng AI
- Định giá & thuế
- Phép tính Decimal với làm tròn kiểu ngân hàng và quy tắc theo tỉnh dựa trên tiền tố mã bưu chính, trong dịch vụ Thanh toán.
- Chọn hãng vận chuyển
- Quy tắc: hộp thư bưu điện → Canada Post; nhà sản xuất ưu tiên → Canpar; UPS chạm giới hạn tần suất → phương án dự phòng; còn lại chọn cước trực tiếp rẻ nhất.
- Lệnh công việc & giai đoạn
- Số duy nhất và máy trạng thái giai đoạn (Receiving → Repair → …) trong Flow, được bao phủ bởi 31 tệp kiểm thử.
- Kiểm toán hóa đơn
- Phân tích hóa đơn EDI 210 (UPS, Canpar) mỗi đêm so với cước đã báo giá, tự động tạo báo cáo thu vượt.
- Thanh toán & định danh
- Stripe Checkout với webhook đã xác minh, hóa đơn và biên lai lưu trên S3; SSO với vai trò, OAuth2 client-credentials giữa các dịch vụ và MFA cho nhân viên.
- Tác vụ theo lịch & tích hợp nhà sản xuất
- Theo dõi hai lần mỗi ngày làm việc, email cảnh báo hằng tuần, nhập dữ liệu nhà sản xuất ba lần mỗi ngày; ECOVACS SEEBURGER ESB, Mammotion FS Cloud và LSS—hợp đồng, không phải hội thoại.
Nguyên tắc chung: nếu kết quả phải chính xác tuyệt đối, lặp lại được và giải thích được với kế toán hoặc luật sư, đó là việc của mã. AI đứng bên cạnh để giải thích và điều hướng.
Bảo mật và kiểm soát bên dưới
Xác thực, phân quyền, kiểm toán
Xác thực — bạn là ai?
- SSO cho nhân viên và đối tác; MFA khi đăng nhập hệ thống vận chuyển.
- Token OAuth2 client-credentials giữa các dịch vụ (Fulfill, Payment, SSO).
- Phiên chatbot: JWT HttpOnly gắn với IP và trình duyệt trong 30 phút; kiểm tra same-origin và danh sách đen Redis chống lạm dụng.
Phân quyền — bạn được xem hoặc làm gì?
- Vai trò ADMIN, CUSTOMER, DEALER, RECEIVER, REPAIR, TECH, SHIPPER; đối tác chỉ thấy dữ liệu của nhà cung cấp mình.
- Mô hình không nắm giữ thông tin xác thực nào—chỉ có các công cụ trong danh sách cho phép.
- Công cụ chỉ đọc, ngoại trừ gửi email nhãn tới liên hệ của chính lô hàng và xóa chat của chính mình.
Kiểm toán — điều gì đã xảy ra?
- Mọi lượt chat đều được ghi nhật ký: phiên, câu hỏi, câu trả lời, công cụ đã dùng, phiên bản mô hình; xuất CSV.
- Webhook Stripe được xác minh; sự kiện thanh toán và hóa đơn lưu trên S3.
- Đối soát EDI 210 hằng đêm giữa hóa đơn hãng vận chuyển và báo giá; báo cáo tự động hằng tuần.
Không điều nào trong số này là đặc thù của AI. Đó là kỷ luật bạn vốn cần—lớp AI chỉ đơn giản kế thừa nó.
Kết quả
Những gì nó mang lại
-
Khách hàng nhận được câu trả lời về bảo hành, mã lỗi, thuế, lô hàng và quy trình sửa chữa bằng chín ngôn ngữ, 24/7, có nêu nguồn.
-
Tiếp nhận ngoài bảo hành chạy từ câu hỏi đầu tiên đến lệnh công việc đã thanh toán mà nhân viên không phải gõ báo giá, nhãn hay email nào.
-
Một tích hợp MCP duy nhất phục vụ trợ lý website hôm nay và sẵn sàng cho trợ lý của nhân viên và đối tác—không cần tích hợp thứ hai.
-
Chi phí mỗi câu trả lời tính bằng xu: khoảng US$0,004 theo giá niêm yết, khoảng US$45 cho 10.000 câu trả lời mỗi tháng.
-
Mọi lượt chat đều được ghi lại cùng công cụ đã dùng và phiên bản mô hình—chất lượng cải thiện bằng cách đọc nhật ký và sửa tài liệu, không phải huấn luyện lại.
Kỹ thuật trung thực: các chế độ lỗi đã dự liệu—và điều thực sự xảy ra
- Ảo giác
- Dựa trên các đoạn đã truy xuất, bắt buộc tra cứu cho dữ kiện, temperature 0,4, chuyển giao sang email. Điều đã xảy ra: những câu trả lời ban đầu về giờ làm việc và địa chỉ đến từ kiến thức chung—đã sửa bằng quy tắc bắt buộc tra cứu.
- Tiêm lệnh (prompt injection)
- Prompt dạng chính sách và công cụ bị ràng buộc bởi schema; không có gì nhạy cảm để mở khóa—không danh bạ điện thoại, không công cụ thanh toán. Điều đã xảy ra: có người thử; các lời từ chối vẫn đứng vững vì phạm vi năng lực hẹp.
- Gián đoạn dịch vụ
- Lỗi công cụ được trả về dưới dạng dữ liệu và bot tiếp tục trả lời từ cơ sở tri thức; các hãng vận chuyển được truy vấn song song với phương án dự phòng theo quy tắc. Điều đã xảy ra: API hãng vận chuyển chạm giới hạn tần suất → chuyển sang hãng dự phòng.
- Trôi mô hình
- Một bí danh mô hình trôi nổi âm thầm thay đổi giọng điệu, độ dài và cách dùng công cụ. Phiên bản mô hình được ghi lại ở mỗi lượt và một bộ kiểm thử hồi quy gồm các câu hỏi thật được chạy lại sau mỗi thay đổi.
Điều chúng tôi muốn nói với chính mình một năm trước
Chín bài học kỹ thuật
-
01
Bắt đầu từ những câu hỏi đã có trong hộp thư—không phải từ công nghệ.
-
02
Công cụ hơn prompt: khi mô hình cần “biết” điều gì đó động, hãy thêm một công cụ, không phải một đoạn văn.
-
03
Giữ cơ sở tri thức đơn giản: PDF và Markdown mà nhân viên vốn đã duy trì.
-
04
Ghim mô hình và ghi lại phiên bản—bí danh trôi nổi âm thầm thay đổi hành vi.
-
05
Suy giảm có kiểm soát: lỗi công cụ là dữ liệu; bot vẫn hoạt động khi một phụ thuộc ngừng chạy.
-
06
Đặt giới hạn cho mọi thứ—số vòng, ký tự, token, tần suất. Tiêu thụ không giới hạn là một hóa đơn thật.
-
07
Tiền đặt sau Stripe và biểu mẫu, không bao giờ sau cửa sổ chat.
-
08
Dùng chuẩn mở: MCP + OAuth2 giúp tích hợp tái sử dụng được cho những client chưa xây dựng.
-
09
Xây trang quản trị trước: tải tài liệu, đọc nhật ký—chất lượng đến từ đó.
Bài học thứ mười, tặng kèm: viết system prompt như một chính sách—quản lý phiên bản, rà soát và kiểm thử như mã.
Trình bày trực tiếp
NATEA Toronto · AI cho doanh nghiệp vừa và nhỏ
- 60 phút · bài nói & demo trực tiếp · trực tuyến
Diễn giả: Nelson Lai — SolvoSync · CTO, Atravesar Services
Bài nói 60 phút kèm demo trực tiếp ngày 21 tháng 10 năm 2026 (trực tuyến), cho thấy một doanh nghiệp bán lẻ vận hành trên atravesar.ca như thế nào và AI thực sự phát huy giá trị ở đâu: dữ liệu 2026 của Cơ quan Thống kê Canada về việc áp dụng AI ở doanh nghiệp vừa và nhỏ, ba mô hình—tri thức, công cụ, tự động hóa—hai demo trên môi trường thật, danh sách kiểm tra bảo mật và quyền riêng tư cho Canada, cùng kế hoạch khởi đầu bốn tuần.
19% doanh nghiệp Canada dùng AI, 25% dự định dùng và 40% cho rằng nó không liên quan. Sự liên quan nằm ngay trong hộp thư của bạn.
Những câu hỏi thường gặp về dự án này
Làm sao ngăn trợ lý bịa đặt thông tin?
Dữ kiện chỉ đến từ các đoạn đã truy xuất hoặc công cụ, không bao giờ từ trí nhớ của mô hình: system prompt bắt buộc tra cứu cơ sở tri thức cho địa chỉ, giờ làm việc và chính sách, temperature là 0,4 và trợ lý chuyển sang email khi công cụ không trả lời được. Những câu trả lời ban đầu về giờ mở cửa đến từ kiến thức chung; quy tắc tra cứu đã khắc phục.
Một câu trả lời AI tốn bao nhiêu?
Theo giá niêm yết tháng 10/2026, một câu trả lời—khoảng 12.000 token đầu vào cộng 300 token đầu ra—tốn khoảng US$0,004, nên 10.000 câu trả lời mỗi tháng vào khoảng US$45. Chi phí thực sự là kỹ thuật và bảo trì nội dung, không phải token.
Doanh nghiệp của tôi có thể tái sử dụng cách tiếp cận này hoặc các máy chủ MCP không?
Có. Lớp công cụ được xây trên chuẩn mở—MCP qua Streamable HTTP với OAuth2 client-credentials—nên cùng một máy chủ có thể phục vụ bất kỳ trợ lý nào. SolvoSync xây dựng cùng mô hình này cho các doanh nghiệp vừa và nhỏ khác: bắt đầu từ những câu hỏi đã có trong hộp thư, ra mắt một kênh trong bốn tuần, đo lường trước khi tuyên bố.
Dữ liệu cá nhân được xử lý thế nào?
Dữ liệu cá nhân nằm ngoài cửa sổ chat. Trợ lý hướng người dùng tới các biểu mẫu có sự đồng ý, xác thực và Stripe; bí mật được giữ ở phía máy chủ; phiên là token HttpOnly gắn với IP và trình duyệt; mọi lượt đều được ghi nhật ký cùng phiên bản mô hình. Thiết kế tuân theo nguyên tắc của PIPEDA và Luật 25 của Québec: mô hình không quyết định—mã và con người quyết định.
Bạn muốn điều này cho doanh nghiệp của mình?
SolvoSync thiết kế, xây dựng và vận hành website, các tích hợp và lớp trợ lý AI—bắt đầu từ những câu hỏi đã có trong hộp thư của bạn, với một kênh đi vào hoạt động trong bốn tuần.