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

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

**Operacje techniczne:** potwierdzić, które sygnały myCoreAI musi odczytywać oraz, tam gdzie ma to zastosowanie, 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:** zrozumieć, jakie źródła danych są używane oraz jak pobierane są dane energetyczne, z czujników, IoT i pogodowe.

## 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 z powrotem nowe wartości zadane, gdy podłą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 zapisywanie nowych wartości zadanych.

Wymienione platformy nie wyczerpują wszystkich możliwości połączenia. Web Port jest warstwą bramową 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 [wsparcie sterowników Web Port](https://kiona.com/products/web-port/driver-support) i [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, energetycznych, pogodowych i ś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, jeśli 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 używa Myrspoven AI-API do przesyłania wartości z BMS lub innego dostawcy danych oraz do pobierania nowych wartości zadanych, 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ępnić wymagane wartości przez Myrspoven AI-API.

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

* Dedykowane integracje dostawców, takie jak Siemens i Schneider.
* Integracje oparte na protokołach przez Web Port i jego ekosystem sterowników.
* Partnerów zewnętrznych, 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ługa protokołów i wymagania dotyczące połączenia.
* [**Dane energetyczne**](/myrspoven-docs/myrspoven-docs-pl/integracje/overview/energy-data.md) — opcje pozyskiwania danych o zużyciu, w tym pobieranie z BMS, Mestro, Metry i ręczne przesyłanie. Wyższa rozdzielczość poprawia wyniki optymalizacji.
* [**Interfejsy API stron trzecich**](/myrspoven-docs/myrspoven-docs-pl/integracje/api.md) — interfejsy API dostawców i platform używane do pozyskiwania danych i pobierania 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 do API lub uzgodnionej metody uwierzytelniania dla zewnętrznych dostawców tylko do odczytu.
* Wirtualnego serwera w sieci budynku, gdy używany jest lokalny komponent edge.
* Wychodzącego dostępu sieciowego z tego serwera do chmury Myrspoven. Edge nie wymaga żadnych 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/integracje/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
