Migrați vechiul LinknLink Scene și automatizări la noua aplicație folosind MCP

Acest ghid explică cum să migrați și să restaurați următoarele date din vechiul LinknLink App:

• Scene
• Legături sau automatizări

Datele vor fi migrate la următoarele caracteristici în noua aplicație:

• Scene de nor
• Automatizări în cloud

În timpul migrării, Codex se conectează la serviciul MCP furnizat de LinknLink App, citește datele moștenite și le reconstruiește folosind dispozitivele și entitățile disponibile în familia actuală.

Datele vechi nu sunt șterse în mod prestabilit, așa că puteți derula înapoi dacă este necesar.

1. De ce aveți nevoie înainte de migrare

Pregătiți următorii trei parametri de conectare:

Un token de obicei arată astfel:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Nu utilizați exemplul Token în acest ghid. Trebuie să copiați Token-ul afișat în propria aplicație.

2. Asigurați-vă că Codexul și telefonul dvs. pot comunica

Computerul care rulează Codex trebuie să poată ajunge la dispozitivul care rulează LinknLink App.

Cea mai simplă configurare este:

• Telefonul și computerul dvs. sunt conectate la aceeași rețea Wi-Fi.
• Telefonul dvs. nu a trecut la date mobile.
• Computerul dvs. nu este conectat la un VPN care izolează rețeaua locală.
• Routerul dvs. nu are izolarea rețelei pentru oaspeți sau izolarea clientului activată.

De exemplu:

IP computer: 192.168.58.20
IP MCP aplicație: 192.168.58.121

Ambele adrese sunt pe 192.168.58.x subrețea, așa că de obicei ar trebui să poată comunica direct.

Dacă aplicația afișează:

10.0.0.232

dar computerul folosește:

192.168.58.x

cele două dispozitive pot fi pe subrețele diferite. Codex ar putea să nu se poată conecta decât dacă routerul a fost configurat să direcționeze traficul între acele subrețele.

Nu introduceți IP-ul routerului, IP-ul gateway-ului sau o adresă IP publică. Trebuie să utilizați IP-ul serviciului MCP afișat pe pagina de setări a agentului AI.

3. Completați solicitarea de migrare pentru Codex

Copiați următorul prompt în Codex și înlocuiți adresa IP, portul și Tokenul cu propriile valori.

Vă rugăm să utilizați serviciul MCP oferit de LinknLink App pentru a 
migrați scenele și legăturile aplicației moștenite în familia actuală 
la Cloud Scenes și Cloud Automations în noua aplicație.

Detalii conexiuni MCP:
- IP: Înlocuiți-l cu IP-ul afișat pe pagina de setări
- Port: 39282
- Token: Înlocuiește-l cu ultimul Token afișat în partea de jos a 
pagina de setări AI Agent

Urmați exact acest proces:

1. Configurați LinknLink ca server MCP HTTP Streamable la distanță.
2. Utilizați următorul punct final MCP:
   http://IP:PORT/mcp
3. Utilizați Tokenul furnizat pentru autentificarea Bearer Token.
4. Rulați MCP initialize handshake și citiți instrumentele/lista pentru a confirma 
că conexiunea funcționează.
5. Citiți informațiile actuale despre familie.
6. Citiți lista completă de dispozitive și entități pentru familia curentă.
7. Citiți capabilitățile și starea curentă a fiecărei Entități necesare 
pentru migrație.
8. Citiți datele vechi ale scenei.
9. Citiți legăturile vechi sau datele de automatizare.
10. Citiți Scenele Cloud și Automatizările Cloud existente pentru a preveni 
duplicate.
11. Creați mapări din DID-uri vechi ale dispozitivelor, endpointId-uri și vechi 
ID-urile de scenă la ID-urile de entitate curente și la ID-urile de scenă în cloud noi.
12. Nu copiați direct ID-urile dispozitivelor vechi. Reconstruiți acțiuni și 
declanșează folosind ID-uri de entitate care există de fapt în familia curentă.
13. Migrați mai întâi Cloud Scenes și înregistrați noile lor ID-uri Cloud Scene.
14. Apoi migrați Cloud Automations care fac referire la scene, folosind 
ID-uri noi pentru Scenă Cloud. Dacă serverul extinde o scenă în Entity 
acțiunile, acțiunile extinse bazate pe Entitățile curente pot fi, de asemenea, utilizate.
15. Apelați validate_scene pentru fiecare scenă nouă.
16. Apelați validate_automation pentru fiecare automatizare nouă.
17. Creați un articol numai după ce trece validarea.
18. Păstrați numele original, ora, zilele lucrătoare, condițiile de declanșare, 
acțiuni ale dispozitivului, text de notificare, temperatură, mod, viteza ventilatorului, 
si intarzieri.
19. Dacă un dispozitiv vechi nu mai există, nu ghiciți maparea. 
Listați informațiile despre dispozitivul moștenit și posibilii candidați de entitate, 
și explicați de ce elementul nu poate fi migrat în siguranță.
20. Nu ștergeți scenele vechi sau legăturile vechi.
21. Nu executați noile scene sau automatizări, deoarece procedând astfel 
putea controla dispozitive reale.
22. După creare, citiți Cloud Scenes și Cloud Automations 
din nou și verificați numărul lor, numele, stările activate, declanșatoarele, 
și acțiuni.
23. În raportul final, includeți:
    - Numărul de scene vechi găsite
    - Numărul de legături vechi găsite
    - Numărul de Scene Cloud create
    - Numărul de automatizări cloud create
    - ID-urile de entitate curente utilizate de fiecare articol migrat
    - Orice elemente care nu au putut fi migrate și motivele specifice
    - Dacă datele moștenite au fost păstrate

