Migracja starszych scen i automatyzacji LinknLink do nowej aplikacji za pomocą MCP

W tym przewodniku wyjaśniono, jak przeprowadzić migrację i przywrócić następujące dane ze starszej wersji LinknLink App:

• Sceny
• Połączenia lub automatyzacje

Dane zostaną przeniesione do następujących funkcji w nowej aplikacji:

• Sceny w chmurach
• Automatyzacja chmury

Podczas migracji Codex łączy się z usługą MCP świadczoną przez LinknLink App, odczytuje starsze dane i odbudowuje je przy użyciu urządzeń i jednostek dostępnych w bieżącej rodzinie.

Starsze dane nie są domyślnie usuwane, więc w razie potrzeby możesz je przywrócić.

1. Czego potrzebujesz przed migracją

Przygotuj następujące trzy parametry połączenia:

Token zazwyczaj wygląda następująco:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Nie używaj przykładowego Tokena w tym przewodniku. Musisz skopiować Token wyświetlony w Twojej aplikacji.

2. Upewnij się, że Codex i Twój telefon mogą się komunikować

Komputer z uruchomionym Codexem musi być w stanie połączyć się z urządzeniem, na którym działa LinknLink App.

Najprostsza konfiguracja to:

• Twój telefon i komputer są połączone z tą samą siecią Wi-Fi.
• Twój telefon nie przełączył się na komórkową transmisję danych.
• Twój komputer nie jest podłączony do sieci VPN, która izoluje sieć lokalną.
• Twój router nie ma włączonej izolacji sieci gościnnej ani izolacji klienta.

Na przykład:

IP komputera: 192.168.58.20
Adres IP MCP aplikacji: 192.168.58.121

Obydwa adresy znajdują się na 192.168.58.x podsieci, więc zazwyczaj powinny mieć możliwość bezpośredniej komunikacji.

Jeśli aplikacja wyświetla:

10.0.0.232

ale komputer używa:

192.168.58.x

oba urządzenia mogą znajdować się w różnych podsieciach. Codex może nie być w stanie nawiązać połączenia, jeśli router nie został skonfigurowany do kierowania ruchu pomiędzy tymi podsieciami.

Nie wprowadzaj adresu IP routera, adresu IP bramy ani publicznego adresu IP. Musisz użyć adresu IP usługi MCP pokazanego na stronie ustawień AI Agent.

3. Ukończ monit o migrację dla Kodeksu

Skopiuj poniższy monit do Kodeksu i zastąp adres IP, port i token własnymi wartościami.

Skorzystaj z usługi MCP świadczonej przez LinknLink App, aby 
migruj sceny i powiązania ze starszej aplikacji w bieżącej rodzinie 
do scen w chmurze i automatyzacji w chmurze w nowej aplikacji.

Szczegóły połączenia MCP:
- IP: Zastąp to adresem IP pokazanym na stronie ustawień
- Port: 39282
- Token: Zastąp go ostatnim Tokenem pokazanym na dole 
stronę ustawień agenta AI

Postępuj dokładnie według tego procesu:

1. Skonfiguruj LinknLink jako zdalny serwer strumieniowy HTTP MCP.
2. Użyj następującego punktu końcowego MCP:
   http://IP:PORT/mcp
3. Użyj dostarczonego Tokena do uwierzytelnienia Tokenem na okaziciela.
4. Uruchom uzgadnianie inicjujące MCP i przeczytaj narzędzia/listę, aby potwierdzić 
że połączenie działa.
5. Przeczytaj aktualne informacje o rodzinie.
6. Przeczytaj pełną listę urządzeń i jednostek dla bieżącej rodziny.
7. Przeczytaj możliwości i aktualny stan każdego wymaganego Podmiotu 
dla migracji.
8. Przeczytaj dane starszej sceny.
9. Przeczytaj starsze dane dotyczące połączeń lub automatyzacji.
10. Przeczytaj istniejące sceny w chmurze i automatyzacje w chmurze, aby temu zapobiec 
duplikaty.
11. Twórz mapowania na podstawie starszych identyfikatorów DID urządzeń, identyfikatorów punktów końcowych i starszych 
identyfikatory scen na bieżące identyfikatory jednostek i nowe identyfikatory scen w chmurze.
12. Nie kopiuj bezpośrednio starszych identyfikatorów urządzeń. Przebuduj działania i 
wyzwala przy użyciu identyfikatorów jednostek, które faktycznie istnieją w bieżącej rodzinie.
13. Najpierw przeprowadź migrację scen w chmurze i zapisz ich nowe identyfikatory scen w chmurze.
14. Następnie migruj Cloud Automations, które odwołują się do scen, używając 
nowe identyfikatory scen w chmurze. Jeśli serwer rozwinie scenę do Entity 
akcji, można również zastosować rozszerzone akcje oparte na bieżących Podmiotach.
15. Wywołaj valid_scene dla każdej nowej sceny.
16. Wywołaj valid_automation dla każdej nowej automatyzacji.
17. Utwórz element dopiero po przejściu walidacji.
18. Zachowaj oryginalną nazwę, godzinę, dni tygodnia, warunki wyzwalania, 
działania urządzenia, tekst powiadomienia, temperatura, tryb, prędkość wentylatora, 
i opóźnienia.
19. Jeśli starsze urządzenie już nie istnieje, nie zgaduj mapowania. 
Wymień informacje o starszych urządzeniach i możliwych kandydatach na Jednostki, 
i wyjaśnij, dlaczego elementu nie można bezpiecznie przenieść.
20. Nie usuwaj starszych scen ani starszych powiązań.
21. Nie wykonuj nowych scen ani automatyzacji, bo tak się dzieje 
mógł sterować prawdziwymi urządzeniami.
22. Po utworzeniu przeczytaj Sceny w chmurze i Automatyzacje w chmurze 
ponownie i sprawdź ich liczniki, nazwy, włączone stany, wyzwalacze, 
i działania.
23. W raporcie końcowym uwzględnij:
    - Liczba znalezionych starszych scen
    - Liczba znalezionych starszych powiązań
    - Liczba utworzonych scen chmur
    - Liczba utworzonych automatyzacji w chmurze
    - Bieżące identyfikatory jednostek używane przez każdy migrowany element
    - Wszelkie elementy, których nie można było przenieść i konkretne powody
    - Czy starsze dane zostały zachowane

