La tua casa ti riconosce: Riconoscimento Facciale e Benvenuto Vocale su Home Assistant con l'AI

alias: "Routine Benvenuto Universale (Blog Version)"
description: "Gestisce volume, annuncio vocale e ripristino musica."
sequence:
  - variables:
      # --- SEZIONE PERSONALIZZABILE ---
      # Inserite qui l'entità del vostro speaker (es. media_player.google_home)
      player_target: media_player.vostro_speaker_smart
      # Inserite qui il volume desiderato per la voce (da 0.1 a 1.0)
      volume_annuncio: 0.6
      # -------------------------------

      # LOGICA AUTOMATICA (Non toccare)
      # Memorizza il volume attuale per poterlo ripristinare dopo
      volume_precedente: "{{ state_attr(player_target, 'volume_level') | default(0.3, true) }}"
      # Controlla se c'era musica in riproduzione
      stava_riproducendo: "{{ is_state(player_target, 'playing') }}"

  # 1. Mettiamo in pausa la musica (se attiva) per non sovrapporsi alla voce
  - if: "{{ stava_riproducendo }}"
    then:
      - action: media_player.media_pause
        target:
          entity_id: "{{ player_target }}"

  # 2. Impostiamo il volume per l'annuncio
  - action: media_player.volume_set
    target:
      entity_id: "{{ player_target }}"
    data:
      volume_level: "{{ volume_annuncio }}"

  # 3. Annuncio Vocale (Usiamo TTS Cloud per la voce naturale 'Diego')
  # Se non avete Nabu Casa, usate 'tts.google_translate_say'
  - action: tts.cloud_say
    target:
      entity_id: "{{ player_target }}"
    data:
      message: "Bentornato a casa! Ho rilevato la tua presenza."
      options:
        voice: it-IT-DiegoNeural

  # 4. Attesa necessaria per far finire la frase prima di abbassare il volume
  # Aumentate i secondi se la frase è più lunga
  - delay: "00:00:06"

  # 5. Ripristino del volume originale
  - action: media_player.volume_set
    target:
      entity_id: "{{ player_target }}"
    data:
      volume_level: "{{ volume_precedente }}"

  # 6. Facciamo ripartire la musica (solo se stava suonando prima)
  - if: "{{ stava_riproducendo }}"
    then:
      - action: media_player.media_play
        target:
          entity_id: "{{ player_target }}"

alias: "AI Vision: Riconoscimento e Benvenuto (Blog Version)"
description: "Analisi AI della telecamera con filtri di presenza per il benvenuto."
mode: single

triggers:
  # IL TRIGGER: Il sensore di movimento della telecamera o della stanza
  - trigger: state
    entity_id: binary_sensor.sensore_movimento_ingresso # <-- PERSONALIZZARE
    to: "on"

