Home Assistant Leitfaden zur Benennung von Entitäten für LinknLink App-Automatisierungen

Eine Home Assistant-Installation wird schwieriger zu warten, wenn Räume, Geräte und Entitäten inkonsistent benannt werden. Ein Sensor kann nach einem Fabrikmodell aufgelistet sein, eine Leuchte kann eine Abkürzung verwenden, die nur eine Person versteht, und zwei Räume können ähnliche Gerätenamen enthalten.

LinknLink App kann Home Assistant-Geräte mit Szenen und Agent+-Workflows in natürlicher Sprache verbinden. Konsistente Namen helfen dem Benutzer, den richtigen Raum und das richtige Gerät zu bestätigen, bevor eine Routine vorbereitet oder ausgeführt wird. In diesem Leitfaden geht es um die Organisation und Überprüfung, nicht um eine Anweisung, jede Entität auf einmal umzubenennen

Wählen Sie ein Home Assistant-Gerät aus

Warum nennt man Matter in Home Assistant-Automatisierungen?

Machen Sie Ziele lesbar

Verwenden Sie Namen, die den Raum, die Geräterolle und den Mess- oder Steuerungstyp identifizieren.

Reduzieren Sie Unklarheiten

Sorgen Sie dafür, dass ähnliche Geräte unterscheidbar sind, wenn eine Szene mehrere Räume enthält.

Halten Sie die Automatisierung überprüfbar

Erleichtern Sie die Überprüfung von Agent+-Vorschlägen und Home Assistant-Serviceanrufen.

Klare Namen verleihen LinknLink App und Home Assistant eine stabile, für Menschen lesbare Schicht. Sie erleichtern die Überprüfung von Szenenzielen, reduzieren Mehrdeutigkeiten bei Agent+-Anfragen und helfen Ihnen bei der Diagnose einer Routine, ohne das zugrunde liegende Gerät oder die Integration zu ändern.

Bevor Sie beginnen

  • Exportieren oder sichern Sie die Konfiguration Home Assistant, bevor Sie Entitäts-IDs ändern.
  • Listen Sie die Räume, Bereiche, Geräte und Einheiten auf, die tatsächlich von Automatisierungen genutzt werden.
  • Wählen Sie Kleinbuchstaben, ein stabiles Trennzeichen und eine Reihenfolge für Raum- und Gerätebegriffe.
  • Zeichnen Sie Integrationen oder Skripts auf, die möglicherweise direkt auf entity_id-Werte verweisen.
  • Testen Sie eine unkritische Automatisierung, bevor Sie ein Benennungsmuster auf eine ganze Etage anwenden.
Kontrollhinweis: Beginnen Sie mit einer schreibgeschützten Rezension oder einem Entwurf. Bestätigen Sie Empfänger, Daten, Dateien, Standorte und Smart-Home-Geräte vor externen oder sensiblen Aktionen.

Planen, umbenennen, testen und pflegen Sie Ihre Entity Map

1. Definieren Sie das Raumvokabular

Wählen Sie eine Schreibweise für Räume wie Wohnzimmer, Schlafzimmer, Küche und Eingangsbereich. Vermeiden Sie den Wechsel zwischen Abkürzungen und vollständigen Namen.

2. Benennen Sie die Geräterolle

Verwenden Sie eine einheitliche Rolle wie Deckenleuchte, Schreibtischlampe, Klimaanlage, Fernseher, Vorhang oder Anwesenheitssensor.

3. Fügen Sie den Mess- oder Steuerungstyp hinzu

Fügen Sie bei Sensoren Begriffe wie Präsenz, Temperatur, Luftfeuchtigkeit oder Beleuchtungsstärke hinzu, wenn die Entität einen bestimmten Wert darstellt.

4. Trennen Sie ähnliche Geräte

Fügen Sie einen Orts-, Zonen- oder Positionsbegriff hinzu, wenn ein Raum über zwei Sensoren oder mehrere Leuchten mit derselben Funktion verfügt.

5. Überprüfen Sie die generierten Entitäts-IDs

