Modalità chat
Configura il tuo agente per conversazioni solo testuali con la modalità chat
La modalità chat consente ai tuoi agenti di agire come agenti chat, ovvero di avere conversazioni solo testuali senza input/output audio. È utile per creare interfacce chat, testare agenti o quando l’audio non è necessario.
Panoramica
Esistono due modi principali per abilitare la modalità chat:
- Configurazione dell’agente: Configura l’agente in modalità solo testuale quando lo crei tramite l’API
- Override runtime: Usa gli override dell’SDK per imporre conversazioni solo testuali a livello di codice
Questa guida illustra entrambi gli approcci e come implementare la modalità chat nei diversi SDK.
Creare agenti solo testuali
Configura un agente in modalità solo testuale per renderla predefinita per ogni conversazione con quell’agente.
Aggiorna dalla dashboard
Aggiorna tramite CLI
Aggiorna tramite API
Apri l’agente nella dashboard, vai alla scheda Avanzate e abilita l’interruttore Solo testo. Salva le modifiche.
Per il riferimento API completo e tutte le opzioni di configurazione disponibili, consulta il campo text only nella documentazione dell’API Create Agent .
Override runtime per la modalità solo testuale
Per abilitare la modalità chat in fase di runtime usando gli override (invece della configurazione a livello di agente), puoi usare l’override textOnly nella configurazione della conversazione:
Questa configurazione garantisce che:
- Non venga usato alcun input/output audio
- Tutta la comunicazione avvenga tramite messaggi di testo
- La conversazione funzioni in modalità di interfaccia simile a una chat
Note importanti
Importante: Quando usi la modalità chat, devi assicurarti che l’evento/callback agent_response sia
attivato e configurato correttamente. Senza di esso, le risposte testuali dell’agente non verranno inviate né
mostrate all’utente.
Override di sicurezza: Quando usi gli override runtime (non la configurazione a livello di agente), devi abilitare gli override della conversazione nelle impostazioni di sicurezza dell’agente. Vai alla scheda Sicurezza dell’agente e abilita gli override appropriati. Per maggiori dettagli, consulta la documentazione sugli override .
Requisiti principali
-
Evento di risposta dell’agente: Configura sempre il callback o il gestore eventi
agent_responseper ricevere e mostrare i messaggi di testo dell’agente. -
Configurazione dell’agente: Se l’agente è impostato specificamente in modalità chat nelle impostazioni, userà automaticamente conversazioni solo testuali senza richiedere l’override.
-
Nessuna interfaccia audio: Quando usi la modalità solo testuale, non devi configurare interfacce audio né richiedere autorizzazioni per il microfono.
Esempio: gestione delle risposte dell’agente
Inviare messaggi di testo
In modalità chat, dovrai inviare i messaggi dell’utente a livello di codice invece che tramite audio:
Vantaggi in termini di concorrenza
La modalità chat offre notevoli vantaggi di concorrenza rispetto alle conversazioni vocali:
- Limiti più alti: Le conversazioni solo chat hanno limiti di concorrenza 25 volte superiori rispetto alle conversazioni vocali
- Pool separato: Le conversazioni testuali usano un pool di concorrenza dedicato, indipendente dai limiti delle conversazioni vocali
- Scalabilità: Ideale per applicazioni a throughput elevato come assistenza clienti, chatbot o test automatizzati
Per stimare il limite solo chat necessario per il tuo traffico, usa lo stimatore di concorrenza.
Durante l’avvio della connessione, le conversazioni solo chat vengono inizialmente verificate rispetto al limite di concorrenza totale durante il processo di handshake, quindi trasferite al pool di concorrenza solo chat separato una volta stabilita la connessione.
Casi d’uso
La modalità chat è ideale per:
- Interfacce chat: Creare UI di chat tradizionali senza voce
- Test: Testare la logica dell’agente senza dipendenze audio
- Accessibilità: Fornire alternative basate sul testo agli utenti
- Ambienti silenziosi: Quando l’input/output audio non è appropriato
- Test di integrazione: Test automatizzati delle conversazioni degli agenti
Risoluzione dei problemi
L’agente non risponde
Se le risposte dell’agente non vengono visualizzate:
- Verifica che il callback
agent_responsesia configurato correttamente - Controlla che l’agente sia configurato in modalità chat oppure che sia impostato l’override
textOnly - Assicurati che la connessione WebSocket sia stabilita correttamente
Passaggi successivi
- Scopri come personalizzare il comportamento dell’agente
- Esplora gli eventi client per interazioni avanzate
- Consulta la configurazione dell’autenticazione per conversazioni sicure