Come addestrare il tuo Agent AI con la Knowledge Base di Irelia.ai

​

~20–30 minuti di configurazione

---

​

Introduzione

Hai configurato il tuo Agent Irelia.ai ed è pronto per le conversazioni — ma non sa ancora nulla della tua attività. Senza le informazioni giuste caricate, il tuo Agent non può rispondere a domande su prezzi, servizi o politiche. E i potenziali clienti che non ottengono risposte passano oltre velocemente. La Knowledge Base (KB) è dove risolvi questo problema. È lo spazio che riempi con i fatti, le FAQ e i dettagli della tua attività, così il tuo Agent AI può cercare tra queste informazioni e rispondere in modo accurato a ogni domanda dei potenziali clienti. Questa guida ti accompagna in tutto il percorso: capire come funziona la Knowledge Base, strutturare i contenuti per ottenere i migliori risultati, caricarli in Irelia e configurare funzionalità intelligenti come l’assegnazione dei documenti e il rilevamento delle lacune. Alla fine di questa guida, avrai: ✅ Una comprensione chiara di come funziona la Knowledge Base e quali contenuti inserire
✅ Documenti D&R ben strutturati caricati e addestrati nel tuo Agent Irelia
✅ Recensioni dei clienti aggiunte come prova sociale nelle conversazioni
✅ Documenti assegnati agli Agent giusti per la massima accuratezza
✅ Notifiche configurate per individuare automaticamente le lacune nella Knowledge Base

​

Come funziona

Pensa alla Knowledge Base come a una biblioteca di riferimento che il tuo Agent AI può consultare durante le conversazioni. Non serve alcuna competenza tecnica — ecco il flusso:

• ✅ Le informazioni devono essere trovabili — Scrivi contenuti che corrispondano al modo in cui i potenziali clienti fanno domande
• ✅ La chiarezza conta — Informazioni chiare e ben strutturate = risposte migliori
• ✅ Gli aggiornamenti sono istantanei — Modifica un documento e l’AI usa immediatamente la nuova versione Quando diciamo che stai “addestrando” l’AI, non gli stai insegnando a pensare diversamente. Gli stai semplicemente dando accesso ai fatti specifici della tua attività di cui ha bisogno. L’AI sa già come gestire le conversazioni — il tuo compito è fornire le informazioni specifiche sulla tua attività di cui ha bisogno per essere utile.

​

📝 Cosa farai

Ecco una panoramica rapida dei passaggi di questa guida:

1. Configura la tua Knowledge Base — Accedi alla KB, crea documenti, aggiungi contenuti e addestra il tuo Agent (~15 minuti)
2. Aggiungi le recensioni dei clienti — Carica le testimonianze come prova sociale (~5 minuti)
3. Assegna documenti ad Agent specifici — Controlla quali Agent accedono a quali informazioni (~3 minuti)
4. Configura le notifiche per informazioni mancanti — Attiva il rilevamento lacune per un miglioramento continuo (~2 minuti)

​

📋 Cosa ti serve

• Un account Irelia.ai con almeno un Agent attivo Obbligatorio
• Le informazioni della tua attività raccolte e pronte (FAQ, prezzi, dettagli prodotti/servizi, politiche) Obbligatorio
• Un LLM con capacità di ragionamento (ChatGPT, Claude, Gemini o simili) per aiutarti a formattare i contenuti — vedi la sezione LLM per Prompt pronti all’uso Opzionale Non serve programmare. Se sai fare copia e incolla, puoi farlo.

​

⚖️ Knowledge Base vs. Prompt: cosa va dove?

Questa è la fonte di confusione n.1 per i nuovi utenti. Facciamo chiarezza.

​

La distinzione chiara

​

📥 Cosa va nella Knowledge Base

Informazioni che il tuo AI può cercare e condividere:

