STeSI Voice Assistant — AI App Bridge
Aggiunge l’AI App Agent come modalità brain per STeSI Voice Assistant
Requisiti
- stesi_voice_assistant — modulo STeSI Voice Assistant
- ai_app (Enterprise) — modulo Odoo 19 AI App Enterprise
- Chiave API OpenAI — configurata in Impostazioni Voice Assistant
Funzionalità
- Pulsante voce nel form dell’agente AI — viene aggiunto un pulsante Parla al form dell’agente AI. Cliccandolo si apre il dialogo Voice Assistant già pre-configurato per quell’agente specifico (agent ID passato nel contesto).
- Microfono nel chatter — un’icona microfono viene iniettata nel compositore messaggi delle conversazioni degli agenti AI. È visibile solo per i thread degli agenti AI. Dopo la trascrizione il messaggio viene inviato automaticamente senza click manuale.
- Modalità microfono per agente — ogni agente AI ha un campo Modalità Microfono (Push to Talk / Auto VAD). Se lasciato vuoto, eredita l’impostazione globale definita in Impostazioni Voice Assistant.
- Risposte vocali / TTS per agente — abilitando il toggle Risposta Vocale su un agente, questo leggerà le proprie risposte ad alta voce tramite OpenAI TTS, usando la voce e la lingua configurate globalmente.
Configurazione
| Dove | Impostazione | Descrizione |
|---|---|---|
| Impostazioni Voice Assistant | Chiave API OpenAI, Voce, Lingua, Modalità Mic | Default globali utilizzati da tutti gli agenti |
| Form agente AI — tab Voce | Modalità Microfono, Risposta Vocale | Override per singolo agente; vuoto = usa globale |
Utilizzo
Flusso pulsante voce
- Apri un agente AI dal menu AI App.
- Clicca il pulsante Parla nell’area azioni in alto.
- Il dialogo Voice Assistant si apre, già legato a quell’agente.
- Parla la tua richiesta — viene trascritta e inviata all’agente automaticamente.
- Se la Risposta Vocale è abilitata, la risposta dell’agente viene riprodotta come audio.
Flusso microfono nel chatter
- Apri qualsiasi conversazione con un agente AI (chatter).
- Clicca l’icona microfono accanto al compositore messaggi.
- Parla — il testo trascritto viene inserito e inviato in un solo passaggio.
Architettura
Il modulo include tre file JavaScript caricati tramite web.assets_backend:
| File | Scopo |
|---|---|
voice_assistant_agent.js |
Aggiunge il pulsante Parla al form dell’agente AI |
composer_voice_action.js |
Inietta l’icona microfono nel compositore del chatter per i thread degli agenti AI |
thread_voice_patch.js |
Patcha Thread.prototype.post per attivare l’invio automatico e il TTS dopo la trascrizione |
Changelog
| Versione | Data | Note |
|---|---|---|
| 19.0.1.1.0 | 2026-05-02 | Microfono nel chatter, modalità mic per agente, TTS risposta vocale, nuovi endpoint, patch Thread.post |
| 19.0.1.0.0 | 2026-05-01 | Rilascio iniziale — modalità brain AI App Agent, pulsante “Parla” nel form agente |
Sviluppato da STeSI Consulting — Francesco Moccia <moccia.f@stesi.consulting>