Efectuați direct migrarea. Nu furnizați numai instrucțiuni. 
Nu repetați tokenul complet în răspunsul final.

După completarea detaliilor, începutul ar trebui să arate astfel:

Detalii conexiuni MCP:
- IP: 192.168.58.121
- Port: 39282
- Indicativ: xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Ce va face Codexul

4.1 Stabiliți conexiunea MCP

Codex se va conecta la LinknLink MCP folosind:

http://YOUR_IP:39282/mcp

Tokenul va fi folosit pentru autentificare.

După o conexiune reușită, Codex ar trebui să identifice un server similar cu:

linknlink-skill-mcp-server

4.2 Citiți datele moștenite

Codexul va citi:

• Lista de scene moștenite
• Detalii despre scena moștenirii
• Lista de legături moștenite
• Detalii legate de moștenire

Datele moștenite pot conține identificatori și valori precum:

sceneId
ruleid
endpointId
a făcut
gatewayDid
coduri IR
Nume vechi ale proprietăților dispozitivelor

Este posibil ca acești identificatori să nu funcționeze direct în noua aplicație.

4.3 Citiți dispozitivele și entitățile familiei curente

Codex va citi Entitățile din familia actuală, de exemplu:

lumina.xxxxx
clima.xxxxx
senzor_binar.xxxxx
eveniment.xxxxx
weather.forecast_home

Noile scene și automatizări ar trebui să utilizeze aceste Entități disponibile în prezent ori de câte ori este posibil.

De exemplu, datele moștenite pot conține numai:

a făcut: 01385886d8828d16dc78ac9d74ceca8e

Entitatea actuală corespunzătoare ar putea fi:

clima.01385886d8828d16dc78ac9d74ceca8e

Codex ar trebui să folosească ID-ul de entitate curent atunci când creează noile date.

4.4 Creați scene înainte de automatizări

Dacă o legătură moștenită face referire la o scenă moștenită, Codex trebuie să creeze mai întâi scena Cloud.

De exemplu:

ID scena moștenire: 3008322404328373708
ID nou scenă în nor: 8845c067a6744467b8e073863f35cda6

Automatizarea ar trebui apoi să facă referire la noul ID Scenă Cloud în loc de ID-ul scenei vechi.

4.5 Validați înainte de creare

Fiecare articol trebuie validat folosind:

validate_scene

sau:

validate_automation

Codex ar trebui să salveze un articol numai atunci când validarea revine:

valabil: adevărat

și nu există erori critice.

5. Cum se verifică migrarea

Deschideți noul LinknLink App și verificați următoarele secțiuni.

Scene de nor

Confirmați că:

• Numele scenei este corect.
• Este folosit dispozitivul corect.
• Acțiunile sunt corecte.
• Parametri precum temperatura, modul de funcționare și viteza ventilatorului sunt complet.
• Scena folosește dispozitive din familia actuală.

Automatizări în cloud

Confirmați că:

• Numele automatizării este corect.
• Automatizarea este activată.
• Timpul de declanșare este corect.
• Setările pentru ziua săptămânii sunt corecte.
• Condițiile de declanșare a dispozitivului sunt corecte.
• Mesajele de notificare sunt corecte.
• Scenele la care se face referire sunt noi Scene Cloud.
• Acțiunile dispozitivului folosesc ID-urile de entitate curente.

Nu ștergeți imediat datele moștenite. Observați noile automatizări timp de câteva zile și confirmați că acestea se declanșează corect înainte de a decide dacă să eliminați înregistrările moștenite.

6. Depanare

6.1 IP-ul răspunde la ping, dar portul expiră

Erorile tipice includ:

Nu s-a putut conecta
Conexiunea a expirat

Verificați următoarele:

• Funcționează serviciul AI Agent MCP?
• Este portul setat la 39282?
• Mai rulează aplicația?
• Firewall-ul sistemului permite accesul la rețeaua locală?
• Serviciul MCP ascultă pe o adresă de rețea locală în loc de numai 127.0.0.1?

6.2 IP-ul nu răspunde la Ping

Cauzele comune includ:

• Adresa IP este incorectă.
• A fost introdus IP-ul routerului în locul IP-ului telefonului.
• Adresa IP a telefonului s-a schimbat.
• Telefonul și computerul sunt conectate la diferite rețele Wi-Fi.
• Un dispozitiv este conectat la o rețea pentru invitați.
• Un VPN a schimbat rutarea computerului.

Deschideți din nou pagina de setări AI Agent și copiați adresa IP afișată în prezent.

6.3 MCP se conectează, dar jetonul este invalid

Deschideți din nou pagina de setări AI Agent:

1. Derulați până în partea de jos a paginii.
2. Găsiți ultimul Token.
3. Atingeți din nou butonul de copiere.
4. Asigurați-vă că valoarea copiată nu conține spații sau întreruperi de linie.
5. Furnizați noul Token către Codex.

6.4 Codex raportează că un dispozitiv nu există

DID sau endpointId Este posibil ca aplicația veche utilizată să nu mai controleze direct dispozitivul.

Solicitați Codex să:

• Citiți dispozitivul curent și listele de entități.
• Potriviți dispozitivele folosind DID, numele, camera și tipul de dispozitiv.
• Interogați capacitățile entităților candidate.
• Reconstruiți elementul folosind ID-ul de entitate curent.
• Opriți migrarea acelui articol dacă nu poate fi găsită nicio potrivire unică.

Codex nu ar trebui să ghicească niciodată o mapare incertă a dispozitivului.

6.5 Datele duplicate apar după migrare

Acest lucru se poate întâmpla atunci când există deja o Scenă Cloud sau Automatizare Cloud care se potrivește.

Înainte de a crea orice, Codex ar trebui:

• Citiți datele existente din cloud.
• Comparați numele, declanșatoarele și acțiunile.
• Omiteți înregistrările care sunt deja identice.
• Raportați articole cu nume care se potrivesc, dar conținut diferit, în loc să le suprascrieți automat.

6.6 Automatizările meteo nu pot fi migrate

Aplicația moștenită poate folosi coduri meteo numerice, în timp ce noua aplicație poate folosi stări ale Entității meteo, cum ar fi:

înzăpezit
ploios
înnorat
însorită

Cereți Codexului să reconstruiască declanșatorul folosind curentul vremea Entitate în loc să copieze direct codul meteo numeric moștenit.

7. Recomandări de securitate

• Tratați Tokenul ca pe o acreditări de acces MCP. Nu-l publica în chat-uri de grup, forumuri sau documente publice.
• Nu includeți Tokenul complet în raportul de migrare.
• Dacă un Token a fost partajat public, regenerează-l în aplicație după migrare.
• Nu ștergeți datele vechi în timpul migrării inițiale.
• Nu permiteți Codex să execute scene în timpul migrării inițiale. În caz contrar, dispozitivele precum aparatele de aer condiționat, încuietorile sau luminile ar putea fi controlate în mod neașteptat.
• Examinați manual automatizările care implică dispozitive sensibile la securitate, cum ar fi încuietori, sisteme de alarmă și supape înainte de a le activa.

Urmând acest proces, Codex poate finaliza conexiunea, citirea datelor, maparea dispozitivului, validarea, crearea și verificarea finală într-un singur flux de lucru, evitând în același timp practica nesigură de a copia ID-urile dispozitivelor vechi direct în noile date.