For the complete documentation index, see llms.txt. This page is also available as Markdown.

Construire avec l’assistant

Confiez les tâches de configuration à l’assistant IA de Kilo IoT — intégrez des appareils, déployez des règles avec leur CEL et configurez des alarmes.

L’assistant peut configurer Kilo pour vous, et pas seulement répondre à des questions. Décrivez le résultat souhaité en langage simple et il peut intégrer des appareils, créer des règles, configurer des alarmes et exécuter des commandes d’appareil existantes dans la limite de vos autorisations. Cette page explique ce qu’il peut modifier et ce que vous devez fournir.

Comment fonctionne l’exécution

Quand vous demandez à l’assistant de mettre quelque chose en place, il ne vous remet pas une liste de contrôle à suivre. Il effectue la tâche en utilisant les opérations réelles de la plateforme, en votre nom et dans la limite de vos autorisations, puis relit le résultat pour confirmer que cela a fonctionné. Deux principes régissent chaque action :

  • Vous approuvez les changements ayant des conséquences. Avant toute action destructrice ou difficile à annuler — suppression d’un appareil ou d’une règle, résolution d’une alarme — l’assistant marque une pause et affiche une confirmation avec Confirmer l’action et Annuler. Lorsqu’il a besoin d’une décision ou d’un détail manquant en cours de tâche, il le demande à l’aide d’une invite structurée plutôt que de deviner.

  • Il vérifie son propre travail. Après avoir effectué un changement, il relit à nouveau l’objet concerné afin de pouvoir vous indiquer ce qui existe réellement maintenant, et pas seulement ce qu’il avait l’intention de faire.

Intégrer un appareil

Décrivez l’appareil que vous voulez ajouter et l’assistant lance avec vous le flux d’intégration — en choisissant le connecteur, en nommant l’appareil, en capturant les identifiants et en sélectionnant le bon profil. Pour un appareil LoRaWAN, si vous fournissez le DevEUI et AppKey à l’avance, il peut terminer automatiquement la configuration puis exécuter des diagnostics pour confirmer que l’appareil transmet bien des données. Il intègre des appareils MQTT et des traceurs de la même manière.

Terminaux MIOTY

L’assistant peut mettre en service un terminal MIOTY sur une connexion MIOTY existante et y associer un modèlecompatible, afin que sa charge utile soit décodée en relevés nommés.

Avant de commencer, créez la connexion MIOTY qui transportera le terminal. Fournissez ensuite les informations du terminal avec l’appareil :

  • EUI — l’identifiant hexadécimal à 16 caractères de l’appareil

  • Clé de session réseau — le secret hexadécimal à 32 caractères utilisé pour sécuriser la communication

  • Adresse courte

  • Classe du terminalZ pour un terminal en liaison montante uniquement ou A pour un terminal bidirectionnel ; Kilo utilise Z lorsque vous l’omettez

  • Clé d’application, si le terminal en utilise une

Indiquez à l’assistant ce que vous ajoutez, quelle connexion MIOTY existante il doit utiliser et où l’appareil doit être placé. Il recherche le fabricant, le modèle et les versions de plan disponibles à la fois dans le catalogue Système et dans le catalogue personnalisé de votre organisation. S’il existe plus d’une correspondance possible, il vous demande de choisir. Il valide ensuite les détails du terminal, résout le Type EUI du modèle et enregistre le terminal. Sélectionnez un plan de ce modèle lorsque sa charge utile doit être décodée ; un plan est facultatif lorsqu’aucun décodeur n’est requis.

"Enregistrez le compteur d’eau MIOTY dans l’usine 2. Son EUI est 70B3D5..., sa clé de session réseau est ..., son adresse courte est 0042 et c’est un terminal de classe Z."

"Ajoutez le nouveau capteur de CO2 dans le laboratoire 2. DevEUI 24E124..., AppKey ..." L’assistant provisionne l’appareil, l’associe et vérifie si des données arrivent — en le signalant si l’appareil reste silencieux.

Le résultat est un terminal enregistré. Lorsque vous sélectionnez un plan, ses relevés utilisent les noms de champs définis par ce plan. L’assistant n’invente ni identifiants ni clés manquants ; il demande toute valeur requise que vous n’avez pas fournie.

An assistant session working through a request, showing each tool it called and the alarm definition it created

Créer et déployer une automatisation

C’est la fonctionnalité la plus puissante de l’assistant. Décrivez le comportement souhaité en langage simple, et il rédige la règle complète — y compris les CEL expressions — la construit, la teste et la déploie.

"Alertez l’ingénieur de permanence si n’importe quel congélateur de Cold Storage A reste au-dessus de −18 °C pendant plus de dix minutes." L’assistant conçoit la logique de la règle, écrit la condition sous forme d’expression CEL, la simule avec une valeur correspondante et une valeur non correspondante pour prouver qu’elle se déclenche correctement, puis la déploie — en vous montrant chaque étape.

Comme il simule avant d’annoncer le succès, vous ne faites pas confiance à une boîte noire : vous voyez la règle se déclencher dans le cas qui doit correspondre et rester muette dans le cas qui ne doit pas correspondre. À partir de là, vous pouvez l’affiner de manière conversationnelle (« passez à quinze minutes », « avertissez aussi le responsable du site ») et l’assistant la met à jour puis la redéploie.

