A régi LinknLink jelenetek és automatizálások migrálása az új alkalmazásba MCP használatával

Ez az útmutató elmagyarázza a következő adatok áttelepítését és visszaállítását a régi LinknLink App fájlból:

• Jelenetek
• Kapcsolódások vagy automatizálások

Az adatok az új alkalmazás következő funkcióiba kerülnek áttelepítésre:

• Felhő jelenetek
• Felhő automatizálások

Az áttelepítés során a Codex csatlakozik az LinknLink App által biztosított MCP-szolgáltatáshoz, beolvassa a régebbi adatokat, és az aktuális családban elérhető eszközök és entitások segítségével újraépíti azokat.

A régi adatok alapértelmezés szerint nem törlődnek, így szükség esetén visszaállíthatja.

1. Mire van szüksége a migráció előtt

Készítse elő a következő három csatlakozási paramétert:

A token általában így néz ki:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

Ne használja a példa Tokent ebben az útmutatóban. Másolnia kell a saját alkalmazásában megjelenő tokent.

2. Győződjön meg arról, hogy a Codex és az Ön telefonja képes kommunikálni

A Codexet futtató számítógépnek el kell érnie az LinknLink App-et futtató eszközt.

A legegyszerűbb beállítás a következő:

• A telefon és a számítógép ugyanahhoz a Wi-Fi hálózathoz csatlakozik.
• A telefon nem vált át mobiladat-kapcsolatra.
• A számítógép nem csatlakozik olyan VPN-hez, amely elszigeteli a helyi hálózatot.
• Az útválasztón nincs engedélyezve a vendéghálózat vagy a kliens elkülönítése.

Például:

Számítógép IP: 192.168.58.20
Alkalmazás MCP IP: 192.168.58.121

Mindkét cím a 192.168.58.x alhálózaton, így általában képesnek kell lenniük a közvetlen kommunikációra.

Ha az alkalmazás megjeleníti:

10.0.0.232

de a számítógép a következőket használja:

192.168.58.x

a két eszköz különböző alhálózatokon lehet. Előfordulhat, hogy a Codex csak akkor tud csatlakozni, ha az útválasztót úgy konfigurálták, hogy a forgalmat ezen alhálózatok között irányítsa.

Ne adja meg az útválasztó IP-címét, az átjáró IP-címét vagy nyilvános IP-címét. Az AI-ügynök beállítási oldalán látható MCP-szolgáltatás IP-címét kell használnia.

3. Töltse ki a Codex migrációs kérését

Másolja a következő promptot a Codexbe, és cserélje ki az IP-címet, a portot és a Tokent saját értékeire.

Kérjük, használja az LinknLink App által biztosított MCP-szolgáltatást 
migrálja az örökölt alkalmazás jeleneteit és kapcsolatait a jelenlegi családban 
a Cloud Scenes és Cloud Automations szolgáltatáshoz az új alkalmazásban.

MCP kapcsolat részletei:
- IP: Cserélje ki a beállítások oldalon látható IP-címre
- Port: 39282
- Token: Cserélje ki az utolsó tokenre, amely az alján látható 
az AI-ügynök beállításai oldalon

Kövesse pontosan ezt a folyamatot:

1. Konfigurálja az LinknLink távoli, streamelhető HTTP MCP-kiszolgálóként.
2. Használja a következő MCP-végpontot:
   http://IP:PORT/mcp
3. Használja a mellékelt Tokent a Bearer Token hitelesítéshez.
4. Futtassa az MCP inicializálási kézfogást, és olvassa el az eszközöket/listát a megerősítéshez 
hogy a kapcsolat működik.
5. Olvassa el az aktuális családi információkat.
6. Olvassa el az aktuális család teljes eszköz- és entitáslistáját.
7. Olvassa el minden szükséges Entitás képességeit és aktuális állapotát 
a migrációhoz.
8. Olvassa el az örökölt jelenetadatokat.
9. Olvassa el az örökölt kapcsolódási vagy automatizálási adatokat.
10. A megelőzés érdekében olvassa el a meglévő felhőjeleneteket és felhőautomatizálásokat 
másolatok.
11. Leképezések készítése régi eszköz DID-kből, végpontazonosítókból és örökölt eszközökből 
jelenetazonosítók a jelenlegi entitásazonosítókhoz és az új Cloud Scene azonosítókhoz.
12. Ne másolja közvetlenül a régebbi eszközazonosítókat. Újjáépítési akciók és 
az aktuális családban ténylegesen létező entitásazonosítók használatával aktiválja.
13. Először migrálja át a felhőjeleneteket, és rögzítse az új Cloud Scene-azonosítókat.
14. Ezután migrálja át a jelenetekre hivatkozó Cloud Automations alkalmazást a 
új Cloud Scene azonosítók. Ha a szerver egy jelenetet Entitássá bővít ki 
műveletek esetén a jelenlegi entitásokon alapuló kiterjesztett műveletek is használhatók.
15. Hívja a validate_scene parancsot minden új jelenethez.
16. Hívja a validate_automation parancsot minden új automatizáláshoz.
17. Csak azután hozzon létre egy elemet, miután átment az ellenőrzésen.
18. Őrizze meg az eredeti nevet, időpontot, hétköznapokat, kiváltási feltételeket, 
eszközműveletek, értesítési szöveg, hőmérséklet, mód, ventilátor sebessége, 
és késések.
19. Ha egy örökölt eszköz már nem létezik, ne találja ki a leképezést. 
Sorolja fel a régi eszközinformációkat és a lehetséges entitásjelölteket, 
és magyarázza el, hogy az elem miért nem migrálható biztonságosan.
20. Ne töröljön örökölt jeleneteket vagy örökölt hivatkozásokat.
21. Ne hajtsa végre az új jeleneteket vagy automatizálásokat, mert így 
valódi eszközöket vezérelhetett.
22. Létrehozás után olvassa el a Cloud Scenes és a Cloud Automations című részt 
újra, és ellenőrizze a számukat, a nevüket, az engedélyezett állapotokat, a triggereket, 
és cselekvések.
23. A zárójelentés tartalmazza:
    - A talált örökölt jelenetek száma
    - A talált örökölt kapcsolatok száma
    - A létrehozott felhőjelenetek száma
    - A létrehozott felhőautomatizálások száma
    - Az egyes áttelepített elemek által használt aktuális entitásazonosítók
    - Minden olyan elem, amelyet nem lehetett áttelepíteni, és a konkrét okok
    - Megőrizték-e az örökölt adatokat

