> 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 que vous êtes le plus susceptible de rencontrer sur un bâtiment optimisé par myCoreAI, et ce qu’il faut vérifier avant d’ouvrir un ticket d’assistance. Procédez de haut en bas — la plupart des problèmes sont détectés lors des première ou deuxième vérifications. Si un symptôme correspond mais que les vérifications proposées ne le résolvent pas, ouvrez un ticket d’assistance avec 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 figés sur une ancienne valeur. La vue du plan montre des capteurs dans un état désactivé ou obsolète.

Vérifications :

* **É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 des données manquantes. Le rétablissement de la connexion suffit généralement à faire disparaître le symptôme en quelques minutes. Nous exigeons au moins un point de données toutes les 15 minutes, l’idéal étant toutes les 5 minutes.
* **Le signal à la source.** Ouvrez la valeur dans le BMS et vérifiez qu’elle s’y met bien à jour. Si le BMS lui-même affiche une valeur périmée, le problème est 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érifications :

* **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 tandis que les écritures sont désactivées.
* **La dernière écriture a réussi.** Chaque intégration affiche 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. Une panne persistante ne l’est pas.
* **Mappage du signal.** Si les écritures atteignent le BMS mais aboutissent sur le mauvais point, l’association entre le signal de sortie de myCoreAI et le point du BMS est incorrecte. Comparez chaque valeur que myCoreAI écrit avec la valeur visible dans l’image du BMS — elles doivent correspondre.

## Incohérence 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 un signal que vous vous attendez à voir dans myPortal n’y figure pas du tout.

La plupart des incohérences de signal proviennent de l’une de trois causes :

1. **Mappage incorrect.** L’identifiant du signal pointe vers le mauvais point BMS. La correction se fait côté intégration — corrigez l’identifiant.
2. **Incompatibilité 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 un décalage ou des valeurs figées.

Un signal totalement absent provient généralement d’un mappage qui n’a jamais été créé, ou d’un tag qui a été désactivé 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 dans la vue du plan apparaissent hors de la plage recommandée — trop chauds (rouge/orange) ou trop froids (bleu/bleu clair).

Vérifications :

* **Commencez par les capteurs goulots d’étranglement.** La liste des goulots d’étranglement dans la vue du plan 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é — plein soleil, 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 ou valeur aberrante unique.** Si tout le bâtiment est trop froid, augmentez le Max sur tous les capteurs concernés afin que myCoreAI ajuste l’ensemble de manière uniforme. Si un seul capteur est la valeur aberrante, 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 l’ensoleillement d’un capteur produiront tous des relevés qui ressemblent à un problème de contrôle, mais n’en sont pas un.

Si le réglage de capteurs individuels ne suffit pas, vous pouvez resserrer les bornes Min/Max adaptatives du bâtiment, ce qui limite l’écart maximal autorisé par rapport à la consigne d’origine. Considérez cela comme une mesure temporaire — myCoreAI donne ses 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 repassé 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 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, ajustable par bâtiment —, l’optimiseur se désactive automatiquement et le bâtiment passe en mode de repli. Il s’agit d’un mécanisme de sécurité, pas d’un bug. Il empêche myCoreAI d’agir sur de mauvaises données.

Pour rétablir :

1. Identifiez les capteurs problématiques à partir de la liste des goulots d’étranglement.
2. Résolvez l’écart à la source — recalibrez, repositionnez, remplacez le capteur ou corrigez une plage de consigne trop serrée.
3. Effacez l’état de repli du bâtiment.

L’optimiseur ne reprendra pas tant que les problèmes sous-jacents des capteurs ne seront pas corrigés. Effacer seulement l’état de repli ne suffit pas.

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

Si vous devez faire revenir un seul circuit à sa consigne d’origine (sans 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 souhaitez enquêter sans perturber tout le reste.

## Quand ouvrir un ticket d’assistance

Si vous avez suivi 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é.
* La vérification ci-dessus à laquelle vous êtes parvenu, 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, si le confort intérieur est fortement affecté — dites-le explicitement. Si vous souhaitez que myCoreAI soit mis en pause pour un bâtiment pendant que le ticket est ouvert, demandez-le. La pause arrête les écritures de consigne mais laisse intactes la collecte de 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.
