Skip to main content

Configurare AI Concierge

Attiva l'assistente chat basato sull'intelligenza artificiale per gli ospiti, scegli un modello e configura il prompt di sistema e il budget.

Configurare AI Concierge

Cosa imparerai: Come abilitare AI Concierge: un assistente chat che risponde alle domande degli ospiti sulla TV e sul Mobile Companion utilizzando le informazioni del tuo hotel.

Tempo necessario: 10 minuti.

Prima di iniziare

Avrai bisogno di:

  • Credenziali di accesso.
  • Una OpenAI API key OPPURE una Anthropic API key. Puoi ottenerle dai siti web dei rispettivi provider. È previsto un piccolo costo mensile basato sull'utilizzo, in genere pochi dollari al mese per un piccolo hotel.
  • Qualche minuto per scrivere una breve descrizione del tuo hotel (utilizzata come "system prompt" dell'intelligenza artificiale).

Nota sui costi: Anche se scegli Anthropic per la chat, l'embedding model (la parte che trova il documento di conoscenza corretto per ogni domanda) attualmente funziona su OpenAI. Pertanto, se scegli Anthropic, avrai probabilmente bisogno di entrambe le chiavi.

Passaggio 1: Aprire AI Concierge → Settings & test

Nella barra laterale di sinistra, sotto PLATFORM, fai clic su AI Concierge.

La pagina presenta tre schede: Knowledge base, Suggested questions, Settings & test. Fai clic su Settings & test.

Pagina AI Concierge con la scheda Settings & test selezionata, che mostra l'interruttore Enable, il menu a discesa del provider e i campi della chiave API

Passaggio 2: Abilitare AI Concierge

In alto, attiva l'interruttore Enable AI Concierge.

Quando è disattivato, i riquadri della chat sulla TV e sui dispositivi mobili vengono comunque visualizzati, ma toccandoli viene mostrato il messaggio "AI is currently unavailable".

Passaggio 3: Scegliere un provider

Sotto Provider, scegline uno:

  • OpenAI — chat ed embedding da un unico provider. Configurazione più semplice. Una sola chiave API.
  • Anthropic — chat da Anthropic, embedding sempre da OpenAI. Sono necessarie due chiavi API.
  • None (disabled) — equivale a disattivare l'interruttore.

Menu a discesa Provider espanso con le tre opzioni visibili

Passaggio 4: Scegliere un modello di chat

Il menu a discesa Chat model mostra i modelli disponibili per il provider scelto. L'impostazione predefinita è ragionevole: scegli un modello più veloce ed economico per hotel con richieste in stile FAQ, oppure uno più avanzato per richieste complesse.

Passaggio 5: Incollare le chiavi API

  • OpenAI API key — incolla la tua chiave (inizia con sk-…). Se una chiave è già salvata, vedrai un badge verde con un'anteprima nascosta. Incolla una nuova chiave solo per sostituirla.
  • Anthropic API key — incolla la tua chiave (inizia con sk-ant-…). Utilizzata solo se il Provider è Anthropic.

Passaggio 6: Scrivere il system prompt

Il campo System prompt definisce la "personalità e le regole" dell'intelligenza artificiale. Scrivi 2-4 brevi paragrafi su:

  • Il nome e lo stile dell'hotel (lusso / boutique / per famiglie).
  • In cosa l'intelligenza artificiale è autorizzata ad aiutare (servizio in camera, spa, consigli locali, servizi dell'hotel).
  • Cosa non dovrebbe fare (dare consigli medici, effettuare prenotazioni che non può realmente gestire, inventare prezzi).
  • Il tono (formale, informale, conciso, dettagliato).

Puoi utilizzare {{hotel_name}} e il sistema inserirà automaticamente il nome del tuo hotel.

Esempio:

Sei il cordiale concierge di {{hotel_name}}, un boutique
hotel nel centro di Cracovia. Aiuta gli ospiti con i servizi dell'hotel,
gli orari del ristorante, le prenotazioni della spa e i consigli locali.
Sii caloroso, conciso e preciso. Se non sai qualcosa,
dillo educatamente e suggerisci all'ospite di chiamare la reception (interno 0).
Non inventare mai prezzi, orari di apertura o nomi del personale. Rispondi nella
lingua in cui l'ospite ti scrive.

Passaggio 7: Regolare il comportamento

  • Temperature — cursore da 0 a 1.5. Valori più bassi = risposte più oggettive e prevedibili. Il valore consigliato è 0.3.
  • Max tokens — la lunghezza massima di ogni risposta. ~500 è un buon valore predefinito.

Passaggio 8: Impostare un budget (consigliato)

Per evitare fatture impreviste:

  • Monthly budget (USD) — es. 20. Imposta a 0 per non avere limiti.
  • Daily message limit — es. 200. Imposta a 0 per non avere limiti.

Quando il limite viene raggiunto, i nuovi messaggi ricevono una cortese risposta "limit reached".

Passaggio 9: Testare la connessione

Fai clic su [Test connection] in basso. Se la tua chiave API funziona, vedrai una conferma verde. In caso contrario, correggi la chiave e riprova.

Passaggio 10: Salvare

Fai clic su [Save settings].

Passaggio 11: Aggiungere un riquadro al menu principale

In Main Menu Editor, fai clic su [+ New item], imposta Type = AI Concierge, assegna un titolo e un'icona, quindi salva.

Ora gli ospiti vedranno un riquadro AI Concierge nella schermata principale.

Vedi: Personalizzare il menu principale

Cosa fare se non funziona?

Il test di connessione fallisce:

  • Chiave errata. Incollala di nuovo.
  • La chiave è stata revocata. Generane una nuova.
  • Il provider ha problemi di fatturazione: controlla il tuo account su OpenAI o Anthropic.

L'intelligenza artificiale fornisce risposte generiche, non specifiche dell'hotel: La knowledge base è vuota. Vedi Gestire la Knowledge Base.

Le risposte sono troppo lunghe o troppo corte: Regola Max tokens (lunghezza) o riscrivi il tuo system prompt per richiedere lo stile desiderato.

I costi sono più alti del previsto: Riduci Temperature, riduci Max tokens, imposta un Monthly budget o scegli un modello più economico.

Passaggi successivi