Установку Home Assistant становится сложнее поддерживать, если помещения, устройства и объекты имеют непоследовательные имена. Датчик может быть указан по заводской модели, для освещения может использоваться сокращенное обозначение, понятное только одному человеку, а две комнаты могут содержать одинаковые названия устройств.
LinknLink App позволяет подключать устройства Home Assistant со сценами и рабочими процессами Agent+ на естественном языке. Согласованные имена помогают пользователю подтвердить правильность помещения и устройства перед подготовкой или запуском процедуры. В этом руководстве рассматриваются организация и проверка, а не инструкции по переименованию всех объектов одновременно.
Почему имена Matter в автоматизации Home Assistant
Сделайте цели читабельными
Используйте имена, которые идентифицируют помещение, роль устройства и тип измерения или управления.
Уменьшите двусмысленность
Обеспечьте различимость похожих устройств, если сцена содержит несколько комнат.
Обеспечьте возможность проверки автоматизации
Упростите проверку предложений Agent+ и сервисных вызовов Home Assistant.
Четкие имена придают LinknLink App и Home Assistant стабильный, удобочитаемый слой. Они упрощают просмотр целей сцены, уменьшают неоднозначность в запросах Agent+ и помогают диагностировать процедуру без изменения базового устройства или интеграции.
Прежде чем начать
- Экспортируйте или создайте резервную копию конфигурации Home Assistant перед изменением идентификаторов объектов.
- Перечислите помещения, зоны, устройства и объекты, которые фактически используются системами автоматизации.
- Выбирайте слова в нижнем регистре, устойчивый разделитель и один порядок для терминов помещения и устройства.
- Записывайте интеграции или сценарии, которые могут напрямую ссылаться на значенияentity_id.
- Прежде чем применять шаблон именования ко всему этажу, протестируйте одну некритическую автоматизацию.
Планируйте, переименовывайте, тестируйте и поддерживайте свою карту сущностей
1. Определите словарь комнаты
Выберите одно написание для таких комнат, как гостиная, спальня, кухня и прихожая. Избегайте переключения между сокращениями и полными именами.
2. Назовите роль устройства.
Используйте постоянную роль, например, потолочный светильник, настольную лампу, кондиционер, телевизор, занавеску или датчик присутствия.
3. Добавьте тип измерения или контроля.
Для датчиков добавьте такие термины, как присутствие, температура, влажность или освещенность, если объект представляет определенное значение.
4. Отдельные похожие устройства
Добавьте термин местоположения, зоны или положения, если в одной комнате есть два датчика или несколько источников света с одной и той же ролью.
5. Проверьте сгенерированные идентификаторы объектов.
Просмотрите полученный объектent_id и убедитесь, что сценарии, панели мониторинга и средства автоматизации по-прежнему ссылаются на намеченную цель.
6. Тест от LinknLink App
Используйте узкий запрос или предварительный просмотр одной сцены, подтвердите комнату и устройство, а затем проверьте состояние Home Assistant после утверждения.
7. Задокументируйте выкройку
Сохраните соглашение об именах рядом с резервной копией Home Assistant, чтобы будущие устройства имели ту же структуру.
Примеры подсказок и что нужно просмотреть
| Вариант использования | Пример запроса | Обзор перед действием |
|---|---|---|
| Датчик присутствия | Используйте «присутствие в гостиной» вместо заводского названия модели. | Помещение и размеры очевидны; используйте везде одно и то же написание номера. |
| Датчик климата | Используйте температуру в спальне и влажность в спальне как отдельные объекты. | Не смешивайте сокращения с полными названиями измерений в одной области. |
| Устройство IR | Используйте гостиная-кондиционер в качестве цели устройства в сцене IR. | Роль устройства ясна для сцены IR или сервисного вызова Home Assistant. |
| Устройство RF | Используйте porch-rf-light, когда местоположение и функция, контролируемая RF, обе matter. | Местоположение, роль протокола и функция устройства легко различимы. |
| Две лампы | Используйте офисную настольную лампу вместо настольной лампы-1, если местоположение известно. | Предпочитайте значимое местоположение числам, которые позже теряют контекст. |
Используйте этапы чтения, подготовки, утверждения и выполнения.
| Этап | Задача агента | Пользовательский контроль |
|---|---|---|
| Читать | Проверяйте только разрешенный источник. | Выберите приложение, диапазон дат, комнату, папку или учетную запись. |
| Подготовьтесь | Извлекайте объекты и создайте проект или предложенный план. | Проверьте предположения, недостающую информацию и затронутые ресурсы. |
| Утвердить | Представьте действие и цель. | Подтвердите или отредактируйте перед выполнением. |
| Выполнить | Запустите поддерживаемое действие после одобрения. | Проверьте результат и, если возможно, сохраняйте путь разворота. |
Обзор контрольного списка
- Идентифицирует ли имя одну комнату или зону, не полагаясь на частную стенографию?
- Может ли другой член семьи сказать, что это: датчик, свет, прибор или сцена?
- Отличаются ли объекты присутствия, температуры и влажности друг от друга?
- Существующие средства автоматизации, информационные панели и сценарии по-прежнему ориентированы на правильный идентификатор объекта?
- Можно ли рассматривать предложение LinknLink App или Agent+ только по названию?
Конфиденциальность, разрешения и более безопасные настройки по умолчанию
Задачи между приложениями могут касаться личных коммуникаций, календарей, файлов, фотографий, местоположений и бытовых устройств. Предоставляйте минимальное полезное разрешение, держите несвязанные данные за пределами области действия и избегайте разглашения учетных данных, паролей, одноразовых кодов или данных личной учетной записи.
Используйте черновики для сообщений и вложений. Используйте предварительный просмотр сцен для внесения изменений в умный дом. Держите покупки, контроль доступа, устройства безопасности и деструктивные действия с файлами за явным подтверждением со стороны человека.
Устранение неполадок
Автоматизация остановилась после переименования
Найдите средства автоматизации, скрипты, информационные панели и шаблоны для старого object_id, а затем восстановите или обновите ссылки по одной.
Агент+ выбирает неправильное устройство
Добавьте в запрос роль помещения и устройства, удалите повторяющиеся имена и запросите предварительный просмотр перед выполнением.
Температура и влажность неясны.
Используйте отдельные термины измерения и документируйте, поступает ли значение от кабеля, датчика Bluetooth или от другого устройства.
Идентификатор объекта не совпадает с отображаемым именем.
Считайте сгенерированный объектentity_id техническим идентификатором и сохраняйте короткую таблицу сопоставлений после любых изменений.
Устройство появляется дважды
Прежде чем создавать еще одну автоматизацию, проверьте дубликаты интеграции, назначение областей и отключенные объекты.
Сопутствующие продукты LinknLink
- HomeClaw: локальный Home Assistant и путь шлюза AI.
- eMotion Ultra: присутствие 60 ГГц, климатический контекст через сенсорный кабель и встроенный IR.
- eMotion Pro: присутствие в помещении на частоте 24 ГГц и поддерживаемые сигналы автоматизации.
- eRemote HA: локальное управление IR для совместимых устройств в Home Assistant.
- eHome HA: управление IR/RF и рабочие процессы Home Assistant.
Сопутствующие руководства LinknLink App и Home Assistant
- LinknLink App Руководство по функциям
- LinknLink Руководство по первым действиям мобильного агента
- LinknLink App Руководство по автоматизации
- LinknLink App Руководство по диагностике Agent+
- Бесплатный удаленный доступ Home Assistant с помощью LinknLink App
Часто задаваемые вопросы
Почему объект Home Assistant имеет имя matter?
Согласованные имена упрощают чтение, проверку и обслуживание средств автоматизации, информационных панелей и сервисных целей.
Какой шаблон именования подходит для датчиков присутствия?
Модель ролей в комнате, такая как присутствие в гостиной или присутствие в спальне, ясна при условии, что последовательно используется одна и та же комната и ролевая лексика.
Должен ли я немедленно переименовать идентификаторы объектов?
Сначала создайте резервную копию, определите ссылки и протестируйте одну некритическую автоматизацию, прежде чем вносить более широкие изменения.
Могут ли чистые имена помочь запросам LinknLink App Agent+?
Да. Имена ролей комнаты и устройства обеспечивают более понятный контекст, когда приложение готовит сцену или действие Home Assistant для просмотра.
Как следует маркировать значения температуры и влажности?
Используйте явные термины, такие как температура в спальне и влажность в спальне, и документируйте подключение исходного устройства или датчика.
Начните с одной комнаты
Выберите одну комнату, запишите предполагаемый шаблон именования, протестируйте одну обратимую автоматизацию и расширяйте ее только после того, как цели сущности станут легко проверить.