Végezze el közvetlenül az áttelepítést. Ne csak utasításokat adjon. 
Ne ismételje meg a teljes Tokent a végső válaszban.

A részletek megadása után a kezdetnek így kell kinéznie:

MCP kapcsolat részletei:
- IP: 192.168.58.121
- Port: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

4. Mit tesz a Codex

4.1 Hozzon létre MCP-kapcsolatot

A Codex a következő használatával csatlakozik az LinknLink MCP-hez:

http://YOUR_IP:39282/mcp

A tokent a hitelesítéshez használjuk fel.

Sikeres csatlakozás után a Codexnek a következőhöz hasonló szervert kell azonosítania:

linknlink-skill-mcp-server

4.2 Olvassa el a régebbi adatokat

A Codex így szól:

• Az örökölt jelenetek listája
• Hagyományos jelenet részletei
• Az örökölt kapcsolatok listája
• Az örökölt kapcsolat részletei

A régebbi adatok azonosítókat és értékeket tartalmazhatnak, például:

sceneId
ruleid
végpontId
tette
gatewayDid
IR kódok
Régi eszköztulajdonságnevek

Előfordulhat, hogy ezek az azonosítók nem működnek közvetlenül az új alkalmazásban.

4.3 Olvassa el a jelenlegi család eszközeit és entitásait

A Codex felolvassa az aktuális család entitásait, például:

fény.xxxxx
éghajlat.xxxxx
bináris_érzékelő.xxxxx
esemény.xxxxx
weather.forecast_home

Az új jeleneteknek és automatizálásoknak lehetőség szerint ezeket a jelenleg elérhető entitásokat kell használniuk.

Például a régi adatok csak a következőket tartalmazhatják:

tette: 01385886d8828d16dc78ac9d74ceca8e

A megfelelő jelenlegi entitás lehet:

klíma.01385886d8828d16dc78ac9d74ceca8e

A Codexnek az aktuális entitásazonosítót kell használnia az új adatok létrehozásakor.

4.4 Jelenetek létrehozása az automatizálás előtt

Ha egy örökölt hivatkozás egy örökölt jelenetre hivatkozik, a Codexnek először létre kell hoznia a Cloud Scene-t.

Például:

Legacy scene azonosító: 3008322404328373708
Új felhőjelenet azonosító: 8845c067a6744467b8e073863f35cda6

Az automatizálásnak ezután az új Cloud Scene ID-re kell hivatkoznia a régi jelenetazonosító helyett.

4.5 Érvényesítés a létrehozás előtt

Minden elemet érvényesíteni kell a következők használatával:

validate_scene

vagy:

validate_automatation

A Codexnek csak akkor kell elmentenie az elemet, ha az érvényesítés visszatér:

érvényes: igaz

és nincsenek kritikus hibák.

5. Az áttelepítés ellenőrzése

Nyissa meg az új LinknLink App fájlt, és ellenőrizze a következő részeket.

Felhő jelenetek

Erősítse meg, hogy:

• A jelenet neve helyes.
• A megfelelő eszközt használja.
• A műveletek helyesek.
• Az olyan paraméterek, mint a hőmérséklet, az üzemmód és a ventilátor sebessége elkészültek.
• A jelenet a jelenlegi család eszközeit használja.

Felhő automatizálások

Erősítse meg, hogy:

