Skip to main content

Creazione della Knowledge Base

La Knowledge Base è il cuore del tuo assistente Grip AI. È la fonte di tutte le informazioni che l’assistente utilizzerà per rispondere alle domande dei chiamanti. Una knowledge base ben strutturata è la chiave per risposte accurate e conversazioni di qualità.
Importante: L’assistente risponde solo basandosi sulle informazioni presenti nella knowledge base. Non inventa risposte o utilizza conoscenze generali.

Cos’è una Knowledge Base?

La Knowledge Base è un insieme di documenti, informazioni e dati che “insegnano” all’assistente AI tutto ciò che deve sapere sulla tua azienda, prodotti e servizi.

Cosa Contiene

  • Informazioni aziendali
  • Dettagli prodotti/servizi
  • Procedure operative
  • FAQ comuni
  • Politiche aziendali

Come Viene Usata

  • Rispondere alle domande
  • Fornire informazioni accurate
  • Guidare conversazioni
  • Gestire richieste specifiche
  • Mantenere coerenza

Tipi di Sorgenti Supportate

Grip AI supporta diversi tipi di sorgenti per costruire la tua knowledge base: Importa direttamente contenuti dal tuo sito web.
1

Accedi alla Sezione Knowledge Base

Nella dashboard, vai su “Knowledge Base” del tuo assistente
2

Aggiungi Sorgente Web

Clicca su ”+ Aggiungi Sorgente” → “Link Web”
3

Inserisci URL

Incolla l’URL della pagina che vuoi importare
Esempio: https://www.tuodominio.it/chi-siamo
4

Configura Importazione

  • Ricorsivo: Importa anche pagine linkate
  • Profondità: Quanti livelli seguire (1-3)
  • Filtri: Escludi certe sezioni (es. footer, sidebar)
5

Importa

Clicca “Importa” e attendi l’elaborazione
URL da Includere:
  • Pagina Chi Siamo
  • Pagine prodotti/servizi
  • FAQ esistenti
  • Pagine informative
  • Guide e tutorial
Consigli:
  • Usa profondità 2 per siti ben strutturati
  • Escludi blog se non pertinente
  • Aggiorna periodicamente se il sito cambia

2. Documenti PDF

Carica manuali, guide e documentazione in formato PDF.
1

Prepara il PDF

  • Massimo 10MB per file
  • Preferibilmente con testo selezionabile (non scansioni)
  • Rimuovi pagine non necessarie
2

Upload

Clicca ”+ Aggiungi Sorgente” → “Carica PDF” Seleziona il file dal tuo computer
3

Attendi Elaborazione

L’AI estrae e analizza il testo (può richiedere 1-3 minuti)
4

Verifica

Controlla che il contenuto sia stato estratto correttamente
Ottimi per Knowledge Base:
  • 📘 Manuali prodotto
  • 📋 Cataloghi servizi
  • 📝 Procedure operative standard (SOP)
  • 📊 Listini prezzi
  • 🎓 Guide tecniche
  • 📑 Documentazione contrattuale
Formato Consigliato:
  • Testo digitale (non scansioni)
  • Ben formattato con titoli
  • Massimo 50 pagine per file
  • Immagini solo se necessarie
Se hai solo PDF scansionati:Opzione 1: OCR Esterno
  1. Usa un tool OCR (Adobe, ABBYY)
  2. Converte in PDF con testo
  3. Carica su Grip
Opzione 2: Trascrizione Manuale
  1. Copia il testo manualmente
  2. Crea documento Word/TXT
  3. Carica come testo
PDF scansionati senza OCR non possono essere elaborati correttamente dall’AI.

3. Documenti Word e TXT

Carica documenti di testo in formato DOCX o TXT.
Formati Supportati:
- .docx (Microsoft Word)
- .doc (Word legacy)
- .txt (Plain text)
- .md (Markdown)

Dimensione Massima: 10MB per file
Codifica: UTF-8 raccomandato per TXT
Consiglio Pro: I file TXT sono ideali per FAQ strutturate. Usa un formato semplice come:
Q: Quali sono i vostri orari?
A: Siamo aperti dal lunedì al venerdì, dalle 9:00 alle 18:00.

