> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/pl/dokumentacja-api/przeglad-zadan-api-geopard/83.-zapytanie-zbierz-kontekst-platformy.md).

# 83. Zapytanie: zbierz kontekst platformy

Przy dużej liczbie (setkach lub tysiącach) przetwarzanych zestawów danych (takich jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.) zawsze istnieje potrzeba zrozumienia statusu przetwarzania każdego zestawu danych i zebrania podsumowania przetwarzania. Te informacje są dostarczane za pomocą `getPlatformContext` zapytania. 

Typowe przypadki: 

* Śledzenie postępu przetwarzania
* Zbieranie podsumowań i statystyk przetwarzania
* Obserwacja błędów i ostrzeżeń podczas przetwarzania w celu dalszego, głębszego zbadania dotkniętych zestawów danych

{% code overflow="wrap" lineNumbers="true" %}

```graphql
query CollectPlatformContext {
 getPlatformContext(input: {
   userUuids: ["<placeholder_of_user_uuid>"],
   statuses: [Start, Done, Warning, Error, Ignored],
   dateFrom: "2023-05-25T12:49:00.000Z", 
   dateTo: "2023-05-30T06:35:00.000Z", 
 }) {
   events {
     fieldUuid
     subFieldUuid
     subFieldType
     operationId
     status 
     executionDate
     messageKey
     optional
   }
 }
}
```

{% endcode %}

Obsługiwane filtry wejściowe:

* `dateFrom` jako data i godzina w formacie ISO 8601 (np.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` jako data i godzina w formacie ISO 8601 (np.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` jako tablica identyfikatorów operacji (`Ciagi znaków`)
* `statuses` jako tablica zawierająca wartości z `ContextEventStatus` wyliczenia (enum) ze wszystkimi statusami przetwarzania, w tym pośrednimi; zaleca się używać kluczowych `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` jako tablica zawierająca wartości `TreeNodeEntity` wyliczenia (enum) ze wszystkimi encjami GeoPard
* `subFieldUuids` jako tablica UUID powiązanych z wybranymi encjami w `subFieldTypes`&#x20;
* `userUuids` jako tablica UUID użytkowników ("User"), po których ma być wyszukiwanie

{% hint style="info" %}
Przynajmniej jeden z następujących filtrów musi być zainicjowany: `userUuids`, `fieldUuids`, `subFieldUuids`, lub `operationIds`.
{% endhint %}

{% hint style="info" %}
Jeśli `dateFrom` i `dateTo` nie są określone, domyślny okres zapytania ustawiony jest na 12 godzin. Maksymalny zalecany zakres czasu dla pobierania danych to 24 godziny.
{% endhint %}

{% hint style="info" %}
Istnieje limit maksymalnie 10 000 zwracanych wierszy.
{% endhint %}

{% hint style="info" %}
Aby zobaczyć wszystkie dostępne, najnowsze wartości enumów (np.: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), zaleca się użycie [Altair](/geopard-tutorials/pl/dokumentacja-api/pierwsze-kroki-z-api-geopard.md).
{% endhint %}

Obiekt wyjściowy zawiera następujące atrybuty:

* `fieldUuid` reprezentuje UUID powiązanego pola (Field)
* `subFieldUuid` oznacza UUID powiązanego przetworzonego zestawu danych (takiego jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.)
* `subFieldType` jako enum powiązany z `TreeNodeEntity`
* `operationId` jako ciąg znaków, który zawiera identyfikator operacji; pozostaje on spójny w całych powiązanych łańcuchach przetwarzania — zaleca się grupowanie po tym identyfikatorze w celu śledzenia wszystkich etapów przetwarzania
* `status` jako enum powiązany z `ContextEventStatus`
* `executionDate` jako ciąg znaków w formacie ISO 8601, wskazujący moment wykonania
* `messageKey` jako enum powiązany z `ContextMessageKey` który opisuje wynik wykonania
* `optional` jako ciąg znaków zawierający opis techniczny (jeśli istotny); jest on wykorzystywany głównie do debugowania i zgłaszania błędów


---

# 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.geopard.tech/geopard-tutorials/pl/dokumentacja-api/przeglad-zadan-api-geopard/83.-zapytanie-zbierz-kontekst-platformy.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.