Canale vocale
Il canale vocale consente di conversare a voce con un agente direttamente dalla console Chat: il parlato viene trascritto, elaborato dalla stessa pipeline della chat scritta (RAG, strumenti, handoff inclusi) e la risposta viene restituita anche in audio sintetizzato.
Disponibilità
Il canale vocale richiede il feature flag voice_channel attivo sul tenant e il permesso chat.voice.use assegnato all'utente. Se non compare l'icona del microfono nella console Chat, verificare entrambe le condizioni con l'amministratore del tenant.
Prerequisiti
- Feature flag e permesso descritti sopra.
- Provider e voci configurati a livello di sistema (vedere Impostazioni di sistema): non sono configurabili per singolo agente.
- Microfono funzionante nel browser dell'utente, con l'autorizzazione concessa quando richiesta.
Attivare la modalità voce
Quando le condizioni di disponibilità sono soddisfatte, nella console Chat compare l'icona microfono accanto alla barra di input. Cliccandola si passa dalla modalità testuale alla modalità voce per la conversazione in corso.
Conversare a voce
- Cliccare il microfono per avviare la registrazione e parlare naturalmente.
- L'audio viene trascritto in tempo reale e inviato come messaggio all'agente, seguendo la stessa pipeline di elaborazione della chat scritta (comprensione RAG, strumenti MCP, valutazione delle condizioni di handoff).
- La risposta arriva sia in forma testuale sia sintetizzata in audio.
- Interruzione ("barge-in"): parlare mentre l'agente sta ancora rispondendo interrompe immediatamente l'audio in corso e avvia un nuovo turno di conversazione con quanto appena detto.
Il canale vocale non è un motore separato: usa esattamente la stessa configurazione dell'agente (Knowledge Base, server MCP, condizioni di handoff) della chat scritta. Le differenze di comportamento tra i due canali riguardano solo il livello di trascrizione e sintesi audio.
Lingue e voci
La lingua parlata dall'utente viene rilevata automaticamente e propagata come variabile template {{detected_language}} (vedere Variabili template nelle conversazioni), così da coerentemente selezionare la voce di sintesi nella stessa lingua. Il catalogo di voci disponibili per lingua è definito centralmente in Impostazioni di sistema.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'icona del microfono non compare | Feature flag voice_channel non attivo, o permesso chat.voice.use mancante | Verificare entrambe le condizioni con l'amministratore del tenant |
| Il microfono non registra | Autorizzazione del browser negata o dispositivo audio non disponibile | Concedere l'autorizzazione al microfono nelle impostazioni del browser e verificare il dispositivo di input |
| Non si sente la risposta audio | Autoplay bloccato dal browser, oppure dispositivo di output non disponibile | Interagire con la pagina prima di avviare la conversazione vocale e verificare il dispositivo di output |
| La lingua della voce non corrisponde a quella parlata | Nessuna voce configurata per la lingua rilevata | Segnalare la lingua mancante all'amministratore di sistema per l'aggiunta in configurazione |