Q: Come posso contattarvi?
A: Puoi chiamarci al numero 02 1234567 o scriverci a [email protected]

4. Q&A Personalizzate

Crea coppie domanda-risposta specifiche direttamente nell’interfaccia.
1

Apri Editor Q&A

Nella Knowledge Base, clicca ”+ Aggiungi Q&A”
2

Scrivi Domanda

Inserisci la domanda esattamente come potrebbe farla un cliente
Esempio: "Quanto tempo ci vuole per ricevere il prodotto?"
3

Scrivi Risposta

Fornisci una risposta completa e accurata
Esempio: "La spedizione standard richiede 3-5 giorni lavorativi. 
Offriamo anche spedizione express in 24-48 ore con un supplemento 
di €5. Il tracking viene inviato via email appena il pacco parte."
4

Salva

Clicca “Salva Q&A”
Ideale per:
  • ✅ Informazioni critiche che devono essere precise al 100%
  • ✅ Risposte a domande molto frequenti
  • ✅ Informazioni non presenti in altri documenti
  • ✅ Override di informazioni generiche
  • ✅ Casi edge o situazioni specifiche
Esempio Pratico:
Q: Offrite sconti per ordini superiori a 1000€?
A: Sì! Per ordini superiori a 1000€ applichiamo automaticamente 
uno sconto del 10%. Per ordini superiori a 5000€, contatta il 
nostro reparto vendite per offerte personalizzate al numero 
02 1234567 interno 3.
Domande:
  • Scrivi come parlerebbero i clienti reali
  • Includi varianti della stessa domanda
  • Usa linguaggio naturale
✅ BUONO:
Q: Quanto costa la spedizione?
Q: C'è un costo per la consegna?
Q: Devo pagare per ricevere il pacco?

❌ CATTIVO:
Q: Informazioni spedizione
Q: Costo delivery
Risposte:
  • Sii specifico e completo
  • Usa numeri e dati concreti
  • Fornisci alternative quando possibile
  • Indica prossimi passi
✅ BUONO:
A: La spedizione standard costa €4.90 e richiede 3-5 giorni 
lavorativi. È gratuita per ordini superiori a €50. Offriamo 
anche spedizione express a €9.90 con consegna in 24-48 ore.

❌ CATTIVO:
A: La spedizione ha un costo variabile.
Le Q&A personalizzate hanno priorità massima sulle altre fonti.Come Funziona:
1. Cliente fa domanda
2. AI cerca prima nelle Q&A personalizzate
3. Se trova match → usa quella risposta
4. Se non trova → cerca nei documenti
Usa Questo per:
  • Sovrascrivere informazioni generiche
  • Garantire risposte precise su temi critici
  • Aggiornamenti temporanei (es. “Durante le feste…”)
Troppi Q&A (>100) possono rallentare le risposte. Usa con moderazione.

Struttura Ideale della Knowledge Base

Una knowledge base efficace segue questa struttura:

1. Informazioni Fondamentali (OBBLIGATORIE)

# IDENTITÀ AZIENDA
Nome: [Nome Azienda]
Settore: [Settore di attività]
Sede: [Città/Indirizzo]
Anno fondazione: [Anno]

# CONTATTI
Telefono: [Numero]
Email: [Email principale]
Sito web: [URL]
Orari: [Orari di apertura dettagliati]

# MISSION & VALORI
Cosa facciamo: [Descrizione chiara servizi/prodotti]
Per chi: [Target clienti]
Come: [Approccio/differenziatori]
Queste informazioni saranno usate dall’assistente in quasi ogni conversazione. Devono essere accurate e sempre aggiornate.

2. Prodotti/Servizi (CORE)

# CATALOGO PRODOTTI

## Categoria: [Nome Categoria]

### Prodotto: [Nome Prodotto]
- Descrizione: [Descrizione dettagliata]
- Prezzo: [€XX.XX]
- Disponibilità: [In stock/Esaurito/Preordine]
- Varianti: [Colori/Taglie/Opzioni]
- Tempi consegna: [X giorni]
- Garanzia: [Dettagli garanzia]

