> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/depannage/common-issues.md).

# Problèmes courants

Cette page couvre les symptômes les plus susceptibles de se produire dans un bâtiment optimisé par myCoreAI, ainsi que les vérifications à effectuer avant d’ouvrir un ticket de support. Procédez de haut en bas. La plupart des problèmes sont détectés lors de la première ou de la deuxième vérification. Si un symptôme correspond mais que les vérifications suggérées ne le résolvent pas, ouvrez un ticket de support en incluant les détails listés à la fin de cette page.

## Les données ne circulent pas depuis le BMS

Symptômes : les relevés des capteurs dans myPortal sont plats, manquants ou bloqués sur une ancienne valeur. La carte des capteurs affiche des capteurs dans un état désactivé ou obsolète.

Vérifiez :

* **L’état de la connexion.** Confirmez que l’intégration côté BMS est en ligne. Une connexion interrompue entre le BMS et myCoreAI est de loin la cause la plus fréquente de données manquantes. La restauration de la connexion règle généralement le symptôme à la prochaine lecture. myCoreAI lit par défaut la plupart des intégrations BMS toutes les 15 minutes (Web Port toutes les 12 minutes), donc attendez un quart d’heure avant de vérifier à nouveau.
* **Le signal à la source.** Ouvrez la valeur dans le BMS et confirmez qu’elle s’y met à jour. Si le BMS lui-même affiche une valeur obsolète, le problème se situe en amont de myCoreAI. Vérifiez le capteur, le contrôleur ou la configuration de journalisation du BMS.

## Les écritures de consigne n’atteignent pas le BMS

Symptômes : myCoreAI affiche une consigne active dans myPortal, mais le BMS agit sur la valeur d’origine (non IA). Le bâtiment se comporte comme si l’optimisation était désactivée, alors qu’elle est activée.

Vérifiez :

* **myCoreAI fonctionne bien** pour ce bâtiment dans myPortal. Un bâtiment mis en pause ou désactivé n’écrira pas.
* **Le chemin d’écriture est activé** de bout en bout. La plupart des intégrations BMS ont un chemin de lecture et un chemin d’écriture distincts ; il est possible que les lectures fonctionnent alors que les écritures sont désactivées.
* **La dernière écriture a réussi.** Chaque intégration expose un indicateur d’état d’écriture. Un léger décalage, jusqu’à environ 15 minutes, entre le calcul d’une valeur par myCoreAI et sa réception par le BMS est normal et se résout de lui-même. Un échec persistant ne l’est pas.
* **Le mappage des signaux.** Si les écritures atteignent le BMS mais arrivent sur le mauvais point, le lien entre le signal de sortie de myCoreAI et le point BMS est incorrect. Comparez chaque valeur écrite par myCoreAI avec la valeur visible dans l’image du BMS. Elles doivent correspondre.

## Décalage de signal entre myCoreAI et le BMS

Symptômes : une valeur visible dans myPortal ne correspond pas à la même valeur dans le BMS. Ou bien un signal que vous vous attendez à voir dans myPortal n’y apparaît pas du tout.

La plupart des décalages de signal proviennent de l’un des trois problèmes suivants :

1. **Mauvais mappage.** La clé du signal pointe vers le mauvais point BMS. La correction se fait côté intégration : corrigez la clé.
2. **Incohérence d’unité ou d’échelle.** La valeur circule techniquement, mais elle est interprétée différemment de chaque côté (Celsius contre Kelvin, Pa contre kPa, pourcentage contre fraction).
3. **Un point de journalisation lu à la place du point en temps réel.** Certaines intégrations BMS exposent les deux ; myCoreAI a besoin du signal en temps réel pour le contrôle et du point de journalisation pour l’analyse historique. Les confondre provoque du retard ou des valeurs bloquées.

Un signal complètement absent provient généralement d’un mappage qui n’a jamais été créé, ou d’une balise désactivée côté BMS.

## Le climat intérieur n’atteint pas la cible

Symptômes : les pièces sont constamment trop chaudes ou trop froides. Les capteurs de la carte des capteurs apparaissent hors de la plage recommandée : trop chauds (rouge/orange) ou trop froids (bleu/bleu clair).

Vérifiez :

* **Commencez par les capteurs goulots d’étranglement.** La liste des goulots d’étranglement de la carte des capteurs indique quels capteurs sortent le bâtiment de la plage. Pour chacun :
  * **Ajustez le Min/Max** pour correspondre aux conditions physiques réelles de cet espace.
  * **Désactivez le capteur** s’il est mal placé (plein soleil, courant d’air, près d’une source de chaleur) et ne représente pas la pièce.
* **Bâtiment entier ou cas isolé.** Si tout le bâtiment est trop froid, augmentez le Min sur tous les capteurs concernés afin que myCoreAI ajuste de manière uniforme. Augmenter uniquement le Max n’ajoute pas de chaleur : à l’intérieur de la plage, myCoreAI économise de l’énergie, donc les pièces se stabilisent près du Min. Si un seul capteur est l’exception, baissez son Min pour qu’il cesse de dominer le comportement de myCoreAI.
* **Causes environnementales** avant tout réglage. Les courants d’air, une mauvaise isolation ou un apport solaire sur un capteur produiront tous des relevés qui ressemblent à un problème de contrôle, mais n’en sont pas un.

