HAOS OpenAI Extension porta la cronologia di Home Assistant nelle risposte di Assist

Un’integrazione personalizzata per home Assistant permette all’assistente vocale di rispondere anche a domande su eventi già avvenuti in casa. Si chiama HAOS OpenAI Extension e aggiunge strumenti di consultazione della cronologia Recorder all’agente di conversazione OpenAI già configurato in Assist. Il progetto, presentato nella community di Home Assistant, consente di ricostruire quando un dispositivo ha cambiato stato, quanto a lungo è rimasto attivo e come si confronta con altri dispositivi. Non introduce un nuovo agente e non richiede una chiave API aggiuntiva.

Come funziona HAOS OpenAI Extension

L’estensione mette a disposizione dell’agente strumenti di sola lettura per interrogare i dati storici conservati da Recorder e confrontare le entità. Prima di inviare i risultati al modello linguistico, è Home Assistant a calcolare il numero di eventi, le durate e i confini temporali delle interrogazioni. L’obiettivo è fornire risposte basate sugli stati registrati, anziché chiedere al modello di ricostruire autonomamente i passaggi.

Il progetto lavora con l’integrazione ufficiale OpenAI conversation e può essere utilizzato anche quando le richieste di Alexa vengono già inoltrate allo stesso agente. Non avvia interrogazioni periodiche della cronologia in background. Le ricerche sono limitate alle entità esposte all’assistente Assist attivo, così da rispettare il perimetro dei dispositivi che l’utente ha scelto di rendere accessibili.

Domande sulla cronologia e confronti tra dispositivi

Tra le richieste possibili figurano domande come «Quando è stata chiusa l’ultima volta la porta del garage?» oppure «Per quanto tempo è rimasta aperta ieri?». L’estensione permette anche confronti tra entità, per esempio individuare quale luce sia rimasta accesa più a lungo nella giornata. Sono riconosciuti periodi espressi in linguaggio naturale, tra cui oggi, ieri e la settimana scorsa.

Le interrogazioni coprono al massimo le ultime 240 ore, equivalenti a 10 giorni, e soltanto nella misura in cui Recorder abbia effettivamente conservato i dati. Il conteggio considera le reali transizioni di stato: registrazioni ripetute dello stesso stato, ad esempio dopo un riavvio, non vengono interpretate come nuovi eventi. Quando la cronologia è assente o incompleta, gli strumenti restituiscono indicatori di copertura che segnalano il limite della risposta.

Installazione con HACS e configurazione di Assist

Per installare l’estensione occorre scaricarla tramite HACS, riavviare Home Assistant e aggiungere HAOS OpenAI Extension da Impostazioni → Dispositivi e servizi → Aggiungi integrazione. Il pulsante di aggiunta del repository a HACS non completa da solo l’installazione: download, riavvio e configurazione dell’integrazione restano passaggi necessari.

Nell’agente OpenAI conversation già in uso bisogna mantenere abilitati Assist e il controllo dei dispositivi, quindi esporre ad Assist le entità di cui si desidera interrogare la cronologia. A questo punto si può formulare una domanda storica e verificare nella traccia della conversazione che sia stato effettivamente richiamato lo strumento per la cronologia o per il confronto. Non è prevista la configurazione di un agente separato.

Limiti della cronologia, privacy e sicurezza

La precisione delle risposte dipende dai dati disponibili in Recorder: se un intervallo non è stato registrato o non è più conservato, l’estensione non può ricostruirlo. Lo sviluppatore chiarisce inoltre che la modalità selezionata di un climatizzatore non equivale a una misura del tempo effettivo di funzionamento del compressore. È una distinzione importante quando si chiedono durate o confronti basati sugli stati delle entità.

Gli strumenti aggiunti dall’estensione sono di sola lettura, ma questo non elimina gli eventuali comandi di controllo già presenti nell’agente di conversazione. Per chiedere informazioni sullo stato della porta del garage senza renderne disponibile l’azionamento, lo sviluppatore suggerisce di esporre un sensore binario appropriato, lasciando non esposti la copertura motorizzata e i relativi controlli.

Infine, l’estensione non trasforma l’agente cloud esistente in un sistema locale: i dati storici recuperati e inviati all’agente possono essere elaborati dal relativo fornitore. Anche Alexa presenta un limite pratico, perché il tempo concesso per rispondere è breve e le interrogazioni lente possono scadere. Il progetto è stato condiviso nella community di Home Assistant, dove l’autore invita a segnalare problemi indicando versione dell’integrazione e tracce pertinenti, dopo aver rimosso informazioni private e credenziali.