• Az automatizálás neve helyes.
• Az automatizálás be van kapcsolva.
• A kioldási idő megfelelő.
• A hétköznapi beállítások helyesek.
• Az eszköz aktiválási feltételei megfelelőek.
• Az értesítő üzenetek helyesek.
• A hivatkozott jelenetek új felhőjelenetek.
• Az eszközműveletek az aktuális entitásazonosítókat használják.

Ne törölje azonnal a régebbi adatokat. Figyelje meg az új automatizálásokat néhány napig, és ellenőrizze, hogy megfelelően aktiválódnak-e, mielőtt eldönti, hogy eltávolítja-e a régi rekordokat.

6. Hibaelhárítás

6.1 Az IP válaszol a Ping-re, de a port lejár

A tipikus hibák a következők:

Nem sikerült csatlakozni
A kapcsolat időtúllépése lejárt

Ellenőrizze a következőket:

• Fut az AI Agent MCP szolgáltatás?
• A port be van állítva 39282?
• Fut még az App?
• A rendszer tűzfala engedélyezi a helyi hálózati hozzáférést?
• Az MCP-szolgáltatás ahelyett, hogy csak egy helyi hálózati címen figyelne? 127.0.0.1?

6.2 Az IP nem válaszol a ping-re

A gyakori okok a következők:

• Az IP-cím helytelen.
• A router IP-jét adta meg a telefon IP-címe helyett.
• A telefon IP-címe megváltozott.
• A telefon és a számítógép különböző Wi-Fi hálózatokhoz csatlakozik.
• Egy eszköz vendéghálózathoz csatlakozik.
• A VPN megváltoztatta a számítógép útválasztását.

Nyissa meg újra az AI Agent beállítási oldalát, és másolja ki az aktuálisan megjelenített IP-címet.

6.3 MCP csatlakozik, de a token érvénytelen

Nyissa meg újra az AI Agent beállítási oldalát:

1. Görgessen az oldal aljára.
2. Keresse meg az utolsó tokent.
3. Érintse meg ismét a másolás gombot.
4. Győződjön meg arról, hogy a másolt érték nem tartalmaz szóközt vagy sortörést.
5. Adja meg az új tokent a Codexnek.

6.4 A Codex azt jelenti, hogy egy eszköz nem létezik

A DID ill végpontId a régi alkalmazás által használt alkalmazás már nem irányíthatja közvetlenül az eszközt.

Kérje meg a Codexet:

• Olvassa el az aktuális eszközök és entitások listáját.
• Párosítsa az eszközöket a DID, név, szoba és eszköztípus használatával.
• Kérdezze le a jelölt entitások képességeit.
• Építse újra az elemet a jelenlegi entitásazonosítóval.
• Állítsa le az elem áttelepítését, ha nem található egyedi egyezés.

A Codex soha nem találhat ki egy bizonytalan eszközleképezést.

6.5 Az áttelepítés után duplikált adatok jelennek meg

Ez akkor fordulhat elő, ha már létezik egy megfelelő Cloud Scene vagy Cloud Automation.

Mielőtt bármit létrehozna, a Codexnek:

• Olvassa el a meglévő felhőadatokat.
• Hasonlítsa össze a neveket, az aktiválókat és a műveleteket.
• A már azonos rekordok kihagyása.
• Jelentse az egyező nevű, de eltérő tartalmú elemeket ahelyett, hogy automatikusan felülírná őket.

6.6 Az időjárási automatizálás nem költözhető át

A régi alkalmazás numerikus időjárási kódokat, míg az új alkalmazás időjárási Entitásállapotokat, például:

havas
esős
felhős
napos

Kérje meg a Codexet, hogy építse újra a triggert az áram segítségével időjárás Entitás ahelyett, hogy közvetlenül másolná a régi numerikus időjárási kódot.

7. Biztonsági ajánlások

• Kezelje a tokent MCP-hozzáférési hitelesítő adatként. Ne tegye közzé csoportos csevegésekben, fórumokon vagy nyilvános dokumentumokban.
• Ne tartalmazza a teljes Tokent az áttelepítési jelentésben.
• Ha egy tokent nyilvánosan megosztottak, az áttelepítés után hozza létre újra az alkalmazásban.
• Ne törölje a régi adatokat a kezdeti áttelepítés során.
• Ne engedje, hogy a Codex jeleneteket hajtson végre a kezdeti áttelepítés során. Ellenkező esetben előfordulhat, hogy az olyan eszközök, mint a légkondicionálók, zárak vagy lámpák váratlanul vezérlésre kerülnek.
• Manuálisan tekintse át a biztonsági szempontból érzékeny eszközöket, például zárakat, riasztórendszereket és szelepeket magában foglaló automatizálásokat, mielőtt engedélyezné őket.

Ennek a folyamatnak a követésével a Codex egyetlen munkafolyamatban tudja befejezni a csatlakozást, az adatolvasást, az eszközleképezést, az érvényesítést, a létrehozást és a végső ellenőrzést, miközben elkerüli azt a nem biztonságos gyakorlatot, hogy a régi eszközazonosítókat közvetlenül az új adatokba másolja.