> 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/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/geopard-mcp-capabilities.md).

# Возможности GeoPard MCP

Полный справочник возможностей GeoPard MCP: что AI-ассистент может читать, анализировать, создавать и экспортировать в вашем аккаунте GeoPard.

## Возможности GeoPard MCP

GeoPard MCP предоставляет совместимым ИИ-ассистентам доступ к вашей учётной записи GeoPard с учётом заданных разрешений. Он работает с реальными данными вашего хозяйства: анализирует неоднородность полей, создаёт рабочие материалы и отправляет их в сельхозтехнику.

Используйте его для создания карт зон, карт-заданий, планов отбора проб и файлов, готовых для загрузки в технику. Это сокращает время на ручную подготовку, а проверка и утверждение остаются за вами.

Инструкции по настройке см. в разделе [Подключение GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/connect-geopard-mcp.md) и [Проверка подключения GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/verify-geopard-mcp-connection.md).

{% hint style="info" %}
Все инструменты для работы с данными действуют в рамках вашего сеанса OAuth. Ассистент получает доступ только к тем хозяйствам, полям и наборам данных, которые доступны вашему пользователю GeoPard.
{% endhint %}

### Обзор возможностей

| Группа                             | Назначение                                                              |
| ---------------------------------- | ----------------------------------------------------------------------- |
| Поиск данных                       | Поиск хозяйств, полей и слоёв данных по полям, включая данные о рельефе |
| Аналитика                          | Расчёт статистики вегетации, анализ рельефа и агрономические расчёты    |
| Зоны и дифференцированное внесение | Создание карт зон и назначение норм внесения                            |
| Качество данных об урожайности     | Очистка и калибровка данных об урожайности, создание наборов данных     |
| Отбор проб                         | Создание планов отбора проб по сетке или зонам с прокладкой маршрута    |
| Экспорт и сельхозтехника           | Экспорт файлов, отправка данных в John Deere и создание WorkPlans       |
| Навигация                          | Открытие точных представлений GeoPard для визуальной проверки           |

### Поиск и контекст

Сначала ассистент определяет контекст хозяйства и поля. Так каждый ответ основывается на ваших данных.

| Инструмент                 | Назначение                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------- |
| `searchFarms`              | Список хозяйств и фильтрация                                                                      |
| `searchFields`             | Поиск полей по хозяйству, названию или фильтрам                                                   |
| `searchSatelliteImages`    | Поиск снимков полей за указанный период                                                           |
| `searchSoilDatasets`       | Поиск наборов данных почвенных лабораторий и датчиков                                             |
| `searchTopographyDatasets` | Поиск карт рельефа: ЦМР, уклон, экспозиция, отмывка рельефа, TPI, TRI и шероховатость поверхности |
| `searchYieldDatasets`      | Поиск наборов данных об урожайности по полю и сезону                                              |
| `searchAsAppliedDatasets`  | Поиск записей о внесении материалов сельхозтехникой                                               |
| `searchZonesMaps`          | Поиск карт зон, их геометрии и назначенных норм внесения                                          |
| `searchEquationMaps`       | Поиск ранее созданных карт по уравнениям                                                          |
| `searchSamplingPlans`      | Поиск планов по полю, типу, статусу или карте зон                                                 |
| `searchTrials`             | Найти опыты с нормами высева и сортами                                                            |
| `searchProvider`           | Поиск организаций, хозяйств, полей и других слоёв данных в John Deere, CNH и AGCO.                |

**Управление проекцией.** Параметр проекции в запросах поиска `ids`, `summary`, `statistics`, а также `full` Для проекций. Для списков используйте компактные результаты. Запрашивайте полные сведения, только если нужны геометрия или статистика атрибутов. Это сокращает число обращений к API в крупных аккаунтах.

### Аналитика

#### Статистика вегетационных индексов для любой геометрии

`searchSatelliteImageryByGeometry` рассчитывает статистику индексов для объектов Point, MultiPoint, Polygon или MultiPolygon за указанный диапазон дат. Используйте этот метод, чтобы изучить проблемный участок, сравнить зоны или оценить опытные полосы.

* **Источники:** Sentinel-2, Landsat 4, 5, 7, 8, 9 и Planet.
* **Индексы:** NDVI, EVI, EVI2, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, GFPI, NDMI, MSI, CCCI, MCARI, TCARI, MCARI\_OSAVI, TCARI\_OSAVI, MCARI1, NDWI, NIR и NDYI.

#### Топография и рельеф

`searchTopographyDatasets` находит доступные для поля слои рельефа. Используйте их, чтобы объяснить направление стока воды, риск эрозии, очаги заморозков и закономерности урожайности, которые не видны только по снимкам.

* **Слои:** DEM, уклон, экспозиция склона, отмывка рельефа, совмещённая отмывка рельефа, TPI, TRI и шероховатость.
* **Фильтры:** хозяйство, поле, UUID конкретных карт рельефа и статус `SAVED`, `EXECUTED`, `ERROR`, или `EMPTY`.
* **Проекции:** `ids`, `summary`, `statistics`, а также `full`, как и в других поисковых запросах.

