Migrace starších scén a automatizací LinknLink do nové aplikace pomocí MCP

Tato příručka vysvětluje, jak migrovat a obnovit následující data ze starší verze LinknLink App:

• Scény
• Vazby nebo automatizace

Data budou migrována do následujících funkcí v nové aplikaci:

• Cloudové scény
• Cloudové automatizace

Během migrace se Codex připojí ke službě MCP poskytované LinknLink App, načte starší data a znovu je sestaví pomocí zařízení a entit dostupných v aktuální rodině.

Starší data se ve výchozím nastavení neodstraňují, takže se v případě potřeby můžete vrátit zpět.

1. Co potřebujete před migrací

Připravte si následující tři parametry připojení:

Token obvykle vypadá takto:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Nepoužívejte vzorový token v této příručce. Musíte zkopírovat token zobrazený ve vaší vlastní aplikaci.

2. Ujistěte se, že Codex a váš telefon mohou komunikovat

Počítač, na kterém běží Codex, musí být schopen dosáhnout zařízení s LinknLink App.

Nejjednodušší nastavení je:

• Váš telefon a počítač jsou připojeny ke stejné síti Wi-Fi.
• Váš telefon se nepřepnul na mobilní data.
• Váš počítač není připojen k síti VPN, která izoluje místní síť.
• Váš router nemá povolenou izolaci sítě hosta nebo izolaci klienta.

Například:

IP počítače: 192.168.58.20
IP aplikace MCP: 192.168.58.121

Obě adresy jsou na 192.168.58.x podsítě, takže by obvykle měli být schopni komunikovat přímo.

Pokud aplikace zobrazuje:

10.0.0.232

ale počítač používá:

192.168.58.x

tato dvě zařízení mohou být v různých podsítích. Codex nemusí být schopen se připojit, pokud router nebyl nakonfigurován tak, aby směroval provoz mezi těmito podsítěmi.

Nezadávejte IP adresu routeru, IP bránu ani veřejnou IP adresu. Musíte použít adresu IP služby MCP zobrazenou na stránce nastavení agenta AI.

3. Dokončete výzvu k migraci pro Codex

Zkopírujte následující výzvu do Codexu a nahraďte IP adresu, port a Token svými vlastními hodnotami.

Použijte prosím službu MCP poskytovanou LinknLink App k 
migrujte scény a propojení starší aplikace v aktuální rodině 
do cloudových scén a cloudových automatizací v nové aplikaci.

Podrobnosti o připojení MCP:
- IP: Nahraďte ji IP uvedenou na stránce nastavení
- Port: 39282
- Žeton: Nahraďte jej posledním žetonem zobrazeným v dolní části 
stránku nastavení agenta AI

Postupujte přesně podle tohoto postupu:

1. Nakonfigurujte LinknLink jako vzdálený streamovatelný HTTP MCP server.
2. Použijte následující koncový bod MCP:
   http://IP:PORT/mcp
3. Použijte poskytnutý token pro ověření tokenu nosiče.
4. Spusťte inicializační handshake MCP a pro potvrzení si přečtěte nástroje/seznam 
že spojení funguje.
5. Přečtěte si aktuální informace o rodině.
6. Přečtěte si úplný seznam zařízení a entit pro aktuální rodinu.
7. Přečtěte si možnosti a aktuální stav každé požadované entity 
za migraci.
8. Přečtěte si data starší scény.
9. Přečtěte si starší data propojení nebo automatizace.
10. Přečtěte si stávající cloudové scény a cloudové automatizace, abyste tomu zabránili 
duplikáty.
11. Vytvářejte mapování ze starších ID zařízení, ID koncových bodů a starších zařízení 
ID scén na aktuální ID entit a nová ID cloudových scén.
12. Nekopírujte přímo ID starších zařízení. Obnovit akce a 
spouští pomocí ID entit, která skutečně existují v aktuální rodině.
13. Nejprve proveďte migraci cloudových scén a zaznamenejte jejich nová ID cloudových scén.
14. Poté migrujte Cloud Automations, které odkazují na scény, pomocí 
nová ID cloudových scén. Pokud server rozbalí scénu na Entity 
akce, lze také použít rozšířené akce založené na aktuálních entitách.
15. Volejte validate_scene pro každou novou scénu.
16. Volejte validate_automation pro každou novou automatizaci.
17. Vytvořte položku až poté, co projde ověřením.
18. Zachovejte původní název, čas, dny v týdnu, spouštěcí podmínky, 
akce zařízení, text upozornění, teplota, režim, rychlost ventilátoru, 
a zpoždění.
19. Pokud starší zařízení již neexistuje, nehádejte mapování. 
Uveďte informace o starším zařízení a možné kandidáty na entity, 
a vysvětlete, proč nelze položku bezpečně migrovat.
20. Neodstraňujte starší scény ani starší vazby.
21. Nespouštějte nové scény nebo automatizaci, protože tak činíte 
mohl ovládat skutečná zařízení.
22. Po vytvoření si přečtěte Cloud Scenes a Cloud Automations 
znovu a ověřte jejich počty, názvy, povolené stavy, spouštěče, 
a akce.
23. V závěrečné zprávě uveďte:
    - Počet nalezených starších scén
    - Počet nalezených starších propojení
    - Počet vytvořených cloudových scén
    - Počet vytvořených cloudových automatizací
    - Aktuální ID entit používaná každou migrovanou položkou
    - Všechny položky, které nebylo možné migrovat, a konkrétní důvody
    - Zda byla zachována starší data

