Oikos/Guide
ASSISTENTE E AI

Chiedi alla casa.
Risponde lei.

L’assistente di Oikos risponde sui consumi e comanda luci, tapparelle e clima. Funziona in locale, senza internet e senza costi. L’intelligenza artificiale è un’aggiunta facoltativa, con la tua chiave.

Attivarlo

  1. 1

    Apri la pagina Assistente

    In Oikos: menu ⋮ → Assistente.

  2. 2

    Accendilo

    Attiva «Attiva l’assistente». Sotto vedi quante entità conosce, divise per tipo.

  3. 3

    Scegli come aprirlo

    Con il ✨ nella barra in alto, oppure con una bolla che resta sopra la pagina: la trascini dove ti è comoda e si appoggia al bordo più vicino. Sui tablet e sui computer la bolla apre una finestra di chat compatta; sul telefono la chat sale dal basso.

Cosa puoi chiedere

Si scrive come si parla, in italiano, inglese, francese, spagnolo, tedesco o rumeno. Sotto il campo di testo ci sono suggerimenti pronti da toccare.

Consumi
«Quanto ho consumato ieri?», «Quando ho consumato di più questo mese?», «Questo mese contro il mese scorso», «Quanto sto consumando adesso?». Produzione del fotovoltaico, prelievo e immissione in rete. Sotto la risposta c’è un piccolo grafico.
Comandi
«Accendi la luce della cucina», «Abbassa le tapparelle della sala al 30%», «Metti il clima a 22 gradi», «Spegni le prese». Anche le scene.
Stato
«Ci sono finestre aperte?», «Che temperatura c’è in camera?», «Quali luci sono accese?».
Scenari
«Sono uscito», «Buonanotte»: tutte le azioni di uno scenario insieme (vedi sotto).

Le azioni fatte dall’assistente finiscono anche nella campanella delle notifiche, e la chat ricorda la conversazione su ogni dispositivo.

Cosa conosce

L’assistente conosce solo le entità che hai messo nelle card della dashboard, più i sensori di energia impostati in Oikos. Non va a cercare nel resto di Home Assistant: se un dispositivo non è in nessuna card, per lui non esiste. Così le risposte riguardano la casa che vedi, e «spegni le luci della sala» non tocca le luci di un’altra stanza.

Se ti serve un’entità che non sta in nessuna card, aggiungila in Entità extra.

Scenari

Uno scenario è un gruppo di azioni con un nome e, se vuoi, qualche modo diverso di chiamarlo: «Esco», con anche «sono uscito» e «vado via», che chiude le tapparelle, spegne le luci e abbassa il clima.

Ogni scenario diventa uno script di Home Assistant (nella cartella packages/oikos_scenarios). Funziona quindi anche a pannello chiuso: da un’automazione, da un tag NFC o dall’assistente vocale di Home Assistant.

Packages

Gli scenari usano i package di Home Assistant. Se non sono attivi, la pagina Assistente lo segnala e li attiva con «Attiva packages».

AI facoltativa

Per le domande che l’assistente locale non conosce puoi aggiungere un modello di intelligenza artificiale. Le domande semplici continuano a passare dal motore locale; l’AI interviene solo quando serve, e la sua risposta porta il segno «AI».

Claude
Di Anthropic. Chiave da console.anthropic.com, si paga a consumo al fornitore. Modelli dal più capace al più economico.
Gemini
Di Google. Chiave da aistudio.google.com, con un livello gratuito a consumi limitati.
Ollama
Gira su un tuo computer in casa: basta il suo indirizzo (per esempio http://192.168.1.20:11434). Nessuna chiave, nessun costo, nessun dato esce di casa.
  1. 1

    Accendi l’AI

    Nella pagina Assistente, sezione Intelligenza artificiale.

  2. 2

    Scegli fornitore e modello

    Per iniziare va bene un modello economico: per le domande sulla casa basta.

  3. 3

    Incolla la chiave e premi Salva

    Poi premi Prova: deve rispondere «Funziona».

Nella stessa pagina vedi l’uso del mese: quante risposte sono arrivate dal motore locale e quante dall’AI, con i token consumati.

Dati e sicurezza

La chiave
Resta nell’applicazione Oikos dentro Home Assistant e non torna mai al browser. Il costo dell’AI è tra te e il fornitore che scegli.
Cosa vede l’AI
Solo le entità delle tue card, le stesse dell’assistente locale. Non ha accesso al resto di Home Assistant.
Cosa non può fare
Serrature, allarmi e cancelli: l’AI non li comanda mai. Dall’assistente locale chiedono sempre una conferma.
Senza AI
Il motore locale non manda niente fuori casa e non richiede internet.

Domande frequenti

Non vedo il ✨ né la bolla.

L’assistente parte spento: accendilo da menu ⋮ → Assistente. Dopo un aggiornamento ricarica la pagina.

Mi risponde «non trovo un sensore di energia».

Imposta i sensori di energia in Oikos (Impostazioni → Impianti fotovoltaici, o nella procedura guidata) oppure nella dashboard Energia di Home Assistant.

Non riconosce una luce.

Quella luce deve stare in una card della dashboard o tra le entità extra. Usa il nome che vedi nella card.

Si può parlare a voce?

Per ora si scrive. Gli scenari però sono script di Home Assistant: li puoi lanciare anche dall’assistente vocale di Home Assistant.