Costruire la base di conoscenza per MagicAI Chat

In questo articolo imparerai quali informazioni MagicAI Chat riceve già automaticamente dal software, cosa devi fornire tramite le tue fonti di conoscenza, quando conviene usare invece le schede Linee guida e Informazioni sullo studio e come strutturare i contenuti affinché il chatbot risponda ai tuoi abbonati in modo preciso.

Contenuti

• Come MagicAI Chat utilizza le tue informazioni
• Cosa proviene automaticamente dal software
• Cosa appartiene alle tue fonti di conoscenza
• Fonti, Linee guida o Informazioni sullo studio
• Consigli sul formato dei file
• Consigli per risposte migliori
• Con quale frequenza aggiornare
• Articoli correlati

---

Come MagicAI Chat utilizza le tue informazioni

MagicAI Chat può fare di più che rispondere alle domande. A seconda delle funzionalità che attivi nella configurazione della chat, agisce anche direttamente: prenota sessioni di prova e corsi, prende in carico la richiesta di disdetta di un abbonato o permette agli abbonati di richiedere una sospensione. Queste azioni provengono dal software. Questo articolo tratta la parte informativa, cioè tutto ciò che MagicAI Chat deve sapere per rispondere con precisione alle domande.

MagicAI Chat risponde esclusivamente sulla base dei contenuti di cui dispone. Non inventa risposte e può rispondere solo a ciò che è effettivamente memorizzato. Se un abbonato pone una domanda per la quale non esiste un'informazione corrispondente, MagicAI Chat non può aiutare. Per questo motivo, fonti di conoscenza complete e aggiornate sono decisive per la qualità di MagicAI Chat.

MagicAI Chat dispone di due tipi di informazioni:

1. Dati di sistema: informazioni che provengono automaticamente dal software (per esempio orari di apertura, contratti, programma dei corsi, offerte di abbonamento).
2. Fonti di conoscenza: contenuti che fornisci tu stesso (file, URL o il tuo Zendesk Help Center).

Tutto ciò che non proviene dal sistema e non è memorizzato nelle tue fonti di conoscenza non può ricevere risposta da MagicAI Chat. Per brevi regole di comportamento e per informazioni temporanee su singoli studi, la configurazione della chat offre inoltre le schede Linee guida e Informazioni sullo studio (vedi Fonti, Linee guida o Informazioni sullo studio).

Cosa proviene automaticamente dal software

Le seguenti informazioni vengono recuperate direttamente dal software, a seconda delle funzionalità che hai attivato. Non è necessario aggiungerle alle tue fonti di conoscenza. Al contrario, informazioni duplicate possono portare a risposte contraddittorie.

