> 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/bg/api-dokumentaciya/pregled-na-zayavkite-v-geopard-api/83.-zayavka-sbirane-na-kontekst-ot-platformata.md).

# 83. Заявка: Събиране на контекст от платформата

При голям брой (стотици или хиляди) обработвани набори от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.) винаги има необходимост да се разбере статусът на обработката на всеки набор и да се събере обобщение на обработката. Тези подробности се предоставят чрез `getPlatformContext` заявка. 

Честите случаи: 

* Проследяване на напредъка на обработката
* Събиране на обобщение и статистика за обработката
* Наблюдение на грешки и предупреждения по време на обработката за по-нататъшно по-задълбочено разследване на засегнатите набори от данни

{% 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 %}

Поддържани входни филтри:

* `dateFrom` като дата и час в ISO 8601 формат (напр.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` като дата и час в ISO 8601 формат (напр.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` като масив от идентификатори на операции (`Низове`)
* `statuses` като масив съдържащ стойности от `ContextEventStatus` изброим тип с всички статуси на обработка, включително междинни; препоръчва се да се използват основните ключови `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` като масив съдържал стойности на `TreeNodeEntity` изброим тип с всички GeoPard ентити
* `subFieldUuids` като масив с UUID-та свързани с избраните ентити в `subFieldTypes`&#x20;
* `userUuids` като масив от UUID-та на „User“ за търсене

{% hint style="info" %}
Трябва да е инициализиран поне един от следните филтри: `userUuids`, `fieldUuids`, `subFieldUuids`, или `operationIds`.
{% endhint %}

{% hint style="info" %}
Ако `dateFrom` и `dateTo` не са зададени, по подразбиране периодът за заявката е 12 часа. Максималният препоръчителен времеви интервал за извличане на данни е 24 часа.
{% endhint %}

{% hint style="info" %}
Има ограничение от максимум 10 000 върнати реда.
{% endhint %}

{% hint style="info" %}
За да се видят всички налични най-нови стойности на изброими типове (като: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), се препоръчва да се използва [Altair](/geopard-tutorials/bg/api-dokumentaciya/prvi-stpki-s-geopard-api.md).
{% endhint %}

Изходният обект включва следните атрибути:

* `fieldUuid` представлява UUID на свързаното поле
* `subFieldUuid` означава UUID на свързания обработен набор от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.)
* `subFieldType` като изброим тип свързан с `TreeNodeEntity`
* `operationId` като низ, който съдържа идентификатора на операцията; той остава постоянен във всички свързани вериги на обработка, препоръчително е да се групира по този идентификатор, за да се проследят всички етапи на обработка
* `status` като изброим тип свързан с `ContextEventStatus`
* `executionDate` като низ в ISO 8601 формат, който указва момента на изпълнение
* `messageKey` като изброим тип свързан с `ContextMessageKey` който описва резултата от изпълнението
* `optional` като низ, който предоставя техническо описание (ако е релевантно); основно се използва за отстраняване на грешки и докладване на бъгове


---

# 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/bg/api-dokumentaciya/pregled-na-zayavkite-v-geopard-api/83.-zayavka-sbirane-na-kontekst-ot-platformata.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.