Überprüfen Sie die resultierende „entity_id“ und stellen Sie sicher, dass Skripte, Dashboards und Automatisierungen weiterhin auf das beabsichtigte Ziel verweisen.

6. Test von LinknLink App

Verwenden Sie eine enge Anfrage oder eine Szenenvorschau, bestätigen Sie den Raum und das Gerät und überprüfen Sie dann nach der Genehmigung den Status Home Assistant.

7. Dokumentieren Sie das Muster

Speichern Sie die Namenskonvention neben der Sicherung Home Assistant, damit zukünftige Geräte derselben Struktur folgen.

Beispielaufforderungen und was Sie überprüfen sollten

Anwendungsfall Beispielanfrage Überprüfen Sie vor der Aktion
Präsenzsensor Verwenden Sie „living-room-presence“ anstelle eines Werksmodellnamens. Raum und Messung sind explizit; Verwenden Sie überall die gleiche Raumschreibweise.
Klimasensor Verwenden Sie Schlafzimmertemperatur und Schlafzimmerfeuchtigkeit als separate Einheiten. Vermischen Sie keine Abkürzungen mit vollständigen Messnamen im selben Bereich.
IR Appliance Verwenden Sie „living-room-ac“ als Appliance-Ziel in einer IR-Szene. Die Appliance-Rolle ist für eine IR-Szene oder einen Home Assistant-Serviceaufruf klar.
RF Gerät Verwenden Sie porch-rf-light, wenn der Standort und die RF-gesteuerte Funktion beide matter sind. Standort, Protokollrolle und Gerätefunktion sind leicht zu unterscheiden.
Zwei Lampen Verwenden Sie „office-desk-lamp“ anstelle von „desk-lamp-1“, wenn der Standort bekannt ist. Bevorzugen Sie einen aussagekräftigen Ort gegenüber Zahlen, die später den Kontext verlieren.
Eingabeaufforderungsmuster: Geben Sie das Ziel an, definieren Sie den zulässigen Umfang, fügen Sie Einschränkungen hinzu, benennen Sie verbotene Aktionen und fordern Sie vor der Ausführung eine Vorschau an.

Verwenden Sie die Phasen „Lesen“, „Vorbereiten“, „Genehmigen“ und „Ausführen“.

Bühne Agentenaufgabe Benutzerkontrolle
Lesen Überprüfen Sie nur die zulässige Quelle. Wählen Sie die App, den Datumsbereich, den Raum, den Ordner oder das Konto.
Bereiten Sie sich vor Extrahieren Sie Entitäten und erstellen Sie einen Entwurf oder Planvorschlag. Überprüfen Sie Annahmen, fehlende Informationen und betroffene Ressourcen.
Genehmigen Präsentieren Sie die Aktion und das Ziel. Vor der Ausführung bestätigen oder überarbeiten.
Ausführen Führen Sie die unterstützte Aktion nach der Genehmigung aus. Überprüfen Sie das Ergebnis und behalten Sie nach Möglichkeit einen Umkehrpfad bei.

Überprüfen Sie die Checkliste

  • Bezeichnet der Name einen Raum oder Bereich, ohne sich auf private Abkürzungen zu verlassen?
  • Kann ein anderes Haushaltsmitglied erkennen, ob es sich um einen Sensor, ein Licht, ein Gerät oder eine Szene handelt?
  • Sind Präsenz-, Temperatur- und Feuchtigkeitseinheiten voneinander unterscheidbar?
  • Zielen vorhandene Automatisierungen, Dashboards und Skripte immer noch auf die richtige Entity_ID?
  • Kann ein LinknLink App- oder Agent+-Vorschlag allein anhand des Namens überprüft werden?

Datenschutz, Berechtigungen und sicherere Standardeinstellungen

App-übergreifende Aufgaben können persönliche Kommunikation, Kalender, Dateien, Fotos, Standorte und Haushaltsgeräte betreffen. Erteilen Sie die kleinste nützliche Berechtigung, halten Sie irrelevante Daten außerhalb des Geltungsbereichs und vermeiden Sie die Weitergabe von Anmeldeinformationen, Passwörtern, Einmalcodes oder privaten Kontodaten.