Proveďte migraci přímo. Neposkytujte pouze pokyny. 
V závěrečné odpovědi neopakujte celý Token.

Po vyplnění údajů by začátek měl vypadat takto:

Podrobnosti o připojení MCP:
- IP: 192.168.58.121
- Port: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Co Codex udělá

4.1 Vytvořte připojení MCP

Codex se připojí k LinknLink MCP pomocí:

http://YOUR_IP:39282/mcp

Token bude použit pro autentizaci.

Po úspěšném připojení by měl Codex identifikovat server podobný:

linknlink-skill-mcp-server

4.2 Přečtěte si starší data

Kodex bude znít:

• Seznam starších scén
• Podrobnosti starší scény
• Seznam starších odkazů
• Podrobnosti staršího propojení

Starší data mohou obsahovat identifikátory a hodnoty, jako jsou:

sceneId
ruleid
endpointId
udělal
bránaDid
Kódy IR
Názvy vlastností starších zařízení

Tyto identifikátory nemusí fungovat přímo v nové aplikaci.

4.3 Přečtěte si zařízení a entity aktuální rodiny

Codex bude číst Entity v aktuální rodině, například:

světlo.xxxxx
klima.xxxxx
binární_senzor.xxxxx
událost.xxxxx
weather.forecast_home

Nové scény a automatizace by měly používat tyto aktuálně dostupné entity, kdykoli je to možné.

Starší data mohou například obsahovat pouze:

udělal: 01385886d8828d16dc78ac9d74ceca8e

Odpovídající aktuální entita může být:

klima.01385886d8828d16dc78ac9d74ceca8e

Codex by měl při vytváření nových dat použít aktuální ID entity.

4.4 Vytvořit scény před automatizacemi

Pokud odkaz na starší scénu odkazuje na starší scénu, musí Codex nejprve vytvořit cloudovou scénu.

Například:

ID starší scény: 3008322404328373708
ID nové cloudové scény: 8845c067a6744467b8e073863f35cda6

Automatizace by pak měla odkazovat na nové ID cloudové scény namísto ID starší scény.

4.5 Ověřit před vytvořením

Každá položka by měla být ověřena pomocí:

ověřit_scénu

nebo:

validate_automation

Codex by měl uložit položku pouze tehdy, když se validace vrátí:

platný: pravda

a nejsou tam žádné kritické chyby.

5. Jak ověřit migraci

Otevřete nový LinknLink App a zkontrolujte následující části.

Cloudové scény

Potvrďte, že:

• Název scény je správný.
• Je použito správné zařízení.
• Akce jsou správné.
• Parametry jako teplota, provozní režim a rychlost ventilátoru jsou kompletní.
• Scéna využívá zařízení ze současné rodiny.

Cloudové automatizace

Potvrďte, že:

• Název automatizace je správný.
• Automatizace je povolena.
• Čas spuštění je správný.
• Nastavení dne v týdnu je správné.
• Podmínky spouštění zařízení jsou správné.
• Oznamovací zprávy jsou správné.
• Referenční scény jsou nové Cloud Scenes.
• Akce zařízení používají aktuální ID entit.

Nemažte starší data okamžitě. Pozorujte nové automatizace několik dní a ověřte, že se spouštějí správně, než se rozhodnete, zda odstranit starší záznamy.

6. Odstraňování problémů

6.1 IP reaguje na ping, ale port vyprší

Mezi typické chyby patří:

Připojení se nezdařilo
Vypršel časový limit připojení

Zkontrolujte následující:

• Je služba AI Agent MCP spuštěna?
• Je port nastaven na 39282?
• Je aplikace stále spuštěna?
• Umožňuje systémový firewall přístup k místní síti?
• Naslouchá služba MCP pouze na místní síťové adrese 127.0.0.1?

6.2 IP nereaguje na ping

Mezi běžné příčiny patří:

• Adresa IP je nesprávná.
• Místo IP telefonu byla zadána IP adresa routeru.
• IP adresa telefonu se změnila.
• Telefon a počítač jsou připojeny k různým sítím Wi-Fi.
• Jedno zařízení je připojeno k síti pro hosty.
• VPN změnila směrování počítače.

Znovu otevřete stránku nastavení AI Agent a zkopírujte aktuálně zobrazenou IP adresu.

6.3 MCP se připojí, ale token je neplatný

Znovu otevřete stránku nastavení AI Agent:

1. Přejděte na konec stránky.
2. Najděte poslední žeton.
3. Klepněte znovu na tlačítko kopírování.
4. Ujistěte se, že zkopírovaná hodnota neobsahuje mezery ani zalomení řádků.
5. Poskytněte nový token Codexu.

6.4 Codex hlásí, že zařízení neexistuje

DID resp endpointId používané starší aplikací již nemusí přímo ovládat zařízení.

Požádejte Codex, aby:

• Přečtěte si aktuální seznam zařízení a entit.
• Přiřaďte zařízení pomocí DID, názvu, místnosti a typu zařízení.
• Dotaz na schopnosti kandidátských entit.
• Znovu vytvořte položku pomocí aktuálního ID entity.
• Pokud nelze nalézt žádnou jedinečnou shodu, zastavte migraci této položky.

Codex by nikdy neměl uhodnout nejisté mapování zařízení.

6.5 Po migraci se objeví duplicitní data

K tomu může dojít, když již existuje odpovídající cloudová scéna nebo cloudová automatizace.

Před vytvořením čehokoli by měl Codex:

• Přečtěte si existující cloudová data.
• Porovnejte jména, spouštěče a akce.
• Přeskočte záznamy, které jsou již totožné.
• Hlásit položky se shodnými názvy, ale odlišným obsahem, místo toho, aby je automaticky přepisovaly.

6.6 Automatizace počasí nelze migrovat

Starší aplikace může používat číselné kódy počasí, zatímco nová aplikace může používat stavy entit počasí, jako jsou:

zasněžené
deštivý
zataženo
slunečno

Požádejte Codex, aby znovu sestavil spoušť pomocí proudu počasí Entita místo přímého kopírování původního číselného kódu počasí.

7. Bezpečnostní doporučení

• Zacházejte s tokenem jako s pověřením pro přístup k MCP. Nezveřejňujte je ve skupinových chatech, fórech nebo veřejných dokumentech.
• Do zprávy o migraci nezahrnujte celý token.
• Pokud byl token sdílen veřejně, po migraci jej znovu vygenerujte v aplikaci.
• Během počáteční migrace nemažte starší data.
• Nedovolte, aby Codex spouštěl scény během počáteční migrace. V opačném případě může dojít k neočekávanému ovládání zařízení, jako jsou klimatizace, zámky nebo světla.
• Před aktivací automatizace, která zahrnuje zařízení citlivá na zabezpečení, jako jsou zámky, poplašné systémy a ventily, ručně zkontrolujte.

Dodržováním tohoto procesu může Codex dokončit připojení, čtení dat, mapování zařízení, ověření, vytvoření a konečné ověření v jediném pracovním postupu, přičemž se vyhne nebezpečné praxi kopírování ID starších zařízení přímo do nových dat.