Cơ sở kiến thức và sản phẩm

Dùng API để đồng bộ hàng loạt câu hỏi đáp, tài liệu và sản phẩm, cập nhật tăng dần theo ID bên ngoài.

4.1 Kho tri thức

Phương thức	Đường dẫn	Mô tả
POST	`/v1/knowledge/faqs/batch`	Ghi hàng loạt câu hỏi và câu trả lời, `{"items": [{"question", "answer", "external_id"}]}`, tối đa 500 mục. Cập nhật tăng dần theo `external_id`; nội dung không thay đổi sẽ không được xử lý lại
POST	`/v1/knowledge/documents`	Thêm tài liệu: `{"title", "content"}` để cung cấp trực tiếp văn bản, hoặc `{"url"}` để chúng tôi thu thập nội dung từ trang web. Khi có `external_id`, tài liệu cũ cùng ID sẽ được thay thế
POST	`/v1/knowledge/documents/upload`	Tải tệp lên (multipart, trường `file`), hỗ trợ txt, md, html, pdf, docx, tối đa 20MB
GET	`/v1/knowledge/documents`	Danh sách tài liệu, `?page=&limit=&source_type=`
GET	`/v1/knowledge/documents/{id}`	Chi tiết tài liệu, `status` là `pending` / `processing` / `ready` / `failed`
DELETE	`/v1/knowledge/documents/{id}`	Xóa

Tài liệu sau khi được ghi sẽ được xử lý bất đồng bộ, thường chuyển sang ready trong vài giây. Nếu đã cấu hình Webhook, bạn sẽ nhận được document.ready hoặc document.failed.

4.2 Sản phẩm

Phương thức	Đường dẫn	Mô tả
POST	`/v1/products/batch`	Ghi hàng loạt, tối đa 500 mục, cập nhật tăng dần theo `external_id`
GET	`/v1/products`	Danh sách sản phẩm
DELETE	`/v1/products/{external_id}`	Xóa

Các trường của sản phẩm:

{
  "external_id": "w-1001",
  "name": "潜水自动机械表",
  "description": "200 米防水，蓝宝石表镜",
  "category": "手表",
  "price": "399.00",
  "currency": "USD",
  "stock": 12,
  "url": "https://shop.example.com/p/w-1001",
  "image_url": "https://shop.example.com/img/w-1001.jpg",
  "attributes": {"材质": "316L 钢", "表径": "39 mm"},
  "variants": [{"sku": "w-1001-blk", "name": "黑色", "price": "399.00", "stock": 5}],
  "status": "active"
}

stock là null nghĩa là không theo dõi tồn kho; sản phẩm có status là inactive sẽ không được đề xuất. AI chỉ dùng các giá trị ở đây để trả lời về giá và tồn kho.

Trang này có hữu ích không?

Cập nhật lần cuối: 31 tháng 10, 2026