• Descrizioni di prodotti/servizi
• Prezzi e pacchetti
• FAQ e obiezioni comuni
• Informazioni e storia dell’azienda
• Spiegazioni dei processi (come funzionano le cose)
• Politiche (spedizioni, rimborsi, ecc.)
• Casi studio e risultati Esempio: “D: Quali sono i vostri piani tariffari? R: Offriamo tre piani: Starter a €29/mese (fino a 100 contatti), Growth a €79/mese (fino a 1.000 contatti) ed Enterprise a €199/mese (contatti illimitati con supporto prioritario).” Questo è un fatto sulla tua attività. Quando qualcuno chiede dei prezzi, l’AI cerca queste informazioni e le condivide.

​

🚫 Cosa NON va nella Knowledge Base

Queste sono istruzioni comportamentali — appartengono al Prompt:

• “Sii sempre cordiale e professionale”
• “Se qualcuno chiede il prezzo, prima capisci le sue esigenze”
• “Non promettere mai risultati esatti”
• “Cerca sempre di fissare una chiamata”
• “Parla in prima persona come l’azienda”
• Istruzioni sul flusso della conversazione
• Domande di qualificazione da porre

​

Il test rapido

Chiediti: “Questo è un FATTO o un’ISTRUZIONE?”

• Fatto → Knowledge Base
• Istruzione → Prompt Tutto qui. Mantienili separati e il tuo AI funzionerà molto meglio.

​

✍️ Best practice per strutturare i contenuti

Il modo in cui strutturi le informazioni influisce direttamente sulla capacità del tuo AI di trovarle e utilizzarle.

​

💎 Il formato d’oro: stile D&R

Il formato più efficace per i contenuti della Knowledge Base è Domanda e Risposta: D: Quali sono i vostri orari di apertura? R: Siamo aperti dal lunedì al venerdì, dalle 9:00 alle 18:00 (CET). Siamo chiusi nei weekend e nei giorni festivi italiani. Perché funziona:

• Rispecchia il modo in cui i potenziali clienti fanno realmente le domande
• Facile per l’AI abbinare domande e risposte
• Semplice da mantenere e aggiornare

​

🔄 Includi variazioni delle domande

Le persone chiedono la stessa cosa in molti modi diversi. Aggiungere variazioni aiuta l’AI ad abbinare e recuperare le informazioni giuste, indipendentemente da come un potenziale cliente formula la sua richiesta. Esempio: D: Quali sono i vostri orari di apertura? / Quando siete aperti? / A che ora chiudete? / Siete aperti nel weekend? / Posso contattarvi il sabato? R: Siamo aperti dal lunedì al venerdì, dalle 9:00 alle 18:00 (CET). Siamo chiusi nei weekend e nei giorni festivi italiani. Cinque domande diverse, una sola risposta. Più angolazioni copri, più affidabilmente il tuo AI troverà la risposta giusta.

​

🧭 Il framework 5W: anticipa ogni domanda

Usa questo framework per fare brainstorming sulle domande che i tuoi potenziali clienti potrebbero fare:

• ❓ COSA — Cos’è il vostro prodotto? Cosa include? Quali risultati posso aspettarmi?
• 🤔 PERCHÉ — Perché dovrei scegliervi rispetto alla concorrenza? Perché questo approccio funziona?
• ⏰ QUANDO — Quando posso iniziare? Quando vedrò i risultati? Quando siete disponibili?
• 👤 CHI — Per chi è pensato? Chi c’è dietro l’azienda? Con chi lavorerò?
• 📍 DOVE — Dove vi trovate? Dove spedite/operate?
• ⚙️ COME — Come funziona? Come posso iniziare? Quanto costa? Scorri ogni categoria e scrivi coppie D&R per le domande che i tuoi potenziali clienti fanno realmente.

​

📂 Organizzazione dei documenti: pensa per categorie

Non mettere tutto in un unico documento gigante. Dividi le informazioni per argomento — questo rende più facile aggiornare sezioni specifiche e assegnare solo contenuti pertinenti ad Agent specifici. Per esempio, potresti creare documenti separati per:

• FAQ Servizio di Coaching — il tuo processo, passaggi di onboarding, tempistiche, domande e obiezioni comuni
• FAQ Corso Online — costi, cosa è incluso, opzioni di pagamento, domande e obiezioni comuni
• Info Azienda — chi siamo, team, credenziali Le categorie esatte dipendono dalla tua attività. Pensa agli argomenti principali su cui i potenziali clienti chiedono informazioni e crea un documento per argomento.

​

Consigli di formattazione

✅ Fai così:

• Usa un linguaggio chiaro e semplice
• Includi numeri e dettagli specifici
• Includi variazioni di come le persone potrebbero chiedere ❌ Non fare così:
• Usare gergo complesso senza spiegazione
• Includere informazioni contraddittorie
• Scrivere muri di testo senza struttura

​

💰 Omissione strategica del prezzo per attività di servizi

Se vendi servizi ad alto valore, considera di non includere prezzi specifici nella tua Knowledge Base. Invece, aggiungi questo alle tue FAQ: “D: Quanto costa? / Quali sono i vostri prezzi? R: Il prezzo dipende dalla tua situazione specifica e dai tuoi obiettivi. Prenota una breve chiamata con il nostro team e ti forniremo un preventivo personalizzato in base alle tue esigenze.” Perché funziona dal punto di vista commerciale: Quando la prima domanda di qualcuno è “quanto costa?”, spesso ti stanno confrontando solo sul prezzo — di fatto rendendo il tuo servizio una commodity. Indirizzandoli verso una chiamata, tu:

• ✅ Mantieni viva la curiosità — La curiosità sul prezzo è una motivazione potente per prenotare una chiamata. Una volta che riveli il numero, quella motivazione scompare — o ti scartano come “troppo caro” senza contesto, oppure ottengono quello che volevano e se ne vanno.
• ✅ Crei l’opportunità di inquadrare correttamente il valore — In un incontro di vendita, puoi capire le loro esigenze specifiche, posizionare la tua soluzione, differenziarti dalla concorrenza e aiutarli a vedere il vero valore di ciò che offri. Questo sposta la conversazione dall’acquisto basato sul prezzo (chi è il più economico?) all’acquisto basato sul valore (chi è il più adatto alle mie esigenze?). In una chiamata, puoi creare meglio il giusto inquadramento. Dalla nostra esperienza, le attività di servizi che usano questo approccio ottengono più chiamate prenotate e conversazioni di qualità superiore.

​

⚡ Percorso rapido (utenti esperti)

Hai già familiarità con la Knowledge Base di Irelia? Ecco la versione condensata:

1. Irelia: Vai su irelia.ai/settings → clicca sull’icona Knowledge Base nella barra laterale sinistra
2. Crea: Clicca su ”+ Create a new document” (Crea un nuovo documento) → Assegna un nome descrittivo → Aggiungi contenuti in formato D&R
3. Salva: Clicca su “Save” (Salva) → Attendi il segno di spunta ✓ che conferma il completamento dell’addestramento
4. Recensioni: Passa alla scheda “Reviews” (Recensioni) → Crea un documento per ogni recensione usando il formato “[Nome] da [Fonte] dice: [testo della recensione]” → Salva ciascuna
5. Assegna: Vai alle impostazioni del tuo Agent → sezione “Knowledge Base” → Disattiva “Allow this agent to access all information” (Consenti a questo Agent di accedere a tutte le informazioni) → Seleziona documenti specifici
6. Notifiche: Vai alla scheda “Events and Notifications” (Eventi e Notifiche) del tuo Agent → Attiva la notifica per informazioni mancanti → Aggiungi un URL webhook o attiva le notifiche email Hai bisogno di più dettagli? Continua con la guida completa qui sotto.

​

🔧 Configurazione passo dopo passo

​

🎉 Complimenti! Ce l’hai fatta!