Необходимо указать фильтр по хозяйству или полю, поскольку карты рельефа относятся к полям.

Атрибуты рельефа можно напрямую использовать в `generateEquationMap`. Объединяйте данные об уклоне с данными о почве и снимками, чтобы планировать известкование и дренажные работы, снижать норму высева на эродированных гребнях или задавать переменную глубину обработки почвы. Карты рельефа также можно передавать в John Deere как слои карт для отображения контекста в кабине.

#### Агрономические расчёты на основе уравнений

`generateEquationMap` применяет прозрачные формулы к нескольким слоям и сохраняет результат в виде карты.

* **Входные переменные** могут включать индексы снимков, характеристики почвы, данные об урожайности, данные о выполненных операциях, топографию, карты зон и карты уравнений.
* **Пробный запуск** по умолчанию имеет значение `true`. Перед созданием карты проверяется синтаксис на примерах значений.
* **Поддержка NumPy** позволяет задавать условную логику с помощью таких функций, как `np.where` и `np.isnan`.

Выберите ручную сетку или сетку по линиям AB. При построении сетки по линиям AB учитываются ширина захвата машины, разворотные полосы, секции, длина внесения и радиус разворота. Это позволяет согласовать карты-задания с фактическими полевыми работами.

Поддерживаются следующие назначения: `GENERAL`, `SEEDING`, `FERTILIZING`, `SPRAYING`, а также `IRRIGATION`.

#### Доступ к геометрии и растрам

| Инструмент      | Назначение                                                      |
| --------------- | --------------------------------------------------------------- |
| `fetchGeoJson`  | Получить FeatureCollection в формате GeoJSON по URL GeoPard WFS |
| `getGeoMapUrls` | Получить URL отрисованных карт для визуальной проверки          |

### Зоны и дифференцированное внесение

| Инструмент            | Назначение                                                                                    |
| --------------------- | --------------------------------------------------------------------------------------------- |
| `saveZonesMap`        | Создать зоны на основе геометрий Polygon или MultiPolygon с необязательными нормами и цветами |
| `assignZonesMapRates` | Назначить нормы для продуктов (до трех) на существующую карту                                 |

Для каждого продукта указываются название и единица измерения нормы, а также, при необходимости, цена за единицу. На одной карте можно задать нормы для MAP, мочевины и семян. Поддерживаются метрические и имперские единицы массы и объема, количество семян, валюта на единицу площади и глубина обработки почвы.

{% hint style="warning" %}
`assignZonesMapRates` обновляет существующую карту. При первом вызове возвращается предварительный просмотр сравнения норм. GeoPard вносит изменения только после явного подтверждения.
{% endhint %}

### Качество данных об урожайности

| Инструмент                      | Назначение                                                         |
| ------------------------------- | ------------------------------------------------------------------ |
| `cleanCalibrateYieldDataset`    | Очистить и откалибровать набор данных урожайности                  |
| `generateSyntheticYieldDataset` | Создать слой урожайности, если измеренные данные уборки недоступны |

**Параметры очистки** включают автоматическую очистку, фильтры минимальных и максимальных значений атрибутов, фильтры по сигмам и протокол USDA. Рабочий процесс по протоколу USDA поддерживает настройки урожайности, влажности, скорости, времени, ширины захвата и перекрытия с учетом культуры.

**Параметры калибровки** позволяют задать среднюю урожайность или общий объем. Значения можно ограничить заданным диапазоном. Также доступна калибровка по траектории машины с регулировкой сглаживания.

Синтетическую урожайность можно создавать для кукурузы, кукурузы на силос, сои, пшеницы, хлопка, риса, ячменя, овса, сорго, канолы, подсолнечника, рапса и ржи. Укажите целевую среднюю урожайность или общий объем, год уборки и дату.

{% hint style="info" %}
Очистка и калибровка урожайности требуют предварительной проверки. Проверьте статистику набора данных и подтвердите неоднозначные целевые атрибуты до запуска корректировок.
{% endhint %}

### Планы отбора проб почвы

`generateSamplingPlan` создает или обновляет `GRID` и `ZONE` планы для поля.

* **Размещение точек:** линия GeoPard Core Line, оптимизированное покрытие, узор NZ или W-образный узор.
* **Маршрут:** маршрут по зонам или интеллектуальная последовательность перемещения между зонами.
* **Отбор проб:** задайте количество точек на зону, глубину и метод отбора — точечный или составной.

Выберите методы анализа, включая Olsen, Bray, Mehlich, DTPA, содержание углерода в почве, нитраты в профиле почвы, влажность, гранулометрический состав, ткани растений, отбор проб зерна, скаутинг, поливную воду и навоз. Шаблоны маркировки помогают согласовать планы и заявки в лабораторию.

