Home Assistant entitáselnevezési útmutató az LinknLink App automatizálásokhoz

Egy Home Assistant telepítést nehezebb karbantartani, ha a helyiségek, eszközök és entitások elnevezése következetlen. Előfordulhat, hogy egy szenzor gyári modell szerint szerepel a listában, egy lámpa olyan rövidítést használhat, amelyet csak egy ember ért, és két helyiség tartalmazhat hasonló eszközneveket.

LinknLink App Home Assistant eszközöket csatlakoztathat jelenetekkel és természetes nyelvű Agent+ munkafolyamatokkal. A konzisztens nevek segítenek a felhasználónak megbizonyosodni a megfelelő helyiségről és eszközről a rutin előkészítése vagy futtatása előtt. Ez az útmutató a szervezéssel és az áttekintéssel foglalkozik, nem pedig az összes entitás egyidejű átnevezésére

Válasszon ki egy Home Assistant eszközt

Miért nevek Matter az Home Assistant automatizálásokban

Tegye olvashatóvá a célokat

Használjon olyan neveket, amelyek azonosítják a helyiséget, az eszköz szerepét és a mérési vagy vezérlési típust.

Csökkentse a kétértelműséget

Ha egy jelenet több helyiséget tartalmaz, akkor a hasonló eszközöket tartsa megkülönböztethetővé.

Legyen ellenőrizhető az automatizálás

Az Agent+ ajánlatok és az Home Assistant szolgáltatáshívások könnyebben ellenőrizhetők.

A világos nevek az LinknLink App és az Home Assistant stabil, ember által olvasható réteget adnak. Könnyebbé teszik a jelenetcélok áttekintését, csökkentik az Agent+ kérések kétértelműségét, és segítenek a rutin diagnosztizálásában az alapul szolgáló eszköz vagy integráció megváltoztatása nélkül.

Mielőtt elkezdené

  • Az entitásazonosítók módosítása előtt exportálja vagy készítsen biztonsági másolatot az Home Assistant konfigurációról.
  • Sorolja fel az automatizálás által ténylegesen használt helyiségeket, területeket, eszközöket és entitásokat.
  • Válasszon kisbetűs szavakat, egy stabil elválasztót és egy sorrendet a szoba- és eszközkifejezésekhez.
  • Rögzítsen olyan integrációkat vagy szkripteket, amelyek közvetlenül hivatkozhatnak az entity_id értékekre.
  • Teszteljen egy nem kritikus automatizálást, mielőtt elnevezési mintát alkalmazna egy egész emeletre.
Ellenőrző megjegyzés: Kezdje írásvédett áttekintéssel vagy piszkozattal. Minden külső vagy érzékeny művelet előtt erősítse meg a címzetteket, a dátumokat, a fájlokat, a helyeket és az intelligens otthoni eszközöket.

Tervezze meg, nevezze át, tesztelje és tartsa karban entitástérképét

1. Határozza meg a szoba szókincsét

Válasszon egy helyesírást olyan helyiségekhez, mint a nappali, hálószoba, konyha és bejárat. Kerülje a váltást a rövidítések és a teljes nevek között.

2. Nevezze el az eszköz szerepkörét

Használjon következetes szerepet, például mennyezeti lámpát, asztali lámpát, váltóáramot, TV-t, függöny- vagy jelenlét-érzékelőt.

3. Adja hozzá a mérési vagy szabályozási típust

Az érzékelők esetében adjon hozzá olyan kifejezéseket, mint a jelenlét, a hőmérséklet, a páratartalom vagy a megvilágítás, ha az entitás egy adott értéket képvisel.

4. Különítse el a hasonló eszközöket

Adjon hozzá egy helyet, zónát vagy pozíció kifejezést, ha egy helyiségben két érzékelő vagy több, azonos szerepkörű lámpa van.

5. Ellenőrizze a generált entitásazonosítókat

Tekintse át a kapott entity_id értéket, és győződjön meg arról, hogy a szkriptek, irányítópultok és automatizálások továbbra is hivatkoznak a tervezett célra.

6. Teszt innen: LinknLink App

Használjon szűk kérést vagy egy jelenet előnézetét, erősítse meg a helyiséget és az eszközt, majd a jóváhagyás után ellenőrizze az Home Assistant állapotot.

7. Dokumentálja a mintát

Mentse el az elnevezési konvenciót az Home Assistant biztonsági másolat mellé, hogy a jövőbeni eszközök ugyanazt a struktúrát kövessék.

Példakérések és mit érdemes felülvizsgálni

Használati eset Példa kérés Tekintse át a cselekvés előtt
Jelenlét érzékelő Használja a nappali-jelenlétet a gyári modellnév helyett. A helyiség és a mérés explicit; mindenhol ugyanazt a szobaírást használja.
Klímaérzékelő Használja a hálószoba-hőmérsékletet és a hálószoba-páratartalmat különálló egységként. Ne keverje össze a rövidítéseket a teljes mérési névvel ugyanazon a területen.
IR készülék Használja a nappali-váltóáramot a készülék célpontjához egy IR jelenetben. A készülék szerepköre egyértelmű IR jelenet vagy Home Assistant szervizhívás esetén.
RF eszköz Használja a veranda-rf-lightot, ha a hely és az RF-vezérelt funkció is matter. A hely, a protokoll szerepe és az eszköz funkciója könnyen megkülönböztethető.
Két lámpa Használja az irodai asztali lámpát az asztali lámpa-1 helyett, ha ismert a hely. Előnyben részesítse az értelmes helyet az olyan számokkal szemben, amelyek később elvesztik a kontextust.
Prompt minta: Adja meg a célt, határozza meg az engedélyezett hatókört, adjon hozzá megszorításokat, nevezze el a tiltott műveleteket, és végrehajtás előtt kérjen előnézetet.

