> 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-pl/rozwiazywanie-problemow/common-issues.md).

# Częste problemy

Ta strona obejmuje objawy, z którymi najprawdopodobniej spotkasz się w budynku zoptymalizowanym przez myCoreAI, oraz to, co sprawdzić przed zgłoszeniem sprawy do wsparcia. Pracuj od góry do dołu — większość problemów wychodzi na jaw już przy pierwszej lub drugiej kontroli. Jeśli objaw pasuje, ale sugerowane kontrole go nie rozwiążą, zgłoś sprawę do wsparcia, podając szczegóły wymienione na końcu tej strony.

## Dane nie przepływają z BMS

Objawy: odczyty czujników w myPortal są stałe, brakujące albo utknęły na starej wartości. Widok blueprint pokazuje czujniki w stanie wyłączonym lub nieaktualnym.

Sprawdź:

* **Status połączenia.** Potwierdź, że integracja po stronie BMS jest online. Zerwane połączenie między BMS a myCoreAI to zdecydowanie najczęstsza przyczyna brakujących danych. Przywrócenie połączenia zwykle usuwa objaw w ciągu kilku minut. Wymagamy co najmniej jednego punktu danych co 15 minut, przy czym optymalnie co 5 minut.
* **Sygnał u źródła.** Otwórz wartość w BMS i potwierdź, że tam się aktualizuje. Jeśli sam BMS pokazuje nieaktualną wartość, problem leży przed myCoreAI — sprawdź czujnik, sterownik lub konfigurację rejestrowania w BMS.

## Zapisy wartości zadanej nie docierają do BMS

Objawy: myCoreAI pokazuje aktywną wartość zadaną w myPortal, ale BMS działa na pierwotnej wartości (nie-AI). Budynek zachowuje się tak, jakby optymalizacja była wyłączona, mimo że jest włączona.

Sprawdź:

* **myCoreAI faktycznie działa** dla tego budynku w myPortal. Wstrzymany lub wyłączony budynek nie będzie zapisywał wartości.
* **Ścieżka zapisu jest włączona** od początku do końca. Większość integracji BMS ma oddzielną ścieżkę odczytu i ścieżkę zapisu; możliwe jest, że odczyty działają, a zapisy są wyłączone.
* **Najnowszy zapis zakończył się sukcesem.** Każda integracja udostępnia wskaźnik statusu zapisu. Krótkie opóźnienie — do około 15 minut — między obliczeniem wartości przez myCoreAI a jej odebraniem przez BMS jest normalne i samo się rozwiązuje. Trwała awaria już nie.
* **Mapowanie sygnału.** Jeśli zapisy docierają do BMS, ale trafiają do niewłaściwego punktu, powiązanie między sygnałem wyjściowym myCoreAI a punktem BMS jest nieprawidłowe. Porównaj każdą wartość zapisywaną przez myCoreAI z wartością widoczną w obrazie BMS — muszą się zgadzać.

## Niezgodność sygnału między myCoreAI a BMS

Objawy: wartość widoczna w myPortal nie zgadza się z tą samą wartością w BMS. Albo sygnał, którego oczekujesz w myPortal, w ogóle się tam nie pojawia.

Większość niezgodności sygnałów wynika z jednej z trzech rzeczy:

1. **Błędne mapowanie.** Klucz sygnału wskazuje na niewłaściwy punkt BMS. Naprawa leży po stronie integracji — popraw klucz.
2. **Niezgodność jednostek lub skalowania.** Wartość technicznie przepływa, ale po każdej stronie jest interpretowana inaczej (Celsjusz vs. Kelvin, Pa vs. kPa, procent vs. ułamek).
3. **Odczyt punktu rejestrowanego zamiast punktu bieżącego.** Niektóre integracje BMS udostępniają oba; myCoreAI potrzebuje sygnału bieżącego do sterowania i punktu rejestrowanego do analizy historycznej. Pomylenie ich powoduje opóźnienia lub zacinające się wartości.

Sygnał, którego całkowicie brakuje, zwykle oznacza mapowanie, które nigdy nie zostało utworzone, albo tag wyłączony po stronie BMS.

## Klimat wewnętrzny nie osiąga celu

Objawy: pomieszczenia są stale zbyt ciepłe lub zbyt zimne. Czujniki w widoku blueprint pokazują wartości poza zalecanym zakresem — zbyt gorąco (czerwony/pomarańczowy) albo zbyt zimno (niebieski/jasnoniebieski).

