> ## 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.
# Riferimento delle impostazioni dell'agente vocale
> Tutte le impostazioni dell'agente vocale ThunderPhone spiegate: livelli, voci, lingue, conferme, strumenti, ordine di parola, segreteria telefonica, annunci di consenso, gestione del silenzio, test e distribuzione.
Apri **Agenti vocali**, seleziona un agente e usa la relativa scheda **Configurazione** per controllare
come suona, ragiona, avvia le chiamate, usa gli strumenti, gestisce il silenzio e la segreteria telefonica
e raggiunge i chiamanti. Le modifiche vengono salvate automaticamente in una bozza; il traffico in produzione non
cambia finché non selezioni **Distribuisci**.
Questa pagina è il riferimento completo della dashboard. Per i nomi dei campi e gli
esempi di richieste, consulta il [riferimento API Agents](/api-reference/agents).
## Prompt e identità
Il nome dell'agente lo identifica in tutta la dashboard, nei report, nella cronologia delle chiamate
e nei portali clienti. Il prompt è il copione operativo dell'agente: persona,
informazioni aziendali, domande obbligatorie, politica di escalation e azioni di chiamata.
L'editor del prompt mostra i token stimati e segnala problemi comuni, come un
prompt vuoto, segnaposto del modello non risolti, un percorso di escalation mancante o
un prompt molto lungo. I primi **5.000 token stimati** sono inclusi; i prompt più lunghi usano
la [tariffazione con supplemento a blocchi](/it/guides/pricing).
Puoi scrivere direttamente nel prompt trasferimenti, pressioni dei tasti, comportamento in attesa
e decisioni di riaggancio. Collega strumenti API, app, MCP o Knowledge quando l'agente necessita di dati o azioni esterni.
## Livello del modello
| Livello | Prezzo base | Ideale per |
| --------- | ----------: | --------------------------------------------------------- |
| **Spark** | 2¢/min | Chiamate semplici e attente ai costi. |
| **Bolt** | 5¢/min | Risposte rapide e flussi di lavoro quotidiani bilanciati. |
| **Storm** | 9¢/min | Istruzioni complesse, comprensione audio e ragionamento. |
Storm offre due controlli facoltativi:
* **Conferma** — **Nessuna** resta in silenzio mentre prepara la risposta completa;
**Tick** riproduce un lieve suono di attesa; **Verbale** pronuncia una breve conferma
e aggiunge **2¢/min**. Il testo verbale può essere generato dal prompt principale oppure
fornito manualmente tramite l'API.
* **Intelligenza aggiuntiva** — aggiunge un ragionamento più approfondito per le chiamate complesse e
**3¢/min**.
Il builder mostra continuamente il **costo totale al minuto** dell'agente, incluse
il livello, il percorso voce/lingua, la lunghezza del prompt, la conferma verbale, l'intelligenza
aggiuntiva e la supervisione.
## Voce, sottofondo e lingue
Seleziona una voce e riproducine l'esempio prima della distribuzione. Il selettore offre solo
voci compatibili con tutte le lingue selezionate e contrassegna le combinazioni premium
con il relativo supplemento. Le tue voci personalizzate vengono visualizzate nello stesso selettore quando sono pronte.
Consulta [Libreria vocale e voci personalizzate](/it/guides/voice-library).
La **traccia di sottofondo** può essere:
* **Nessuna** — nessun audio ambientale.
* **Call center** — un ambiente da call center, con anteprima nella dashboard.
Imposta una **lingua principale**, quindi un numero qualsiasi di **lingue aggiuntive**. L'agente
rileva automaticamente quando un chiamante passa a una lingua selezionata e
risponde in quella lingua. Alcune combinazioni voce/lingua aggiungono **3¢/min**; consulta il
catalogo generato delle [Lingue supportate](/it/guides/supported-languages).
## Funzionalità connesse
La scheda Configurazione dispone di quattro sezioni di funzionalità collegabili in modo indipendente:
| Sezione | Utilizzala per |
| ------------------- | --------------------------------------------------------------------------------------------- |
| **App connesse** | Operazioni approvate in Google Calendar, Google Sheets, Slack, HubSpot, Salesforce o Cal.com. |
| **Connessioni API** | I tuoi endpoint HTTP, descritti come funzioni richiamabili. |
| **Knowledge** | File o contenuti web che l'agente può cercare durante una chiamata. |
| **Server MCP** | Strumenti memorizzati nella cache rilevati da server remoti Model Context Protocol. |
Un collegamento fa parte della bozza e diventa disponibile per le chiamate in produzione
dopo la distribuzione. Configura prima le risorse in **Connessioni** o
**Knowledge**, quindi collegale all'agente.
## Endpoint telefonici e web
In **Numeri di telefono**, collega un numero esistente, configura un numero demo oppure
importa un numero tramite una connessione VoIP. Un numero può usare agenti diversi
per le direzioni in entrata e in uscita.
In **Widget web**, collega un widget affinché i visitatori possano parlare con l'agente da un
sito. La disponibilità del widget può anche essere abilitata o disabilitata come parte della
configurazione dell'agente.
## Comportamento avanzato delle chiamate
Espandi **Avanzate** in fondo a Config per accedere ai seguenti controlli.
### Supervisione
Quando è abilitata, un secondo monitor AI verifica ogni turno dell'agente rispetto alle
istruzioni e può intervenire in modo silenzioso. La supervisione aggiunge **8¢/min** e non è
disponibile su Bolt.
### Tono di connessione
Riproduci un breve tono immediatamente dopo la connessione della chiamata e prima che una delle due parti
parli.
### Suono dello strumento
Scegli il suono emesso dallo strumento audio richiamabile dal prompt:
* **Nessuno** — lo strumento non viene offerto.
* **Rintocco**, **Ding** o **Bip** — ciascuno può essere ascoltato in anteprima nel builder.
### Chi parla per primo
Configura separatamente le chiamate in entrata e in uscita:
* **In entrata:** parla prima l'agente oppure parla prima il chiamante.
* **In uscita:** parla prima l'agente oppure parla prima il destinatario.
Questa impostazione è utile per i compositori automatici in uscita che devono attendere una persona o
un menu telefonico prima di iniziare il copione.
### Gestione della segreteria telefonica
Scegli cosa accade quando una chiamata in uscita raggiunge la segreteria telefonica:
| Opzione | Comportamento |
| --------------------------------------- | ---------------------------------------------------------------------------------- |
| **Lascia decidere all'agente** | Il prompt e il contesto della conversazione determinano se parlare o riagganciare. |
| **Riaggancia in silenzio** | Termina senza lasciare un messaggio. |
| **Lascia un messaggio, poi riaggancia** | Pronuncia il messaggio configurato e termina la chiamata. |
I messaggi della segreteria telefonica possono contenere fino a **2.000 caratteri** e supportano
`{agent_name}` e `{org_name}`. Consulta
[Prezzi](/it/guides/pricing) per sapere come viene
calcolata la durata delle chiamate.
### Annuncio del consenso
Per impostazione predefinita, un breve annuncio all'inizio di ogni chiamata informa il chiamante
che sta parlando con un assistente AI e che la chiamata viene registrata. Puoi modificare il testo
dell'annuncio, fino a **2.000 caratteri**; viene riprodotto letteralmente
nella lingua dell'agente.
Disabilitare l'annuncio su un agente idoneo richiede che un amministratore dell'organizzazione
attesti che l'organizzazione fornirà qualsiasi avviso richiesto dalla legge e
otterrà qualsiasi consenso richiesto dalla legge. Riabilitarlo e disabilitarlo
successivamente richiede una nuova attestazione. Consulta la
[guida sulle leggi relative al consenso alla registrazione](/it/guides/recording-consent-laws) prima di modificare
questa impostazione.
### Verifiche del silenzio
Quando è abilitata, l'agente verifica se il chiamante è ancora presente dopo un
periodo di silenzio, ripete fino al limite impostato e poi riaggancia:
* **Secondi prima della verifica:** 10–120 secondi.
* **Numero massimo di verifiche:** 1–10.
I valori predefiniti sono 15 secondi e 3 verifiche.
## Schede del builder e ciclo di vita
| Scheda o azione | Scopo |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| **Live / Parla** | Parla con la bozza corrente nel browser e ispeziona la trascrizione e l'attività degli strumenti. |
| **Chiamate** | Esamina le chiamate gestite da questo agente. |
| **A/B** | Crea varianti del prompt o della configurazione e confronta i risultati dal vivo. |
| **Simula** | Esegui scenari AI-chiamante salvati o ad hoc rispetto alla bozza. |
| **Convalida** | Riproduci turni di chiamate reali congelati rispetto alla bozza prima della distribuzione. |
| **Cronologia** | Confronta le revisioni distribuite e ripristinane una nella bozza. |
| **Annulla modifiche** | Ripristina ogni impostazione della bozza in attesa alla versione distribuita. |
| **Distribuisci** | Promuovi atomicamente la bozza completa e crea una revisione. |
Se un altro editor salva lo stesso agente dopo che lo hai caricato, ThunderPhone blocca
il salvataggio o la distribuzione in conflitto e ti chiede di aggiornare la pagina invece di sovrascrivere
le sue modifiche.
## Gestisci gli agenti dall'elenco
La pagina **Agenti vocali** supporta anche azioni del ciclo di vita a livello di organizzazione:
* **Duplica** un agente come nuovo punto di partenza nella stessa organizzazione.
* **Trasferisci** un agente a un'altra organizzazione di cui fai parte. **Copia** conserva
l'originale; **Sposta** lo rimuove dall'organizzazione corrente e richiede
l'accesso da amministratore.
* Seleziona uno o più agenti ed esporta la relativa configurazione visualizzata in
formato **CSV** o **JSON**.
* Elimina un agente oppure elimina in blocco gli agenti selezionati, dopo la conferma.
La copia o lo spostamento di un agente tra organizzazioni non concede automaticamente
all'organizzazione di destinazione l'accesso alle connessioni disponibili solo nell'origine. Verifica
le integrazioni dell'app, dell'API, di Knowledge, MCP, dei numeri di telefono e dei widget
dell'agente copiato prima di pubblicarlo nell'organizzazione di destinazione.
## Pagine correlate
Una guida concisa per creare un agente dall'inizio alla fine.
Livelli base, componenti aggiuntivi, misurazione delle chiamate, numeri e addebiti una tantum.
Congela gli scambi delle chiamate reali e riproducili prima della pubblicazione.
Campi delle richieste, bozze, pubblicazioni, versioni ed esempi.