Migrer les scènes et automatisations héritées LinknLink vers la nouvelle application à l'aide de MCP

Ce guide explique comment migrer et restaurer les données suivantes à partir de l'ancien LinknLink App :

• Scènes
• Liens ou automatisations

Les données seront migrées vers les fonctionnalités suivantes dans la nouvelle application :

• Scènes de nuages
• Automatisations cloud

Pendant la migration, Codex se connecte au service MCP fourni par LinknLink App, lit les données héritées et les reconstruit à l'aide des appareils et entités disponibles dans la famille actuelle.

Les données héritées ne sont pas supprimées par défaut, vous pouvez donc les restaurer si nécessaire.

1. Ce dont vous avez besoin avant la migration

Préparez les trois paramètres de connexion suivants :

Un jeton ressemble généralement à ceci :

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

N'utilisez pas l'exemple de jeton dans ce guide. Vous devez copier le jeton affiché dans votre propre application.

2. Assurez-vous que le Codex et votre téléphone peuvent communiquer

L'ordinateur exécutant Codex doit pouvoir atteindre l'appareil exécutant LinknLink App.

La configuration la plus simple est la suivante :

• Votre téléphone et votre ordinateur sont connectés au même réseau Wi-Fi.
• Votre téléphone n'est pas passé aux données mobiles.
• Votre ordinateur n'est pas connecté à un VPN qui isole le réseau local.
• L'isolation du réseau invité ou l'isolation du client n'est pas activée sur votre routeur.

Par exemple :

IP de l'ordinateur : 192.168.58.20
IP de l’application MCP : 192.168.58.121

Les deux adresses sont sur le 192.168.58.x sous-réseau, ils devraient donc généralement pouvoir communiquer directement.

Si l'application affiche :

10.0.0.232

mais l'ordinateur utilise :

192.168.58.x

les deux appareils peuvent se trouver sur des sous-réseaux différents. Codex risque de ne pas pouvoir se connecter à moins que le routeur n'ait été configuré pour acheminer le trafic entre ces sous-réseaux.

N'entrez pas l'adresse IP du routeur, l'adresse IP de la passerelle ou une adresse IP publique. Vous devez utiliser l'adresse IP du service MCP indiquée sur la page des paramètres de l'agent AI.

3. Complétez l'invite de migration pour le Codex

Copiez l'invite suivante dans le Codex et remplacez l'adresse IP, le port et le jeton par vos propres valeurs.

Veuillez utiliser le service MCP fourni par LinknLink App pour 
migrer les scènes et les liens de l'application héritée dans la famille actuelle 
aux scènes cloud et aux automatisations cloud dans la nouvelle application.

Détails de la connexion MCP :
- IP : remplacez-le par l'adresse IP indiquée sur la page des paramètres
- Port : 39282
- Jeton : remplacez-le par le dernier jeton affiché en bas de 
la page des paramètres de l'agent AI

Suivez exactement ce processus :

1. Configurez LinknLink en tant que serveur HTTP MCP diffusable à distance.
2. Utilisez le point de terminaison MCP suivant :
   http://IP:PORT/mcp
3. Utilisez le jeton fourni pour l'authentification du jeton du porteur.
4. Exécutez la poignée de main d'initialisation MCP et lisez les outils/la liste pour confirmer 
que la connexion fonctionne.
5. Lisez les informations actuelles sur la famille.
6. Lisez les listes complètes de périphériques et d'entités pour la famille actuelle.
7. Lisez les capacités et l'état actuel de chaque entité requise 
pour la migration.
8. Lisez les données de scène héritées.
9. Lisez les données de liaison ou d'automatisation héritées.
10. Lisez les scènes cloud et les automatisations cloud existantes pour éviter 
des doublons.
11. Créez des mappages à partir des DID, des endpointIds et des anciens appareils hérités 
les ID de scène aux ID d’entité actuels et aux nouveaux ID de scène Cloud.
12. Ne copiez pas directement les anciens ID de périphérique. Reconstruire les actions et 
se déclenche à l’aide d’ID d’entité qui existent réellement dans la famille actuelle.
13. Migrez d'abord les scènes Cloud et enregistrez leurs nouveaux ID de scène Cloud.
14. Migrez ensuite les Cloud Automations qui font référence à des scènes, à l'aide de l'outil 
nouveaux ID de scène cloud. Si le serveur étend une scène en entité 
actions, les actions étendues basées sur les entités actuelles peuvent également être utilisées.
15. Appelez validate_scene pour chaque nouvelle scène.
16. Appelez validate_automation pour chaque nouvelle automatisation.
17. Créez un élément uniquement après avoir passé la validation.
18. Conservez le nom d'origine, l'heure, les jours de la semaine, les conditions de déclenchement, 
actions de l'appareil, texte de notification, température, mode, vitesse du ventilateur, 
et des retards.
19. Si un appareil existant n'existe plus, ne devinez pas le mappage. 
Répertoriez les informations sur les appareils existants et les entités candidates possibles, 
et expliquez pourquoi l'élément ne peut pas être migré en toute sécurité.
20. Ne supprimez pas les scènes ou les liens hérités.
21. N'exécutez pas les nouvelles scènes ou automatisations, car cela 
pourrait contrôler de vrais appareils.
22. Après la création, lisez les scènes cloud et les automatisations cloud 
à nouveau et vérifiez leurs comptes, noms, états activés, déclencheurs, 
et des actions.
23. Dans le rapport final, inclure :
    - Le nombre de scènes héritées trouvées
    - Le nombre de liens hérités trouvés
    - Le nombre de Cloud Scenes créées
    - Le nombre d'Automatisations Cloud créées
    - Les ID d'entité actuels utilisés par chaque élément migré
    - Tous les éléments qui n'ont pas pu être migrés et les raisons spécifiques
    - Si les données héritées ont été préservées

