Il tuo primo agente
Questo tutorial ti accompagna nella creazione, configurazione e test del tuo primo agente vocale IA. Alla fine, avrai un agente funzionante capace di rispondere alle domande sulla tua attività.
Cosa costruiremo
Un agente vocale che:
- Saluta i chiamanti in modo professionale
- Risponde alle domande usando le informazioni della tua attività
- Fornisce orari lavorativi e dettagli di contatto
- Sa quando trasferire a un umano
Tempo stimato: 15-20 minuti
Prerequisiti
Prima di iniziare, assicurati di avere:
- Creato il tuo account Hanc.AI (Configurazione dell'account)
- Effettuato l'accesso alla piattaforma
- Le informazioni di base sulla tua attività pronte
Passo 1: Creare un nuovo agente
Ci sono 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 ti fanno iniziare rapidamente. Hanc.AI offre 24 template di ruolo pronti all'uso in due categorie.
1.1 Vai su Agenti vocali
- Clicca su "Agenti vocali" nella barra laterale sinistra
- Se è la tua prima volta, un tour di onboarding ti guiderà attraverso l'interfaccia passo dopo passo
1.2 Avviare la creazione dell'agente
Clicca sul pulsante "Crea agente vocale". Compare un modale con due opzioni:
- Inizia da zero — crea un agente vuoto che configuri manualmente (vedi il Percorso B qui sotto)
- Ruoli template — 24 template di ruolo organizzati in due categorie
Puoi anche costruire un agente con Hanc Studio — descrivi ciò di cui hai bisogno e assembla per te un agente pronto (ruolo, workflow, knowledge base e integrazioni).
1.3 Sfogliare i ruoli template
I ruoli template sono organizzati in due categorie:
Rivolti ai clienti (14 ruoli):
| Template | Ideale per |
|---|---|
| Agente di vendita | Chiamate di vendita, presentazioni, chiusura di trattative |
| Receptionist | Accoglienza dei chiamanti, instradamento, richieste generali |
| Consulente | Chiamate esplorative, valutazione delle esigenze, consulenza |
| Agente di supporto | Supporto clienti, risoluzione di problemi, gestione dei problemi |
| Agente ordini | Inserimento ordini, tracciamento, modifiche |
| Instradatore di chiamate | Indirizzamento dei chiamanti al reparto o alla persona giusta |
| Agente promemoria | Promemoria di appuntamenti, follow-up, notifiche |
| Agente feedback | Raccolta di feedback e sondaggi dai clienti |
| Agente recupero crediti | Promemoria di pagamento, solleciti di fatture |
| Qualificatore di lead | Qualifica dei lead in entrata, raccolta di informazioni sui prospect |
| Guida | Istruzioni passo dopo passo, onboarding, tutorial |
| Promotore | Notorietà del prodotto, campagne, coinvolgimento in cima al funnel |
| Risponditore automatico | Risposta automatica alle chiamate, fornitura di informazioni di base |
| Presentatore | Presentazioni di prodotti o servizi, demo |
Rivolti ai dipendenti (10 ruoli):
| Template | Ideale per |
|---|---|
| Segretario | Gestione delle chiamate interne, pianificazione, presa di messaggi |
| Recruiter | Screening dei candidati, pianificazione dei colloqui |
| Onboarder | Onboarding dei nuovi dipendenti, orientamento |
| Coordinatore | Coordinamento del team, pianificazione delle riunioni |
| Controllore | Monitoraggio dei processi, aggiornamenti di stato, controlli di conformità |
| Helpdesk interno | Supporto IT, FAQ interne, assistenza ai dipendenti |
| Raccoglitore di dati | Raccolta di dati strutturati dai membri del team |
| Agente approvazioni | Instradamento delle approvazioni, raccolta di autorizzazioni |
| Agente acquisti | Richieste di acquisto, richieste ai fornitori |
| Dispatcher | Assegnazione dei task, allocazione delle risorse, dispatching |
Per questo tutorial: Seleziona qualsiasi template che corrisponda al tuo caso d'uso.
I ruoli template includono prompt pre-scritti, messaggi di saluto e protocolli di conversazione ottimizzati per ruoli specifici. Puoi personalizzare tutto dopo la creazione.
1.4 Visualizzare i dettagli del template
Clicca su qualsiasi scheda template per aprire una vista di dettaglio che mostra:
- Descrizione del ruolo e di ciò che fa l'agente
- Vantaggi dell'uso di questo template
- Capacità che avrà l'agente
- Selettore di lingua — prima scegli una lingua (es. English, Deutsch), poi una variante regionale (es. Stati Uniti, Austria, Svizzera) e la voce corrispondente
- Scarica come documento Word — esporta le domande della procedura guidata di configurazione come file
.docxnella lingua che hai scelto, così il tuo team può compilarle offline. Una volta compilato, la stessa procedura di configurazione guidata può rileggere il documento e popolare automaticamente ogni campo corrispondente — vedi Compilazione tramite documento Word qui sotto
Ogni template è fornito in 25 lingue supportate con prompt di qualità nativa e opzioni vocali per ciascuna. Il ruolo Receptionist in tedesco usa una base tedesca reale, 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), usa il percorso del documento Word:
- Clicca su Scarica come documento Word nel modale di dettaglio del ruolo — ottieni un
.docxcorrispondente al ruolo e alla lingua che hai scelto. - Compila tutte le sezioni per cui hai risposte. Salta ciò che non conosci.
- Clicca su Configurazione guidata per aprire la procedura guidata per lo stesso ruolo.
- All'interno della procedura, clicca su Carica documento compilato e seleziona il file. La procedura analizza le tue risposte e mostra una conferma come "12 campi su 18 compilati dal documento."
- Rivedi e modifica i campi precompilati, poi prosegui nella procedura guidata come di consueto.
Puoi ricaricare il documento in qualsiasi momento — ogni caricamento aggiorna i campi corrispondenti con i valori più recenti del tuo file.
1.5 Scegliere come creare
Dalla vista di dettaglio del template, hai due pulsanti:
- Deploy Agent — Crea l'agente istantaneamente con i valori predefiniti del template. Puoi inserire i dettagli della tua attività in seguito usando la procedura guidata di configurazione. È il modo più rapido per iniziare.
- Configurazione guidata — Apre una procedura guidata passo dopo passo in cui inserisci i dettagli della tua attività (nome dell'azienda, servizi, informazioni di contatto, ecc.) prima che l'agente venga creato.
Deploy Agent è ottimo se vuoi prima esplorare l'agente e configurarlo in seguito. Configurazione guidata è meglio se hai le informazioni della tua attività pronte e vuoi un agente più completo fin dall'inizio.
1.6 Configurazione guidata (se scelta)
Se hai cliccato su Configurazione guidata, una procedura guidata ti accompagna nel compilare i dettagli specifici della tua attività:
- Nome dell'azienda, servizi, dettagli di contatto
- Orari lavorativi, sede, prezzi
- Istruzioni e politiche specifiche
Importante: Puoi saltare campi o intere sezioni che non si applicano alla tua attività. Tuttavia, almeno una sezione deve essere completata interamente prima di poter procedere.
Dopo aver completato la procedura guidata, il tuo agente viene creato con tutti i dettagli che hai fornito.
Percorso B: Da zero
Per il pieno controllo fin dall'inizio:
- Clicca su "Crea agente vocale"
- Seleziona "Inizia da zero"
- Viene creato un agente vuoto con un prompt predefinito
- Configurerai tutto manualmente nel passo successivo
Passo 2: Dopo la creazione
Una volta creato il tuo agente, vedrai un banner di successo con i passi successivi suggeriti. Un tour di onboarding ti accompagnerà attraverso le schede di configurazione dell'agente, evidenziando impostazioni e funzionalità chiave.
Il tuo agente arriva con due variabili di recupero predefinite — Email e Telefono — così può raccogliere subito le informazioni di contatto dai chiamanti. Puoi personalizzarle o rimuoverle nella scheda Azioni.
La procedura guidata di configurazione
Cerca l'icona a bacchetta luminosa accanto al nome del tuo agente — è la procedura guidata di configurazione. Ti aiuta a inserire i dettagli rimanenti sezione per sezione.
Come funziona la procedura guidata di configurazione:
- L'avanzamento è tracciato come "X/Y sezioni completate" così sai sempre cosa resta
- Ogni sezione copre un'area diversa della configurazione: Configurazione dell'agente, Profilo aziendale, Servizi, Specialisti, Sedi e altro
- Puoi saltare campi o intere sezioni che non ti servono (minimo 1 campo per sezione)
- Lavora sulle sezioni in qualsiasi ordine, al tuo ritmo
Se hai usato Deploy Agent, la procedura guidata di configurazione è il tuo modo principale per aggiungere i dettagli aziendali dopo la creazione. Se hai usato Configurazione guidata, alcune sezioni saranno già compilate.
Modificare manualmente il prompt o i file della knowledge base disabilita la procedura guidata di configurazione. Se questo accade, compare un pulsante "Reset to Template" che ti permette di ripristinare la funzionalità della procedura guidata.
Schede dell'agente
La pagina di configurazione del tuo agente ha queste schede:
| Scheda | Cosa contiene |
|---|---|
| Dashboard | Panoramica dell'attività dell'agente e statistiche |
| Model | Prompt, voce, lingua e impostazioni del modello IA |
| Knowledge Base | File e informazioni che l'agente usa per rispondere alle domande |
| Impostazioni | Impostazioni delle chiamate, primo messaggio, limiti di durata delle chiamate |
| Azioni | Azioni post-chiamata (email, SMS, webhook) |
| Widget | Configurazione del widget web per l'incorporamento nel tuo sito web |
Passo 3: Configurare 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:
## Role
You are a friendly virtual assistant for [Your Business Name].
You help customers with questions about our services, hours, and booking appointments.
## Communication Style
- Speak clearly and concisely
- Be polite and professional
- Keep responses short (1-3 sentences when possible)
- Ask one question at a time
## Important Rules
1. Only provide information you know for certain
2. If you don't know something, say "I don't have that information, but I can connect you with our team"
3. Never make up prices, availability, or other specific details
4. Transfer to a human if the customer is upset or has a complex issue
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 al tuo 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 selezionane 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 lavorativi e sede
- Domande frequenti
- Politiche (cancellazione, pagamento, ecc.)
- Informazioni sul team
L'agente conosce SOLO ciò che è nella knowledge base. Se un'informazione manca, l'agente non può rispondere a quelle domande. Aggiungi tutti i dettagli importanti.
3.3 Voce
Scegli una voce che si abbini al tuo marchio:
- Seleziona la lingua
- Sfoglia le voci disponibili (maschili/femminili, stili diversi)
- Ascolta l'anteprima delle voci prima di selezionare
3.4 Impostazioni delle chiamate
Configura il comportamento delle chiamate:
- Primo messaggio (saluto quando l'agente risponde)
- Impostazioni della lingua
- Limiti di durata delle chiamate
3.5 Tool
Aggiungi tool che l'agente può usare 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 via SMS
- Attiva webhook
- Effettua chiamate API
3.7 Widget
Configura il widget web per l'incorporamento nel tuo sito web:
- Aspetto e colori
- Posizione e comportamento
- Branding personalizzato
3.8 Salvare le impostazioni
Clicca su "Salva" o "Aggiorna" per salvare la tua configurazione.
Passo 4: Testare il tuo agente
Ora vediamo il tuo agente in azione!
4.1 Test tramite widget web
- Trova il tuo agente nell'elenco Agenti vocali
- 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 di base
- Attendi il saluto dell'agente
- Di': "Salve"
- L'agente dovrebbe rispondere in modo naturale
Test 2: Orari lavorativi
- Di': "Quali sono i vostri orari di apertura?"
- L'agente dovrebbe fornire i tuoi orari dalla knowledge base
Test 3: Domanda su un servizio
- Di': "Quali servizi offrite?"
- L'agente dovrebbe elencare i tuoi servizi
Test 4: Domanda sul prezzo
- 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 quell'informazione
4.4 Terminare il test
Clicca su "Termina chiamata" o chiudi la finestra di test quando hai finito.
Passo 5: Affinare 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 | Regola il tono del prompt: "Sii cordiale e colloquiale" |
| L'agente non conosce un'informazione | Controlla che la knowledge base contenga l'informazione |
| L'agente inventa cose | Sottolinea nel prompt: "Non inventare MAI informazioni" |
| Lingua errata | Controlla che l'impostazione della lingua corrisponda alle tue esigenze |
| Voce troppo veloce/lenta | Regola le impostazioni di velocità della voce |
Itera e migliora
- Testa → Identifica i problemi → Regola prompt/impostazioni → Testa di nuovo
- Aggiungi altre FAQ alla knowledge base in base alle chiamate di prova
- Affina il prompt in base alle conversazioni reali
Passo 6: Distribuire il tuo agente (facoltativo)
Una volta soddisfatto dei test, puoi distribuire il tuo agente:
Opzione A: Collegare 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 sono ora gestite dal tuo agente
Opzione B: Aggiungere il widget del 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 della messa in produzione, verifica:
- Il primo messaggio è chiaro e accogliente
- Il prompt definisce correttamente il comportamento
- La knowledge base ha informazioni accurate
- L'agente gestisce bene le domande comuni
- L'agente ammette quando non conosce qualcosa
- La voce suona appropriata per il tuo marchio
- La lingua è impostata correttamente
- Le chiamate di prova producono buoni risultati
Cosa viene dopo?
Congratulazioni! Hai creato il tuo primo agente vocale.
Continua a imparare:
- Approfondimento sugli agenti vocali — Configurazione avanzata degli agenti
- Best practice per la 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 prova
- Controlla 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 veloce
- Controlla che l'agente non sia in pausa/inattivo
L'agente fornisce informazioni errate
- Verifica che il contenuto della knowledge base sia corretto
- Controlla che la knowledge base sia collegata all'agente
- Rivedi il prompt per istruzioni contrastanti
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