actions:
  # 1. SCATTO FOTO
  # Scattiamo un'istantanea per analizzarla
  - action: camera.snapshot
    target:
      entity_id: camera.ingresso_principale # <-- PERSONALIZZARE
    data:
      filename: /config/www/snap_ai.jpg

  # 2. PICCOLA PAUSA
  # Diamo tempo al sistema di salvare il file su disco
  - delay:
      seconds: 2

  # 3. ANALISI GEMINI
  # Inviamo a Google la foto scattata e la nostra "Legenda" (family_reference.jpg)
  - action: llmvision.image_analyzer
    data:
      provider: VOSTRO_PROVIDER_ID # <-- INSERIRE IL VOSTRO ID PROVIDER
      image_file: |-
        /config/www/snap_ai.jpg
        /config/www/family_reference.jpg
      message: >
        Confronta la persona in 'snap_ai.jpg' con i volti in 'family_reference.jpg'.
        Se riconosci qualcuno della famiglia, scrivi SOLO: "Ho visto [Nome]".
        Se è un estraneo, scrivi: "Sconosciuto".
        Sii sintetico.
    response_variable: response

  # 4. DECISIONE INTELLIGENTE
  # Questo blocco decide se lanciare il saluto. Devono essere vere TUTTE le condizioni.
  - if:
      - condition: template
        value_template: >
          {# --- CONFIGURAZIONE VARIABILI --- #}
          {# Nome da cercare nella risposta dell'AI #}
          {% set target_name = 'Vincenzo' %}
          {# La vostra entità persona per tracciare la presenza #}
          {% set my_person = states.person.vincenzo %}
          {# Lo script di benvenuto per controllare quando è stato eseguito l'ultima volta #}
          {% set my_script = 'script.routine_benvenuto_universale' %}

          {# --- INIZIO CONTROLLI --- #}

          {# 1. RICONOSCIMENTO: Gemini ha visto proprio me? #}
          {% set visto_dall_ai = target_name in response.response_text %}

          {# 2. PRESENZA: Sono effettivamente segnato come 'a casa'? #}
          {% set sono_a_casa = my_person.state == 'home' %}

          {# 3. RIENTRO RECENTE: Sono rientrato da meno di 15 minuti (900 sec)? #}
          {# Questo evita che il saluto parta se sono in casa da ore e passo davanti alla cam #}
          {% set appena_rientrato = (as_timestamp(now()) - as_timestamp(my_person.last_changed)) < 900 %}

          {# 4. ANTI-NOIA: Lo script NON è stato eseguito nell'ultima ora (3600 sec)? #}
          {# Questo evita saluti doppi se esco a buttare la spazzatura e rientro subito #}
          {% set last_run = state_attr(my_script, 'last_triggered') %}
          {% set tempo_passato = (as_timestamp(now()) - as_timestamp(last_run)) if last_run else 3601 %}
          {% set cooldown_ok = tempo_passato > 3600 %}

          {# RISULTATO FINALE: Tutte le condizioni devono essere VERE #}
          {{ visto_dall_ai and sono_a_casa and appena_rientrato and cooldown_ok }}

    then:
      # Se tutte le condizioni sopra sono vere, lancia lo script
      - action: script.routine_benvenuto_universale

alias: "AI Vision 2.0: Riconoscimento Base (No Audio)"
description: "Scatta foto, riconosce i volti confrontandoli con la legenda e invia notifica."
mode: single

triggers:
  # IL TRIGGER: Il sensore di movimento della telecamera
  - trigger: state
    entity_id: binary_sensor.vostro_sensore_movimento # <-- PERSONALIZZARE QUI
    to: "on"

actions:
  # 1. SCATTO FOTO
  # Salviamo l'immagine in /config/www/ per renderla accessibile a Gemini
  - action: camera.snapshot
    target:
      entity_id: camera.vostra_telecamera # <-- PERSONALIZZARE QUI
    data:
      filename: /config/www/snap_ai_base.jpg

  # 2. PAUSA TECNICA
  # Fondamentale: aspettiamo che il file venga scritto fisicamente sul disco
  - delay:
      seconds: 2

  # 3. ANALISI GEMINI (Il cuore del sistema)
  - action: llmvision.image_analyzer
    data:
      provider: VOSTRO_PROVIDER_ID # <-- INSERIRE IL VOSTRO ID PROVIDER
      # IMPORTANTE: Usiamo il simbolo | per elencare i file senza errori
      # Passiamo sia lo scatto attuale che la foto "Legenda"
      image_file: |
        /config/www/snap_ai_base.jpg
        /config/www/family_reference.jpg
      message: >
        Sei un sistema di sicurezza.
        L'immagine 1 è lo scatto attuale.
        L'immagine 2 ('family_reference.jpg') contiene i volti e i nomi dei familiari per confronto.

        Analizza chi c'è nell'immagine 1:
        - Se riconosci un familiare, scrivi: "Rilevato [Nome]".
        - Se è una persona ma non la riconosci, scrivi: "Rilevato Sconosciuto".
        - Se non c'è nessuno (falso allarme, solo animali o auto), scrivi SOLO: "Nessuno".
        Sii sintetico.
      include_filename: false
      max_tokens: 100
    response_variable: response

  # 4. AGGIORNAMENTO DASHBOARD (Opzionale)
  # Scriviamo il risultato in un helper di testo per vederlo nella Card Lovelace
  - action: input_text.set_value
    target:
      entity_id: input_text.vostro_helper_testo # <-- PERSONALIZZARE (o rimuovere se non usato)
    data:
      value: >-
        {{ as_timestamp(now()) | timestamp_custom('%H:%M') }} - {{ response.response_text | truncate(240, true) }}

  # 5. NOTIFICA INTELLIGENTE
  # Inviamo la notifica SOLO se Gemini ha visto qualcosa di rilevante (ignoriamo "Nessuno")
  - if:
      - condition: template
        value_template: "{{ 'Nessuno' not in response.response_text and response.response_text != '' }}"
    then:
      - action: notify.mobile_app_vostro_smartphone # <-- PERSONALIZZARE QUI
        data:
          title: "Sicurezza AI"
          message: "{{ response.response_text }}"
          data:
            # Alleghiamo la foto dello scatto alla notifica
            image: /local/snap_ai_base.jpg
            clickAction: /lovelace/security