Passa al contenuto principale

Integrazione CSV URL

Importa documenti direttamente da file CSV accessibili pubblicamente tramite URL nella base di conoscenza del tuo assistente AI.

Inizio Veloce​

Inizia in 3 passaggi:

  1. Naviga: Amministrazione → I miei assistenti → [Nome Assistente] → Integrazioni → CSV URL
  2. Aggiungi URL: Inserisci il tuo URL CSV pubblico e seleziona il tipo di importazione (FAQ/Prodotto/Predefinito)
  3. Importa: Clicca su "Aggiungi URL" e monitora lo stato

Suggerimento: Prova prima con un piccolo file CSV per familiarizzare con il processo.

Panoramica Integrazione CSV URL

Cosa Puoi Fare​

  • ✅ Importa da URL CSV pubblici HTTP/HTTPS
  • ✅ Importa in blocco più URL contemporaneamente
  • ✅ Rileva automaticamente la struttura CSV (FAQ, Prodotto o Generico)
  • ✅ Assegna categorie e mappa colonne personalizzate
  • ✅ Monitora lo stato e la cronologia dell'importazione

Prerequisites​

  • Accesso da amministratore al tuo assistente AI SmartTalk
  • File CSV accessibili pubblicamente (nessuna autenticazione richiesta)
  • Struttura CSV corretta con intestazioni di colonna
  • Codifica UTF-8 consigliata

Import Types​

1. Import FAQ​

Migliore per: Documentazione di supporto, basi di conoscenza

Colonne richieste:

  • question
  • answer

Esempio:

question,answer
"Come posso reimpostare la mia password?","Clicca su 'Password dimenticata' e segui le istruzioni."
"Quali sono i vostri orari?","Lunedì-Venerdì, 9 AM - 6 PM."

2. Import Prodotto​

Migliore per: Cataloghi di e-commerce, inventario

Colonna richiesta:

  • idProduct (o colonna mappata personalizzata)

Opzionale:

  • name (o colonna mappata personalizzata)

Esempio:

idProduct,name,description,price
"PROD001","Widget Premium","Widget di alta qualità","99.99"
"PROD002","Widget Standard","Widget base","49.99"

3. Import Predefinito​

Migliore per: Contenuti generali, dati misti

  • Rileva automaticamente la struttura FAQ o Prodotto
  • Torna all'importazione di documenti generici
  • Gestisce vari formati CSV

Guida Passo-Passo​

Passo 1: Accesso all'Integrazione​

  1. Accedi a AI SmartTalk
  2. Vai su Amministrazione → I Miei Assistenti → [Il Tuo Assistente]
  3. Clicca su Integrazioni → CSV URL

Passo 2: Aggiungi CSV URL​

URL Singolo:

  1. Clicca su Aggiungi Nuovo CSV URL
  2. Inserisci l'URL del file CSV
  3. Fornisci un nome opzionale
  4. Seleziona il tipo di importazione (FAQ/Prodotto/Predefinito)
  5. Scegli la categoria (opzionale)
  6. Clicca su Aggiungi URL

Modulo di Importazione CSV URL Singolo

Importazione Massiva:

  1. Clicca su Importa URL in Massa
  2. Inserisci gli URL (uno per riga)
  3. Configura le impostazioni condivise
  4. Clicca su Importa Tutti gli URL

Importazione CSV URL in Massa

Passo 3: Configura il Mappatura delle Colonne (Solo Prodotto)​

Mappa le colonne del tuo CSV ai campi previsti:

  • Colonna ID Prodotto: Predefinito idProduct → Mappa a product_id, sku, ecc.
  • Colonna Nome: Predefinito name → Mappa a product_name, title, ecc.

Step 4: Monitor Import​

Traccia lo stato nella Cronologia Importazioni:

  • In attesa: In attesa di elaborazione
  • Importato: Completato con successo
  • Errore: Fallito (visualizza dettagli)

Import Status Dashboard

Step 5: Re-import (Aggiorna Dati)​

  1. Trova l'URL nella cronologia
  2. Clicca su Re-import
  3. Conferma l'azione
  4. Monitora lo stato aggiornato

Step 6: Verify Import​

  1. Controlla la Knowledge Base per nuovi documenti
  2. Testa il chatbot con domande sui contenuti importati

Post-Import Knowledge Base

Requisiti CSV​

URL Validi​

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP non supportato)
❌ https://private.site.com/auth-data.csv (Autenticazione richiesta)
❌ file:///local/data.csv (File locali non supportati)

Requisiti del File​

  • Accesso: Accessibile pubblicamente tramite HTTP/HTTPS
  • Intestazioni: La prima riga deve contenere i nomi delle colonne
  • Delimitatori: Virgola (,) o punto e virgola (;)
  • Codifica: UTF-8 raccomandato
  • Dimensione: Massimo 10MB per file

Risoluzione dei Problemi​

Errori Comuni​

ErroreSoluzione
URL Non AccessibileVerifica che l'URL sia pubblico e valido
Formato Non ValidoControlla delimitatore e intestazioni
Colonne MancantiAssicurati che le colonne richieste esistano (domanda/riposta o idProduct)
Timeout File GrandeDividi il file o riduci la dimensione sotto i 10MB

Passi per la Risoluzione​

  1. Testa l'URL nel browser
  2. Valida la struttura e la codifica del CSV
  3. Rivedi i messaggi di errore nella cronologia di importazione
  4. Testa con un file di esempio più piccolo
  5. Contatta il supporto se il problema persiste

Best Practices​

URL Management​

  • Usa URL stabili e permanenti
  • Testa le URL mensilmente per accessibilità
  • Usa CDN per migliori prestazioni
  • Includi la versione nei nomi dei file: products-v2024.csv

Data Organization​

  • Usa nomi di categoria chiari
  • Mantieni formati CSV coerenti
  • Pulisci i dati prima dell'importazione (rimuovi righe vuote)
  • Tieni i file sotto 10MB

Performance​

  • Testa prima con campioni piccoli
  • Elabora grandi importazioni durante le ore di bassa affluenza
  • Usa l'importazione in blocco per più URL correlati
  • Monitora regolarmente il tasso di successo dell'importazione

Security​

  • ✅ Trasferimenti criptati HTTPS
  • ✅ Validazione delle URL
  • ✅ Controllo degli accessi basato su permessi
  • ✅ Elaborazione di file temporanei (nesso stoccaggio permanente)
  • ✅ Pulizia automatica dei dati obsoleti
  • ✅ Registri di audit per tutte le attività

Dopo l'importazione​

Una volta importati, i tuoi dati:

  1. Diventano ricercabili nella knowledge base
  2. Potenziano immediatamente le risposte del chatbot
  3. Appaiono organizzati per categorie
  4. Possono essere verificati nella sezione Knowledge Base

Verifica il tuo import:

  • Controlla la Knowledge Base per nuovi documenti
  • Testa il chatbot con domande sui contenuti importati
  • Rivedi categorie e organizzazione

Supporto​

Hai bisogno di aiuto?

Ora puoi:

  • ✅ Importare dati CSV da URL pubblici
  • ✅ Gestire tipi di dati FAQ, Prodotto e generici
  • ✅ Importare in blocco più fonti
  • ✅ Mappare colonne personalizzate per i prodotti
  • ✅ Monitorare e gestire gli import
  • ✅ Aggiornare i dati tramite re-import

Prossimi passi:

  1. Testa con un CSV di esempio
  2. Importa i tuoi dati di produzione
  3. Imposta le categorie
  4. Pianifica re-import regolari
  5. Monitora le prestazioni

Domande? Contatta il nostro team di supporto in qualsiasi momento.