Sprawdź:

* **Najpierw czujniki ograniczające.** Lista ograniczających w widoku blueprint pokazuje, które czujniki wyciągają budynek poza zakres. Dla każdego:
  * **Dostosuj Min/Max** tak, aby odpowiadały rzeczywistym warunkom fizycznym w tej przestrzeni.
  * **Wyłącz czujnik** jeśli jest źle umieszczony — bezpośrednie światło słoneczne, przeciąg, blisko źródła ciepła — i nie odzwierciedla pomieszczenia.
* **Cały budynek kontra pojedynczy odstający czujnik.** Jeśli cały budynek jest zbyt zimny, podnieś Max dla wszystkich istotnych czujników, aby myCoreAI korygował je równomiernie. Jeśli tylko jeden czujnik odstaje, obniż jego Min, aby przestał dominować zachowanie myCoreAI.
* **Przyczyny środowiskowe** przed dostrajaniem. Przeciągi, słaba izolacja lub nasłonecznienie czujnika dadzą odczyty, które wyglądają jak problem ze sterowaniem, ale nim nie są.

Jeśli indywidualne dostrojenie czujników nie wystarczy, możesz zawęzić adaptacyjne granice Min/Max budynku, co ograniczy, jak daleko myCoreAI może odejść od pierwotnej wartości zadanej. Traktuj to jako środek tymczasowy — myCoreAI działa najlepiej, gdy ma swobodę działania bez sztucznych ograniczeń. Poszerz granice ponownie, gdy podstawowy problem zostanie rozwiązany.

## Optymalizator przeszedł w tryb bezpieczny

Objawy: myCoreAI działał normalnie, a potem przestał zapisywać zoptymalizowane wartości. Budynek wraca do pierwotnych wartości zadanych.

myCoreAI monitoruje, jak bardzo każdy czujnik odchyla się od oczekiwanego zachowania (czynnik RMSE budynku). Gdy odchylenie przekroczy próg — **1.7** domyślnie, z możliwością dostosowania dla każdego budynku — optymalizator wyłącza się automatycznie, a budynek przechodzi w tryb awaryjny. To mechanizm bezpieczeństwa, a nie błąd. Zapobiega on działaniu myCoreAI na podstawie złych danych.

Aby odzyskać działanie:

1. Zidentyfikuj problematyczne czujniki z listy ograniczających.
2. Usuń odchylenie u źródła — skalibruj ponownie, przestaw, wymień czujnik lub popraw zbyt wąski zakres wartości zadanej.
3. Wyczyść stan awaryjny dla budynku.

Optymalizator nie wznowi pracy, dopóki podstawowe problemy z czujnikami nie zostaną naprawione. Samo wyczyszczenie stanu awaryjnego nie wystarczy.

## Wyłączenie jednego obwodu spod kontroli AI

Jeśli chcesz, aby jeden obwód wrócił do pierwotnej wartości zadanej (nie-AI) bez zatrzymywania optymalizacji całego budynku, możesz dezaktywować ten pojedynczy obwód z jego panelu sterowania w myPortal. Reszta budynku nadal będzie optymalizowana. To właściwe rozwiązanie, gdy jeden obieg działa nieprawidłowo i chcesz to zbadać bez zakłócania wszystkiego innego.

## Kiedy zgłosić sprawę do wsparcia

Jeśli przejdziesz przez powyższe kontrole, a objaw nadal występuje, zgłoś sprawę do wsparcia. Dołącz:

* Budynek lub budynki, których dotyczy problem.
* Objaw — co widzisz i czego się spodziewałeś.
* Przybliżony czas rozpoczęcia problemu.
* Do której z powyższych kontroli dotarłeś i co ustaliłeś.
* Zrzuty ekranu lub linki do dotkniętego widoku myPortal, jeśli to istotne.

W przypadku pilnych problemów — na przykład, jeśli komfort wewnętrzny jest znacząco pogorszony — zaznacz to wyraźnie. Jeśli chcesz, aby myCoreAI został wstrzymany dla budynku na czas trwania sprawy, poproś o to. Wstrzymanie zatrzymuje zapisywanie wartości zadanych, ale pozostawia zbieranie danych i monitorowanie bez zmian.


---

# 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-pl/rozwiazywanie-problemow/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.
