> 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 sur un bâtiment optimisé par myCoreAI, et ce qu’il faut vérifier avant d’ouvrir un ticket d’assistance. Travaillez 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 d’assistance avec les détails indiqués à la fin de cette page.

## Les données ne proviennent pas du BMS

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

Vérifier :

* **É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. Le rétablissement de la connexion fait généralement disparaître le symptôme en quelques minutes. myCoreAI lit chaque minute (au maximum toutes les cinq minutes) ; une optimisation fiable nécessite au moins un point de données toutes les cinq minutes.
* **Le signal à la source.** Ouvrez la valeur dans le BMS et confirmez qu’elle y est mise à jour. Si le BMS affiche lui-même 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 applique 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érifier :

* **myCoreAI est bien en cours d’exécution** pour ce bâtiment dans myPortal. Un bâtiment 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 soient désactivées.
* **La dernière écriture a réussi.** Chaque intégration expose un indicateur d’état d’écriture. Un court délai — 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.
* **Mappage du signal.** Si les écritures atteignent le BMS mais se retrouvent sur le mauvais point, l’association entre le signal de sortie de myCoreAI et le point du BMS est incorrecte. Comparez chaque valeur écrite par myCoreAI à la valeur visible dans l’image du BMS — elles doivent correspondre.

## Discordance 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 figure pas du tout.

La plupart des discordances de signal proviennent de l’un de ces trois cas :

1. **Mappage erroné.** La clé du signal pointe vers le mauvais point BMS. La correction se fait côté intégration — rectifiez la clé.
2. **Incompatibilité d’unité ou d’échelle.** La valeur circule techniquement, mais elle est interprétée différemment de chaque côté (Celsius vs Kelvin, Pa vs kPa, pourcentage vs 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 des retards ou des valeurs bloquées.

Un signal complètement manquant provient généralement d’un mappage jamais 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 en permanence trop chaudes ou trop froides. Les capteurs de la vue du schéma affichent des valeurs hors de la plage recommandée — trop chaudes (rouge/orange) ou trop froides (bleu/bleu clair).

Vérifier :

* **D’abord les capteurs goulots d’étranglement.** La liste des goulots d’étranglement dans la vue du schéma indique quels capteurs sortent le bâtiment de la plage. Pour chacun :
  * **Ajustez Min/Max** pour correspondre aux conditions physiques réelles dans cet espace.
  * **Désactivez le capteur** s’il est mal placé — en plein soleil, dans un courant d’air, près d’une source de chaleur — et qu’il n’est pas représentatif de la pièce.
* **Bâtiment entier vs. valeur aberrante unique.** Si tout le bâtiment est trop froid, augmentez le Max sur tous les capteurs concernés afin que myCoreAI ajuste uniformément. Si un seul capteur est l’exception, baissez son Min pour qu’il cesse de dominer le comportement de myCoreAI.
* **Causes environnementales** avant l’ajustement. Les courants d’air, une mauvaise isolation ou un fort ensoleillement sur un capteur produiront tous des relevés qui ressemblent à un problème de régulation, alors que ce n’en est 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 l’ampleur du déplacement autorisé par myCoreAI par rapport à la consigne d’origine. Considérez cela comme une mesure temporaire — myCoreAI fonctionne mieux 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 repassé en mode de sécurité

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

myCoreAI surveille l’écart de chaque capteur par rapport au comportement attendu (le facteur RMSE du bâtiment). Lorsque l’écart dépasse un seuil — **1.7** par défaut, configurable par bâtiment — l’optimiseur se désactive automatiquement et le bâtiment passe en mode de sécurité. Il s’agit d’un mécanisme de protection, pas d’un bug. Il empêche myCoreAI d’agir sur des données incorrectes.

Pour rétablir :

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 de sécurité pour le bâtiment.

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

## Un bâtiment n’est ni en apprentissage ni en optimisation

Symptômes : l’apprentissage d’un bâtiment ne se termine pas (l’état d’apprentissage reste rouge, ou la file 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 récentes et changeantes des capteurs pour entraîner son jumeau numérique et exécuter l’optimiseur. Les causes habituelles sont :

* **Un signal figé ou obsolète.** Un capteur — ou un circuit en arrêt de pompe — renvoie la même valeur, ou aucune valeur, pendant une période prolongée. La validation des données le signale comme défectueux et le supprime.
* **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 majeure partie ou la totalité.
* **Un signal ajouté récemment avec peu d’historique**, ce qui peut entraîner la suppression de lignes jusqu’à ce qu’il ait accumulé suffisamment de données.

Vérifiez au [niveau du capteur et du signal](/myrspoven-docs/myrspoven-docs-fr/depannage/overview.md) en premier lieu, confirmez que les données circulent toujours, et effacez ou désactivez tout capteur figé ou défectueux. Si le bâtiment a été réentraîné récemment mais refuse toujours d’optimiser — ou si la validation signale qu’elle a supprimé la majeure partie des données — ouvrez un ticket d’assistance.

## Retirer un seul circuit du contrôle de l’IA

Si vous avez besoin qu’un circuit revienne à sa consigne d’origine (non IA) sans interrompre l’optimisation de tout le bâtiment, vous pouvez désactiver ce seul circuit depuis son panneau de commande 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 souhaitez enquêter sans perturber le reste.

## Quand ouvrir un ticket d’assistance

Si vous avez effectué les vérifications ci-dessus et que le symptôme persiste, ouvrez un ticket d’assistance. Incluez :

* Le ou les bâtiments concernés.
* Le symptôme — ce que vous observez et ce à quoi vous vous attendiez.
* L’heure approximative à laquelle le problème a commencé.
* Jusqu’à quelle vérification ci-dessus vous êtes allé, et ce que vous avez trouvé.
* Des captures d’écran ou des liens vers la vue myPortal concernée, si pertinent.

Pour les problèmes urgents — par exemple, si le confort intérieur est fortement affecté — indiquez-le explicitement. Si vous souhaitez que myCoreAI soit mis 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 de données et la surveillance actives.


---

# 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.myrspoven.com/myrspoven-docs/myrspoven-docs-fr/depannage/common-issues.md?ask=<question>&goal=<endgoal>
```

`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.
