> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/devices/registering-devices.md).
# Enregistrement des appareils
Enregistrez un appareil dans Kilo IoT via LNS, MIOTY, Tracker, MQTT ou l’émulateur — créez son jumeau numérique, son profil et ses correspondances de métriques.
Chaque appareil enregistré sur le serveur Kilo IoT devient un Jumeau numérique — une représentation numérique complète qui reflète l’état actuel, la configuration, l’historique de télémétrie et les schémas comportementaux de l’appareil. Le Jumeau numérique persiste même lorsque l’appareil physique est hors ligne, vous offrant une vue opérationnelle continue de l’ensemble de votre déploiement. Comme le rattachement à l’appareil physique est facultatif, vous pouvez créer et configurer entièrement un profil d’appareil avant que le matériel ne soit connecté — la configuration et la mise en service du matériel n’ont donc pas besoin de se faire en même temps. Avec le [Émulateur](/kilo-docs-fr/kilo-iot-server/devices/emulated-devices.md), vous pouvez aller plus loin et faire produire des données à l’appareil avant même que le matériel n’existe.
L’enregistrement d’un appareil consiste à créer ce Jumeau numérique et à le relier à un appareil physique via un connecteur. Le flux d’enregistrement vous guide pour nommer l’appareil, le lier à un connecteur, configurer son profil de communication et mapper les mesures qu’il rapporte.
## Prérequis
Avant d’enregistrer un appareil, vous devez disposer de :
* **Un connecteur** — au moins un connecteur LNS, Mioty, Tracker, MQTT (Cloud ou Externe) ou Émulateur doit être configuré. Voir [Connecteurs](/kilo-docs-fr/kilo-iot-server/connectors.md) et l’ [la documentation du connecteur MQTT](/kilo-docs-fr/kilo-iot-server/connectors/mqtt-connector.md) .
* **Identifiants de l’appareil** — pour les appareils LoRaWAN : le Device EUI et l’AppKey (généralement imprimés sur l’appareil ou son emballage). Pour les points d’extrémité MIOTY : l’End Point EUI et la clé de session réseau. Pour les traceurs : l’ID unique fourni par le fabricant. Pour les appareils MQTT : la portion de sujet au niveau de l’appareil sous laquelle l’appareil publie, utilisée comme ID de l’appareil dans l’enregistrement de l’appareil ; elle doit correspondre à la portion publiée caractère par caractère (les espaces sont supprimés à la saisie). **Les appareils émulés n’ont besoin d’aucun de ces éléments** — c’est vous qui choisissez l’ID de l’appareil.
* **Pour les appareils MQTT uniquement — l’appareil doit publier avant que le mappage puisse être terminé.** La liste déroulante Clé de connecteur dans l’onglet Mappage se remplit à partir des clés de charge utile réellement reçues de l’appareil. Voir la [section sur le comportement spécifique à MQTT](#mqtt-specific-behavior) ci-dessous pour le flux de travail en deux passes.
## Par où commencer
Il existe deux points d’entrée pour l’enregistrement d’un appareil — ils ouvrent tous deux la même boîte de dialogue Gérer l’appareil :
1. **Appareils** — Cliquez sur **Appareils** dans la barre latérale. Cette page affiche tous les appareils de tous les connecteurs. Cliquez sur **Ajouter un appareil** dans le coin supérieur droit.
2. **Action de ligne de connecteur** — Depuis la **Connecteurs** page, cliquez sur le bouton **+ Ajouter un appareil** sur n’importe quelle ligne de connecteur. La boîte de dialogue s’ouvre avec ce connecteur présélectionné.
Le formulaire de l’appareil est conçu aussi bien pour les petits écrans que pour les ordinateurs de bureau, afin que vous puissiez enregistrer du matériel depuis un téléphone, directement sur le point d’installation.
## Phase 1 — Créer le profil de l’appareil
La boîte de dialogue s’ouvre en mode **Ajouter un appareil** création **Informations de l’appareil** et n’affiche pour l’instant que la section — aucun onglet ni navigation n’est encore visible ; la première étape consiste simplement à identifier l’appareil.
* **Photos de l’appareil** — Importez éventuellement des photos de l’appareil physique pour faciliter l’identification visuelle.
* **Nom de l’appareil** — Saisissez un nom descriptif (obligatoire). Utilisez une convention de nommage qui puisse passer à l’échelle dans tout votre déploiement — par exemple, inclure l’emplacement ou le type d’appareil dans le nom.
Cliquez sur **Enregistrer**. Le Jumeau numérique est créé avec uniquement le nom et éventuellement une photo. La boîte de dialogue passe automatiquement en mode édition.
## Phase 2 — Configurer la connexion, les métriques et les journaux
Après la première sauvegarde, la boîte de dialogue se rouvre avec les onglets **Informations de l’appareil**, **Connexion**, **Mappage** et **Journaux** et un bouton de navigation entre eux. C’est ici que vous liez l’appareil à un connecteur et que vous configurez ses données. Deux autres onglets apparaissent lorsqu’ils s’appliquent : **Suivant** un bouton **Commandes et états** sur un appareil qui peut recevoir des downlinks, et **Émulateur** sur un appareil lié au connecteur Émulateur.
### Onglet Connexion
Cet onglet relie le Jumeau numérique à l’appareil qui l’alimente via un connecteur. La liste déroulante affiche les connecteurs dont votre organisation dispose réellement, par nom et par type, et les champs situés en dessous changent pour correspondre à celui que vous choisissez.
#### Pour les appareils LoRaWAN (connecteur LNS)
1. **Type de connecteur** — Sélectionnez le connecteur LNS dans la liste déroulante. S’il n’existe qu’un seul connecteur LNS, il peut être présélectionné.
2. **Device EUI** — Saisissez l’identifiant LoRaWAN unique de l’appareil (chaîne hexadécimale de 8 octets, affichée sous la forme `HH HH HH HH HH HH HH HH`). Il est généralement imprimé sur l’étiquette ou l’emballage de l’appareil. Une fois qu’un appareil physique est lié, ce champ ne peut plus être modifié sans détacher d’abord l’appareil.
**Scanner le code QR** — Au lieu de recopier seize caractères hexadécimaux depuis une étiquette, cliquez sur **Scanner le code QR** et pointez la caméra de votre ordinateur portable ou de votre téléphone vers le code QR sur l’appareil ou son emballage. Le Device EUI est renseigné à partir du code, et lorsque le code contient également l’AppKey, ce champ est aussi rempli. C’est la solution la plus rapide et la plus sûre lors de la mise en service de dispositifs en série — un seul caractère mal saisi dans un DevEUI produit un appareil qui ne rejoindra jamais silencieusement.
Si le navigateur ne peut pas accéder à une caméra, le scanner renvoie **« Le scanner de code QR est introuvable. Veuillez réessayer. »** Vérifiez qu’une caméra est présente et que le navigateur a reçu l’autorisation d’y accéder pour ce site, puis réessayez — ou saisissez les identifiants manuellement.
3. **Utiliser des modèles de profil d’appareil** — Cochez cette option pour sélectionner un profil parmi une bibliothèque de profils d’appareils connus.
Les modèles de profil d’appareil sont des préréglages pratiques pour les appareils LoRaWAN connus. Chaque modèle inclut la classe LoRaWAN de l’appareil, la bande de fréquence et un **codec** — la logique de décodage de charge utile qui traduit les données brutes de liaison montante de l’appareil en champs lisibles. La sélection d’un modèle se fait en deux étapes :
* **Marque** — Sélectionnez le fabricant de l’appareil dans la liste d’autocomplétion.
* **Modèle** — Sélectionnez le modèle de l’appareil. La liste est filtrée en fonction de la marque sélectionnée.
* **Profil** — Sélectionnez le profil modèle pour cet appareil. Les options sont dérivées des bandes régionales prises en charge par le modèle.
Une fois les trois sélectionnés, le serveur récupère le modèle correspondant et applique sa configuration au formulaire : la **classe**, **bande**et **codec** sont renseignés automatiquement. Vous pouvez vérifier et ajuster ces valeurs avant d’enregistrer.
Les modèles sont fournis comme aides pratiques. Le décodage correct des charges utiles n’est pas garanti pour chaque version de micrologiciel ni pour chaque révision matérielle. Si le codec d’un modèle produit des champs manquants ou incorrects, vous pouvez modifier directement le champ **Fonctions de code** (voir ci-dessous).
Si vous n’utilisez pas de modèle, configurez le profil manuellement :
* **Classe** — Choisissez la classe LoRaWAN de l’appareil :
* **Classe A** — L’appareil dort entre les transmissions et n’ouvre que de brèves fenêtres de réception après chaque liaison montante. C’est extrêmement économe en énergie — la plupart des capteurs alimentés par batterie utilisent la classe A et peuvent fonctionner pendant des années avec une seule batterie.
* **Classe C** — L’appareil garde son récepteur ouvert en continu, ce qui lui permet de recevoir à tout moment les commandes de liaison descendante du serveur. Comme la radio écoute en permanence, les appareils de classe C consomment nettement plus d’énergie et sont généralement alimentés par le secteur. Choisissez la classe C pour les appareils qui doivent répondre immédiatement aux commandes, comme les actionneurs, les interrupteurs ou les affichages.
* **Marque** et **Modèle** — Saisissez le fabricant et le modèle de l’appareil en texte libre.
* **Bande** — Sélectionnez la bande de fréquences LoRaWAN correspondant à votre région. La bande doit correspondre à la configuration de votre passerelle et à la réglementation radio de votre région. Options disponibles : EU868 (Europe), US915 (États-Unis), AU915 (Australie), AS923 (Asie), KR920 (Corée du Sud), IN865 (Inde), RU864 (Russie), CN470 (Chine), CN779 (Chine), EU433 (Europe 433 MHz), ISM2400 (2,4 GHz mondial). Pour une liste complète des bandes de fréquences par pays, voir [Fréquences LoRaWAN](/kilo-docs-fr/kilo-iot-server/connectors/lns-connector/lorawan-frequencies.md). Pour une introduction à LoRaWAN, voir [Qu’est-ce que LoRaWAN ?](/kilo-docs-fr/kilo-iot-server/connectors/lns-connector/what-is-lorawan.md).
* **AppKey** — Saisissez la clé d’application de l’appareil — la clé de chiffrement LoRaWAN utilisée pour l’activation par survol (OTAA). Elle est généralement fournie par le fabricant de l’appareil ; vérifiez l’emballage de l’appareil ou la documentation officielle.
#### Ajouter au Vault
Les identifiants d’appareil ont tendance à finir dans des endroits peu pratiques : une étiquette sur une unité désormais fixée à six mètres de haut dans une allée d’entrepôt. Cliquez sur **Ajouter au Vault** dans le formulaire de l’appareil pour stocker le couple EUI et clé de l’appareil dans Key Vault, où ils peuvent être récupérés indépendamment du matériel et de l’étiquette. Pour un appareil LoRaWAN, cela stocke l’AppKey associée au DevEUI.
Faites-le lors de l’enregistrement, tant que les identifiants sont encore sous vos yeux. Réapprovisionner un appareil dont vous n’avez plus l’AppKey en fichier signifie qu’il faut retourner jusqu’à l’unité elle-même — et la possibilité de lire ou non la clé à ce moment-là dépend du fabricant, ce qui peut impliquer une connexion filaire à la carte. Voir [Key Vault](/kilo-docs-fr/kilo-iot-server/reports/key-vault.md).
#### Fonctions de code (codec)
Le **Fonctions de code** le champ contient le codec de charge utile de l’appareil — une logique JavaScript qui décode la charge utile montante LoRaWAN brute de l’appareil en champs nommés. Ces champs décodés deviennent les **clés de connecteur** visibles dans l’onglet Mappage.
Lorsque vous sélectionnez un modèle de profil d’appareil, ce champ est automatiquement rempli avec le codec du modèle. Si vous configurez manuellement, ce champ commence vide — vous devrez peut-être coller un codec depuis la documentation du fabricant de l’appareil ou depuis un dépôt communautaire de codecs.
Si le résultat décodé ne correspond pas à ce que vous attendez — par exemple, si des champs manquent, si les valeurs semblent incorrectes ou si les noms de champs ne correspondent pas à la documentation de votre capteur — vous pouvez modifier le code directement. L’éditeur est une zone de texte multiligne au format monospace.
#### Intervalle d’envoi des données
Un appareil transmet selon un calendrier fixe — toutes les quelques minutes, une fois par jour, une fois par mois — et ce calendrier est configuré **sur l’appareil lui-même**. Il varie d’un fabricant à l’autre : certains appareils sont livrés avec l’intervalle déjà défini par le fabricant, d’autres exigent que vous le configuriez lors de la mise en service. Dans tous les cas, le calendrier est une propriété de l’appareil. Le **Intervalle d’envoi des données** champ est l’endroit où vous indiquez à la plateforme quel est ce calendrier, afin qu’elle sache quand attendre des données.
Réglez-le pour qu’il corresponde à la manière dont l’appareil est réellement configuré pour transmettre. Si l’appareil envoie une fois par jour, définissez cette valeur sur **1 jour**; une fois par mois, définissez-la sur **1 mois**. Le champ commence à **1 heure** par défaut uniquement parce que la plateforme a besoin d’une valeur initiale — elle n’a aucun moyen de lire le véritable calendrier de l’appareil, alors considérez cette valeur par défaut comme un simple emplacement à remplacer.
Si aucun message n’arrive dans l’intervalle configuré, l’appareil est marqué hors ligne dans la liste des appareils et signalé sur la carte Appareils de la page Vue d’ensemble. Régler l’intervalle pour qu’il corresponde à l’appareil permet d’éviter qu’un appareil sain à faible fréquence soit marqué hors ligne simplement parce qu’il est silencieux entre deux rapports planifiés.
Choisissez un nombre et une unité : **minute**, **heure**, **jour**, **semaine**, ou **mois**.
> **Les appareils émulés sont l’exception.** Sur un appareil lié au connecteur Émulateur, ce champ ne décrit pas un calendrier que le matériel suit déjà — il *est* le calendrier selon lequel la plateforme émet les données. Voir [Appareils émulés](/kilo-docs-fr/kilo-iot-server/devices/emulated-devices.md).
#### Pour les traceurs de véhicules (connecteur Tracker)
1. **Type de connecteur** — Sélectionnez le connecteur Tracker dans la liste déroulante.
2. **ID unique** — Saisissez l’identifiant unique de l’appareil de suivi.
3. **Modèle de l’appareil** — Recherchez et sélectionnez dans la bibliothèque de modèles de traceurs. Commencez à taper pour filtrer la liste.
4. **URL pour traceur GPS** — Après avoir sélectionné un modèle, un panneau affiche l’URL du point de terminaison. Cliquez sur le bouton de copie pour la copier, puis configurez votre traceur pour envoyer les données vers cette URL.
#### Pour les points d’extrémité MIOTY (connecteur Mioty)
Sélectionnez le connecteur Mioty dans la liste déroulante et le formulaire présente l’ensemble des paramètres MIOTY — End Point EUI, adresse courte, clé de session réseau et compteurs. Ces champs, leurs plages valides et le schéma qui décode les charges utiles du point d’extrémité sont documentés en détail sur [Appareils MIOTY](/kilo-docs-fr/kilo-iot-server/devices/mioty-devices.md).
#### Pour les appareils émulés (connecteur Émulateur)
Sélectionnez le connecteur Émulateur et l’appareil génère sa propre télémétrie au lieu d’en recevoir — aucun identifiant, aucun identifiant d’accès, aucun matériel. Vous lui donnez un ID d’appareil, choisissez ce qu’il mesure (à la main ou à partir d’un préréglage d’appareil) et définissez à quelle fréquence il rapporte. Un onglet supplémentaire **Émulateur** vous permet ensuite de piloter directement ses valeurs.
C’est ainsi que vous construisez un déploiement avant l’arrivée des capteurs, puis que vous faites basculer le même appareil vers du matériel réel lorsqu’ils arrivent. Voir [Appareils émulés](/kilo-docs-fr/kilo-iot-server/devices/emulated-devices.md).
### Onglet Mappage
Cet onglet mappe les données brutes des capteurs de l’appareil vers des définitions de mesure normalisées. Si des modèles de métriques ont été configurés pour le type d’appareil, les mappages peuvent se remplir automatiquement. Sinon, vous pouvez attribuer les modèles de métriques manuellement.
#### Clés de connecteur — voyez ce que l’appareil envoie
Une fois l’appareil connecté et en train de transmettre, l’onglet Mappage affiche un **tableau des clés de connecteur** qui montre chaque champ de la charge utile brute de l’appareil. Chaque ligne indique le nom du champ (exactement comme l’appareil l’envoie — par exemple, `t`, `temp1`, `humidity_pct`), sa valeur actuelle et l’horodatage de la dernière mise à jour. Il s’agit de la charge utile en direct provenant de l’appareil, mise à jour en temps réel.
Revenez à ce tableau chaque fois que vous devez savoir ce qu’un appareil rapporte et sous quelle forme — pour rédiger une condition de règle, ou définir la valeur attendue sur une commande. Voir [Décodage de la charge utile et clés de connecteur](/kilo-docs-fr/kilo-iot-server/devices/payload-decoding.md).
#### Mapper les champs bruts vers des modèles de métriques
C’est ici que vous transformez une sortie d’appareil cryptique en mesures significatives et étiquetées. Lorsque vous mappez une clé de connecteur brute (comme `t`) vers un modèle de métrique (comme « Température », unité : °C, type : Float), vous donnez à ce champ brut une identité lisible par l’humain. À partir de ce moment-là, les tableaux de bord, les règles d’automatisation, les alertes et les requêtes historiques affichent tous « Température (°C) » — et non le nom de champ brut envoyé par le micrologiciel de l’appareil.
Pour normaliser un champ brut :
1. **Ajouter une métrique** — Cliquez sur **Ajouter une clé** et sélectionnez un modèle de métrique dans la liste déroulante (par exemple « Température », unité : °C, type : Float). Les colonnes Unité, Type et Type de données se remplissent automatiquement à partir du modèle. Si le modèle dont vous avez besoin n’existe pas, créez-en un d’abord dans [Métriques](/kilo-docs-fr/kilo-iot-server/devices/metric-templates.md) Métriques
2. **Sélectionner la clé de connecteur** — Dans la liste déroulante **Clé de connecteur** de cette métrique, choisissez le nom du champ brut qui correspond à cette mesure (par exemple, sélectionnez `t` pour un appareil qui envoie la température sous la forme `t`).
3. **Enregistrer** — Le mappage prend effet immédiatement. Les données normalisées transitent par les tableaux de bord, les règles d’automatisation, les évaluations d’alarmes et les requêtes historiques.
Si la clé de connecteur n’est pas renseignée, les données de cette métrique seront ignorées.
Répétez l’opération pour chaque mesure rapportée par l’appareil. Plusieurs métriques peuvent être mappées lors d’une même session.
#### Tout appareil, tout format de charge utile
Ce flux de travail accepte les données de tout appareil que le serveur peut recevoir — y compris du matériel prototype dont les schémas de charge utile évoluent, des capteurs de fabricants de niche avec des formats de télémétrie non documentés, et des équipements de terrain hérités qui transmettent des identifiants encodés plutôt que des noms de champs lisibles. Si l’appareil envoie des données, le tableau des clés de connecteur les affiche et vous pouvez les mapper.
Pour plus de détails sur la configuration des modèles de métriques, voir [Métriques](/kilo-docs-fr/kilo-iot-server/devices/metric-templates.md).
#### Comportement spécifique à MQTT
Pour les appareils ingérés via le [connecteur MQTT](/kilo-docs-fr/kilo-iot-server/connectors/mqtt-connector.md), deux spécificités du flux d’enregistrement s’appliquent :
* **La liste déroulante Clé de connecteur est vide jusqu’à l’arrivée de la première publication.** La liste déroulante se remplit à partir des clés de charge utile réellement reçues de l’appareil, et non depuis une saisie en texte libre. Pour un nouvel enregistrement d’appareil MQTT, cela nécessite une sauvegarde en deux passes : ajoutez une ligne par métrique avec la clé normalisée sélectionnée et le Type de données défini, laissez Clé de connecteur vide, enregistrez, vérifiez que l’appareil publie, rouvrez l’enregistrement de l’appareil — la liste déroulante Clé de connecteur est maintenant remplie, faites correspondre chaque ligne, puis enregistrez à nouveau.
* **Colonne Valeur de l’onglet Mappage vs historique de l’onglet Journaux.** La colonne Valeur est un instantané en direct de la charge utile la plus récente (mise à jour à chaque publication acceptée, que les clés de connecteur soient renseignées ou non). L’onglet Journaux est l’historique par capteur (alimenté uniquement par les publications qui arrivent *après* la sauvegarde des clés de connecteur). Après avoir terminé la deuxième passe, générez une nouvelle publication pour alimenter l’onglet Journaux — les publications antérieures ne sont pas normalisées rétroactivement.
* **Le mappage est itératif.** L’enregistrement initial capture rarement toutes les clés de charge utile utiles. Une fois que des données en direct ont été reçues pendant une période représentative, rouvrez l’enregistrement de l’appareil, consultez la liste déroulante Clé de connecteur et la colonne Valeur pour voir ce qui est réellement publié, ajoutez des lignes de Mappage pour tout champ supplémentaire que vous souhaitez suivre, enregistrez, puis déclenchez une nouvelle publication afin que l’onglet Journaux commence à enregistrer l’historique des nouveaux mappages.
Voir [Sujets et routage des appareils](/kilo-docs-fr/kilo-iot-server/connectors/mqtt-connector/topics-and-device-routing.md) pour le flux de travail complet d’enregistrement spécifique à MQTT.
### Onglet Journaux
L’onglet Journaux est initialement vide. Une fois que l’appareil commence à envoyer des données, cet onglet affiche le journal brut des événements avec les horodatages et les détails de la charge utile.
Cliquez sur **Enregistrer** à nouveau pour enregistrer la configuration de la connexion et des métriques.
## Après l’enregistrement
L’appareil apparaît dans les listes d’appareils à travers le serveur — dans la table des appareils du connecteur, dans Appareils, et dans tous les tableaux de bord ou règles d’automatisation qui le référencent.
Pour les appareils LoRaWAN, les données commencent à circuler une fois que l’appareil physique envoie une demande de jonction et que le serveur l’accepte. Pour les appareils de suivi, les données commencent à circuler une fois que le traceur commence à envoyer des données vers le point de terminaison URL configuré.
Enregistrer un appareil ici ne le fait pas rejoindre le réseau. Un appareil LoRaWAN rejoint un réseau à la fois, donc une unité précédemment mise en service ailleurs — renvoyée d’un autre site, achetée d’occasion ou utilisée sur une autre plateforme — reste rattachée à ce réseau jusqu’à ce qu’elle soit réinitialisée et qu’elle envoie une nouvelle demande de jonction. Le matériel sorti d’usine rejoint le réseau de lui-même ; tout appareil ayant un historique a généralement besoin d’une réinitialisation au préalable. Voir [Avant que quoi que ce soit n’arrive : rejoindre le réseau](/kilo-docs-fr/kilo-iot-server/devices/device-diagnostics.md#before-anything-arrives-joining-the-network).
Si l’appareil est enregistré mais qu’aucune donnée n’arrive, ouvrez son **Connexion** onglet et lisez l’état de réception — il indique si l’appareil a atteint le réseau, si des messages sont reçus et si les valeurs qu’ils contiennent sont enregistrées, avec l’étape suivante spécifique pour chaque cas. Voir [Diagnostic de l’appareil](/kilo-docs-fr/kilo-iot-server/devices/device-diagnostics.md).
## Et ensuite
* **Configurer les modèles de métriques** avant ou après l’enregistrement pour contrôler la manière dont les données brutes sont normalisées. Voir [Métriques](/kilo-docs-fr/kilo-iot-server/devices/metric-templates.md).
* **Modifier les propriétés de l’appareil** à tout moment via la même boîte de dialogue. Voir [Gestion des appareils](/kilo-docs-fr/kilo-iot-server/devices/device-management.md).
* **Diagnostiquer un appareil silencieux** depuis son onglet Connexion. Voir [Diagnostic de l’appareil](/kilo-docs-fr/kilo-iot-server/devices/device-diagnostics.md).
* **Enregistrer un point d’extrémité MIOTY** et ses champs spécifiques au protocole. Voir [Appareils MIOTY](/kilo-docs-fr/kilo-iot-server/devices/mioty-devices.md).
* **Commencer sans matériel** puis basculer vers l’appareil réel à son arrivée. Voir [Appareils émulés](/kilo-docs-fr/kilo-iot-server/devices/emulated-devices.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/devices/registering-devices.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