Pour en savoir plus sur le moteur de règles lui-même, voir Moteur de règles. L’assistant est un moyen rapide de produire un premier jet correct — ou une règle terminée — sans construire le canevas à la main.

Configurer des alarmes et des accès

  • Alarmes — Demandez-lui de créer une définition d’alarme avec une gravité et une chaîne d’escalade, et il configure les destinataires, les canaux et les étapes. Il peut également résoudre un événement d’alarme (avec votre confirmation) lorsque vous lui indiquez que la situation est maîtrisée.

  • Équipe — Il peut inviter un utilisateur et lui attribuer un rôle, de sorte que l’intégration d’un nouvel opérateur ou sous-traitant tienne en une phrase plutôt qu’en une succession d’écrans.

  • Matériel — Demandez quel capteur convient à un objectif et il recommande des options compatibles issues du catalogue partenaire et des références actuelles, afin que vous choisissiez du matériel réel et adapté plutôt qu’une liste générique.

Exécuter une commande d’appareil

L’assistant peut faire fonctionner votre équipement, et pas seulement le décrire. Demandez ce qu’un appareil peut faire et il liste les commandes configurées dessus ; demandez-lui d’en exécuter une et il l’exécute — après vous avoir montré ce qu’il s’apprête à envoyer et en attendant votre confirmation.

"Quelles commandes sont disponibles sur le contrôleur de la chambre froide ?" "Réglez son intervalle de remontée à cinq minutes." L’assistant liste les commandes de l’appareil, affiche les paramètres qu’il utilisera, vous demande de confirmer, l’envoie, puis indique s’il a été transmis.

Trois choses régissent cela, et ce sont elles qui permettent de confier un bâtiment à une IA en toute sécurité :

  • Il exécute des commandes qui existent déjà. Les commandes sont définies une seule fois dans l’onglet Commandes et états , avec des paramètres typés et une vérification facultative. L’assistant exécute ces définitions — il n’en invente pas de nouvelles et n’improvise pas une charge utile.

  • Il demande toujours d’abord. L’exécution des commandes a de réels effets physiques, donc chacune passe par une confirmation explicite.

  • Il vérifie le résultat. La transmission est asynchrone, donc après l’envoi, l’assistant indique l’état d’exécution plutôt que de supposer le succès. L’appareil doit aussi être en ligne pour recevoir la commande.

Cela s’applique aux appareils qui peuvent recevoir des downlinks dès le départ — appareils MQTT, appareils LoRaWAN de classe C et appareils émulés avec Prendre en charge les commandes activé. Un capteur LoRaWAN de classe A n’ouvre qu’une brève fenêtre de réception après chaque uplink, il n’est donc pas disponible pour un contrôle à la demande. Voir Commandes d’appareil.

Configurer une passerelle

Demandez à l’assistant d’ajouter une passerelle et il s’occupe de la partie plateforme pour vous — en l’enregistrant et en produisant les détails de connexion nécessaires au matériel. Il vous indique ensuite exactement quoi saisir sur la passerelle elle-même, puisque cette dernière étape se fait dans la configuration propre de la passerelle et non dans Kilo.

Piloter l’émulateur

L’assistant peut exécuter tout le appareil émulé flux de travail en conversation : lister les préréglages d’appareil disponibles, provisionner un appareil à partir d’un préréglage ou des métriques que vous décrivez, lire et modifier sa configuration et son intervalle de remontée, et envoyer une mesure ponctuelle pour tester une règle. Il peut aussi mettre l’appareil en service sur une vraie LoRaWAN connexion lorsque le matériel arrive, et déplacer un appareil réel vers l’Émulateur pour reproduire quelque chose. Les autres types de connecteur nécessitent un basculement manuel dans l’onglet Connexion de l’appareil.

"Créez un capteur de qualité de l’air émulé dans la chambre froide 3 et envoyez une température de −20." Un appareil qui remonte lui-même des données, prêt pour les tableaux de bord et les règles que vous êtes sur le point de créer.

Ce qu’il construit par opposition à ce qu’il opère

La distinction importante à garder en tête est celle entre les automatisations que l’assistant écrit et les commandes qu’il exécute.

Le automatisations qu’il construit surveillent et alertent. Une règle qui agit d’elle-même le fait via le nœud Execute Command du moteur de règles, que vous ajoutez délibérément — l’assistant ne fait pas agir une règle comme effet secondaire d’une demande.

Et rien ici ne remplace le parcours manuel : l’onglet Commandes et états de l’appareil et un tableau de bord widget de contrôle sont toujours là pour un fonctionnement en un clic.

Conseils pour bien déléguer

  • Formulez le résultat, pas les clics. "Intégrez ce capteur et placez-le sur le tableau de bord du laboratoire 2" vaut mieux qu’une dictée étape par étape — l’assistant connaît les étapes.

  • Donnez-lui les détails dont il a besoin. Des identifiants, des seuils, des durées et des destinataires fournis d’avance signifient moins d’allers-retours.

  • Lisez la confirmation avant d’approuver. La carte de confirmation détaille le changement ; c’est votre dernier point de contrôle avant que quoi que ce soit se produise.

  • Itérez. Considérez le premier résultat comme une ébauche que vous pouvez affiner dans la même conversation.

Voir aussi

Mis à jour