Планы создаются или обновляются. Ассистент может корректировать существующие метки или маршруты, не создавая дубликатов.

### Экспорт и сельхозтехника

| Инструмент                      | Назначение                                                        |
| ------------------------------- | ----------------------------------------------------------------- |
| `exportData`                    | Экспортировать зоны и карты по уравнению в архив для скачивания   |
| `exportToJohnDeereAsFiles`      | Отправить экспортированный архив в John Deere Operations Center   |
| `exportToJohnDeereAsMapsLayers` | Отправить объект GeoPard как слой карты                           |
| `createJohnDeereWorkPlan`       | Создать план работ по посеву или внесению на основе карты-задания |
| `importJohnDeereData`           | Запустить асинхронный импорт данных из John Deere в GeoPard       |

Экспортировать как `SHAPEFILE_MULTIPOLYGON`, `SHAPEFILE_POLYGON`, или `ISOXML`. Геометрию опытных участков можно включить, не допуская пересечения норм внесения в родительских зонах.

Слои карты поддерживают зоны, уравнения, снимки, почвенные данные, урожайность и рельеф. Они дают оператору полезный визуальный контекст наряду с картами-заданиями.

### Навигация и сеанс

| Инструмент     | Назначение                                                                 |
| -------------- | -------------------------------------------------------------------------- |
| `buildAppUrl`  | Создать прямую ссылку на хозяйство, поле, группу ресурсов или набор данных |
| `parseAppUrl`  | Извлечь контекст из URL приложения GeoPard                                 |
| `clearSession` | Очистить данные сеанса                                                     |

Прямые ссылки упрощают итоговую проверку. Перед полевой работой откройте в GeoPard нужную карту.

### Типовой рабочий процесс

1. **Определите контекст.** Найдите хозяйство и поле. Просмотрите доступные слои.
2. **Оцените изменчивость.** Рассчитайте статистику индексов. Изучите статистику почвенных данных, рельефа и урожайности.
3. **Создайте карту-задание.** Проверьте уравнение. Создайте карту по уравнению или зоны с нормами внесения.
4. **Проверьте и экспортируйте.** Изучите карту-задание, затем экспортируйте её или отправьте в John Deere.
5. **Извлеките уроки после уборки.** Очистите данные об урожайности. Сравните их с данными о фактическом внесении. Уточните логику на следующий сезон.

Этот рабочий процесс помогает вносить ресурсы там, где это принесёт наибольшую отдачу. Он также сокращает время между анализом и работой в поле.

### Примеры запросов

* *Для поля X предоставь статистику NDVI по Sentinel-2 за последние 60 дней. Покажи участки с наибольшей изменчивостью.*
* *Перечисли карты рельефа для поля X. Используй уклон и TPI, чтобы объяснить полосы с низкой урожайностью при уборке урожая 2025 года.*
* *Составь уравнение для расчёта нормы азота на основе NDVI и содержания органического вещества в почве. Проверь его, затем создай сетку с ячейками 20 м.*
* *Создай карту удобрения из четырёх зон для поля X. Используй нормы MAP 120, 100, 85 и 70 кг/га. Покажи предварительный просмотр перед сохранением.*
* *Очисти набор данных по урожайности кукурузы за 2025 год согласно протоколу USDA. Откалибруй общий объём до 1 240 тонн.*
* *Создай план отбора проб по зонам: три образца керна на зону, глубина 20 см, анализ Mehlich3 и оптимизированный маршрут.*
* *Отправь карту-задание в мою организацию John Deere как план работ.*

### Ограничения и гарантии

* **Доступ в пределах разрешений.** Доступ с использованием OAuth учитывает права каждого пользователя.
* **Требуется подтверждение.** Деструктивная запись данных требует предварительного просмотра и явного подтверждения.
* **Пробные запуски.** Уравнения проверяются до создания карты.
* **Предварительные проверки.** Корректировки урожайности требуют проверенной статистики и подтверждённых атрибутов.
* **Ваши данные остаются вашими.** GeoPard форматирует ваши данные для анализа. Вы сохраняете право собственности и контроль над ними.

{% hint style="warning" %}
GeoPard MCP помогает принимать решения, но не заменяет местную агрономическую экспертизу. Перед применением проверьте нормы внесения, уравнения и единицы измерения по планам выращивания культур, анализам почвы, инструкциям на этикетках и местным нормативам.
{% endhint %}

### Связанные страницы

* [Подключение GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/connect-geopard-mcp.md)
* [Проверка подключения GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/verify-geopard-mcp-connection.md)
* [Оптимальная глубина обработки почвы](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/optimal-tillage-depth.md)
* [Объяснение закономерностей растительности](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/explain-vegetation-patterns.md)
* [Очистка и калибровка данных об урожайности](https://docs.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/clean-and-calibrate-yield-data.md)


---

# 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.geopard.tech/geopard-tutorials/ru/obzor-produkta-veb-prilozhenie/geopard-mcp/geopard-mcp-capabilities.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.