## Spedizioni
- Standard: €X.XX - [X-Y giorni]
- Express: €X.XX - [X-Y giorni]
- Gratuita: Ordini > €XX
- Tracking: Sì/No

## Resi
- Periodo: [X giorni]
- Condizioni: [Dettagli]
- Costi: [Gratuito/A carico cliente]
- Procedura: [Steps]

3. FAQ (ALTAMENTE RACCOMANDATE)

Organizza le FAQ per categoria:
# FAQ - DOMANDE GENERALI

Q: Quali sono i vostri orari di apertura?
A: Siamo aperti dal lunedì al venerdì dalle 9:00 alle 18:00 
e il sabato dalle 9:00 alle 13:00. Domenica chiusi.

Q: Dove siete situati?
A: La nostra sede principale è in [Indirizzo completo]. 
Abbiamo anche una filiale a [Altra città].

Q: Come posso contattarvi?
A: Puoi chiamarci al [numero], inviarci una email a [email], 
o compilare il form sul nostro sito [url].

Q: Offrite consulenze gratuite?
A: Sì, la prima consulenza è gratuita e senza impegno. 
Prenota chiamando il [numero] o tramite il sito.
# FAQ - ORDINI E SPEDIZIONI

Q: Come posso effettuare un ordine?
A: Puoi ordinare online su [sito], per telefono al [numero], 
o via email a [email]. Accettiamo tutti i metodi di pagamento.

Q: Quali metodi di pagamento accettate?
A: Accettiamo carte di credito/debito (Visa, Mastercard, 
American Express), PayPal, bonifico bancario e contrassegno.

Q: Quanto tempo ci vuole per la spedizione?
A: Spedizione standard: 3-5 giorni lavorativi (€4.90)
Spedizione express: 24-48 ore (€9.90)
Spedizione gratuita per ordini superiori a €50.

Q: Posso tracciare il mio ordine?
A: Sì, riceverai un codice di tracking via email appena 
il pacco parte. Puoi tracciarlo su [link].

Q: Cosa devo fare se il pacco non arriva?
A: Contattaci entro 48 ore dalla data di consegna prevista. 
Verificheremo con il corriere e risolveremo il problema.
# FAQ - SUPPORTO E ASSISTENZA

Q: Ho un problema con il prodotto, cosa faccio?
A: Contatta il nostro supporto tecnico al [numero] o 
scrivi a [email]. Siamo disponibili lun-ven 9-18.

Q: Il prodotto è in garanzia?
A: Sì, tutti i nostri prodotti hanno garanzia di [X anni]. 
Per maggiori dettagli consulta [link certificato garanzia].

Q: Posso restituire un prodotto?
A: Sì, hai [X giorni] per restituire il prodotto se non 
sei soddisfatto. Deve essere in condizioni originali con 
imballo integro. Per info: [link politica resi].

Q: Come richiedo assistenza tecnica?
A: Apri un ticket su [link] o chiama [numero]. 
Tempo medio di risposta: [X ore] per urgenze, 
[Y ore] per richieste standard.

4. Politiche Aziendali

# POLITICHE AZIENDALI

## Politica Resi e Rimborsi
[Dettagli completi su come funzionano resi e rimborsi]

## Politica Privacy
[Riassunto di come gestite i dati, link a privacy policy completa]

## Termini e Condizioni
[Punti salienti, link a T&C completi]

## Politica Spedizioni
[Dettagli su costi, tempi, corrieri utilizzati]

## Politica Cancellazioni
[Come cancellare ordini, appuntamenti, servizi]

5. Procedure Operative (SE APPLICABILE)

# PROCEDURE INTERNE

## Gestione Reclami
1. Raccogliere tutti i dettagli
2. Registrare ticket sistema [sistema]
3. Risposta entro [X ore]
4. Follow-up se necessario

## Escalation
Quando trasferire a un umano:
- Richieste complesse non gestibili
- Cliente molto insoddisfatto
- Problemi tecnici oltre le competenze
- Decisioni che richiedono autorizzazione

Numeri trasferimento:
- Supporto: [numero/interno]
- Vendite: [numero/interno]
- Manager: [numero/interno]

