> 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/docs-us-cs/integrace/overview.md).

# Přehled

myCoreAI běží na provozních datech z budov a od externích poskytovatelů dat. Integrace přinášejí tyto hodnoty do Myrspovenu a tam, kde připojený systém podporuje řízení, vracejí do budovy nové hodnoty žádaných hodnot.

Tato kapitola popisuje dostupné možnosti integrace a požadavky na straně budovy.

**Technický provoz:** potvrdit, které signály myCoreAI potřebuje číst a, kde je to relevantní, které žádané hodnoty smí zapisovat.\
**Integrátoři:** vymezit rozsah API, protokolu, edge komponenty, síťového přístupu a předání při zprovoznění.\
**Správci majetku:** pochopit, které zdroje dat se používají a jak jsou načítána data o energii, senzorech, IoT a počasí.

## Modely integrace

Integrace Myrspovenu používají dva hlavní modely.

### Myrspoven se integruje na externí API

V tomto modelu je Myrspoven zodpovědný za psaní a údržbu integračního kódu. myCoreAI se připojuje k externímu systému, čte nakonfigurované hodnoty a zapisuje zpět nové hodnoty žádaných hodnot, když připojený systém podporuje řízení.

Podporované integrace BMS a SCADA zahrnují dedikované konektory platforem a integrace založené na protokolech:

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

Tyto integrace podporují jak čtení dat BMS, tak zápis nových hodnot žádaných hodnot.

Uvedené platformy nejsou konečným limitem toho, co lze připojit. Web Port je vrstva brány s podporou ovladačů pro mnoho polních protokolů a typů zařízení, což umožňuje Myrspovenu integrovat se se širším rozsahem lokálních BMS a automatizačních řešení, než by naznačoval samotný seznam dodavatelů. Viz [podpora ovladačů Web Portu](https://kiona.com/products/web-port/driver-support) a [Web Port](/myrspoven-docs/docs-us-cs/integrace/overview/bms-integrations/web-port.md).

Myrspoven také podporuje menší integrace pouze pro čtení dat ze senzorů, IoT, energií, počasí a prostředí:

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

Většina integrací v tomto modelu je založena na HTTP/REST. Myrspoven také podporuje integrace založené na MQTT tam, kde je to pro externí systém vhodné.

### Externí poskytovatelé se integrují do Myrspovenu

V tomto modelu je odpovědný za posílání hodnot do Myrspovenu externí poskytovatel. Poskytovatel používá Myrspoven AI-API k odesílání hodnot z BMS nebo jiného poskytovatele dat a k vyzvednutí nových hodnot žádaných hodnot, když jsou k dispozici.

Tento model se používá tehdy, když externí strana vlastní připojení k BMS nebo datové platformě a může požadované hodnoty zpřístupnit prostřednictvím Myrspoven AI-API.

V praxi může Myrspoven onboarding budov realizovat prostřednictvím:

* Dedikovaných integrací dodavatelů, například Siemens a Schneider.
* Integrací založených na protokolech prostřednictvím Web Portu a jeho ekosystému ovladačů.
* Externích partnerů, kteří dodávají data a žádané hodnoty prostřednictvím Myrspoven AI-API.

## Obsah

* [**Integrace BMS**](/myrspoven-docs/docs-us-cs/integrace/overview/bms-integrations.md) — integrace BMS a SCADA, rozsah čtení/zápisu, pokrytí protokolů a požadavky na připojení.
* [**Energetická data**](/myrspoven-docs/docs-us-cs/integrace/overview/energy-data.md) — možnosti načítání dat o spotřebě, včetně odběru z BMS, Mestro, Metry a ručního nahrání. Vyšší rozlišení zlepšuje výsledky optimalizace.
* [**API třetích stran**](/myrspoven-docs/docs-us-cs/integrace/api.md) — API dodavatelů a platforem používaná pro načítání dat a vyzvedávání žádaných hodnot.

## Požadavky na straně budovy

Požadavky závisejí na modelu integrace a zdroji dat. Typický projekt může potřebovat:

* Přístup k externímu API, BMS, systému SCADA nebo poskytovateli dat, který obsahuje požadované hodnoty.
* Přístup ke čtení a zápisu do BMS, když je myCoreAI nakonfigurován pro optimalizaci a řízení žádaných hodnot.
* Přihlašovací údaje k API nebo dohodnutý způsob autentizace pro poskytovatele třetích stran pouze pro čtení.
* Virtuální server v síti budovy, pokud je použit on-premise edge komponent.
* Odchozí síťový přístup z tohoto serveru do cloudu Myrspoven. Edge nepotřebuje žádné příchozí otevření firewallu.
* Technický kontaktní bod pro zprovoznění a mapování signálů.

Seznam signálů, vlastnictví dat a rozsah žádaných hodnot jsou dohodnuty během technického průzkumu a nemění se bez explicitní konfigurace.


---

# 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/docs-us-cs/integrace/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.
