Home Assistant Guía de nombres de entidades para automatizaciones LinknLink App

Una instalación Home Assistant se vuelve más difícil de mantener cuando las salas, los dispositivos y las entidades tienen nombres inconsistentes. Un sensor puede estar listado por modelo de fábrica, una luz puede usar una taquigrafía que solo una persona entiende y dos habitaciones pueden contener nombres de dispositivos similares.

LinknLink App puede conectar dispositivos Home Assistant con escenas y flujos de trabajo de Agent+ en lenguaje natural. Los nombres coherentes ayudan al usuario a confirmar la habitación y el dispositivo correctos antes de preparar o ejecutar una rutina. Esta guía cubre la organización y la revisión, no una instrucción para cambiar el nombre de cada entidad a la vez.

Seleccione un dispositivo Home Assistant

Por qué los nombres Matter en las automatizaciones Home Assistant

Hacer que los objetivos sean legibles

Utilice nombres que identifiquen la habitación, la función del dispositivo y el tipo de medición o control.

Reducir la ambigüedad

Mantenga dispositivos similares distinguibles cuando una escena contenga varias habitaciones.

Mantenga la automatización revisable

Haga que las propuestas de Agent+ y las llamadas de servicio Home Assistant sean más fáciles de verificar.

Los nombres claros dan a LinknLink App y Home Assistant una capa estable y legible por humanos. Hacen que los objetivos de escena sean más fáciles de revisar, reducen la ambigüedad en las solicitudes de Agent+ y lo ayudan a diagnosticar una rutina sin cambiar el dispositivo subyacente o la integración.

Antes de comenzar

  • Exporte o haga una copia de seguridad de la configuración Home Assistant antes de cambiar los ID de entidad.
  • Enumere las salas, áreas, dispositivos y entidades que realmente utilizan las automatizaciones.
  • Elija palabras en minúscula, un separador estable y un orden para los términos de habitación y dispositivo.
  • Registre integraciones o scripts que puedan hacer referencia a los valores de entidad_id directamente.
  • Pruebe una automatización no crítica antes de aplicar un patrón de nombres a todo un piso.
Nota de control: Comience con una revisión de solo lectura o un borrador. Confirme destinatarios, fechas, archivos, ubicaciones y dispositivos domésticos inteligentes antes de cualquier acción externa o sensible.

Planifique, cambie el nombre, pruebe y mantenga su mapa de entidad

1. Definir el vocabulario de la sala.

Elija una ortografía para habitaciones como sala de estar, dormitorio, cocina y entrada. Evite cambiar entre abreviaturas y nombres completos.

2. Asigne un nombre a la función del dispositivo

Utilice un papel consistente como luz de techo, lámpara de escritorio, aire acondicionado, televisión, cortina o sensor de presencia.

3. Agregue el tipo de medición o control.

Para sensores, agregue términos como presencia, temperatura, humedad o iluminancia cuando la entidad represente un valor específico.

4. Separar dispositivos similares

Agregue un término de ubicación, zona o posición cuando una habitación tenga dos sensores o varias luces con la misma función.

5. Verifique los ID de entidad generados

Revise el id_entidad resultante y confirme que los scripts, paneles y automatizaciones aún hagan referencia al objetivo previsto.

6. Prueba de LinknLink App

Utilice una solicitud limitada o una vista previa de una escena, confirme la habitación y el dispositivo, luego verifique el estado de Home Assistant después de la aprobación.

7. Documentar el patrón

Guarde la convención de nomenclatura junto a la copia de seguridad Home Assistant para que los dispositivos futuros sigan la misma estructura.

Mensajes de ejemplo y qué revisar

Caso de uso Solicitud de ejemplo Revisar antes de actuar
sensor de presencia Utilice living-room-presence en lugar de un nombre de modelo de fábrica. El espacio y las medidas son explícitos; Utilice la misma ortografía de habitación en todas partes.
Sensor climático Utilice la temperatura del dormitorio y la humedad del dormitorio como entidades separadas. No mezcle abreviaturas con nombres completos de medidas en la misma área.
Dispositivo IR Utilice living-room-ac para el dispositivo objetivo en una escena IR. La función del dispositivo está clara para una escena IR o una llamada de servicio Home Assistant.
Dispositivo RF Utilice porch-rf-light cuando la ubicación y RF funcionan ambos matter. La ubicación, la función del protocolo y la función del dispositivo son fáciles de distinguir.
dos lamparas Utilice office-desk-lamp en lugar de desk-lamp-1 cuando conozca la ubicación. Prefiera una ubicación significativa a números que pierdan contexto más adelante.
Patrón rápido: Indique el objetivo, defina el alcance permitido, agregue restricciones, nombre acciones prohibidas y solicite una vista previa antes de la ejecución.

