> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Crea il tuo primo agente vocale
> Il builder dell'agente dall'inizio alla fine: prompt, motore, voce e lingue, strumenti e Knowledge, conversazione e deployment.
Tutto ciò che riguarda un agente si trova nel builder in **Agenti vocali**
(`/dashboard/agents`) — creane uno e accederai direttamente al builder. Questa guida
segue lo stesso percorso del tour in-app "Crea un agente".
È la prima volta qui? La [guida rapida della dashboard](/it/quickstart-dashboard)
riunisce questa pagina, la fatturazione, i numeri e le simulazioni nella
procedura guidata di configurazione in cinque passaggi.
## 1. Scrivi il prompt
Il prompt è il copione del tuo agente vocale. Descrivi — in qualsiasi
lingua — chi è l'agente e come deve gestire la chiamata: la sua
personalità, ciò che sa e cosa deve o non deve fare.
Anche le azioni di chiamata vengono definite nel prompt. Trasferimenti, pressioni
dei tasti e chiusure di chiamata sono semplici righe del prompt come *"Se il chiamante chiede di parlare con una persona, trasferisci
la chiamata a +1 555…"* — senza configurazioni separate.
Le indicazioni specifiche sono meglio di quelle generiche. "Conferma al chiamante il numero dell'ordine
prima di apportare modifiche" funziona meglio di "fai attenzione agli ordini".
## 2. Scegli un motore
Nella scheda **Configurazione**, il selettore del motore bilancia costo e
prestazioni su tre livelli — **Spark** è ottimizzato per il costo,
**Bolt** per la velocità, **Storm** per l'intelligenza nei prompt complessi.
Ogni scheda mostra il relativo prezzo al minuto. Cambia in qualsiasi momento; consulta il
[confronto completo dei livelli](/api-reference/agents#product-tiers-at-a-glance).
## 3. Scegli una voce e le lingue
Scegli una voce e riproduci il suo campione direttamente nel builder. Imposta la
**lingua principale** con cui inizia la chiamata, oltre alle eventuali **lingue
aggiuntive** — l'agente passa automaticamente a una di esse quando un chiamante la usa.
L'elenco delle voci viene filtrato in base alle voci che supportano tutte le lingue selezionate.
Consulta [Lingue supportate](/it/guides/supported-languages) per il catalogo completo
(le lingue premium aggiungono 2¢/min).
## 4. Collega strumenti e Knowledge
Quattro sezioni nella scheda Configurazione offrono capacità all'agente:
* **App connesse** — il percorso più semplice:
[collega Slack, HubSpot, Google e altro](/it/guides/connect-apps) in pochi
clic, quindi lascia che il tuo agente le usi durante le chiamate.
* **Connessioni API** — per qualsiasi altra API,
[crea una connessione API](/it/guides/api-connections) per le azioni
necessarie al tuo agente (incolla un comando cURL e la procedura guidata AI crea una bozza
dello strumento).
* **Knowledge** — collega una
[base di conoscenza](/it/guides/knowledge-base) in cui l'agente può effettuare ricerche
durante la chiamata.
* **Server MCP** — [aggiungi un server MCP](/it/guides/mcp-servers) tramite URL.
Consulta [Connessioni](/it/guides/concepts) per sapere in cosa differiscono
i quattro tipi.
## 5. Tieni sotto controllo la tariffa tutto incluso
Il builder mostra la tua **tariffa al minuto tutto incluso** — motore più
supplementi — e la aggiorna in tempo reale mentre modifichi le impostazioni. Nessuna sorpresa
in fattura.
## 6. Parlagli
Fai clic su **Parla** e saluta — il tuo agente risponde direttamente nel browser
(chiederà l'accesso al microfono). È il ciclo di iterazione più rapido:
modifica il prompt, parla, ripeti. Quando vuoi un chiamante dall'altra
parte invece di te, [avvia una simulazione](/it/guides/simulate-a-call).
## 7. Distribuisci
Ogni modifica viene **salvata automaticamente nella tua bozza** — verifica la presenza di "Salvato" nella barra
superiore. Le modifiche alla bozza non sono attive finché non fai clic su **Distribuisci**.
Ogni distribuzione viene salvata come snapshot nella scheda **Cronologia**: controlla cosa è
cambiato tra le versioni e ripristina qualsiasi versione precedente. Questo rende
sicuro distribuire spesso — puoi sempre tornare indietro.
## 8. Collegalo al mondo
Le sezioni **Numeri di telefono** e **Widget web** della scheda Configurazione collegano
endpoint senza uscire dal builder — collega un numero esistente,
attiva un nuovo numero demo, importa tramite VoIP oppure collega un widget web.
***
## Passaggi successivi
Numero demo in pochi secondi oppure usa il tuo tramite VoIP.
Un chiamante AI conversa davvero con il tuo agente.
Trascrizioni, registrazioni, ascolto in tempo reale e sussurro.
Crea e gestisci gli agenti programmaticamente.