Base di conoscenza e prodotti

Sincronizza in blocco domande e risposte, documenti e prodotti tramite API, con aggiornamenti incrementali basati sull'ID esterno.

4.1 Base di conoscenza

Metodo	Percorso	Descrizione
POST	`/v1/knowledge/faqs/batch`	Scrittura in batch di domande e risposte, `{"items": [{"question", "answer", "external_id"}]}`, massimo 500 elementi. Aggiornamento incrementale per `external_id`: i contenuti invariati non vengono rielaborati
POST	`/v1/knowledge/documents`	Aggiunge un documento: `{"title", "content"}` per fornire direttamente il testo, oppure `{"url"}` e la pagina web viene scaricata da noi. Con `external_id` sostituisce il vecchio documento con lo stesso ID
POST	`/v1/knowledge/documents/upload`	Carica un file (multipart, campo `file`), supporta txt, md, html, pdf, docx, massimo 20 MB
GET	`/v1/knowledge/documents`	Elenco documenti, `?page=&limit=&source_type=`
GET	`/v1/knowledge/documents/{id}`	Dettaglio documento, `status` è `pending` / `processing` / `ready` / `failed`
DELETE	`/v1/knowledge/documents/{id}`	Elimina

Dopo la scrittura, i documenti vengono elaborati in modo asincrono e di solito passano a ready in pochi secondi. Se hai configurato un webhook, riceverai document.ready o document.failed.

4.2 Prodotti

Metodo	Percorso	Descrizione
POST	`/v1/products/batch`	Scrittura in batch, massimo 500 elementi, aggiornamento incrementale per `external_id`
GET	`/v1/products`	Elenco prodotti
DELETE	`/v1/products/{external_id}`	Elimina

Campi del prodotto:

{
  "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 con valore null indica che la giacenza non viene tracciata; i prodotti con status inactive non vengono consigliati. L'AI usa solo questi valori per rispondere su prezzi e disponibilità.

Questa pagina ti è stata utile?

Ultimo aggiornamento: 31 ottobre 2026