Utilice las etapas de lectura, preparación, aprobación y ejecución

etapa Tarea del agente control de usuario
leer Inspeccione sólo la fuente permitida. Elija la aplicación, rango de fechas, sala, carpeta o cuenta.
preparar Extraiga entidades y cree un borrador o plan propuesto. Consultar supuestos, información faltante y recursos afectados.
Aprobar Presentar la acción y el destino. Confirmar o revisar antes de la ejecución.
ejecutar Ejecute la acción admitida después de la aprobación. Verifique el resultado y mantenga una ruta de reversión cuando sea posible.

Revisar la lista de verificación

  • ¿El nombre identifica una habitación o área sin depender de una taquigrafía privada?
  • ¿Puede otro miembro del hogar saber si se trata de un sensor, una luz, un electrodoméstico o una escena?
  • ¿Se distinguen entre sí las entidades de presencia, temperatura y humedad?
  • ¿Las automatizaciones, los paneles y los scripts existentes todavía tienen como objetivo el ID de entidad correcto?
  • ¿Se puede revisar una propuesta LinknLink App o Agent+ solo desde el nombre?

Privacidad, permisos y valores predeterminados más seguros

Las tareas entre aplicaciones pueden afectar comunicaciones personales, calendarios, archivos, fotografías, ubicaciones y dispositivos domésticos. Otorgue el permiso útil más pequeño, mantenga los datos no relacionados fuera del alcance y evite compartir credenciales, contraseñas, códigos de un solo uso o detalles de cuentas privadas.

Utilice borradores para mensajes y archivos adjuntos. Utilice vistas previas de escenas para cambios en el hogar inteligente. Mantenga las compras, el control de acceso, los dispositivos de seguridad y las acciones destructivas de archivos detrás de una confirmación humana explícita.

Solución de problemas

Una automatización se detuvo después de un cambio de nombre

Busque automatizaciones, scripts, paneles y plantillas para el antiguo ID de entidad, luego restaure o actualice las referencias una a la vez.

Agent+ selecciona el dispositivo incorrecto

Agregue la función de sala y dispositivo a la solicitud, elimine nombres duplicados y solicite una vista previa antes de la ejecución.

La temperatura y la humedad no están claras.

Utilice términos de medición separados y documente si el valor proviene de un cable, un sensor Bluetooth u otra integración.

El ID de la entidad no es el mismo que el nombre para mostrar

Trate el id_entidad generado como el identificador técnico y mantenga una breve tabla de mapeo después de cualquier cambio.

Un dispositivo aparece dos veces

Verifique los duplicados de integración, la asignación de áreas y las entidades deshabilitadas antes de crear otra automatización.

Productos relacionados LinknLink

  • HomeClaw: una ruta de puerta de enlace Home Assistant local y AI.
  • eMotion Ultra: Presencia de 60GHz, contexto climático a través de su cable sensor y IR incorporado.
  • eMotion Pro: Presencia en sala de 24 GHz y señales de automatización compatibles.
  • eRemote HA: control local IR para dispositivos compatibles en Home Assistant.
  • eHome HA: control IR/RF y flujos de trabajo Home Assistant.

Guías relacionadas LinknLink App y Home Assistant

Preguntas frecuentes

¿Por qué la entidad Home Assistant nombra matter?

Los nombres coherentes hacen que las automatizaciones, los paneles y los objetivos de servicio sean más fáciles de leer, revisar y mantener.

¿Qué patrón de nomenclatura funciona para los sensores de presencia?

Un patrón de rol en la habitación, como presencia en la sala de estar o presencia en el dormitorio, es claro, siempre que se utilice consistentemente el mismo vocabulario de habitación y rol.

¿Debo cambiar el nombre de los ID de las entidades inmediatamente?

Primero haga una copia de seguridad, identifique referencias y pruebe una automatización no crítica antes de realizar cambios más amplios.

¿Borrar nombres puede ayudar a las solicitudes de LinknLink App Agent+?

Sí. Los nombres de funciones de sala y dispositivo brindan un contexto más claro cuando la aplicación prepara una escena o una acción Home Assistant para su revisión.

¿Cómo se deben etiquetar las entidades de temperatura y humedad?

Utilice términos explícitos como temperatura del dormitorio y humedad del dormitorio, y documente el dispositivo fuente o la conexión del sensor.

Comience con una habitación

Elija una habitación, escriba el patrón de nomenclatura previsto, pruebe una automatización reversible y amplíe solo después de que los objetivos de la entidad sean fáciles de verificar.