Stesi Voice Assistant
Assistente vocale italiano per Odoo (OpenAI Whisper + TTS)
Funzionalità
- Push-to-Talk e Auto VAD — due modalità di registrazione; il rilevamento del silenzio ferma la registrazione automaticamente.
- Tre modalità brain — Intent Matching (regole a parole chiave, latenza zero), LLM Agent (tool-calling GPT-4o / GPT-4.1), Hybrid (intent prima, LLM come fallback).
- Registro strumenti estensibile — i moduli companion aggiungono strumenti dati Odoo senza modificare il core.
- Storico conversazioni — log persistente per utente con metriche di latenza STT / brain / TTS.
- Sicurezza a livello di riga — ogni utente vede solo le proprie conversazioni.
- Interfaccia completamente in italiano — tutte le etichette, i menu e i messaggi di runtime sono tradotti.
- Tutta la configurazione in Impostazioni — chiave API, modello/voce/velocità/formato TTS, vocabolario Whisper, parametri VAD, modalità brain, modello LLM.
Configurazione
Vai in Voice Assistant → Configurazione → Impostazioni e imposta:
| Impostazione | Descrizione |
|---|---|
| Chiave API OpenAI | La tua chiave API di OpenAI (platform.openai.com) |
| Modalità Brain | Intent Matching, LLM Agent, or Hybrid |
| Modello LLM | GPT-4o, GPT-4.1, Mini, Nano — bilanciamento qualità/costo |
| System Prompt LLM (extra) | Contesto aziendale opzionale aggiunto al system prompt |
| Modello TTS | TTS-1, TTS-1-HD, GPT-4o Mini TTS, GPT-4o Audio Preview |
| Voce TTS | Alloy, Echo, Fable, Nova, Onyx, Shimmer |
| Velocità TTS | 0.25 (lento) a 4.0 (veloce), default 1.0 |
| Formato Risposta TTS | MP3 (massima compatibilità), Opus, AAC, FLAC, WAV, PCM |
| Vocabolario Whisper | Termini di dominio per migliorare la precisione della trascrizione |
| Modalità Microfono | Push to Talk or Auto VAD |
| Durata Silenzio VAD (ms) | Millisecondi di silenzio prima dell'arresto automatico (solo Auto VAD) |
| Soglia Silenzio VAD | Soglia ampiezza RMS 0–100 (solo Auto VAD) |
Utilizzo
- Apri Voice Assistant → Apri Assistente.
- Push to Talk: tieni premuto il pulsante microfono → parla → rilascia.
Auto VAD: clicca il pulsante microfono → parla → si ferma automaticamente sul silenzio. - La risposta appare sullo schermo e viene riprodotta come audio.
- Lo storico completo della sessione viene visualizzato sotto il microfono.
- I log delle conversazioni persistenti sono disponibili in Voice Assistant → Reporting → Storico Conversazioni.
Moduli Companion
| Modulo | Descrizione |
|---|---|
| STeSI Voice Assistant Sale | Strumenti LLM: elenco degli ordini di vendita e dettaglio del singolo ordine |
| STeSI Voice Assistant — AI App Bridge | Bridge verso gli agenti AI Enterprise di Odoo — pulsante vocale nel form agente, microfono nel chatter, TTS per agente |
Sviluppato da STeSI Consulting — Francesco Moccia <moccia.f@stesi.consulting>