## Situazioni di Emergenza
[Come gestire emergenze o situazioni critiche]

Best Practices per Contenuti

Linguaggio e Stile

✅ Fare

  • Usa linguaggio chiaro e semplice
  • Scrivi frasi brevi
  • Sii specifico con date e numeri
  • Fornisci esempi concreti
  • Usa elenchi puntati
  • Includi contesti

❌ Evitare

  • Gergo tecnico non necessario
  • Frasi lunghe e complesse
  • Informazioni vaghe
  • Affermazioni generiche
  • Muri di testo
  • Ambiguità

Esempi Pratici

I nostri prodotti sono di alta qualità e offriamo 
un servizio eccellente. Abbiamo varie opzioni disponibili 
e i prezzi sono competitivi. Contattaci per maggiori informazioni.
Problemi:
  • Troppo vago
  • Nessun dato concreto
  • Non risponde a domande specifiche
  • Richiede follow-up

Formattazione

# Livello 1 - Argomento Principale
## Livello 2 - Sottosezione
### Livello 3 - Dettaglio

Esempio:
# Servizi
## Consulenza
### Consulenza Marketing
#### Cosa Include
Aiuta l’AI a capire la struttura e trovare informazioni velocemente.
Per Sequenze:
Come prenotare:
1. Scegli il servizio
2. Seleziona data e ora
3. Compila il form
4. Conferma via email
Per Liste:
Documenti necessari:
- Carta d'identità valida
- Codice fiscale
- Certificato residenza
| Piano | Prezzo/mese | Include |
|-------|-------------|---------|
| Basic | €29 | 10 utenti, 5GB storage |
| Pro | €79 | 50 utenti, 50GB storage |
| Enterprise | Custom | Illimitato |
Le tabelle aiutano a confrontare opzioni rapidamente.

Organizzazione e Manutenzione

Struttura a Cartelle

Organizza la knowledge base logicamente:
📁 Knowledge Base
  📁 01-Informazioni-Azienda
    📄 Chi-siamo.txt
    📄 Contatti-orari.txt
    📄 Sedi.txt
  
  📁 02-Prodotti
    📄 Catalogo-generale.pdf
    📄 Listino-prezzi-2025.xlsx
    📁 Categorie
      📄 Categoria-A.txt
      📄 Categoria-B.txt
  
  📁 03-Servizi
    📄 Servizio-consulenza.txt
    📄 Servizio-installazione.txt
  
  📁 04-FAQ
    📄 FAQ-generali.txt
    📄 FAQ-ordini.txt
    📄 FAQ-tecnico.txt
  
  📁 05-Politiche
    📄 Resi-e-rimborsi.pdf
    📄 Spedizioni.txt
    📄 Privacy-policy.pdf
  
  📁 06-Procedure
    📄 Gestione-reclami.txt
    📄 Escalation.txt

Versionamento

1

Sistema di Versioni

Mantieni uno storico delle modifiche:
FAQ-generali-v1.0.txt (01-01-2025)
FAQ-generali-v1.1.txt (15-01-2025) - Aggiunti orari festivi
FAQ-generali-v2.0.txt (01-02-2025) - Nuova politica resi
2

Documenta Modifiche

Tieni un changelog:
# CHANGELOG Knowledge Base

## 2025-02-01
- Aggiornato listino prezzi (+3% generale)
- Nuova politica resi (da 14 a 30 giorni)
- Aggiunti 3 nuovi prodotti categoria B

## 2025-01-15
- Modificati orari periodo festivo
- Aggiunto FAQ su spedizioni internazionali
3

Review Periodica

Programma revisioni regolari:
  • Settimanale: FAQ (aggiungi nuove domande dai transcript)
  • Mensile: Prezzi e disponibilità
  • Trimestrale: Review completa accuratezza
  • Annuale: Pulizia contenuti obsoleti

Testing della Knowledge Base

Dopo aver creato o aggiornato la knowledge base:
1

Prepara Domande Test

Crea una lista di 20-30 domande comuni
2

Chiama l'Assistente

Effettua chiamate di prova ponendo le domande
3

