Addestramento e contenuti

L'Agent AI di Hotely risponde alle domande degli utenti basandosi esclusivamente sui contenuti che gli fornisci. Non inventa informazioni e non accede a fonti esterne non autorizzate. La qualità delle risposte dipende direttamente dalla qualità e completezza dei contenuti di addestramento. Questa guida spiega come funziona il sistema di apprendimento e come ottimizzare i contenuti per ottenere le risposte migliori.

Come l'Agent utilizza i contenuti

Quando un utente pone una domanda, l'Agent esegue un processo in tre fasi:

1. Comprensione della domanda — analizza il testo dell'utente per capire cosa sta chiedendo, considerando il contesto della conversazione precedente
2. Ricerca nei contenuti — cerca tra tutti i contenuti forniti (pagine web, documenti, istruzioni) le informazioni più pertinenti alla domanda
3. Generazione della risposta — formula una risposta naturale utilizzando le informazioni trovate, rispettando il tono e le istruzioni configurate nel prompt di sistema

Se l'Agent non trova informazioni pertinenti nei contenuti, lo comunica onestamente e, se configurato, propone di raccogliere i dati di contatto per una risposta dal team.

Fonti di contenuto

L'Agent può apprendere da tre tipologie di fonti:

Il sistema di prompt

Il prompt di sistema è il cuore dell'addestramento dell'Agent. È un testo che definisce chi è l'Agent, come deve comportarsi e quali informazioni prioritarie deve comunicare. Viene processato prima di ogni risposta e influenza il modo in cui l'Agent interpreta le domande e formula le risposte.

Struttura di un prompt efficace

Un prompt ben strutturato contiene quattro sezioni:

1. Identità e ruolo

Definisci chi è l'Agent e per quale attività lavora:

Sei l'assistente virtuale di Hotel Bellavista, un boutique hotel
a 4 stelle situato sulla Costiera Amalfitana. Il tuo compito è
rispondere alle domande degli ospiti in modo cortese, professionale
e accurato.

2. Tono e stile

Indica come l'Agent deve comunicare:

Rispondi sempre in modo cordiale e professionale. Usa un tono
amichevole ma non troppo informale. Dai del "Lei" all'interlocutore
a meno che non si presenti come un cliente abituale o usi un tono
molto informale. Rispondi nella lingua in cui ti scrive l'utente.

3. Informazioni prioritarie

Elenca le informazioni che l'Agent deve comunicare con priorità:

Informazioni importanti da comunicare quando pertinente:
- Check-in dalle 15:00, check-out entro le 11:00
- Colazione inclusa nel prezzo, servita dalle 7:30 alle 10:30
- Parcheggio privato gratuito su prenotazione
- Wi-Fi gratuito in tutta la struttura
- La struttura accetta animali di piccola taglia (max 10 kg)
- Per prenotare direttamente: [link al booking engine]

4. Regole di comportamento

Definisci cosa l'Agent deve e non deve fare:

Regole:
- Non inventare mai informazioni. Se non conosci la risposta,
  dì che verificherai con lo staff e offri di raccogliere il contatto
- Non fornire mai prezzi specifici a meno che non siano nei contenuti
  forniti — indirizza al booking engine per verificare disponibilità e prezzi
- Non parlare mai di strutture concorrenti
- Se l'ospite chiede di prenotare, fornisci il link diretto al booking engine
- Per richieste speciali (decorazioni, torte, transfer), raccogli i dettagli
  e proponi di passare la richiesta allo staff

Esempi di prompt per settore

Prompt per hotel

Sei il concierge virtuale di Hotel Bellavista, boutique hotel
4 stelle a Positano. Rispondi in modo professionale e cortese.

La struttura offre:
- 20 camere con vista mare
- Ristorante panoramico con cucina locale
- Piscina infinity con solarium
- Spa con trattamenti personalizzati
- Transfer da/per aeroporto di Napoli

Check-in: 15:00-22:00 | Check-out: entro 11:00
Colazione: 7:30-10:30 (inclusa)
Parcheggio: gratuito su prenotazione

Quando l'ospite chiede prezzi o disponibilità, indirizzalo
alla pagina di prenotazione. Non inventare prezzi.

Prompt per ristorante

Sei l'assistente del Ristorante Da Luigi, trattoria tipica
nel centro di Firenze. Rispondi con calore e simpatia.

Orari: Mar-Dom 12:00-15:00, 19:00-23:00. Chiuso il lunedì.
Prenotazioni: consigliata la prenotazione per cena,
specialmente nel weekend.

Specialità: bistecca alla fiorentina, ribollita, pappardelle
al cinghiale. Menu completo nei documenti caricati.

Per allergie e intolleranze: abbiamo opzioni senza glutine
e vegetariane. Per esigenze specifiche, consiglia di
comunicarle al momento della prenotazione.

Prompt per B&B

Sei l'assistente del B&B Il Giardino, un bed and breakfast
familiare immerso nelle colline toscane.