Si l’ajustement individuel des capteurs ne suffit pas, vous pouvez resserrer les bornes Min/Max adaptatives du bâtiment, ce qui limite la distance à laquelle myCoreAI est autorisé à s’éloigner de la consigne d’origine. Considérez cela comme une mesure temporaire. myCoreAI donne de meilleurs résultats lorsqu’il est libre de se déplacer sans restrictions artificielles. Élargissez à nouveau les bornes une fois le problème sous-jacent résolu.

## L’optimiseur est passé en mode sécurisé

Symptômes : myCoreAI fonctionnait normalement, puis a cessé d’écrire des valeurs optimisées. Le bâtiment revient à ses consignes d’origine.

myCoreAI se désactive automatiquement lorsqu’il ne peut plus contrôler le bâtiment en toute sécurité, et le bâtiment passe en mode sécurisé. La cause la plus fréquente est de mauvaises données de capteurs. Il s’agit d’un mécanisme de sécurité, pas d’un bogue.

Pour rétablir le fonctionnement :

1. Identifiez les capteurs problématiques dans la liste des goulots d’étranglement.
2. Corrigez l’écart à la source : recalibrez, repositionnez, remplacez le capteur, ou corrigez une plage de consigne trop serrée.
3. Quittez le mode sécurisé pour le bâtiment.

L’optimiseur ne reprendra pas tant que les problèmes de capteurs sous-jacents n’auront pas été résolus. Quitter le mode sécurisé seul ne suffit pas.

## Un bâtiment n’apprend pas ou n’optimise pas

Symptômes : l’apprentissage d’un bâtiment ne se termine pas (l’état d’apprentissage reste rouge, ou la file d’attente n’avance pas), ou l’optimiseur s’arrête avec une erreur concernant des données défectueuses, figées ou manquantes.

myCoreAI a besoin de données de capteurs récentes et changeantes pour entraîner son jumeau numérique et exécuter l’optimiseur. Les causes habituelles sont les suivantes :

* **Un signal figé ou obsolète.** Un capteur renvoie la même valeur, ou aucune valeur, pendant une période prolongée. La validation des données signale cela comme défectueux et l’élimine. Un circuit de chauffage dont toutes les pompes sont à l’arrêt est censé conserver une valeur plate, il bénéficie donc de 12 heures avant d’être considéré comme figé.
* **Trop de données défectueuses ou manquantes.** Lorsque de nombreux signaux sont défectueux ou absents sur la fenêtre d’apprentissage, il reste trop peu de données exploitables, et la validation peut en supprimer la majorité, voire la totalité.
* **Un capteur récemment ajouté avec peu d’historique.** Un capteur disposant de moins de 14 jours de données est exclu du modèle jusqu’à ce qu’il en ait suffisamment.

Vérifiez d’abord au [niveau du capteur et du signal](/myrspoven-docs/myrspoven-docs-fr/depannage/overview.md) niveau du capteur et du signal d’abord, confirmez que les données circulent toujours, et effacez ou désactivez tout capteur figé ou défectueux. Un signal supprimé réapparaît lors du prochain réentraînement dès qu’il renvoie à nouveau des valeurs normales. Si le bâtiment a été réentraîné récemment mais n’optimise toujours pas, ou si la validation indique qu’elle a supprimé la majeure partie des données, ouvrez un ticket de support.

## Retirer un seul circuit du contrôle par IA

Si vous avez besoin qu’un circuit revienne à sa consigne d’origine (non IA) sans arrêter l’optimisation de tout le bâtiment, vous pouvez désactiver ce seul circuit depuis son panneau de contrôle dans myPortal. Le reste du bâtiment continue d’être optimisé. C’est la bonne solution lorsqu’une boucle se comporte mal et que vous voulez enquêter sans perturber le reste.

## Quand ouvrir un ticket de support

Si vous avez suivi les vérifications ci-dessus et que le symptôme persiste, ouvrez un ticket de support. Incluez :

* Le ou les bâtiments concernés.
* Le symptôme : ce que vous observez et ce que vous attendiez.
* L’heure approximative à laquelle le problème a commencé.
* La vérification ci-dessus que vous avez atteinte, et ce que vous avez constaté.
* Des captures d’écran ou des liens vers la vue myPortal concernée, le cas échéant.

Pour les problèmes urgents, par exemple lorsque le confort intérieur est fortement impacté, indiquez-le explicitement. Si vous souhaitez mettre myCoreAI en pause pour un bâtiment pendant que le ticket est ouvert, demandez-le. La mise en pause arrête les écritures de consigne mais conserve la collecte des données et la surveillance.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/depannage/common-issues.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
