Impostazioni generali dell'Agent

La scheda Impostazioni generali è il cuore della configurazione di un Agent. È la prima che incontri dopo la creazione ed è quella che torni a visitare ogni volta che vuoi cambiare il comportamento di base dell'assistente. Tutte le altre schede (Servizi, Design, Integrazione, ecc.) sono specializzazioni: questa è il pannello di controllo principale.

Nome pubblico e identificativi

Nome dell'Agent

Il nome interno usato nella dashboard. È quello che vedi nella lista chatbot e nelle notifiche. Non viene mostrato agli ospiti.

ID univoco

Ogni Agent ha un ID generato automaticamente da Hotely. Lo trovi nella card "ID del Agent" alla fine della scheda. Serve per integrazioni tecniche e supporto — copialo se ti viene richiesto dall'assistenza.

Slug pubblico

Lo slug è la parte finale dell'URL pubblico dell'Agent. Da gestire con attenzione perché cambiarlo invalida i link e i QR code già distribuiti.

Descrizione e contesto

Descrizione interna

Un campo libero in cui descrivi l'attività in modo che l'Agent abbia un contesto generale. Esempi efficaci:

"B&B di tre camere in centro storico, conduzione familiare, colazione fatta in casa con prodotti locali, clientela italiana e tedesca, attivo da aprile a ottobre."
"Ristorante toscano specializzato in cucina tradizionale con menu degustazione di quattro portate. Servizio pranzo solo nei weekend, cena tutti i giorni tranne mercoledì."
"Hotel 4 stelle sul mare, 80 camere, ristorante interno con vista, spa con piscina coperta, animazione bambini in estate."

Questa descrizione è una delle informazioni di base che l'Agent usa per dare un tono coerente alle risposte.

Prompt di sistema: l'istruzione che guida l'Agent

Il prompt di sistema è la sezione più importante delle impostazioni generali. È l'istruzione principale che definisce il comportamento dell'Agent: il tono di voce, le priorità, cosa fare in casi specifici, cosa evitare, come comportarsi quando non sa una risposta.

Il prompt di sistema viene letto prima di ogni conversazione. È come spiegare a un nuovo collaboratore "ecco come dovresti rispondere ai clienti, ecco cosa è importante per noi, ecco cosa non dovresti mai fare".

Cosa scrivere nel prompt

Buone pratiche per scrivere un prompt efficace:

Identifica il ruolo dell'Agent: "Sei il concierge digitale dell'Hotel Bellavista, un hotel familiare di otto camere a Cinque Terre."
Definisci il tono: "Rispondi sempre in modo cordiale, professionale e caloroso, come farebbe un padrone di casa accogliente."
Indica le priorità: "Le tue priorità sono: rispondere a domande sui servizi, raccogliere richieste di prenotazione, gestire ordini di room service."
Spiega cosa non fare: "Non dare mai informazioni di prezzo se non sono confermate nei contenuti. Quando non sai una risposta, proponi di metterti in contatto con la reception."
Aggiungi dettagli operativi: "Quando ti chiedono se ci sono parcheggi, specifica che sono gratuiti per gli ospiti. Quando chiedono se accettiamo animali, conferma di sì con un supplemento di 15 EUR."
Personalizza per il settore: per un ristorante, "Quando ti chiedono allergeni, controlla sempre il menu strutturato prima di rispondere"; per un hotel, "Quando un ospite vuole prenotare, raccogli sempre data di arrivo, partenza e numero di persone."

Esempi di prompt per tipi diversi

B&B familiare:

Sei l'assistente digitale di Casa del Sole, un B&B di quattro camere
gestito dalla famiglia Rossi in centro a Bolzano. Rispondi sempre con
tono caloroso e personale, in italiano o nella lingua dell'ospite.

Le tue priorità in ordine:
1. Rispondere a domande su orari, servizi, posizione
2. Raccogliere richieste di prenotazione (date, persone, contatti)
3. Indirizzare gli ospiti agli articoli di città per visite locali

Non dare mai prezzi se non sono nel sito o nei documenti. Quando un
ospite chiede disponibilità, raccogli le date e proponi di ricevere
risposta personale entro poche ore.

Per richieste fuori dal normale (eventi privati, gruppi numerosi),
raccogli i dettagli e segnala che la richiesta sarà valutata dalla
famiglia.

Ristorante stellato:

Sei l'assistente di Osteria della Memoria, ristorante con una stella
Michelin a Modena. Rispondi con tono raffinato ma accessibile, come
farebbe il maître d'hotel.

Quando un cliente chiede del menu, presenta le tre opzioni di
degustazione (Tradizione, Innovazione, Stagione) sottolineando il
percorso narrativo di ciascuna.

Gestisci le intolleranze con attenzione: chiedi sempre dettagli
specifici prima di proporre piatti, e ricorda di menzionare la
possibilità di contaminazione in cucina per i celiaci.

Per le prenotazioni, raccogli sempre numero di persone, eventuali
ricorrenze, intolleranze, preferenze (terrazza, sala interna).

Hotel boutique multilingua:

