Creazione di un Agent

Creare un nuovo Agent su Hotely è il primo passo per attivare l'assistente AI nella tua struttura. La procedura guidata richiede pochi minuti e raccoglie solo le informazioni essenziali per iniziare. Tutto il resto della configurazione (contenuti, design, integrazione, canali) si fa successivamente, senza interrompere il flusso di creazione.

Questa guida ti accompagna passo-passo nella creazione del primo Agent, spiegando ogni scelta e le sue implicazioni operative.

Quando creare un nuovo Agent

Tipicamente crei un Agent quando:

• È il tuo primo Agent — stai aprendo l'attività sulla piattaforma e vuoi iniziare a ricevere conversazioni
• Hai aperto una nuova proprietà — il tuo gruppo alberghiero o ristorativo aggiunge una nuova struttura
• Vuoi separare canali di comunicazione — es. un Agent per gli ospiti dell'hotel e uno per il ristorante interno
• Stai testando un nuovo flusso — un Agent sperimentale per provare istruzioni o configurazioni senza impattare quello di produzione
• Vuoi separare staff e ospiti — un Agent per i clienti esterni e uno per la comunicazione interna allo staff

Hotely non impone un limite tecnico al numero di Agent creabili. Ogni Agent ha la propria configurazione, i propri contenuti, i propri canali. Tutti gli Agent del tuo workspace condividono il team, i permessi e il piano di abbonamento.

Accesso alla creazione

Dalla dashboard principale, vai sulla sezione Agenti dalla sidebar (o vai direttamente alla lista chatbot). In alto a destra trovi il pulsante Nuovo Agent o Crea Agent. Cliccandolo si apre la procedura guidata.

Passaggio 1: Scelta del tipo

Il primo passaggio è la scelta del tipo di Agent. È la decisione più importante perché determina molte impostazioni di default, la terminologia interna e le funzionalità attivate immediatamente.

Le tre opzioni:

• Sito web — per attività turistiche generiche (guide, esperienze, agenzie, eventi)
• Ristorante — per ristoranti, pizzerie, bar, attività di ristorazione
• Struttura ricettiva — per hotel, B&B, ville, agriturismi

Per i dettagli completi su ciascun tipo e per capire quale scegliere, vedi la guida Tipi di Agent. La scelta del tipo può essere modificata in seguito dalle impostazioni generali, anche se è preferibile partire dal tipo corretto per evitare riadattamenti.

Passaggio 2: Nome dell'Agent

Inserisci un nome interno per l'Agent. Questo nome serve solo a te per identificarlo nella dashboard — non viene mostrato agli ospiti, a meno che tu non lo riprenda nelle impostazioni di personalizzazione visiva.

Consigli sul nome

• Usa il nome commerciale della tua attività (es. "Hotel Bellavista", "Ristorante Da Luigi", "Tour Guide Roma")
• Per chi gestisce più strutture, includi un riferimento geografico (es. "Bellavista Riccione", "Bellavista Cesenatico")
• Per Agent separati su una stessa attività, includi il ruolo (es. "Bellavista — Concierge", "Bellavista — Ristorante")
• Evita nomi tecnici o generici (es. "Test", "Bot Italiano", "Chatbot 1")

Il nome può essere cambiato in qualsiasi momento dalle impostazioni.

Passaggio 3: Lingua principale

Indica la lingua principale dei tuoi contenuti — quella in cui scrivi tipicamente le tue informazioni sul sito, i tuoi articoli, i menu, le brochure. Per attività italiane è quasi sempre l'italiano.

L'Agent comunque comprende e risponde in 30+ lingue automaticamente, indipendentemente dalla lingua principale impostata. La lingua principale serve come default per:

• L'interfaccia interna della dashboard
• I testi predefiniti del welcome message e dei placeholder
• La lingua di partenza per le traduzioni multilingua dei contenuti

Se la tua clientela è prevalentemente estera (es. una guida turistica che lavora solo con turisti inglesi), puoi impostare l'inglese come lingua principale.

Passaggio 4: Conferma e creazione

