Latitude Voice Agent for Home Assistant

This adds a Latitude agent to Home Assistant Assist (voice) using:

• Home Assistant conversation + custom_sentences
• intent_script to handle the intent
• rest_command to call Latitude
• A helper (input_text) to persist the Latitude conversation UUID for multi-turn chat

It supports:

• Voice queries: "ask latitude …"
• Multi-turn conversation (keeps the same Latitude uuid)
• Reset by voice: "reset latitude"

Files

• configuration.yaml – Home Assistant config blocks
• custom_sentences/en/latitude.yaml – sentences + wildcard slot list
• secrets.yaml.example – example secrets entry

Setup

1) Add the secret

In your Home Assistant /config/secrets.yaml:

latitude_auth_header: "Bearer YOUR_LATITUDE_TOKEN"

2) Add the custom sentences

Copy this file into your Home Assistant config:

/config/custom_sentences/en/latitude.yaml

(Exact path matters.)

3) Add configuration blocks

Copy the contents of configuration.yaml from this repo into your own /config/configuration.yaml, merging top-level keys if you already have them.

If a key already exists, paste the new entries under it (do not duplicate the key).

4) Set your Latitude project ID

In your /config/configuration.yaml, find the rest_command.latitude_run_document URL and replace [YOUR_PROJECT_ID] with your actual Latitude project ID:

url: "https://gateway.latitude.so/api/v3/projects/[YOUR_PROJECT_ID]/versions/live/documents/run"

You can find your project ID in the Latitude dashboard URL or project settings.

5) Restart Home Assistant

Restart is required to ensure Conversation + custom sentences are loaded.

UI path: Settings → System → Restart → Restart Home Assistant

6) Test without a speaker

Developer Tools → Actions → run conversation.process with:

text: "ask latitude hi"
language: "en"

Then:

text: "ask latitude what did I just say"
language: "en"

7) Use by voice

Use Assist and say:

"ask latitude hi"

"ask latitude what did I just say"

To start over:

"reset latitude"

Notes

Multi-turn is implemented by storing Latitude's uuid in: input_text.latitude_conversation_uuid

Streaming is disabled (stream: false) for reliability in voice workflows.