A szakaszok olvasása, előkészítése, jóváhagyása és végrehajtása használata

Színpad Ügynöki feladat Felhasználói vezérlés
Olvassa el Csak az engedélyezett forrást vizsgálja meg. Válassza ki az alkalmazást, a dátumtartományt, a szobát, a mappát vagy a fiókot.
Készülj fel Kivonja az entitásokat, és készítsen tervezetet vagy javasolt tervet. Ellenőrizze a feltételezéseket, a hiányzó információkat és az érintett forrásokat.
Jóváhagyni Mutassa be az akciót és a célt. Végrehajtás előtt erősítse meg vagy módosítsa.
Végrehajtás A jóváhagyás után futtassa a támogatott műveletet. Ellenőrizze az eredményt, és lehetőség szerint tartsa be a megfordítási útvonalat.

Ellenőrzőlista áttekintése

  • A név azonosít egy helyiséget vagy területet anélkül, hogy privát gyorsírásra támaszkodna?
  • Meg tudja mondani egy másik háztartástag, hogy érzékelőről, lámpáról, készülékről vagy jelenetről van-e szó?
  • Megkülönböztethetők-e egymástól a jelenlét, a hőmérséklet és a páratartalom entitásai?
  • A meglévő automatizálások, irányítópultok és szkriptek továbbra is a megfelelő entity_id-t célozzák?
  • Egy LinknLink App vagy Agent+ ajánlat áttekinthető-e pusztán a név alapján?

Adatvédelem, engedélyek és biztonságosabb alapértelmezések

Az alkalmazások közötti feladatok érinthetik a személyes kommunikációt, a naptárakat, fájlokat, fényképeket, helyeket és háztartási eszközöket. Adja meg a legkisebb hasznos engedélyt, tartsa távol a nem kapcsolódó adatokat, és kerülje a hitelesítő adatok, jelszavak, egyszeri kódok vagy privát fiókadatok megosztását.

Használjon piszkozatokat üzenetekhez és mellékletekhez. Használja a jelenetek előnézetét az intelligens otthon megváltoztatásához. Tartsa a vásárlásokat, a hozzáférés-szabályozást, a biztonsági eszközöket és a pusztító fájlműveleteket kifejezett emberi megerősítés mögött.

Hibaelhárítás

Egy automatizálás leállt az átnevezés után

Keressen automatikákban, szkriptekben, irányítópultokban és sablonokban a régi entity_id számára, majd egyesével állítsa vissza vagy frissítse a hivatkozásokat.

Az Agent+ rossz eszközt választ ki

Adja hozzá a szoba és az eszköz szerepkörét a kéréshez, távolítsa el az ismétlődő neveket, és kérjen előnézetet a végrehajtás előtt.

A hőmérséklet és a páratartalom nem egyértelmű

Használjon külön mérési feltételeket, és dokumentálja, hogy az érték kábelből, Bluetooth érzékelőből vagy más integrációból származik-e.

Az entitásazonosító nem egyezik meg a megjelenített névvel

A generált entity_id-t kezelje technikai azonosítóként, és minden változtatás után tartson egy rövid leképezési táblázatot.

Egy eszköz kétszer jelenik meg

Egy másik automatizálás létrehozása előtt ellenőrizze az integrációs ismétlődéseket, a terület-hozzárendelést és a letiltott entitásokat.

Kapcsolódó LinknLink termékek

  • HomeClaw: helyi Home Assistant és AI-átjáró-útvonal.
  • eMotion Ultra: 60 GHz-es jelenlét, klímakontextus az érzékelőkábelen keresztül, és beépített IR.
  • eMotion Pro: 24 GHz-es szobajelenlét és támogatott automatizálási jelek.
  • eRemote HA: helyi IR vezérlő kompatibilis készülékekhez az Home Assistant-ben.
  • eHome HA: IR/RF ellenőrzés és Home Assistant munkafolyamatok.

Kapcsolódó LinknLink App és Home Assistant útmutatók

Gyakran Ismételt Kérdések

Miért nevezi el az Home Assistant entitás matter?

Az egységes elnevezések megkönnyítik az automatizálások, irányítópultok és szolgáltatási célok olvashatóságát, áttekintését és karbantartását.

Milyen elnevezési minta működik a jelenlétérzékelőknél?

A helyiség-szerepminta, mint például a nappali-jelenlét vagy a hálószoba-jelenlét, egyértelmű, feltéve, hogy ugyanazt a helyiséget és a szerepszótárat következetesen használják.

Azonnal át kell neveznem az entitásazonosítókat?

Először készítsen biztonsági másolatot, azonosítsa a hivatkozásokat, és teszteljen egy nem kritikus automatizálást, mielőtt szélesebb körű változtatásokat hajtana végre.

A törölt nevek segíthetnek az LinknLink App Agent+ kérésekben?

Igen. A helyiség- és eszközszerep-nevek világosabb kontextust biztosítanak, amikor az alkalmazás egy jelenetet vagy egy Home Assistant-műveletet készít elő felülvizsgálatra.

Hogyan kell címkézni a hőmérséklet- és páratartalom-elemeket?

Használjon kifejezett kifejezéseket, például hálószoba-hőmérséklet és hálószoba-páratartalom, és dokumentálja a forráseszköz vagy az érzékelő csatlakozását.

Kezdje az Egy szobával

Válasszon ki egy helyiséget, írja le a tervezett elnevezési mintát, teszteljen egy megfordítható automatizálást, és csak azután bontsa ki, hogy az entitáscélok könnyen ellenőrizhetők.