Proviene dal software (quando la funzionalità è attiva)	Non duplicare nelle tue fonti
Orari di apertura, indirizzo e contatti dello studio (Informazioni sullo studio)	Orari di apertura, indirizzo, numero di telefono
Offerte di abbonamento e prezzi (Offerte di abbonamento)	Listini prezzi, panoramiche delle tariffe
Slot disponibili per le sessioni di prova e prenotazione (Prenotazione di una sessione di prova)	Date disponibili per le sessioni di prova
Appuntamenti disponibili e prenotazione (Ricerca degli appuntamenti, Prenotazione appuntamento)	Appuntamenti disponibili
Programma dei corsi e corsi disponibili (Programma del corso, Prenotazione del corso)	Orari e descrizioni dei corsi
Processo di disdetta (Annullamento del contratto)	Passaggi della disdetta (MagicAI Chat guida l'abbonato durante il processo)
Richiesta di sospensioni (Self-service per i clienti)	Passaggi della sospensione (MagicAI Chat guida l'abbonato durante il processo)

Cosa appartiene alle tue fonti di conoscenza

Le tue fonti di conoscenza coprono tutto ciò che non proviene automaticamente dal sistema, cioè tutto ciò che il tuo studio fa in modo individuale. L'elenco seguente mostra le domande tipiche che pongono i tuoi abbonati e a cui solo le tue fonti di conoscenza possono rispondere.

Sessione di prova e iscrizione

• Cosa devo portare a una sessione di prova?
• Come si svolge la sessione di prova?
• Qual è l'età minima per iscriversi?
• Posso visitare lo studio in anticipo?
• Cosa include un pass giornaliero? Comprende la sauna e il parcheggio, e posso entrare più di una volta?

Strutture e offerta

• C'è un parcheggio? È gratuito?
• Ci sono docce, armadietti e asciugamani?
• C'è una sauna o un'area benessere? È separata per genere o mista?
• La sauna ha orari propri diversi da quelli dello studio?
• C'è il WiFi nello studio?
• Ci sono bevande o un distributore d'acqua?
• Quanto è grande l'area di allenamento?
• Offrite personal training? Quanto costa all'incirca?

Ospiti e accompagnatori

• Posso portare un amico?
• Quanto costa un pass giornaliero?
• Esiste una promozione «porta un amico»?
• Qual è l'età minima per gli ospiti?
• I bambini possono accompagnare i genitori nello studio senza allenarsi?

Abbonamento e contratto

• Come avviene la firma di un contratto?
• Cosa devo portare per firmare un contratto?
• Esistono tariffe per studenti, alunni o anziani?
• Offrite opzioni di fitness aziendale (Hansefit, EGYM Wellpass, Urban Sports Club, ecc.)?
• Come funziona l'iscrizione tramite il fitness aziendale?
• Posso cambiare la mia tariffa (upgrade o downgrade)?
• Posso cambiare il mio studio di riferimento?
• C'è attualmente un'offerta speciale o una promozione? Fino a quando è valida e quali condizioni si applicano?
• Mi sono iscritto online. Da quando posso venire allo studio?
• Posso trasferire il mio abbonamento a un'altra persona?
• Posso regalare un abbonamento?
• Posso continuare a usare lo studio fino alla fine del contratto dopo aver disdetto?
• Ho disdetto. Posso annullare la disdetta?
• Esiste un diritto di recesso dopo l'iscrizione?

Pagamento

• Quando viene addebitata la quota di abbonamento?
• Il mio pagamento non è andato a buon fine. Cosa devo fare?
• Esiste una quota di iscrizione o una quota amministrativa?
• Come funziona il rimborso in caso di pagamento eccessivo?
• Perché è stato addebitato un importo diverso da quello previsto?
• Quali metodi di pagamento sono accettati?
• Ci sono altre quote ricorrenti obbligatorie oltre a quella mensile?

Regolamento interno

• Che abbigliamento devo indossare?
• Mi serve un asciugamano?
• Posso fare foto o filmare nello studio?
• Posso portare il mio cane?
• Quali sono le regole per l'area sauna e benessere?
• Devo pulire gli attrezzi dopo l'uso?
• Posso entrare nello studio più di una volta al giorno?
• Cosa devo fare se un attrezzo è guasto?

App e accesso

• Cosa posso fare nell'app?
• Non riesco ad accedere all'app. Cosa devo fare?
• Come funziona l'accesso 24/7?
• La porta d'ingresso non si apre. Cosa devo fare?
• Ho perso la mia tessera di abbonamento. Come ne ottengo una nuova?
• Esiste una tessera di abbonamento digitale e come la uso?
• Come ricarico il credito di consumo?

Varie

• State assumendo? Come posso candidarmi?
• Lo studio è accessibile alle persone con disabilità?
• Quando lo studio è più affollato?
• Esistono programmi speciali (per esempio Hyrox o sport riabilitativo)?
• Posso semplicemente venire ad allenarmi con un'opzione di fitness aziendale (per esempio Wellpass o Hansefit), o devo iscrivermi separatamente?
• Lo studio è aperto nei giorni festivi e, in tal caso, si applicano orari diversi?
• Come ottengo un certificato di abbonamento (per esempio per la mia assicurazione sanitaria)?

Fonti, Linee guida o Informazioni sullo studio

Oltre alla scheda Fonti (le fonti di conoscenza), la configurazione della chat ha altre due schede per i tuoi contenuti: Linee guida e Informazioni sullo studio. Le tre schede si completano a vicenda e ognuna ha uno scopo preciso.

Scheda	Da usare per	Esempio
Fonti	Contenuti dettagliati da documenti, dal tuo sito web o dal tuo Zendesk Help Center: tutto ciò che il tuo studio fa in modo individuale, come elencato sopra.	La tua pagina FAQ, un PDF con il tuo regolamento interno
Linee guida	Regole di comportamento che il chatbot deve seguire. Una linea guida vale per gli studi che scegli, oppure per Tutte le palestre (tutti gli studi).	«Non dare consigli medici. Rimanda gli abbonati ai trainer dello studio.»
Informazioni sullo studio	Informazioni legate alla situazione o temporanee che valgono per uno o più studi.	«La sauna di Example Fitness Cittaesempio è chiusa per manutenzione dal 3 al 14 novembre.»

Una voce nella scheda Linee guida o Informazioni sullo studio contiene al massimo 500 caratteri. Le modifiche lì vengono pubblicate immediatamente, senza Aggiornare le fonti di conoscenza. I contenuti più lunghi vanno quindi nelle tue fonti di conoscenza, mentre una regola su come il chatbot deve comportarsi va nella scheda Linee guida e non in un documento.

Non ripetere i dati standard nemmeno nella scheda Informazioni sullo studio: indirizzo, orari di apertura e servizi vengono forniti automaticamente. La scheda Informazioni sullo studio non è la stessa cosa della funzionalità Informazioni sullo studio, che fornisce proprio questi dati standard dal software.

Come creare le voci in entrambe le schede è descritto in Configurare MagicAI Chat: scheda Linee guida e scheda Informazioni sullo studio.

Consigli sul formato dei file

Aggiungi le tue fonti nella scheda Fonti della configurazione della chat (Impostazioni / MagicAI / Chatbot, poi apri la configurazione). La scheda elenca tutte le fonti con le colonne Fonte, Tipo e Modalità Crawl. Con Aggiungere una fonte di conoscenza scegli il Tipo di fonte: File, URL o Zendesk. Le istruzioni passo per passo si trovano in Configurare MagicAI Chat: scheda Fonti.

Formati consigliati

• File di testo (.txt, .md): i più adatti. Struttura chiara, facili da aggiornare.
• Documenti Word (.docx): accettati anche questi. Strutturali con titoli chiari, proprio come un file di testo.
• PDF: funziona finché il testo è selezionabile. I documenti scansionati o i PDF di sole immagini non vengono riconosciuti.

Ogni fonte di tipo file contiene esattamente un file di massimo 10 MB. Per più documenti crea più fonti.

Non adatti

• PDF scansionati (testo non estraibile)
• PDF di sole immagini

Altri formati, come i fogli di calcolo Excel o i file immagine, non possono essere caricati. Se le tue informazioni si trovano in un foglio di calcolo, convertile in testo con frasi complete, perché altrimenti le relazioni tra le colonne andrebbero perse.

Sito web come fonte

• MagicAI Chat può leggere il tuo sito web o la tua pagina FAQ esistenti. Inserisci l'URL e scegli la Modalità Crawl.
• Eseguire la scansione dell'intero sito web parte da questo URL e recupera automaticamente fino a 50 sottopagine, fino a una profondità massima di 5 livelli.
• Recupera solo questa pagina elabora solo questo URL esatto, senza sottopagine.
• La pagina deve essere accessibile pubblicamente (senza login).

Consigli per risposte migliori

La qualità delle risposte di MagicAI Chat dipende direttamente da come sono costruite le tue fonti di conoscenza. Ecco i consigli più importanti.

Ogni sezione deve essere comprensibile da sola

MagicAI Chat cerca le sezioni di testo che corrispondono a una domanda. Una sezione che non ha senso senza il testo precedente produce risposte scadenti.

Dai contesto ai titoli

In questo modo MagicAI Chat può collocare meglio la sezione, anche quando la domanda è formulata in modo generico.

Un solo argomento per sezione

Ogni sezione dovrebbe rispondere esattamente a una domanda. Non mescolare più argomenti in un lungo paragrafo.

Tieni condizioni e restrizioni insieme all'affermazione

Se una regola ha eccezioni o prerequisiti, questi devono trovarsi nella stessa sezione, non più in basso né in un paragrafo separato.

Usa il formato domanda e risposta

Il formato più efficace è la domanda seguita dalla risposta.

Usa una terminologia coerente

Usa sempre lo stesso termine per lo stesso concetto. Se alterni tra «app», «app di allenamento», «portale abbonati» e «area online», è più difficile per MagicAI Chat riconoscere che indicano la stessa cosa.

Fatti, non pubblicità

MagicAI Chat cerca fatti. Testi di marketing come «Vivi il tuo miglior allenamento» non aiutano. «Lo studio offre 500 m² di superficie di allenamento con 80 macchine» invece sì.

Evita le contraddizioni

La stessa informazione dovrebbe comparire in un solo punto. Se gli orari di apertura compaiono in tre punti diversi con dati differenti, MagicAI Chat fornisce risposte contraddittorie. Inoltre, i contenuti duplicati occupano posti nei risultati di ricerca e possono escludere altre informazioni rilevanti.

Sezioni né troppo corte né troppo lunghe

Una buona sezione ha da 3 a 8 frasi e risponde completamente a una domanda, comprese tutte le condizioni e restrizioni. Le sezioni troppo corte (da 1 a 2 frasi) danno troppo poco contesto. Le sezioni troppo lunghe (più di mezza pagina DIN A4) rendono più difficile per MagicAI Chat trovare il passaggio rilevante.

Con quale frequenza aggiornare

I dati di sistema (orari di apertura, prezzi, programma dei corsi e così via) vengono recuperati dal software in tempo reale, quindi qui non devi aggiornare nulla manualmente. Le voci nelle schede Linee guida e Informazioni sullo studio vengono pubblicate immediatamente quando le salvi.

Per le tue fonti di conoscenza:

• Aggiornamento manuale: se hai aggiunto fonti o se i contenuti di una fonte sono cambiati, fai clic su Aggiornare le fonti di conoscenza nell'intestazione della scheda Fonti, così MagicAI Chat lavora con i contenuti attuali. In Ultima esecuzione del digest: (ultima elaborazione) vedi quando le fonti sono state elaborate l'ultima volta.
• Aggiornamento automatico: se non esegui un aggiornamento manuale, tutte le fonti di conoscenza vengono reindicizzate automaticamente ogni notte. In questa occasione vengono riletti anche i contenuti del sito web e dell'Help Center, quindi tieni aggiornati il tuo sito web e il tuo Zendesk Help Center, altrimenti MagicAI Chat trasmette informazioni obsolete.
• Fonti di tipo file: MagicAI Chat lavora con il file così come lo hai caricato. Le modifiche al documento sul tuo computer non arrivano da sole al chatbot, quindi sostituiscilo tu: apri il menu della riga della fonte nella scheda Fonti, scegli Modifica della fonte di conoscenza e carica la nuova versione. Nello stesso menu puoi rimuovere una fonte con Cancellare (elimina), purché nella configurazione rimanga almeno una fonte. Poi fai clic su Aggiornare le fonti di conoscenza.

Articoli correlati

• Configurare MagicAI Chat

---

Avviso: Questo articolo è stato creato con l'aiuto dell'intelligenza artificiale e tradotto automaticamente senza revisione editoriale. Ci scusiamo per eventuali errori.