Confermando si crea l'Agent. Il sistema:

• Genera un ID univoco per l'Agent (visibile nelle impostazioni generali)
• Crea uno slug pubblico predefinito basato sul nome (es. "Hotel Bellavista" → hotel-bellavista)
• Imposta i valori di default basati sul tipo scelto
• Apre la pagina di configurazione dell'Agent appena creato

Sei già operativo. L'Agent risponderà alle conversazioni — anche se senza contenuti caricati, le risposte saranno generiche. Il passaggio successivo è caricare i contenuti.

La pagina di configurazione dell'Agent

Dopo la creazione, atterri nella pagina di configurazione dell'Agent. È organizzata in schede laterali, ciascuna dedicata a un'area di configurazione:

Non sei obbligato a configurare ogni scheda. Le minime necessarie per attivare l'Agent sono:

• Impostazioni generali — per definire il prompt di sistema (cosa deve fare e come deve comportarsi l'Agent)
• Una fonte di addestramento — almeno una tra crawler, file e articoli, per dare contenuto all'Agent
• Design — per personalizzare colori e messaggio di benvenuto
• Pubblicazione — copiare il widget e incollarlo sul sito (vedi Integrazione)

Tutto il resto si attiva quando ti serve.

Cosa succede sotto: il sistema interno

Quando crei un Agent, Hotely crea automaticamente:

• Un identificativo univoco per l'Agent, usato internamente
• Uno slug pubblico che diventa l'URL dell'Agent (es. hotely.ai/hotel-bellavista)
• Una base di conoscenza vuota pronta a ricevere contenuti
• Le impostazioni di default del tipo scelto (terminologia, prompt iniziali, funzioni attive)
• Le configurazioni di default per i canali (chat, design, lingua)
• Un'area conversazioni vuota che si popolerà man mano

Slug pubblico e URL

Lo slug pubblico è la parte finale dell'URL dove vive l'Agent. Per esempio se lo slug è hotel-bellavista, l'URL pubblico dell'Agent diventa:

• Chat principale: hotely.ai/hotel-bellavista
• Camera 305 (per strutture ricettive): hotely.ai/hotel-bellavista/room-305
• Tavolo 12 (per ristoranti): hotely.ai/ristorante-luigi/table-12

Lo slug si può cambiare dalle impostazioni generali. Cambiarlo successivamente significa che gli URL già condivisi (es. QR code stampati) non funzionano più — meglio sceglierlo bene fin da subito.

Consigli sullo slug

• Usa nome breve e descrittivo (es. villa-toscana, agriturismo-fattoria)
• Solo lettere minuscole, numeri e trattini, niente spazi o caratteri speciali
• Evita slug troppo generici (es. hotel, ristorante) che potrebbero collidere con altri
• Per multi-proprietà, includi il riferimento geografico (es. bellavista-rimini, bellavista-cesenatico)

Multi-Agent: gestire più Agent in parallelo

Una volta creato il primo Agent, dalla lista chatbot in dashboard puoi:

• Creare nuovi Agent con il pulsante in alto a destra
• Duplicare un Agent esistente per riutilizzarne configurazione e contenuti come base
• Aprire la chat di test per provare l'Agent senza pubblicarlo
• Vedere le statistiche rapide di ogni Agent (conversazioni, richieste, performance)
• Sospendere un Agent temporaneamente se vuoi metterlo offline senza eliminarlo

I dati di un Agent restano isolati: i contenuti, le conversazioni, le richieste e gli ospiti di un Agent non si mescolano con quelli di altri. Per condivisione cross-Agent puoi usare i workspace (vedi Workspace).

Errori frequenti in fase di creazione

Prossimi passi dopo la creazione

Una volta creato l'Agent, il flusso suggerito è:

1. Configura le impostazioni generali — prompt di sistema, comportamento
2. Carica i contenuti con crawler, file o articoli
3. Personalizza l'aspetto da Design
4. Verifica le risposte in chat di prova
5. Pubblica l'Agent con Integrazione

L'ordine non è rigido — puoi tornare a modificare ogni area in qualsiasi momento.