Skip to content

Automations and Actions

Tom Grounds - Personal edited this page Jun 19, 2026 · 1 revision

Asset Intelligence provides awareness of environmental risk, but it does not directly control your home.

Instead, it integrates with Home Assistant by exposing asset state as entities that can be used to trigger automations.


Core Principle

Asset Intelligence:

✅ Detects conditions
✅ Evaluates risk
✅ Explains what is happening

Home Assistant:

✅ Decides what to do
✅ Executes automations
✅ Controls devices


How Automation Works

Each asset in Asset Intelligence is represented as a Home Assistant device with associated entities.

These entities expose:

  • Current risk state
  • Candidate state
  • Advisory information
  • Environmental context

These can be used as triggers, conditions, or inputs in Home Assistant automations.


Example Automation Scenarios

Asset Intelligence enables Home Assistant to take action based on real-world context.


Example 1: Reduce Heat Exposure

Trigger:

  • Asset risk becomes RED due to temperature

Action:

  • Turn on HVAC cooling
  • Close blinds
  • Turn on ventilation

Example 2: Protect Against Sun Exposure

Trigger:

  • Advisory indicates exposure risk
  • Lux or UV exceeds preferred values

Action:

  • Close shades on east-facing windows
  • Adjust lighting conditions

Example 3: Improve Air Quality

Trigger:

  • CO₂ exceeds configured threshold

Action:

  • Turn on fresh air vent
  • Activate ventilation system
  • Send notification

Example 4: Leak Detection Response

Trigger:

  • Leak detected in room

Action:

  • Shut off water supply
  • Send urgent alert
  • Activate alarm

What You Use in Automations

You can reference asset entities in Home Assistant by:

  • Device
  • Entity ID
  • Attribute values

Common properties include:

  • Risk state (Green, Amber, Red)
  • Candidate state
  • Advisory message
  • Risk reasons
  • Environmental values

Example Automation (Conceptual)

Trigger:

  • Asset risk state changes to RED

Condition:

  • Persisting beyond debounce threshold

Action:

  • Close blinds
  • Turn on HVAC
  • Notify user

Important: Debounce Behavior

Risk states are controlled by debounce logic to avoid rapid state changes.

This means:

  • A temporary spike may not immediately trigger a RED state
  • Automations will respond to confirmed conditions

This improves stability and prevents unnecessary actions.


Risk vs Advisory in Automations

You can build automations using either:


Risk State (Recommended for Control)

Use when:

  • You want reliable triggers
  • You are automating physical systems

Example:

  • If risk = RED → take action

Advisory (Recommended for Notifications)

Use when:

  • You want insight or guidance
  • You are notifying users

Example:

  • If advisory contains "high CO₂" → send notification

System Design Philosophy

Asset Intelligence does not:

  • Automatically control devices
  • Automatically execute recovery actions
  • Override Home Assistant automations

This ensures:

  • Full user control
  • Flexibility in behavior
  • Compatibility with any Home Assistant setup

Why This Approach Matters

Separating awareness from action allows:

  • Custom automation strategies
  • Different responses per household
  • Safe control of devices
  • Integration with existing automations

The same risk condition could result in different actions depending on:

  • Time of day
  • Occupancy
  • User preferences
  • Device availability

Best Practices

✅ Use risk state for automation triggers
✅ Use advisory for notifications and insights
✅ Combine risk with time/day conditions
✅ Use debounce-aware logic where necessary
✅ Test automations before relying on them


Example: Layered Automation

Trigger:

  • Asset risk = RED

Condition:

  • Time is between 8 AM and 10 PM

Action:

  • Close shades
  • Turn on ventilation

Secondary Action:

  • Send notification

Summary

Asset Intelligence provides:

  • Accurate environmental awareness
  • Consistent risk evaluation
  • Explainable advisory insights

Home Assistant provides:

  • Automation logic
  • Device control
  • User-defined responses

Together, they enable a powerful model:

Awareness → Decision → Action


Asset Intelligence tells you what is happening.

You decide what your home does about it.

Clone this wiki locally