Anyone can contribute to this repository, including:
- Sentence templates that will be matched to intents
- Test sentences for testing the sentence templates
- Response templates that Home Assistant will use to generate responses
Several workflows are available for contribution:
- For small edits to existing files, you can edit directly on Github
- A complete online development environment is available with Github codespaces
- Local development should be done by forking and setting up a local development environment
In order to match text to intents, we have created a specialized template language and matcher. These sentences are grouped by intent, and collected into YAML files. By convention, lists and expansion rules put into sentences/<language>/_common.yaml
Sentences and the intents they should match are collected together into YAML files. By convention, test names for areas and entities are put into tests/<language>/_fixtures.yaml
Responses to intents will be generated with Home Assistant templates. These are different than the sentence templates, which are used for matching text to intents.
Response templates will have access to the state object of the matched entity, such as the climate entity for the sentence "what is the temperature?".
See file format for more details on the YAML format for response templates.