> 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/integracje/overview.md).

# Przegląd

myCoreAI działa na podstawie danych operacyjnych z budynków oraz danych od zewnętrznych dostawców. Integracje przekazują te wartości do Myrspoven i, tam gdzie podłączony system obsługuje sterowanie, zwracają nowe wartości nastaw do budynku.

Ten rozdział omawia dostępne opcje integracji oraz wymagania po stronie budynku.

**Operacje techniczne:** potwierdź, które sygnały myCoreAI musi odczytywać oraz, jeśli ma to zastosowanie, które nastawy może zapisywać.\
**Integratorzy:** określ zakres API, protokołu, komponentu brzegowego, dostępu do sieci oraz przekazania po uruchomieniu.\
**Zarządcy aktywów:** zrozumcie, które źródła danych są wykorzystywane oraz w jaki sposób dane dotyczące energii, czujników, IoT i pogody są pobierane.

## Modele integracji

Integracje Myrspoven korzystają z dwóch głównych modeli.

### Myrspoven integruje się z zewnętrznymi API

W tym modelu Myrspoven odpowiada za tworzenie i utrzymanie kodu integracyjnego. myCoreAI łączy się z systemem zewnętrznym, odczytuje skonfigurowane wartości i zapisuje z powrotem nowe wartości nastaw, gdy podłączony system obsługuje sterowanie.

Obsługiwane integracje BMS i SCADA obejmują:

* **Webport**
* **Siemens Building X**
* **Ouman**
* **Fidelix Analytics**
* **ProptechOS**

Te integracje obsługują zarówno odczyt danych BMS, jak i zapis nowych wartości nastaw.

Myrspoven obsługuje także mniejsze integracje tylko do odczytu dla danych z czujników, IoT, energii, pogody i danych środowiskowych:

* **Yggio**
* **EcoGuard**
* **PropEye**
* **Mestro**
* **Metry**
* **Radonova**
* **OpenMeteo**
* **AirThings**

Większość integracji w tym modelu opiera się na HTTP/REST. Myrspoven obsługuje również integracje oparte na MQTT, gdy jest to odpowiednie rozwiązanie dla systemu zewnętrznego.

### Zewnętrzni dostawcy integrują się z Myrspoven

W tym modelu zewnętrzny dostawca odpowiada za przesyłanie wartości do Myrspoven. Dostawca korzysta z Myrspoven AiAPI, aby przesyłać wartości z BMS lub innego dostawcy danych oraz pobierać nowe wartości nastaw, gdy są dostępne.

Ten model jest używany, gdy zewnętrzna strona posiada połączenie z BMS lub platformą danych i może udostępniać wymagane wartości przez AiAPI.

## Zawartość

* [**Integracja BMS**](broken://pages/3d9305a1d5126b88b2c94ef5a474296c3accf2b5) — integracje BMS i SCADA, zakres odczytu/zapisu oraz wymagania dotyczące połączenia.
* [**Dane energetyczne**](broken://pages/aa3138c7dda4c2d0a5245c571adfca51da283459) — opcje pobierania danych o zużyciu, w tym pobieranie z BMS, Mestro, Metry i ręczne przesyłanie. Wyższa rozdzielczość poprawia wyniki optymalizacji.
* [**API Myrspoven**](/myrspoven-docs/myrspoven-docs-pl/integracje/api.md) — dostęp do API w celu pobierania danych i pobierania nastaw.

## Wymagania po stronie budynku

Wymagania zależą od modelu integracji i źródła danych. Typowy projekt może wymagać:

* Dostępu do zewnętrznego API, BMS, systemu SCADA lub dostawcy danych, który posiada wymagane wartości.
* Dostępu do odczytu i zapisu w BMS, gdy myCoreAI jest skonfigurowany do optymalizacji i sterowania nastawami.
* Danych uwierzytelniających API lub uzgodnionej metody uwierzytelniania dla zewnętrznych dostawców tylko do odczytu.
* Wirtualnego serwera w sieci budynku, gdy używany jest lokalny komponent brzegowy.
* Ruchu wychodzącego z tego serwera do chmury Myrspoven. Brak otwierania zapory sieciowej dla ruchu przychodzącego.
* Technicznej osoby kontaktowej do uruchomienia i mapowania sygnałów.

Lista sygnałów, własność danych oraz zakres nastaw są uzgadniane podczas przeglądu technicznego i nie zmieniają się bez wyraźnej konfiguracji.


---

# 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/integracje/overview.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.