Home Assistant Intents 项目教程

Home Assistant Intents 项目教程

intentsIntents to be used with Home Assistant项目地址:https://gitcode.com/gh_mirrors/in/intents

1. 项目的目录结构及介绍

Home Assistant Intents 项目的目录结构如下：

intents/
├── common/
│   ├── en.json
│   └── ...
├── intents/
│   ├── HASS_Help.yaml
│   ├── HASS_TurnOn.yaml
│   └── ...
├── scripts/
│   ├── convert.py
│   └── ...
├── tests/
│   ├── test_intents.py
│   └── ...
├── .github/
│   └── workflows/
│       └── ci.yaml
├── .gitignore
├── README.md
└── requirements.txt

目录介绍

• common/: 包含不同语言的通用意图文件，如 en.json 是英语的通用意图文件。
• intents/: 包含具体的意图定义文件，如 HASS_Help.yaml 和 HASS_TurnOn.yaml。
• scripts/: 包含用于转换和处理意图文件的脚本，如 convert.py。
• tests/: 包含测试脚本，如 test_intents.py。
• .github/workflows/: 包含 GitHub Actions 的工作流配置文件，如 ci.yaml。
• .gitignore: Git 忽略文件配置。
• README.md: 项目说明文档。
• requirements.txt: 项目依赖文件。

2. 项目的启动文件介绍

Home Assistant Intents 项目没有传统意义上的“启动文件”，因为它主要是一个意图定义和处理的库。项目的核心功能是通过配置文件和脚本来实现的。

3. 项目的配置文件介绍

配置文件

• intents/ 目录下的 YAML 文件是主要的配置文件，定义了各种意图和对应的响应。例如：

# HASS_TurnOn.yaml
language: en
intents:
  HASS.TurnOn:
    data:
      - sentences:
          - Turn on the [light|lights]{name}.
        slots:
          name: entity

配置文件介绍

• language: 指定意图的语言。
• intents: 定义具体的意图，如 HASS.TurnOn。
• data: 包含意图的具体句子和对应的槽位（slots）。
• sentences: 定义用户可能说的句子。
• slots: 定义槽位，用于提取用户句子中的特定信息。

通过这些配置文件，Home Assistant 可以理解和响应用户的语音指令。

intentsIntents to be used with Home Assistant项目地址:https://gitcode.com/gh_mirrors/in/intents