Sei il concierge digitale di Palazzo del Borgo, boutique hotel di 15
camere nel centro storico di Lucca. Adatti tono e stile alla lingua
dell'ospite — italiano caloroso, inglese impeccabile, tedesco preciso,
francese elegante.

Conosci a memoria orari, servizi, suggerimenti di città (ristoranti
convenzionati, esperienze locali). Quando un ospite chiede consigli
gastronomici, proponi prima i ristoranti partner, poi le opzioni
locali in base ai gusti.

Per le richieste di room service, raccogli il numero camera (se non è
già nel contesto), il dettaglio dell'ordine e l'ora desiderata.
Conferma sempre prima di inviare la richiesta in cucina.

Quando aggiornare il prompt

Aggiorna il prompt quando:

Cambi il posizionamento o lo stile dell'attività
Aggiungi un nuovo servizio importante che vuoi che l'Agent menzioni proattivamente
Noti pattern di risposte non ottimali nelle conversazioni (es. tono troppo formale, omissione di informazioni importanti)
Cambia la stagionalità (es. modalità inverno vs estate per un resort balneare)

Le modifiche al prompt entrano in vigore immediatamente per le conversazioni successive. Le conversazioni in corso continuano con il prompt precedente.

Modello AI

Hotely usa modelli linguistici di ultima generazione. La scelta del modello può essere lasciata al default consigliato — è già ottimizzato per qualità di risposta e velocità.

Per casi specifici (es. attività con un volume enorme di conversazioni dove la velocità è critica, o attività di lusso dove serve la massima qualità) puoi cambiare il modello dalle impostazioni avanzate. Il supporto può aiutarti a scegliere l'opzione migliore per il tuo caso.

File collegati come knowledge base

Nella stessa scheda trovi la sezione dei file collegati — i documenti caricati che l'Agent usa come fonte di conoscenza. Puoi vedere quali file sono attualmente attivi, aggiungerne di nuovi o rimuoverne. La gestione completa dei file è descritta nella sezione File e documenti.

Messaggio di benvenuto

Il primo messaggio che l'utente vede quando apre la chat. Da configurare con cura perché è il "biglietto da visita" dell'Agent. Esempi:

"Ciao, sono l'assistente di Casa del Sole. Posso aiutarti con orari, disponibilità, informazioni sul soggiorno."
"Benvenuto da Luigi. Vuoi vedere il menu, prenotare un tavolo o ordinare al tavolo?"
"Sono il concierge digitale del Palazzo del Borgo. Sono qui per assisterti in italiano, inglese, francese o tedesco."

Il messaggio di benvenuto può includere proposte di azione rapida — vedi Welcome screen per la versione avanzata con pulsanti.

Comportamento avanzato

Apertura automatica

Decidi se il widget chat si apre automaticamente al caricamento della pagina (utile per attrarre attenzione) o solo al clic dell'utente (più discreto). Per attività di accoglienza tipicamente è consigliata l'apertura solo al clic — un'apertura automatica forzata può infastidire visitatori che stanno solo navigando.

Suoni di notifica

Decidi se ricevere un suono quando un nuovo messaggio arriva nell'inbox della dashboard. Utile per chi monitora attivamente le conversazioni.

Disabilitazione temporanea

Puoi mettere l'Agent in pausa temporaneamente — la chat scompare dal sito, gli ospiti che la riaprono trovano un messaggio di servizio. Utile per manutenzione, riconfigurazione o test su contenuti nuovi.

Privacy e raccolta dati

Dalle impostazioni generali puoi anche definire:

Conservazione delle conversazioni (illimitata o con scadenza automatica)
Anonimizzazione dei dati personali dopo X giorni
Cookie banner mostrato all'avvio della chat
Link a privacy policy e termini

Per la guida completa vedi Privacy.

Salvataggio e attivazione

Le modifiche alle impostazioni generali si salvano cliccando Salva. Le modifiche entrano in vigore immediatamente per le conversazioni successive. Non c'è bisogno di ripubblicare l'Agent o di toccare il widget sul sito — l'aggiornamento è automatico.

Buone pratiche

Buona pratica	Perché
Scrivere un prompt di sistema esplicito	Riduce risposte fuori tono e aumenta coerenza
Aggiornare il prompt quando cambiano le stagioni	L'Agent allinea le risposte al periodo attuale
Salvare il prompt in un documento esterno	Backup in caso di modifiche da rivedere
Testare in chat di prova dopo ogni modifica	Verifica che il comportamento sia quello desiderato
Coinvolgere il personale di reception nella scrittura	Loro sanno quali domande arrivano davvero
Aggiornare la descrizione interna quando l'attività evolve	Migliora la qualità delle risposte sul lungo periodo

Errori frequenti

Prompt troppo corto ("Sei un assistente turistico") — l'Agent risponde in modo generico
Prompt troppo lungo e contraddittorio — l'Agent si confonde
Prompt senza priorità — l'Agent non sa cosa fare quando deve scegliere tra due azioni
Prompt senza istruzioni "non fare" — l'Agent può dare informazioni che preferiresti non desse
Aggiornamenti del prompt senza test — rischio di regressioni non intenzionali

Per ogni dubbio, contatta il supporto a support@hotely.ai o consulta gli esempi di prompt nelle guide per tipo di attività.