Valuta Risposte

Verifica:
  • ✅ Accuratezza
  • ✅ Completezza
  • ✅ Chiarezza
  • ✅ Tono appropriato
4

Identifica Gap

Nota dove l’assistente:
  • Non sa rispondere
  • Risponde in modo incompleto
  • Fornisce info errate
5

Integra KB

Aggiungi le informazioni mancanti

Metriche di Qualità Knowledge Base

Monitora questi indicatori:

Coverage Rate

Definizione: % domande con risposta nella KBTarget: >95%Come Migliorare:
  • Analizza domande senza risposta nei transcript
  • Aggiungi FAQ per temi ricorrenti

Confidence Score

Definizione: Quanto l’AI è sicura delle risposteTarget: Media >85%Come Migliorare:
  • Informazioni più dettagliate
  • Rimuovi contraddizioni
  • Chiarisci ambiguità

Update Frequency

Definizione: Quanto spesso aggiorni la KBTarget:
  • FAQ: Settimanale
  • Prezzi: Mensile
  • Tutto: Trimestrale
Come Ottimizzare:
  • Automatizza dove possibile
  • Processi chiari

Information Density

Definizione: Rapporto info utili / totale testoTarget: >70%Come Migliorare:
  • Rimuovi fluff
  • Informazioni essenziali
  • Elimina ridondanze

Errori Comuni da Evitare

❌ Problema:
"Offriamo servizi di alta qualità a prezzi competitivi"
"I nostri prodotti sono i migliori sul mercato"
✅ Soluzione:
"Servizio Consulenza SEO: €590, include audit 50+ punti, 
analisi 20 keyword, piano azione, report PDF. 
Durata: 2-3 settimane. Risultati: +20-40% traffico in 3 mesi."
❌ Problema:
Documento 1: "Spedizione gratuita oltre €50"
Documento 2: "Spedizione gratuita oltre €30"
FAQ: "La spedizione costa sempre €4.90"
Effetto: L’AI si confonde e fornisce risposte incoerenti✅ Soluzione:
  • Usa una sola fonte per ogni tipo di informazione
  • Rimuovi documenti obsoleti
  • Verifica coerenza prima di caricare
❌ Troppo Tecnico:
"Il processo di deployement del nostro software B2B SaaS 
utilizza architettura microservizi containerizzata con 
orchestrazione Kubernetes e CI/CD pipeline su AWS ECS..."
❌ Troppo Vago:
"Installiamo il software e lo configuriamo per te"
✅ Bilanciato:
"Installazione Professional Include:
1. Setup server (cloud o on-premise)
2. Configurazione personalizzata
3. Migrazione dati esistenti
4. Test e verifica funzionalità
5. Training team (4 ore)

Durata: 3-5 giorni lavorativi
Prezzo: €1.200 una tantum
Include: 30 giorni supporto post-installazione"
❌ Problema:
"Durante COVID-19 siamo aperti solo su appuntamento"
"Promozione Black Friday: -30% su tutto"
"Listino prezzi 2023"
✅ Soluzione:
  • Date su ogni documento
  • Review periodiche programmate
  • Alert automatici per scadenze
  • Rimuovi subito info time-sensitive scadute
❌ Problema:
  • 500 pagine di manuali tecnici
  • 200 prodotti con descrizioni lunghissime
  • Troppi documenti ridondanti
Effetto:
  • AI rallenta
  • Risposte confuse
  • Difficoltà a trovare info rilevante
✅ Soluzione:
  • Mantieni KB sotto 100 documenti quando possibile
  • Riassumi manuali lunghi (pagine chiave)
  • Crea “Executive Summaries”
  • Usa Q&A per override rapidi

Template Pronti all’Uso

Template: Azienda Servizi

# [NOME AZIENDA] - KNOWLEDGE BASE

## INFORMAZIONI AZIENDA

### Identità
Nome: [Nome Azienda S.r.l.]
Settore: [Servizi professionali / Consulenza / etc]
Fondazione: [Anno]
Sede legale: [Indirizzo completo]
P.IVA: [numero]

