Il tuo primo agente
Questo tutorial ti guida nella creazione, configurazione e test del tuo primo agente vocale IA. Alla fine, avrai un agente funzionante in grado di rispondere a domande sulla tua attività.
Cosa costruiremo
Un agente vocale IA che:
- Saluta i chiamanti in modo professionale
- Risponde alle domande utilizzando le informazioni della tua azienda
- Fornisce orari di apertura e contatti
- Sa quando trasferire la chiamata a un operatore umano
Tempo stimato: 15-20 minuti
Prerequisiti
Prima di iniziare, assicurati di avere:
- Creato il tuo account Hanc.AI (Configurazione account)
- Effettuato l'accesso alla piattaforma
- Informazioni di base sulla tua attività pronte
Passaggio 1: Crea un nuovo agente
Esistono due percorsi per creare un agente: Basato su template (consigliato per i principianti) o Da zero.
Percorso A: Basato su template (Consigliato)
I ruoli template forniscono configurazioni predefinite che permettono di iniziare rapidamente. Hanc.AI offre 24 template di ruolo pronti all'uso in due categorie.
1.1 Vai a Agenti vocali IA
- Clicca su "Agenti vocali IA" nella barra laterale sinistra
- Se è la prima volta, un tour di onboarding ti guiderà attraverso l'interfaccia passo dopo passo
1.2 Avvia la creazione dell'agente
Clicca sul pulsante "Crea agente vocale IA". Apparirà una finestra modale con due opzioni:
- Inizia da zero — crea un agente vuoto da configurare manualmente (vedi Percorso B sotto)
- Ruoli template — 24 template di ruolo organizzati in due categorie
1.3 Sfoglia i ruoli template
I ruoli template sono organizzati in due categorie:
Rivolti al cliente (14 ruoli):
| Template | Ideale per |
|---|---|
| Agente di vendita | Chiamate di vendita, presentazioni, chiusura affari |
| Receptionist | Accoglienza chiamanti, smistamento, richieste generali |
| Consulente | Chiamate esplorative, valutazione delle esigenze, consulenza |
| Agente di supporto | Assistenza clienti, risoluzione problemi |
| Agente ordini | Inserimento ordini, tracking, modifiche |
| Smistatore di chiamate | Indirizzare i chiamanti al reparto o alla persona giusta |
| Agente promemoria | Promemoria appuntamenti, follow-up, notifiche |
| Agente feedback | Raccolta feedback e sondaggi clienti |
| Agente di recupero crediti | Promemoria pagamenti, follow-up fatture |
| Qualificatore di lead | Qualificazione lead in ingresso, raccolta info sui prospect |
| Guida | Istruzioni passo-passo, onboarding, walkthrough |
| Promotore | Awareness di prodotto, campagne, engagement top-of-funnel |
| Risponditore automatico | Risposta automatica, informazioni di base |
| Presentatore | Presentazioni di prodotti o servizi, demo |
Rivolti ai dipendenti (10 ruoli):
| Template | Ideale per |
|---|---|
| Segretaria | Gestione chiamate interne, pianificazione, raccolta messaggi |
| Recruiter | Screening candidati, pianificazione colloqui |
| Onboarder | Onboarding nuovi dipendenti, orientamento |
| Coordinatore | Coordinamento team, pianificazione riunioni |
| Controllore | Monitoraggio processi, aggiornamenti di stato, controlli di conformità |
| Helpdesk interno | Supporto IT, FAQ interne, assistenza dipendenti |
| Raccoglitore dati | Raccolta dati strutturati dai membri del team |
| Agente di approvazione | Smistamento approvazioni, raccolta firme |
| Agente acquisti | Richieste di acquisto, contatti con fornitori |
| Dispatcher | Assegnazione attività, allocazione risorse, dispatch |
Per questo tutorial: Seleziona qualsiasi template adatto al tuo caso d'uso.
I ruoli template includono prompt predefiniti, messaggi di saluto e protocolli di conversazione ottimizzati per ruoli specifici. Puoi personalizzare tutto dopo la creazione.
1.4 Visualizza i dettagli del template
Clicca su qualsiasi card di template per aprire una vista dettagliata che mostra:
- Descrizione del ruolo e di cosa fa l'agente
- Vantaggi dell'utilizzo di questo template
- Capacità che l'agente avrà
- Selettore di lingua — prima scegli una lingua (es. inglese, deutsch), poi una variante regionale (es. Stati Uniti, Austria, Svizzera) e la voce corrispondente
- Scarica come documento Word — esporta le domande del Setup Wizard come file
.docxnella lingua scelta, in modo che il tuo team possa compilarlo offline. Una volta compilato, lo stesso wizard di Setup guidato può rileggere il documento e auto-popolare tutti i campi corrispondenti — vedi Compilazione tramite documento Word sotto
Ogni template è fornito in 20 lingue supportate con prompt di qualità nativa e opzioni vocali per ciascuna. Il ruolo Receptionist in tedesco utilizza una vera base in tedesco, non una traduzione di un template inglese.
Compilazione tramite documento Word
Se preferisci raccogliere le informazioni aziendali offline (o suddividere il lavoro tra i colleghi), utilizza il percorso con documento Word:
- Clicca su Scarica come documento Word nella finestra modale dei dettagli del ruolo — ottieni un
.docxcorrispondente al ruolo e alla lingua scelti. - Compila quante più sezioni puoi. Salta quelle di cui non hai risposte.
- Clicca su Setup guidato per aprire il wizard per lo stesso ruolo.
- All'interno del wizard, clicca su Carica documento compilato e seleziona il file. Il wizard analizza le tue risposte e mostra una conferma del tipo "12 di 18 campi compilati dal documento."
- Rivedi e modifica i campi precompilati, quindi prosegui attraverso il wizard come di consueto.
Puoi ricaricare il documento in qualsiasi momento — ogni caricamento aggiorna i campi corrispondenti con i valori più recenti dal tuo file.
1.5 Scegli come creare
Dalla vista dei dettagli del template, hai due pulsanti:
- Distribuisci agente — Crea l'agente istantaneamente con le impostazioni predefinite del template. Potrai inserire i dettagli della tua azienda in seguito utilizzando il Setup Wizard. Questo è il modo più rapido per iniziare.
- Setup guidato — Apre un wizard passo-passo dove inserisci i dettagli della tua azienda (nome dell'azienda, servizi, contatti, ecc.) prima che l'agente venga creato.
Distribuisci agente è ottimo se vuoi prima esplorare l'agente e configurarlo in seguito. Setup guidato è migliore se hai già le informazioni della tua azienda pronte e desideri un agente più completo fin dall'inizio.
1.6 Setup guidato (se scelto)
Se hai cliccato su Setup guidato, un wizard ti guida nella compilazione dei dettagli specifici della tua attività:
- Nome azienda, servizi, contatti
- Orari di apertura, ubicazione, prezzi
- Istruzioni specifiche e politiche
Importante: Puoi saltare campi o intere sezioni che non si applicano alla tua attività. Tuttavia, almeno una sezione deve essere completamente completata prima di poter procedere.
Dopo aver completato il wizard, il tuo agente viene creato con tutti i dettagli forniti.
Percorso B: Da zero
Per il pieno controllo fin dall'inizio:
- Clicca su "Crea agente vocale IA"
- Seleziona "Inizia da zero"
- Viene creato un agente vuoto con un prompt predefinito
- Configurerai tutto manualmente nel passaggio successivo
Passaggio 2: Dopo la creazione
Una volta creato l'agente, vedrai un banner di successo con i prossimi passi suggeriti. Un tour di onboarding ti guiderà attraverso le schede di configurazione dell'agente, evidenziando le impostazioni e le funzionalità chiave.
Il tuo agente arriva con due variabili di recupero predefinite — Email e Telefono — in modo che possa raccogliere informazioni di contatto dai chiamanti fin da subito. Puoi personalizzare o rimuovere queste variabili nella scheda Azioni.
Il Setup Wizard
Cerca l'icona della bacchetta luminosa accanto al nome del tuo agente — questo è il Setup Wizard. Ti aiuta a compilare i dettagli rimanenti sezione per sezione.
Come funziona il Setup Wizard:
- Il progresso è tracciato come "X/Y sezioni completate" così sai sempre cosa resta da fare
- Ogni sezione copre un'area diversa di configurazione: Configurazione agente, Profilo aziendale, Servizi, Specialisti, Sedi e altro
- Puoi saltare campi o intere sezioni di cui non hai bisogno (minimo 1 campo per sezione)
- Lavora sulle sezioni in qualsiasi ordine al tuo ritmo
Se hai usato Distribuisci agente, il Setup Wizard è il tuo metodo principale per aggiungere i dettagli aziendali dopo la creazione. Se hai usato Setup guidato, alcune sezioni saranno già compilate.
La modifica manuale del prompt o dei file della Knowledge Base disabilita il Setup Wizard. Se ciò accade, apparirà un pulsante "Ripristina al template" che ti consente di ripristinare la funzionalità del wizard.
Schede dell'agente
La pagina di configurazione del tuo agente ha queste schede:
| Scheda | Cosa contiene |
|---|---|
| Dashboard | Panoramica dell'attività dell'agente e statistiche |
| Modello | Prompt, voce, lingua e impostazioni del modello IA |
| Knowledge Base | File e informazioni che l'agente usa per rispondere alle domande |
| Impostazioni | Impostazioni chiamata, primo messaggio, limiti di durata |
| Azioni | Azioni post-chiamata (email, SMS, webhook) |
| Widget | Configurazione del widget web per l'incorporamento sul tuo sito |
Passaggio 3: Configura le impostazioni dell'agente
3.1 Prompt
Il prompt definisce la personalità, il comportamento e il flusso di conversazione del tuo agente.
Se hai usato un template, il prompt è precompilato. Rivedilo e personalizzalo per la tua attività.
Se hai iniziato da zero, scrivi il tuo prompt:
## Ruolo
Sei un assistente virtuale cordiale per [Nome della tua azienda].
Aiuti i clienti con domande sui nostri servizi, orari e prenotazione di appuntamenti.
## Stile di comunicazione
- Parla in modo chiaro e conciso
- Sii educato e professionale
- Mantieni le risposte brevi (1-3 frasi quando possibile)
- Fai una domanda alla volta
## Regole importanti
1. Fornisci solo informazioni di cui sei certo
2. Se non sai qualcosa, di' "Non ho questa informazione, ma posso metterla in contatto con il nostro team"
3. Non inventare mai prezzi, disponibilità o altri dettagli specifici
4. Trasferisci a un operatore umano se il cliente è arrabbiato o ha un problema complesso
Includi sempre l'istruzione: "Non inventare mai informazioni." Questo impedisce all'IA di inventare dettagli falsi sulla tua attività.
3.2 Knowledge Base
La knowledge base fornisce all'agente i fatti di cui ha bisogno per rispondere alle domande.
- Vai alla scheda Knowledge Base nelle impostazioni dell'agente
- Crea una nuova knowledge base o seleziona una esistente
- Carica file con le informazioni della tua attività
Formati di file accettati: .txt, .md, .docx, .pdf, .html, .csv
Cosa includere:
- Servizi e prezzi
- Orari di apertura e ubicazione
- Domande frequenti
- Politiche (cancellazione, pagamento, ecc.)
- Informazioni sul team
L'agente conosce SOLO ciò che è nella knowledge base. Se mancano informazioni, l'agente non può rispondere a quelle domande. Aggiungi tutti i dettagli importanti.
3.3 Voce
Scegli una voce adatta al tuo brand:
- Seleziona la lingua
- Sfoglia le voci disponibili (maschio/femmina, stili diversi)
- Ascolta l'anteprima delle voci prima di selezionarne una
3.4 Impostazioni chiamata
Configura il comportamento della chiamata:
- Primo messaggio (saluto quando l'agente risponde)
- Impostazioni della lingua
- Limiti di durata delle chiamate
3.5 Strumenti
Aggiungi strumenti che l'agente può utilizzare durante le chiamate:
- Google Calendar per la pianificazione di appuntamenti
- Integrazioni API personalizzate
3.6 Azioni
Configura azioni post-chiamata che si attivano dopo la fine di una conversazione:
- Invia riepiloghi via email
- Invia notifiche SMS
- Attiva webhook
- Effettua chiamate API
3.7 Widget
Configura il widget web per l'incorporamento sul tuo sito:
- Aspetto e colori
- Posizione e comportamento
- Branding personalizzato
3.8 Salva le impostazioni
Clicca su "Salva" o "Aggiorna" per salvare la tua configurazione.
Passaggio 4: Testa il tuo agente
Ora vediamo il tuo agente in azione!
4.1 Test tramite Widget Web
- Trova il tuo agente nella lista Agenti vocali IA
- Clicca su "Parla con l'agente" o sul pulsante di test/chiamata
- Consenti l'accesso al microfono nel tuo browser
- Inizia a parlare
4.2 Test tramite numero di telefono
Se hai un numero di telefono collegato:
- Assegna il tuo agente al numero (nelle impostazioni Numeri di telefono)
- Chiama il numero da qualsiasi telefono
4.3 Scenari di test
Test 1: Saluto base
- Attendi il saluto dell'agente
- Di': "Ciao"
- L'agente dovrebbe rispondere naturalmente
Test 2: Orari di apertura
- Di': "Quali sono i vostri orari di apertura?"
- L'agente dovrebbe fornire i tuoi orari dalla knowledge base
Test 3: Domanda sui servizi
- Di': "Quali servizi offrite?"
- L'agente dovrebbe elencare i tuoi servizi
Test 4: Domanda sui prezzi
- Di': "Quanto costa [il tuo servizio]?"
- L'agente dovrebbe fornire il prezzo se è nella knowledge base
Test 5: Domanda sconosciuta
- Di': "Qual è il senso della vita?"
- L'agente dovrebbe dire educatamente di non avere queste informazioni
4.4 Termina il test
Clicca su "Termina chiamata" o chiudi la finestra di test al termine.
Passaggio 5: Perfeziona il tuo agente
In base ai test, potresti voler migliorare:
Problemi comuni e soluzioni
| Problema | Soluzione |
|---|---|
| L'agente parla troppo | Aggiungi al prompt: "Mantieni le risposte a 1-2 frasi" |
| L'agente troppo formale | Modifica il tono del prompt: "Sii cordiale e colloquiale" |
| L'agente non conosce le informazioni | Verifica che la knowledge base contenga le informazioni |
| L'agente inventa cose | Sottolinea nel prompt: "Non inventare MAI informazioni" |
| Lingua sbagliata | Verifica che l'impostazione Lingua corrisponda alle tue esigenze |
| Voce troppo veloce/lenta | Modifica le impostazioni di velocità della voce |
Itera e migliora
- Testa → Identifica i problemi → Modifica prompt/impostazioni → Testa di nuovo
- Aggiungi altre FAQ alla knowledge base in base alle chiamate di test
- Perfeziona il prompt in base alle conversazioni reali
Passaggio 6: Distribuisci il tuo agente (Opzionale)
Una volta soddisfatto dei test, puoi distribuire il tuo agente:
Opzione A: Collega un numero di telefono
- Vai su Numeri di telefono
- Acquista un numero o importane uno esistente
- Assegna il tuo agente al numero
- Le chiamate a quel numero saranno gestite dal tuo agente
Opzione B: Aggiungi widget al sito web
- Vai alle impostazioni del tuo agente
- Trova la scheda Widget
- Copia il codice di incorporamento
- Aggiungilo al tuo sito web
Checklist: Il tuo agente è pronto?
Prima di andare in produzione, verifica:
- Il primo messaggio è chiaro e accogliente
- Il prompt definisce correttamente il comportamento
- La knowledge base contiene informazioni accurate
- L'agente gestisce bene le domande comuni
- L'agente ammette quando non sa qualcosa
- La voce è adatta al tuo brand
- La lingua è impostata correttamente
- Le chiamate di test producono buoni risultati
E adesso?
Congratulazioni! Hai creato il tuo primo agente vocale IA.
Continua a imparare:
- Approfondimento sugli agenti vocali IA — Configurazione avanzata degli agenti
- Best practice della Knowledge Base — Crea knowledge base migliori
- Numeri di telefono — Collega numeri di telefono reali
- Ruoli template — Prompt e configurazioni pronti all'uso
- Campagne — Configura campagne di chiamate in uscita
Risoluzione dei problemi
L'agente non avvia la chiamata di test
- Verifica i permessi del microfono nel browser
- Prova un browser diverso
- Assicurati di avere una connessione internet stabile
L'agente non risponde
- Attendi qualche secondo — potrebbe esserci un ritardo di elaborazione
- Parla chiaramente e non troppo velocemente
- Verifica che l'agente non sia in pausa/inattivo
L'agente fornisce informazioni errate
- Verifica che il contenuto della knowledge base sia corretto
- Verifica che la knowledge base sia collegata all'agente
- Rivedi il prompt per istruzioni in conflitto
La qualità della voce è scarsa
- Controlla la tua connessione internet
- Prova una voce diversa
- Riduci il rumore di fondo
Hai bisogno di aiuto?
- Consulta la Guida alla risoluzione dei problemi
- Contatta support@hanc.ai