Skip to content
Tom Grounds - Personal edited this page Jun 19, 2026 · 2 revisions

General

What is Asset Intelligence?

Asset Intelligence transforms Home Assistant into a system that understands:

  • What you own (assets)
  • Where things are (areas)
  • What conditions matter (environment)
  • What those conditions mean (risk and advisory)

Is this just another device integration?

No.

Asset Intelligence is a system-level integration that:

  • Models assets as devices
  • Uses Home Assistant as the system of record
  • Adds intelligence on top of environment, placement, and context

Rooms and Areas

Why can’t I create rooms in Asset Intelligence?

Rooms are managed by Home Assistant Areas.

This ensures:

  • No duplication
  • No sync issues
  • Consistent room definitions across your system

What happens if I rename or move a room?

Changes in Home Assistant are automatically reflected in Asset Intelligence.


Assets and Devices

Why do assets show up as devices?

Each asset is implemented as a Home Assistant device.

This allows:

  • Use in automations
  • Visibility in HA UI
  • Area and label integration

Will this create duplicate devices?

No.

Assets are created once and reconnected on restart.


Can I edit assets in Home Assistant directly?

Yes, but using Asset Intelligence is recommended to maintain consistency.


Labels

Where do I create labels?

Labels are created in Home Assistant:

Settings → Labels


Why are labels not managed in the Asset Intelligence UI?

Labels are global and shared across Home Assistant.

This allows consistency across integrations and automations.


Can an asset have multiple labels?

Yes.

This is encouraged to provide flexible categorization.


Environment and Sensors

Why am I seeing missing values (—) in my room?

This means:

  • A sensor has not been configured
  • A sensor is unavailable
  • Data is missing

Why does the system warn about missing Lux or UV?

If light or exposure matters for an asset, missing sensors reduce confidence and completeness of evaluation.


Do I need every sensor type?

No.

You should configure sensors based on what matters in each room.


Risk and Advisory

What is the difference between risk and advisory?

  • Risk = current evaluated state (Green, Amber, Red)
  • Advisory = explanation or recommendation

Why is my asset Amber but nothing seems wrong?

Amber can mean:

  • Warning conditions
  • Missing data
  • Reduced confidence
  • Early indicators before a Red condition

Why don’t candidate state and actual state match?

Debounce rules may be active.

The system waits for conditions to persist before confirming a state change.


Why does the system show warnings about missing data?

The system does not assume safety when data is missing.

It warns to indicate incomplete understanding.


Automation

Why doesn’t Asset Intelligence fix issues automatically?

By design:

  • Asset Intelligence detects and explains
  • Home Assistant automations decide and act

How do I take action on risk?

Use Home Assistant automations:

  • Trigger on risk state
  • Trigger on advisory signals
  • Perform actions (HVAC, shades, alerts)

What should I use for automations?

  • Use risk state for control
  • Use advisory for notifications

Documents and Storage

Where are documents stored?

Documents are stored in your configured external storage (e.g., NAS).


What happens if storage is not configured?

Document upload and management will not function.


Are documents stored in Home Assistant?

No.

Only references are stored—files are external.


Activity and Auditing

What is tracked in activity?

  • Asset changes
  • Risk transitions
  • Environment events
  • Advisory generation
  • Document actions
  • Custody events

How far back does history go?

History is bounded to avoid excessive storage usage.


System Behavior

What happens on restart?

  • Assets reconnect to existing devices
  • Environment evaluation resumes
  • No duplication occurs

Why does the system still evaluate with missing sensors?

The system always produces a result, but confidence and warnings reflect gaps.


Does Asset Intelligence control my home?

No.

It is an intelligence layer—not a control system.


Summary

Asset Intelligence:

  • Detects conditions
  • Evaluates risk
  • Explains what matters

Home Assistant:

  • Executes actions
  • Runs automations
  • Controls devices

The system is designed to separate awareness from action.

Clone this wiki locally