Wykonaj migrację bezpośrednio. Nie podawaj jedynie instrukcji. 
Nie powtarzaj całego Tokenu w końcowej odpowiedzi.

Po uzupełnieniu szczegółów początek powinien wyglądać następująco:

Szczegóły połączenia MCP:
- IP: 192.168.58.121
- Port: 39282
- Token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Co zrobi Kodeks

4.1 Nawiąż połączenie MCP

Codex połączy się z LinknLink MCP za pomocą:

http://YOUR_IP:39282/mcp

Token będzie używany do uwierzytelnienia.

Po udanym połączeniu Codex powinien zidentyfikować serwer podobny do:

linknlink-skill-mcp-server

4.2 Przeczytaj starsze dane

Kodeks będzie czytać:

• Lista starszych scen
• Szczegóły sceny starszej
• Starsza lista powiązań
• Starsze szczegóły powiązania

Starsze dane mogą zawierać identyfikatory i wartości, takie jak:

identyfikator sceny
rządził
identyfikator punktu końcowego
zrobił
bramaZrobiłem
Kody IR
Starsze nazwy właściwości urządzeń

Te identyfikatory mogą nie działać bezpośrednio w nowej aplikacji.

4.3 Przeczytaj urządzenia i jednostki bieżącej rodziny

Kodeks odczyta Byty z bieżącej rodziny, na przykład:

światło.xxxxx
klimat.xxxxx
czujnik_binarny.xxxxx
wydarzenie.xxxxx
pogoda.prognoza_home

Nowe sceny i automatyzacje powinny wykorzystywać obecnie dostępne Byty, gdy tylko jest to możliwe.

Na przykład starsze dane mogą zawierać tylko:

zrobiłem: 01385886d8828d16dc78ac9d74ceca8e

Odpowiedni bieżący Podmiot może być:

klimat.01385886d8828d16dc78ac9d74ceca8e

Codex powinien używać bieżącego identyfikatora jednostki podczas tworzenia nowych danych.

4.4 Utwórz sceny przed automatyzacją

Jeśli starsze powiązanie odwołuje się do starszej sceny, Codex musi najpierw utworzyć Scenę w Chmurze.

Na przykład:

Identyfikator starszej sceny: 3008322404328373708
Identyfikator nowej sceny w chmurze: 8845c067a6744467b8e073863f35cda6

Automatyzacja powinna następnie odwoływać się do nowego identyfikatora sceny w chmurze zamiast do starszego identyfikatora sceny.

4.5 Sprawdź przed utworzeniem

Każdy element należy sprawdzić za pomocą:

valid_scene

lub:

valid_automation

Kodeks powinien zapisać element tylko wtedy, gdy zwróci walidację:

ważne: prawda

i nie ma żadnych błędów krytycznych.

5. Jak zweryfikować migrację

Otwórz nowy plik LinknLink App i sprawdź poniższe sekcje.

Sceny w chmurach

Potwierdź, że:

• Nazwa sceny jest prawidłowa.
• Używane jest właściwe urządzenie.
• Działania są prawidłowe.
• Parametry takie jak temperatura, tryb pracy i prędkość wentylatora są kompletne.
• Scena korzysta z urządzeń z aktualnej rodziny.

Automatyzacja chmury

Potwierdź, że:

• Nazwa automatyzacji jest prawidłowa.
• Automatyzacja jest włączona.
• Czas wyzwalania jest prawidłowy.
• Ustawienia dnia tygodnia są prawidłowe.
• Warunki wyzwalania urządzenia są prawidłowe.
• Komunikaty powiadomień są prawidłowe.
• Sceny, do których istnieją odniesienia, to nowe Sceny w Chmurze.
• Akcje urządzenia korzystają z bieżących identyfikatorów jednostek.

Nie usuwaj natychmiast starszych danych. Obserwuj nowe automatyzacje przez kilka dni i upewnij się, że uruchamiają się prawidłowo, zanim podejmiesz decyzję o usunięciu starszych rekordów.

6. Rozwiązywanie problemów

6.1 IP odpowiada na ping, ale port przekroczył limit czasu

Typowe błędy obejmują:

Nie udało się połączyć
Upłynął limit czasu połączenia

Sprawdź następujące elementy:

• Czy usługa AI Agent MCP jest uruchomiona?
• Czy port jest ustawiony na 39282?
• Czy aplikacja nadal działa?
• Czy zapora systemowa umożliwia dostęp do sieci lokalnej?
• Czy usługa MCP nasłuchuje na adresie sieci lokalnej, a nie tylko 127.0.0.1?

6.2 Adres IP nie odpowiada na polecenie Ping

Typowe przyczyny obejmują:

• Adres IP jest nieprawidłowy.
• Zamiast adresu IP telefonu wprowadzono adres IP routera.
• Adres IP telefonu uległ zmianie.
• Telefon i komputer są połączone z różnymi sieciami Wi-Fi.
• Jedno urządzenie jest podłączone do sieci gościnnej.
• VPN zmienił routing komputera.

Otwórz ponownie stronę ustawień AI Agent i skopiuj aktualnie wyświetlany adres IP.

6.3 MCP łączy się, ale token jest nieprawidłowy

Otwórz ponownie stronę ustawień AI Agent:

1. Przewiń w dół strony.
2. Znajdź ostatni żeton.
3. Ponownie dotknij przycisku kopiowania.
4. Upewnij się, że skopiowana wartość nie zawiera spacji ani podziałów wierszy.
5. Dostarcz nowy token do Codexu.

6.4 Kodeks zgłasza, że urządzenie nie istnieje

DID lub identyfikator punktu końcowego używane przez starszą aplikację, nie mogą już bezpośrednio sterować urządzeniem.

Poproś Kodeks, aby:

• Przeczytaj aktualne listy urządzeń i jednostek.
• Dopasuj urządzenia, używając DID, nazwy, pokoju i typu urządzenia.
• Zapytaj o możliwości kandydatów na Jednostki.
• Odbuduj element, używając bieżącego identyfikatora jednostki.
• Zatrzymaj migrację tego elementu, jeśli nie można znaleźć żadnego unikalnego dopasowania.

Kodeks nigdy nie powinien odgadywać niepewnego mapowania urządzeń.

6.5 Po migracji pojawiają się zduplikowane dane

Może się to zdarzyć, gdy istnieje już pasująca scena w chmurze lub automatyzacja w chmurze.

Przed stworzeniem czegokolwiek Codex powinien:

• Przeczytaj istniejące dane w chmurze.
• Porównaj nazwy, wyzwalacze i działania.
• Pomiń rekordy, które są już identyczne.
• Zgłaszaj elementy o pasujących nazwach, ale innej treści, zamiast automatycznie je nadpisywać.

6.6 Nie można migrować automatyki pogodowej

Starsza aplikacja może wykorzystywać numeryczne kody pogody, natomiast nowa aplikacja może wykorzystywać stany jednostek pogodowych, takie jak:

śnieżny
deszczowy
pochmurno
słoneczny

Poproś Codex o odbudowanie spustu przy użyciu prądu pogoda Entity zamiast bezpośredniego kopiowania starszego numerycznego kodu pogody.

7. Zalecenia dotyczące bezpieczeństwa

• Traktuj token jako dane uwierzytelniające dostępu MCP. Nie publikuj go na czatach grupowych, forach ani w dokumentach publicznych.
• Nie dołączaj całego tokenu do raportu migracji.
• Jeśli Token został udostępniony publicznie, po migracji wygeneruj go ponownie w Aplikacji.
• Nie usuwaj starszych danych podczas początkowej migracji.
• Nie zezwalaj Codexowi na uruchamianie scen podczas początkowej migracji. W przeciwnym razie urządzenia takie jak klimatyzatory, zamki lub oświetlenie mogą zostać nieoczekiwanie przejęte.
• Ręcznie przeglądaj automatyzację obejmującą urządzenia wrażliwe na bezpieczeństwo, takie jak zamki, systemy alarmowe i zawory, przed ich włączeniem.

Postępując zgodnie z tym procesem, Codex może zakończyć połączenie, odczyt danych, mapowanie urządzenia, walidację, tworzenie i ostateczną weryfikację w ramach jednego przepływu pracy, unikając jednocześnie niebezpiecznej praktyki kopiowania identyfikatorów starszych urządzeń bezpośrednio do nowych danych.