### Contatti
Telefono: [+39 XX XXXX XXXX]
Email: [[email protected]]
Sito web: [www.azienda.it]
PEC: [[email protected]]

### Orari
Lunedì - Venerdì: 9:00 - 13:00 / 14:00 - 18:00
Sabato: Su appuntamento
Domenica e festivi: Chiuso

Periodo estivo (luglio-agosto): Lun-Ven 9:00 - 13:00

### Chi Siamo
[Descrizione dell'azienda: cosa fate, per chi, da quanto tempo, 
team size, valori, mission. Max 200 parole]

---

## SERVIZI

### Servizio 1: [Nome Servizio]

**Descrizione:**
[Cosa include, come funziona, per chi è ideale]

**Include:**
- [Elemento 1]
- [Elemento 2]
- [Elemento 3]

**Durata:** [X settimane/mesi]

**Prezzo:** 
- Base: €XXX
- Opzione Premium: €XXX (include [extra])

**Come Prenotare:**
1. Chiamare il [numero]
2. Email a [email]
3. Form su [URL]

**Cosa Portare:**
- [Documento/Info necessaria 1]
- [Documento/Info necessaria 2]

---

### Servizio 2: [Nome Servizio]
[Ripeti struttura sopra]

---

## FAQ

### Domande Generali

**Q: Quali sono i vostri orari?**
A: Siamo aperti dal lunedì al venerdì dalle 9:00 alle 18:00 
(pausa pranzo 13-14). Il sabato su appuntamento.

**Q: Dove siete situati?**
A: La nostra sede è in [Indirizzo]. Facilmente raggiungibile 
con [mezzi pubblici/parcheggio].

**Q: Offrite la prima consulenza gratuita?**
A: [Sì/No e dettagli]

### Domande su Prenotazioni

**Q: Come posso prenotare un appuntamento?**
A: Puoi prenotare in 3 modi:
1. Chiamando il [numero]
2. Inviando email a [email]
3. Compilando il form su [URL]
Ti confermeremo l'appuntamento entro 24 ore.

**Q: Posso spostare/cancellare un appuntamento?**
A: Sì, avvisaci con almeno 24 ore di anticipo chiamando 
[numero] o scrivendo a [email]. Senza preavviso dovremo 
addebitare [% o importo].

**Q: Cosa succede se sono in ritardo?**
A: Avvisaci appena possibile. Se il ritardo è superiore a 
15 minuti potremmo dover riprogrammare.

### Domande su Pagamenti

**Q: Quali metodi di pagamento accettate?**
A: Accettiamo:
- Bonifico bancario
- Carta di credito/debito
- Contanti (fino a €XX per legge)
- PayPal

**Q: Quando devo pagare?**
A: [Al momento della prenotazione / Dopo il servizio / 
50% anticipo 50% a completamento]

**Q: Emettete fattura?**
A: Sì, emettiamo regolare fattura elettronica. 
Comunicaci P.IVA e dati al momento della prenotazione.

---

## POLITICHE

### Cancellazioni
[Dettagli politica cancellazioni]

### Privacy
[Riassunto: come vengono gestiti i dati dei clienti]
Policy completa: [URL]

### Reclami
Per reclami o segnalazioni:
- Email: [email reclami]
- Tel: [numero]
Risposta garantita entro 48 ore lavorative.

---

## PROCEDURE INTERNE

### Quando Trasferire a Operatore Umano
- Richieste molto complesse o fuori standard
- Cliente molto insoddisfatto o arrabbiato
- Situazioni che richiedono autorizzazione speciale
- Emergenze

### Numeri Trasferimento
- Segreteria: [numero] int. [X]
- Responsabile: [numero] int. [X]
- Emergenze: [numero mobile]

### Casi Speciali
[Istruzioni per situazioni particolari specifiche del tuo business]

---

ULTIMO AGGIORNAMENTO: [Data]
VERSIONE: [1.0]

Checklist Finale

Prima di attivare l’assistente, verifica:

Prossimi Passi

Pro Tip: La knowledge base è un organismo vivo. Programma una revisione settimanale dei transcript per identificare domande ricorrenti e aggiornare la KB di conseguenza.