Camere disponibili:
- Girasole: doppia con bagno privato, vista giardino
- Lavanda: matrimoniale con balcone, vista colline
- Olivo: tripla con bagno en-suite, piano terra

Check-in: 14:00-20:00 (arrivi tardivi su accordo)
Check-out: entro 10:30
Colazione: 8:00-10:00 con prodotti locali e fatti in casa

La struttura non accetta animali. Bambini benvenuti.
Parcheggio gratuito nel giardino.

Errori comuni nel prompt

Aggiungere contenuti FAQ

Le FAQ (Frequently Asked Questions) sono uno dei modi più efficaci per addestrare l'Agent. Puoi inserirle direttamente nel prompt di sistema oppure in un documento dedicato.

Formato consigliato

Struttura le FAQ in modo chiaro con domanda e risposta:

D: Accettate animali domestici?
R: Sì, accettiamo animali di piccola taglia (fino a 10 kg)
con un supplemento di 15€ per notte. È necessario comunicarlo
al momento della prenotazione.

D: C'è il parcheggio?
R: Sì, disponiamo di un parcheggio privato gratuito con
15 posti auto. La prenotazione del posto è consigliata
durante l'alta stagione.

D: A che ora è la colazione?
R: La colazione viene servita dalle 7:30 alle 10:30 nella
sala ristorante al piano terra. È inclusa nel prezzo del
soggiorno e offre prodotti locali, dolci fatti in casa,
frutta fresca e bevande calde.

Quante FAQ servono

Non esiste un numero minimo o massimo, ma una buona base di partenza include:

• 10-15 FAQ generiche sulla struttura (orari, servizi, politiche)
• 5-10 FAQ specifiche sul territorio (cosa fare, come arrivare, trasporti)
• 3-5 FAQ sulle prenotazioni (pagamento, cancellazione, modifica)

L'Agent è in grado di rispondere anche a domande non esplicitamente coperte dalle FAQ, combinando le informazioni disponibili per formulare risposte pertinenti.

Contenuti dal sito web

Il crawler automatico visita il tuo sito web e indicizza i contenuti testuali di ogni pagina. Questo è il metodo più rapido per fornire all'Agent una base di conoscenza ampia e aggiornata. Per la configurazione dettagliata del crawler, consulta la guida Siti Web e Crawler.

Cosa viene indicizzato

• Testo delle pagine (paragrafi, titoli, liste)
• Meta description e titoli delle pagine
• Contenuti strutturati (tabelle, elenchi)

Cosa non viene indicizzato

• Immagini (il contenuto visivo non è processato)
• Video e audio
• Contenuti generati dinamicamente da JavaScript complesso
• Aree protette da login
• PDF e documenti linkati (devono essere caricati separatamente)

File e documenti

Puoi caricare file in diversi formati per fornire all'Agent informazioni aggiuntive non presenti sul sito web. Per la procedura dettagliata, consulta la guida File e documenti.

Quando usare i file

Ottimizzazione delle risposte

Strategia iterativa

L'addestramento dell'Agent è un processo iterativo:

1. Configura il prompt iniziale con le informazioni di base
2. Aggiungi contenuti tramite crawler e file
3. Testa l'Agent con domande reali
4. Identifica le lacune — dove l'Agent non risponde bene?
5. Aggiungi contenuti specifici per colmare le lacune
6. Affina il prompt — modifica tono, regole o informazioni prioritarie
7. Ritesta e ripeti il ciclo

Monitorare le conversazioni

Dalla dashboard puoi visualizzare le conversazioni degli utenti con l'Agent. Questo è uno strumento prezioso per:

• Scoprire domande frequenti che non avevi previsto
• Identificare risposte inaccurate o incomplete
• Capire quali informazioni aggiungere al prompt o ai contenuti
• Verificare che il tono sia appropriato

Contenuti multilingua

L'Agent risponde automaticamente nella lingua dell'utente, traducendo le informazioni dai contenuti forniti. Tuttavia, per ottenere risposte di qualità superiore in lingue specifiche, puoi:

• Aggiungere versioni del sito web in più lingue al crawler
• Caricare documenti in lingue diverse (es. menu in italiano e in inglese)
• Includere nel prompt istruzioni specifiche per le lingue principali dei tuoi ospiti

Aggiornamento dei contenuti

I contenuti dell'Agent devono essere mantenuti aggiornati:

• Riesegui il crawler quando aggiorni il sito web
• Sostituisci i file quando cambiano listini, menu o condizioni
• Aggiorna il prompt quando cambiano orari, politiche o servizi
• Controlla periodicamente le conversazioni per verificare che le risposte siano ancora accurate

Un Agent con contenuti obsoleti rischia di fornire informazioni errate, danneggiando la reputazione della tua attività. Stabilisci una routine di aggiornamento (ad esempio, una revisione mensile) per mantenere tutto allineato.

Per assistenza nell'ottimizzazione dell'addestramento del tuo Agent, contatta support@hotely.ai.