Hành động KiotViet được kích hoạt tự động khi bạn kết nối KiotViet trong phần Tích hợp. Không cần cấu hình riêng — tất cả quản lý tại trang Tích hợp.
Tính năng
Kiểm tra tồn kho
Khi khách hàng hỏi về sản phẩm có còn hàng hay không, agent tự động gọi API KiotViet để kiểm tra số lượng tồn kho tại thời điểm hỏi.
- Khách hỏi: “Áo thun trắng còn hàng không?”
- Agent gọi API
/productscủa KiotViet với tên sản phẩm. - KiotViet trả về số lượng tồn kho từ tất cả chi nhánh.
- Agent trả lời: “Áo thun trắng: còn 15 cái.” kèm hình ảnh sản phẩm.
- Tìm theo tên sản phẩm hoặc mã sản phẩm (SKU).
- Hỗ trợ tìm kiếm không dấu — khách gõ “ao thun” vẫn tìm được “Áo thun”.
- Tìm trên toàn bộ danh mục, không giới hạn 100 sản phẩm đầu tiên.
Hiển thị hình ảnh sản phẩm
Khi kiểm tra tồn kho, agent tự động hiển thị hình ảnh sản phẩm từ KiotViet ngay trong cửa sổ chat. Điều này giúp khách hàng xác nhận đúng sản phẩm mình đang tìm.
- Hình ảnh lấy từ thư viện ảnh sản phẩm trên KiotViet — nếu sản phẩm chưa có ảnh, agent chỉ hiển thị thông tin dạng văn bản.
- Chỉ hiển thị ảnh đầu tiên (ảnh chính) của mỗi sản phẩm.
Tra cứu đơn hàng
Khách hàng có thể hỏi về trạng thái đơn hàng bằng nhiều cách khác nhau.
Thông tin trả về:
- Mã đơn hàng / hóa đơn
- Trạng thái (ví dụ: “Đang giao hàng”, “Hoàn thành”)
- Tên khách hàng
- Tổng tiền
- Danh sách sản phẩm trong đơn (tên, số lượng, giá)
Nếu khách không cung cấp mã đơn hàng hoặc số điện thoại, agent sẽ tự động hỏi trước khi tra cứu — đảm bảo tìm đúng đơn.
Đồng bộ sản phẩm vào kiến thức
Ngoài tra cứu thời gian thực, tích hợp KiotViet cũng đồng bộ toàn bộ danh mục sản phẩm (tên, mã, giá, phân loại, mô tả) vào kiến thức của agent. Nhờ đó agent có thể trả lời câu hỏi chung về sản phẩm mà không cần gọi API mỗi lần. Ví dụ:- “Có những loại áo nào?” → Agent trả lời từ kiến thức đã đồng bộ.
- “Áo thun trắng giá bao nhiêu?” → Agent trả lời từ kiến thức đã đồng bộ.
- “Áo thun trắng còn bao nhiêu?” → Agent gọi API KiotViet (dữ liệu thời gian thực).
Xem cách đồng bộ sản phẩm tại trang Tích hợp KiotViet.
Cấu hình
Hành động KiotViet không cần cấu hình riêng — nó được kích hoạt tự động khi bạn kết nối KiotViet trong phần Tích hợp. Để thay đổi hoặc quản lý, hãy vào trang Tích hợp.
Kiểm tra trong Playground
Sau khi kết nối KiotViet và đồng bộ sản phẩm, vào Playground để thử nghiệm:1
Thử kiểm tra tồn kho
Hỏi: “Sản phẩm X còn hàng không?” — agent phải trả lời với số lượng chính xác và hình ảnh sản phẩm (nếu có).
2
Thử tra cứu đơn hàng
Hỏi: “Kiểm tra đơn hàng DH001234” — agent phải trả lời với trạng thái và chi tiết đơn.
3
Thử tìm kiếm không dấu
Hỏi: “ao thun con khong?” — agent phải tìm đúng sản phẩm dù khách không gõ dấu tiếng Việt.
4
Thử câu hỏi chung về sản phẩm
Hỏi: “Có những sản phẩm nào?” — agent phải trả lời từ kiến thức đã đồng bộ.
Mẹo sử dụng hiệu quả
Đồng bộ thường xuyên
Khi thêm sản phẩm mới hoặc thay đổi giá trên KiotViet, nhớ đồng bộ lại và huấn luyện lại agent để kiến thức luôn cập nhật.
Thêm ảnh sản phẩm trên KiotViet
Agent chỉ hiển thị hình ảnh nếu sản phẩm có ảnh trên KiotViet. Thêm ảnh chất lượng tốt để khách hàng có trải nghiệm tốt hơn.
Hướng dẫn trong system prompt
Thêm vào system prompt: “Khi khách hỏi về sản phẩm cụ thể có còn hàng hay không, luôn kiểm tra tồn kho thời gian thực thay vì trả lời từ kiến thức cũ.”
Đào tạo nhân viên
Hướng dẫn nhân viên cửa hàng cách khách hàng có thể tra cứu đơn hàng qua chat — để nhân viên có thể hướng dẫn khách khi cần.