> 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/ai-assistant/querying-your-data.md).
# Travailler avec l’assistant
Interrogez Kilo IoT Server en langage naturel — état des appareils, historique, violations de seuil, suivis.
L’Assistant IA accepte le langage naturel. Il n’y a aucune syntaxe spéciale à apprendre, aucun langage de requête à mémoriser. Tapez comme vous parleriez à un collègue qui connaît tout de votre déploiement — que vous soyez *en train de* poser une question sur vos données ou *lui demander d’effectuer une action*. Cette page se concentre sur l’aspect questions et analyse ; pour lui confier de véritables tâches de configuration, consultez [Créer avec l’assistant](/kilo-docs-fr/kilo-iot-server/ai-assistant/building-with-ai.md).
Lorsque vous ouvrez **Chat IA**, une salutation et quelques sujets suggérés vous aident à démarrer — sélectionnez-en un, ou tapez simplement votre question dans la zone en bas.
## Rédiger des requêtes efficaces
Une question précise produit une réponse précise. Suivez ces recommandations pour obtenir les résultats les plus utiles :
* **Nommez l’appareil, le capteur ou l’emplacement.** « Quelle est la température dans l’entrepôt B ? » est bien plus utile que « Quelle est la température ? » Lorsque des dizaines de capteurs signalent la température, l’assistant doit savoir lequel vous voulez dire.
* **Utilisez des expressions temporelles naturelles.** L’assistant comprend « hier », « les 3 dernières heures », « entre le 1er janvier et le 15 janvier », « ce matin » et des expressions similaires. Il n’est pas nécessaire de fournir des horodatages Unix ou des dates formatées.
* **Posez des questions de suivi.** L’assistant conserve tout le contexte au sein d’une conversation. Affinez, restreignez ou élargissez une requête précédente sans tout reformuler.
* **Réutilisez votre dernier message.** Appuyez sur la **flèche vers le haut** dans la zone de saisie du chat pour faire réapparaître le dernier message envoyé — utile pour modifier une question et la reposer.
## Catégories de requêtes
### Statut en temps réel
Demandez l’état actuel de vos appareils :
* « Quels appareils sont hors ligne ? »
* « Quel est le taux d’humidité actuel dans la salle des serveurs 3 ? »
* « Affichez-moi tous les appareils dont la batterie est inférieure à 20 % »
* « La passerelle du toit est-elle en ligne ? »
### Données historiques
Interrogez les enregistrements de télémétrie sur n’importe quelle période couverte par vos paramètres de rétention :
* « Quelle était la température moyenne dans l’entrepôt frigorifique A la semaine dernière ? »
* « Quand le congélateur 3 a-t-il dépassé pour la dernière fois -18 degrés Celsius ? »
* « Combien d’événements d’ouverture de porte se sont produits après 22 h ce mois-ci ? »
* « Affichez-moi toutes les mesures de CO2 supérieures à 1000 ppm au cours des 48 dernières heures »
### Agrégations et comparaisons
Effectuez des calculs sur plusieurs appareils, plages de temps, ou les deux :
* « Comparez les relevés de température de cette semaine dans l’entrepôt B avec ceux de la semaine dernière »
* « Quel a été le niveau maximal de CO2 dans le laboratoire aujourd’hui ? »
* « Quelle zone a affiché le taux d’humidité moyen le plus élevé en mars ? »
### Graphiques
Demandez des graphiques visuels et ils s’affichent directement dans la fenêtre de discussion :
* « Créez un graphique en courbe de la température du capteur 5 sur les 7 derniers jours »
* « Affichez un histogramme comparant l’humidité de tous les capteurs de l’entrepôt »
* « Diagramme circulaire de l’état des appareils sur l’ensemble du parc »
* « Nuage de points de la température par rapport à l’humidité pour le laboratoire 1 cette semaine »
Les graphiques en courbe sont les plus adaptés aux tendances de séries chronologiques, les histogrammes aux comparaisons entre appareils ou entre périodes, les diagrammes circulaires aux répartitions proportionnelles, et les nuages de points pour identifier les corrélations entre deux mesures.
### Documentation
Posez une question sur n’importe quelle fonctionnalité de la plateforme et l’assistant recherche sémantiquement toute la base de connaissances :
* « Comment configurer une passerelle LoRaWAN ? »
* « Expliquez l’historique des versions du moteur de règles »
* « Quels canaux de notification sont disponibles ? »
Les réponses incluent des explications et des liens directs vers les pages de documentation concernées.
## Conversations en plusieurs étapes
L’assistant mémorise le contexte au cours d’une session. Appuyez-vous sur les réponses précédentes sans vous répéter :
1. « Montrez-moi les relevés de température du capteur 5 sur la semaine écoulée »
2. « Maintenant, étendez cela au mois dernier »
3. « Comparez-le avec le capteur 6 sur la même période »
4. « Lequel a enregistré le plus de violations de seuil au-dessus de 30 degrés ? »
Chaque question de suivi s’appuie sur le contexte précédent, rendant l’analyse complexe conversationnelle plutôt que fastidieuse.
## De la question à l’action
La même conversation peut passer de l’analyse directement à l’action. Après « quels congélateurs ont dépassé −18 °C la nuit dernière ? », vous pouvez enchaîner avec « crée une règle qui m’alerte si cela se reproduit » — et l’assistant la rédige et la déploie. Chaque fois qu’une demande modifierait quelque chose d’important, l’assistant affiche une confirmation avec **Confirmer l'action** et **Annuler** d’abord, pour que vous gardiez le contrôle de chaque modification. Le flux de travail complet de création et d’exploitation est présenté dans [Créer avec l’assistant](/kilo-docs-fr/kilo-iot-server/ai-assistant/building-with-ai.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/ai-assistant/querying-your-data.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.