Effectuez la migration directement. Ne fournissez pas uniquement des instructions. 
Ne répétez pas le jeton complet dans la réponse finale.

Après avoir rempli les détails, le début devrait ressembler à ceci :

Détails de la connexion MCP :
- IP : 192.168.58.121
- Port : 39282
- Jeton : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Ce que fera le Codex

4.1 Établir la connexion MCP

Le Codex se connectera au MCP LinknLink en utilisant :

http://YOUR_IP:39282/mcp

Le jeton sera utilisé pour l'authentification.

Après une connexion réussie, Codex doit identifier un serveur similaire à :

linknlink-skill-mcp-server

4.2 Lire les données héritées

Le Codex lira :

• La liste des scènes héritées
• Détails de la scène héritée
• La liste de liens héritée
• Détails de la liaison héritée

Les données héritées peuvent contenir des identifiants et des valeurs tels que :

ID de la scène
identifiant de règle
ID du point de terminaison
fait
passerelleDid
Codes IR
Noms des propriétés des appareils hérités

Ces identifiants peuvent ne pas fonctionner directement dans la nouvelle application.

4.3 Lire les appareils et entités de la famille actuelle

Le Codex lira les entités de la famille actuelle, par exemple :

lumière.xxxxx
climat.xxxxx
capteur_binaire.xxxxx
événement.xxxxx
météo.forecast_home

Les nouvelles scènes et automatisations doivent utiliser ces entités actuellement disponibles autant que possible.

Par exemple, les données héritées peuvent contenir uniquement :

fait : 01385886d8828d16dc78ac9d74ceca8e

L'entité actuelle correspondante pourrait être :

climat.01385886d8828d16dc78ac9d74ceca8e

Le Codex doit utiliser l'ID d'entité actuel lors de la création des nouvelles données.

4.4 Créer des scènes avant les automatisations

Si un lien hérité fait référence à une scène héritée, le Codex doit d'abord créer la scène cloud.

Par exemple :

ID de scène héritée : 3008322404328373708
Nouvel ID de scène Cloud : 8845c067a6744467b8e073863f35cda6

L'automatisation doit alors faire référence au nouvel ID de scène Cloud au lieu de l'ID de scène existant.

4.5 Valider avant la création

Chaque élément doit être validé à l'aide de :

valider_scene

ou :

valider_automatisation

Le Codex ne doit enregistrer un élément que lorsque la validation revient :

valide : vrai

et il n'y a pas d'erreurs critiques.

5. Comment vérifier la migration

Ouvrez le nouveau LinknLink App et vérifiez les sections suivantes.

Scènes de nuages

Confirmez que :

• Le nom de la scène est correct.
• Le bon appareil est utilisé.
• Les actions sont correctes.
• Les paramètres tels que la température, le mode de fonctionnement et la vitesse du ventilateur sont complets.
• La scène utilise des appareils de la famille actuelle.

Automatisations cloud

Confirmez que :

• Le nom de l'automatisation est correct.
• L'automatisation est activée.
• L'heure de déclenchement est correcte.
• Les paramètres du jour de la semaine sont corrects.
• Les conditions de déclenchement de l'appareil sont correctes.
• Les messages de notification sont corrects.
• Les scènes référencées sont de nouvelles scènes Cloud.
• Les actions de l'appareil utilisent les ID d'entité actuels.

