> 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 danych operacyjnych z budynków oraz danych od zewnętrznych dostawców. Integracje wprowadzają te wartości do Myrspoven, a tam, gdzie połączony system obsługuje sterowanie, zwracają do budynku nowe wartości zadane.

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

**Dział techniczny:** potwierdzić, które sygnały myCoreAI musi odczytywać oraz, jeśli dotyczy, które wartości zadane może zapisywać.\
**Integratorzy:** określić zakres API, protokołu, komponentu edge, dostępu sieciowego oraz przekazania po uruchomieniu.\
**Zarządcy aktywów:** rozumieć, które źródła danych są używane oraz jak dane energetyczne, z czujników, IoT i pogodowe są pobierane.

## Modele integracji

Integracje Myrspoven wykorzystują dwa główne modele.

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

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

Obsługiwane integracje BMS i SCADA obejmują dedykowane konektory platform oraz integracje oparte na protokołach:

* **Web Port**
* **Siemens Building X**
* **Ouman**
* **Fidelix Analytics**
* **ProptechOS**

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

Wymienione platformy nie wyczerpują możliwości połączeń. Web Port to warstwa bramowa ze wsparciem sterowników dla wielu protokołów polowych i typów urządzeń, co pozwala Myrspoven integrować się z szerszym zakresem lokalnych systemów BMS i automatyki, niż sugeruje sama lista dostawców. Zobacz [obsługę sterowników Web Port](https://kiona.com/products/web-port/driver-support) oraz [Web Port](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/bms-integrations/web-port.md).

Myrspoven obsługuje również mniejsze integracje tylko do odczytu dla danych z czujników, IoT, energii, pogody i środowiska:

* **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 AI-API, aby wysyłać wartości z BMS lub innego dostawcy danych oraz pobierać nowe wartości zadane, gdy są dostępne.

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

W praktyce Myrspoven może wdrażać budynki poprzez:

* Dedykowane integracje producentów, takie jak Siemens i Schneider.
* Integracje oparte na protokołach poprzez Web Port i jego ekosystem sterowników.
* Zewnętrzni partnerzy, którzy dostarczają dane i wartości zadane przez Myrspoven AI-API.

## Spis treści

* [**Integracje BMS**](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/bms-integrations.md) — integracje BMS i SCADA, zakres odczytu/zapisu, obsługiwane protokoły i wymagania dotyczące połączenia.
* [**Dane energetyczne**](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/energy-data.md) — opcje pobierania danych o zużyciu, w tym pobieranie z BMS, Mestro, Metry i ręczne wgrywanie. Wyższa rozdzielczość poprawia wyniki optymalizacji.
* [**Myrspoven API**](/myrspoven-docs/myrspoven-docs-pl/integracje/api.md) — dostęp do API do pobierania danych i odbierania wartości zadanych.

## 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 przechowuje wymagane wartości.
* Dostępu do odczytu i zapisu BMS, gdy myCoreAI jest skonfigurowany do optymalizacji i sterowania wartościami zadanymi.
* Danych uwierzytelniających API lub uzgodnionej metody uwierzytelniania dla zewnętrznych dostawców działających tylko w trybie odczytu.
* Wirtualnego serwera w sieci budynku, gdy używany jest lokalny komponent edge.
* Ruchu wychodzącego z tego serwera do chmury Myrspoven. Brak otwarć zapory dla ruchu przychodzącego.
* Technicznej osoby kontaktowej do uruchomienia i mapowania sygnałów.

Lista sygnałów, własność danych i zakres wartości zadanych 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, and the optional `goal` query parameter:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/integracje/overview.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.