Verwenden Sie Entwürfe für Nachrichten und Anhänge. Nutzen Sie Szenenvorschauen für Smart-Home-Änderungen. Sorgen Sie dafür, dass Einkäufe, Zugriffskontrolle, Sicherheitsvorrichtungen und zerstörerische Dateiaktionen der ausdrücklichen menschlichen Bestätigung unterliegen.

Fehlerbehebung

Eine Automatisierung wurde nach einer Umbenennung gestoppt

Durchsuchen Sie Automatisierungen, Skripte, Dashboards und Vorlagen nach der alten entity_id und stellen Sie dann die Referenzen einzeln wieder her oder aktualisieren Sie sie.

Agent+ wählt das falsche Gerät aus

Fügen Sie der Anfrage die Raum- und Geräterolle hinzu, entfernen Sie doppelte Namen und fordern Sie vor der Ausführung eine Vorschau an.

Temperatur und Luftfeuchtigkeit sind unklar

Verwenden Sie separate Messbegriffe und dokumentieren Sie, ob der Wert von einem Kabel, einem Bluetooth-Sensor oder einer anderen Integration stammt.

Die Entitäts-ID stimmt nicht mit dem Anzeigenamen überein

Behandeln Sie die generierte „entity_id“ als technischen Bezeichner und führen Sie nach jeder Änderung eine kurze Zuordnungstabelle.

Ein Gerät erscheint zweimal

Überprüfen Sie Integrationsduplikate, Bereichszuweisungen und deaktivierte Entitäten, bevor Sie eine weitere Automatisierung erstellen.

Verwandte LinknLink-Produkte

  • HomeClaw: ein lokaler Home Assistant und AI-Gateway-Pfad.
  • eMotion Ultra: 60-GHz-Präsenz, Klimakontext über das Sensorkabel und integriertes IR.
  • eMotion Pro: 24-GHz-Raumpräsenz und unterstützte Automatisierungssignale.
  • eRemote HA: lokale IR-Steuerung für kompatible Geräte in Home Assistant.
  • eHome HA: IR/RF-Steuerung und Home Assistant-Workflows.

Verwandte LinknLink App- und Home Assistant-Anleitungen

Häufig gestellte Fragen

Warum nennt die Entität Home Assistant matter?

Durch einheitliche Namen sind Automatisierungen, Dashboards und Serviceziele einfacher zu lesen, zu überprüfen und zu verwalten.

Welches Benennungsmuster funktioniert für Präsenzsensoren?

Ein Raum-Rollenmuster wie Wohnzimmer-Anwesenheit oder Schlafzimmer-Anwesenheit ist klar, vorausgesetzt, dass das gleiche Raum- und Rollenvokabular konsequent verwendet wird.

Sollte ich Entitäts-IDs sofort umbenennen?

Erstellen Sie zunächst ein Backup, identifizieren Sie Referenzen und testen Sie eine unkritische Automatisierung, bevor Sie umfassendere Änderungen vornehmen.

Können Klarnamen bei LinknLink App Agent+-Anfragen helfen?

Ja. Raum- und Geräterollennamen bieten einen klareren Kontext, wenn die App eine Szene oder Home Assistant Aktion zur Überprüfung vorbereitet.

Wie sollten Temperatur- und Feuchtigkeitseinheiten gekennzeichnet werden?

Verwenden Sie eindeutige Begriffe wie „Schlafzimmertemperatur“ und „Schlafzimmerfeuchtigkeit“ und dokumentieren Sie das Quellgerät oder die Sensorverbindung.

Beginnen Sie mit einem Raum

Wählen Sie einen Raum aus, notieren Sie das beabsichtigte Benennungsmuster, testen Sie eine reversible Automatisierung und erweitern Sie ihn erst, wenn die Entitätsziele leicht zu überprüfen sind.