Ne supprimez pas immédiatement les données héritées. Observez les nouvelles automatisations pendant plusieurs jours et confirmez qu'elles se déclenchent correctement avant de décider de supprimer ou non les anciens enregistrements.

6. Dépannage

6.1 L'adresse IP répond au ping, mais le port expire

Les erreurs typiques incluent :

Échec de la connexion
La connexion a expiré

Vérifiez les éléments suivants :

• Le service AI Agent MCP est-il en cours d’exécution ?
• Le port est-il défini sur 39282?
• L'application est-elle toujours en cours d'exécution ?
• Le pare-feu du système autorise-t-il l'accès au réseau local ?
• Le service MCP écoute-t-il sur une adresse de réseau local au lieu de seulement 127.0.0.1?

6.2 L'adresse IP ne répond pas au ping

Les causes courantes incluent :

• L'adresse IP est incorrecte.
• L’adresse IP du routeur a été saisie à la place de l’adresse IP du téléphone.
• L'adresse IP du téléphone a changé.
• Le téléphone et l'ordinateur sont connectés à différents réseaux Wi-Fi.
• Un appareil est connecté à un réseau invité.
• Un VPN a modifié le routage de l’ordinateur.

Ouvrez à nouveau la page des paramètres de l'agent AI et copiez l'adresse IP actuellement affichée.

6.3 MCP se connecte, mais le jeton n'est pas valide

Ouvrez à nouveau la page des paramètres de l'agent AI :

1. Faites défiler vers le bas de la page.
2. Trouvez le dernier jeton.
3. Appuyez à nouveau sur le bouton Copier.
4. Assurez-vous que la valeur copiée ne contient pas d'espaces ni de sauts de ligne.
5. Fournissez le nouveau jeton au Codex.

6.4 Le Codex signale qu'un périphérique n'existe pas

Le DID ou ID du point de terminaison utilisé par l’ancienne application ne peut plus contrôler directement l’appareil.

Demandez au Codex de :

• Lisez les listes actuelles de périphériques et d’entités.
• Faites correspondre les appareils en utilisant le DID, le nom, la pièce et le type d'appareil.
• Interrogez les capacités des entités candidates.
• Reconstruisez l'élément en utilisant l'ID d'entité actuel.
• Arrêtez de migrer cet élément si aucune correspondance unique ne peut être trouvée.

Le Codex ne devrait jamais deviner un mappage de périphérique incertain.

6.5 Des données en double apparaissent après la migration

Cela peut se produire lorsqu'une scène cloud ou une automatisation cloud correspondante existe déjà.

Avant de créer quoi que ce soit, le Codex doit :

• Lisez les données cloud existantes.
• Comparez les noms, les déclencheurs et les actions.
• Ignorer les enregistrements déjà identiques.
• Signalez les éléments dont les noms correspondent mais dont le contenu est différent au lieu de les écraser automatiquement.

6.6 Les automatisations météorologiques ne peuvent pas être migrées

L'ancienne application peut utiliser des codes météorologiques numériques, tandis que la nouvelle application peut utiliser des états d'entité météo tels que :

enneigé
pluvieux
nuageux
ensoleillé

Demandez au Codex de reconstruire le déclencheur en utilisant le courant météo Entité au lieu de copier directement l’ancien code météo numérique.

7. Recommandations de sécurité

• Traitez le jeton comme un identifiant d'accès MCP. Ne le publiez pas dans des discussions de groupe, des forums ou des documents publics.
• N'incluez pas le jeton complet dans le rapport de migration.
• Si un jeton a été partagé publiquement, régénérez-le dans l'application après la migration.
• Ne supprimez pas les données héritées lors de la migration initiale.
• N'autorisez pas Codex à exécuter des scènes lors de la migration initiale. Sinon, des appareils tels que les climatiseurs, les serrures ou les lumières pourraient être contrôlés de manière inattendue.
• Examinez manuellement les automatisations impliquant des dispositifs sensibles à la sécurité, tels que les serrures, les systèmes d'alarme et les vannes, avant de les activer.

En suivant ce processus, Codex peut effectuer la connexion, la lecture des données, le mappage des appareils, la validation, la création et la vérification finale dans un seul flux de travail tout en évitant la pratique dangereuse consistant à copier les anciens identifiants des appareils directement dans les nouvelles données.