Prenditi un momento per apprezzare ciò che hai appena costruito: ✅ Il tuo Agent AI ha una Knowledge Base completa con le informazioni della tua attività
✅ Le recensioni dei clienti sono pronte per essere usate come prova sociale nelle conversazioni
✅ Ogni Agent accede solo ai documenti pertinenti per risposte più accurate
✅ Le notifiche per informazioni mancanti assicurano che la tua Knowledge Base continui a migliorare automaticamente Cosa succede ora: Ogni volta che un potenziale cliente fa una domanda, il tuo Agent AI cerca nella Knowledge Base, trova le informazioni più pertinenti e formula una risposta naturale e accurata — senza che tu muova un dito.

​

Prossimi passi

Ora che la tua Knowledge Base è configurata, le possibilità sono infinite. Le tue opzioni da qui:

1. 🤖 Vuoi aiuto nella creazione dei contenuti? Vai a Usare un LLM per preparare i tuoi documenti per Prompt pronti all’uso che velocizzano la creazione dei contenuti
2. 🔍 Vuoi capire le risposte del tuo AI? Consulta la sezione Debugging per vedere esattamente quali informazioni l’AI usa per ogni risposta
3. 📋 Vuoi verificare che tutto sia configurato correttamente? Usa la Checklist rapida per assicurarti che non sia stato dimenticato nulla
4. ➕ Hai altri contenuti da aggiungere? Ripeti i Passaggi 2–4 per ogni nuovo argomento — crea un nuovo documento, aggiungi contenuti D&R e salva

​

🤖 Usare un LLM per preparare i tuoi documenti

Non hai tempo per scrivere tutto da zero? Qualsiasi LLM potente con ragionamento attivato va bene — ChatGPT, Claude, Gemini o simili. Basta incollare i Prompt qui sotto nel tuo strumento preferito.

​

Metodo 1: Trasforma documenti e pagine web esistenti

Se hai già informazioni sulla tua attività (testi del sito web, brochure, documenti interni), usa questo Prompt per convertirle in formato Knowledge Base:

​

Metodo 2: Genera domande e obiezioni da zero

Non hai contenuti esistenti? Usa questo Prompt per generare una Knowledge Base completa partendo solo da una descrizione della tua attività: Questo ti dà una base solida da personalizzare con i tuoi dettagli specifici.

​

Revisiona prima di caricare

Revisiona sempre i contenuti generati dall’AI prima di aggiungerli alla tua Knowledge Base:

• ✅ Adatta il tono per corrispondere al tuo brand
• ✅ Aggiungi dettagli specifici (numeri, nomi, ecc.)
• ✅ Verifica l’accuratezza e rimuovi informazioni irrilevanti

​

🔍 Debugging: capire come il tuo AI usa le tue informazioni

Hai bisogno di capire perché l’AI ha dato una risposta specifica? Irelia ha strumenti di debugging integrati che ti mostrano esattamente quali contenuti della Knowledge Base l’AI ha utilizzato.

​

🔬 Come accedere alle informazioni di debug

1. Vai su irelia.ai/leads (il tuo pannello chat)
2. Trova una conversazione in cui l’AI ha risposto
3. Cerca l’icona info (ℹ️) accanto ai messaggi dell’AI — questa icona indica quale messaggio ha estratto informazioni dalla Knowledge Base per rispondere

4. Clicca sull’icona per aprire il popup di debug

​

👁️ Cosa vedrai

Il popup mostra:

• Blocchi di informazioni estratti — I pezzi esatti della tua Knowledge Base che l’AI ha trovato pertinenti
• Riepilogo — Una vista condensata delle informazioni pertinenti estratte (ciò che l’AI usa effettivamente per rispondere)

​

📈 Come usare queste informazioni per migliorare

​

✅ Checklist rapida

Usa questa checklist per verificare che la configurazione della tua Knowledge Base sia completa: ✅ Tutto spuntato? La tua Knowledge Base è pronta!

​

🛠️ Risoluzione dei problemi e FAQ