Guide

Collega i tuoi dati: file, API e mappatura automatica

Quali tabelle caricare, cosa sbloccano, come funzionano la mappatura delle colonne e i report di qualità, e come mantenere i dati sempre aggiornati.

2 Nov 2026 · 2 min di lettura

Gli agenti lavorano sui tuoi prodotti, negozi, ordini, scorte e policy. Li carichi una volta in un modello di dati standard. I tuoi file possono mantenere i tuoi nomi di colonna: la piattaforma li mappa per te.

Cosa caricare, e cosa sblocca

Tabella Colonne minime Cosa sblocca
Products sku, name, category Personal Shopper, Shop the Look, agenti di merchandising
Stores store_id, name, city (+ orari di apertura, fuso orario) Store Locator, Store Staff Copilot
Customers customer_id Loyalty Assistant, Clienteling, segmenti
Orders + Order lines order_id, customer_id, order_date / order_id, sku stato ordini, resi, analisi vendite
Inventory sku, location_id, on_hand Stock-out Sentinel, disponibilità
Promotions promo_id Promotion Analyst
Knowledge docs file .md / .txt Customer Care, FAQ, assistente HR

Formati: Parquet (consigliato), CSV, TSV e JSON. Policy e FAQ: Markdown o testo semplice.

1. Carica un file

Nella console, apri Data, scegli la tabella (ad esempio Products), seleziona il tuo file e clicca su Upload & map columns.

2. Controlla la mappatura delle colonne

La piattaforma propone una corrispondenza per ogni campo standard (ad esempio item_code → sku, sale_price → price, image_link → image_url) e mostra valori di esempio del tuo file. I campi obbligatori sono contrassegnati; correggi con i menu a tendina dove serve, poi clicca su Process.

3. Leggi il report di qualità

L'elaborazione richiede pochi secondi (i prodotti qualcosa in più, perché vengono indicizzati per la ricerca AI). Il report mostra le righe caricate, i duplicati rimossi, i valori vuoti o illeggibili per ogni campo e le colonne che non sono state utilizzate.

Mantieni i dati aggiornati

Ricarica la stessa tabella ogni volta che cambia. Ogni caricamento è una nuova versione; l'ultima andata a buon fine diventa automaticamente attiva e gli agenti la usano dalla domanda successiva. Un documento di conoscenza con lo stesso nome file sostituisce quello precedente.

Automatizza il tutto

Invia file dai tuoi sistemi tramite API:

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

Vedi Chiavi API e integrazione. I connettori per piattaforme e-commerce come Shopify e Magento sono nella nostra roadmap.

#onboarding#data#integration#csv#parquet

Provatelo sul vostro catalogo. Scopri gli agenti

AI Agent Buddies più popolari

🛍️ ● Demo live

Cliente · Scoperta e acquisto

Personal Shopper

Trova prodotti in base a esigenza, budget, colore e occasione; confronta le opzioni e consiglia le più adatte.

Per i clienti
Provalo live →
💬 ● Demo live

Cliente · Assistenza

Assistenza clienti

Risponde alle domande sulle policy partendo dai documenti del retailer, verifica gli ordini e l'idoneità ai resi.

Per i clienti
Provalo live →
🚚 ● Demo live

Cliente · Assistenza

Stato dell'ordine (WISMO)

“Dov'è il mio ordine?”: stato, date e prossimi passaggi.

Per i clienti
Provalo live →
📍 ● Demo live

Cliente · Assistenza

Trova negozi

Negozi più vicini, stato aperto/chiuso in tempo reale nell'ora locale, orari e servizi.

Per i clienti
Provalo live →
👗 ● Demo live

Cliente · Scoperta e acquisto

Stylist “Shop the Look”

Crea un outfit completo e coordinato attorno a qualsiasi prodotto o occasione, usando solo articoli reali del catalogo.

Per i clienti
Provalo live →
📊 ● Demo live

Merchandising e assortimento

Copilota merchandising

Risponde con i numeri alle domande su assortimento e performance, poi consiglia le azioni da intraprendere.

Per il vostro team
Provalo live →
🚨 ● Demo live

Inventario e supply chain

Sentinella rotture di stock

Segnala gli SKU a rischio rottura di stock confrontando le giacenze con la velocità di vendita recente.

Per il vostro team
Provalo live →
🤝 ● Demo live

Operazioni di negozio

Assistente clienteling

Prepara una scheda cliente (livello, ordini passati) e suggerisce prodotti da proporre a un cliente abituale.

Per il vostro team
Provalo live →
👥 ● Demo live

Marketing e CRM

Generatore di segmenti

Crea segmenti di clienti in base a livello, città e comportamento d'acquisto, con i relativi conteggi.

Per il vostro team
Provalo live →

Articoli correlati

🧭Guide
Guide · 2 min di lettura

Come funziona l'onboarding: dalla prima chiamata agli agenti AI attivi

I sei passaggi dalla prima conversazione agli agenti che servono i tuoi clienti: workspace, dati, agenti, test, lancio e team. La maggior parte dei rivenditori è operati…

🧭Guide
Guide · 1 min di lettura

Installare e configurare gli agenti per la tua attività

Esplora il catalogo degli agenti, installa quelli supportati dai tuoi dati e personalizzali con le tue istruzioni.

🧭Guide
Guide · 1 min di lettura

Metti alla prova i tuoi agenti nel Playground prima del lancio

Una chat privata con tutti i tuoi agenti che mostra quale agente ha risposto e quali strumenti ha utilizzato, più una checklist pre-lancio.

🧭Guide
Guide · 1 min di lettura

Integrazione con la REST API: agenti e dati nei tuoi sistemi

Crea una chiave API, richiama qualsiasi agente (con streaming), invia dati automaticamente e consulta l'elenco completo degli endpoint.

🧭Guide
Guide · 1 min di lettura

Invita il tuo team: ruoli e permessi

Offri a ogni collega un proprio accesso con il ruolo giusto: owner, admin, analyst o viewer.

🧭Guide
Guide · 1 min di lettura

Lingue e configurazione internazionale

Lingue della console, dell'acquirente e del catalogo spiegate, con configurazioni consigliate per Europa, Golfo, India e Sud-Est asiatico.

🧭Guide
Guide · 1 min di lettura

Lancia l'assistente AI per lo shopping sul tuo sito web o tramite un link

Scegli le lingue e il brand, poi incolla una riga di codice o condividi un link ospitato. Cosa vedono gli acquirenti e come metterlo in pausa.