> 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/fin/tuote-esittely-verkkosovellus/geopard-mcp/geopard-mcp-capabilities.md).

# GeoPard MCP:n kyvykkyydet

Täydellinen viite GeoPard MCP:n kyvykkyyksiin: mitä AI Assistant voi lukea, analysoida, luoda ja viedä GeoPard-tililläsi.

## GeoPard MCP:n ominaisuudet

GeoPard MCP antaa yhteensopiville tekoälyavustajille rajatun käyttöoikeuden GeoPard-tilillesi. Se toimii oikeilla maatilatiedoillasi. Se voi analysoida lohkojen sisäistä vaihtelua, luoda käytännön toiminnan aineistoja ja lähettää ne työkoneisiin.

Sen avulla voit luoda vyöhykekarttoja, levityskarttoja, näytteenottosuunnitelmia ja koneille valmiita tiedostoja. Näin valmisteluun kuluu vähemmän aikaa, mutta tarkastelu ja hyväksyntä pysyvät sinun käsissäsi.

Käyttöönotto-ohjeet ovat ohjeissa [GeoPard MCP:n yhdistäminen](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/connect-geopard-mcp.md) ja [GeoPard MCP -yhteyden tarkistaminen](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/verify-geopard-mcp-connection.md).

{% hint style="info" %}
Kaikki datatyökalut toimivat OAuth-istuntosi kautta. Avustaja käyttää vain niitä maatiloja, lohkoja ja aineistoja, jotka ovat GeoPard-käyttäjäsi käytettävissä.
{% endhint %}

### Ominaisuuksien yleiskuva

| Ryhmä               | Toiminto                                                                    |
| ------------------- | --------------------------------------------------------------------------- |
| Tietojen haku       | Etsi maatiloja, lohkoja ja lohkojen tietotasoja, mukaan lukien topografia   |
| Analytiikka         | Laske kasvillisuustilastoja, maaston ominaisuuksia ja agronomisia yhtälöitä |
| Vyöhykkeet ja VRA   | Luo vyöhykekarttoja ja määritä levitysmäärät                                |
| Satotietojen laatu  | Puhdista ja kalibroi satotietoaineistoja sekä luo niitä                     |
| Näytteenotto        | Luo ruudukko- ja vyöhykepohjaisia näytteenottosuunnitelmia reitityksineen   |
| Vienti ja työkoneet | Vie tiedostoja, lähetä tietoja John Deereen ja luo WorkPlan-suunnitelmia    |
| Navigointi          | Avaa tarkkoja GeoPard-näkymiä visuaalista tarkastelua varten                |

### Tietojen haku ja konteksti

Avustaja selvittää ensin maatilan ja lohkon kontekstin. Näin kaikki vastaukset perustuvat tietoihisi.

| Työkalu                    | Tarkoitus                                                                                          |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| `searchFarms`              | Luettele ja suodata maatiloja                                                                      |
| `searchFields`             | Etsi lohkoja maatilan, nimen tai suodattimien perusteella                                          |
| `searchSatelliteImages`    | Etsi lohkon kuvia määritetyltä aikaväliltä                                                         |
| `searchSoilDatasets`       | Etsi maanäytteiden laboratorio- ja anturiaineistoja                                                |
| `searchTopographyDatasets` | Etsi topografiakarttoja: DEM, kaltevuus, ilmansuunta, vinovalovarjoste, TPI, TRI ja pinnan karheus |
| `searchYieldDatasets`      | Etsi satokauden satotietoaineistoja lohkon ja kauden perusteella                                   |
| `searchAsAppliedDatasets`  | Etsi työkoneiden levitystietoja                                                                    |
| `searchZonesMaps`          | Etsi vyöhykekarttoja, geometrioita ja määritettyjä levitysmääriä                                   |
| `searchEquationMaps`       | Etsi aiemmin luotuja yhtälökarttoja                                                                |
| `searchSamplingPlans`      | Etsi suunnitelmia lohkon, tyypin, tilan tai vyöhykekartan perusteella                              |
| `searchTrials`             | Etsi lajike- ja koeruutukokeita                                                                    |
| `searchProvider`           | Hae John Deeren, CNH:n ja AGCO:n organisaatioita, maatiloja, lohkoja ja muita tietokerroksia.      |

**Projektion hallinta.** Hakujen tukemat `ids`, `summary`, `statistics`, ja `full` projektiot. Käytä luetteloissa tiiviitä tuloksia. Pyydä täydet tiedot vain, kun geometrioita tai ominaisuuksien tilastoja tarvitaan. Näin suurten tilien edestakainen tiedonsiirto vähenee.

### Analytiikka

#### Kasvillisuusindeksien tilastot mille tahansa geometrialle

`searchSatelliteImageryByGeometry` laskee indeksien tilastot Point-, MultiPoint-, Polygon- tai MultiPolygon-geometrialle aikavälillä. Käytä sitä epäilyttävän alueen tarkasteluun, vyöhykkeiden vertailuun tai koeruutukaistojen arviointiin.

* **Palveluntarjoajat:** Sentinel-2, Landsat 4, 5, 7, 8, 9 ja Planet.
* **Indeksit:** 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 ja NDYI.

#### Topografia ja maasto

`searchTopographyDatasets` hakee pellolle saatavilla olevat maastokerrokset. Käytä sitä veden liikkeen, eroosioriskin, kylmien kohtien ja satokuviota selittävien tekijöiden tarkasteluun – asioiden, joita pelkät satelliittikuvat eivät paljasta.

* **Tasot:** DEM, kaltevuus, suunta, varjostus, yhdistetty varjostus, TPI, TRI ja karheus.
* **Suodattimet:** maatila, lohko, tiettyjen topografiakarttojen UUID-tunnukset ja tila `SAVED`, `EXECUTED`, `ERROR`, tai `EMPTY`.
* **Projektiot:** `ids`, `summary`, `statistics`, ja `full`, kuten muissakin hauissa.

Maatila- tai lohkosuodatin on pakollinen, sillä topografiakartat kuuluvat lohkoille.

Maaston ominaisuuksia voidaan käyttää suoraan `generateEquationMap`. Yhdistä kaltevuus maaperä- ja satelliittikuviotietoihin kalkituksen ja ojituksen suunnittelussa, vähennä kylvömäärää eroosioherkillä harjanteilla tai säädä muokkauksen syvyyttä paikkakohtaisesti. Topografiakartat voidaan myös siirtää John Deereen karttatasoina ohjaamossa tarkasteltaviksi.

#### Yhtälöihin perustuva agronomia

`generateEquationMap` suorittaa läpinäkyviä kaavoja useille tietokerroksille ja tallentaa tuloksen kartaksi.

* **Syötemuuttujat** voivat olla satelliittikuvien indeksejä, maaperän ominaisuuksia, satotietoja, levitys- tai kylvökarttatietoja, topografiatietoja, vyöhykekarttoja ja yhtälökarttoja.
* **Testiajo** on oletusarvoisesti `true`. Se tarkistaa syntaksin näytearvoilla ennen kartan luontia.
* **NumPy-tuki** mahdollistaa ehdollisen logiikan esimerkiksi funktioilla `np.where` ja `np.isnan`.

Valitse manuaalinen ruudukko tai AB-linjoihin perustuva ruudukko. AB-linjaruudukoissa käytetään koneen työleveyttä, päisteitä, lohkoja, levityspituutta ja kääntösädettä. Näin viljelysuunnitelmat vastaavat todellisia peltotöitä.

Tuetut käyttötarkoitukset ovat `GENERAL`, `SEEDING`, `FERTILIZING`, `SPRAYING`ja `IRRIGATION`.

#### Geometriat ja rasterien käyttö

| Työkalu         | Tarkoitus                                                           |
| --------------- | ------------------------------------------------------------------- |
| `fetchGeoJson`  | Hae GeoPardin WFS-URL-osoitteesta GeoJSON FeatureCollection         |
| `getGeoMapUrls` | Hae kartan renderöidyt URL-osoitteet visuaalista tarkastelua varten |

### Vyöhykkeet ja muuttuva annostelu

| Työkalu               | Tarkoitus                                                                                     |
| --------------------- | --------------------------------------------------------------------------------------------- |
| `saveZonesMap`        | Luo vyöhykkeitä Polygon- tai MultiPolygon-geometrioista; annostelut ja värit ovat valinnaisia |
| `assignZonesMapRates` | Määritä enintään kolmen tuotteen annostelut olemassa olevaan karttaan                         |

Jokaisella tuotteella on nimi ja annosteluyksikkö sekä haluttaessa yksikköhinta. Yhdessä kartassa voi olla MAP-lannoitteen, urean ja siementen annostelut. Tuettuja yksiköitä ovat metriset ja brittiläiset massa- ja tilavuusyksiköt, siemenmäärät, valuutta pinta-alaa kohti sekä muokkaussyvyys.

{% hint style="warning" %}
`assignZonesMapRates` päivittää olemassa olevan kartan. Ensimmäinen kutsu palauttaa annostelujen vertailun esikatselun. GeoPard tallentaa muutokset vasta nimenomaisen vahvistuksen jälkeen.
{% endhint %}

### Satotietojen laatu

| Työkalu                         | Tarkoitus                                               |
| ------------------------------- | ------------------------------------------------------- |
| `cleanCalibrateYieldDataset`    | Puhdista ja kalibroi satotietoaineisto                  |
| `generateSyntheticYieldDataset` | Luo satotaso, kun mitattua satotietoa ei ole saatavilla |

**Puhdistusasetukset** sisältävät automaattisen puhdistuksen, ominaisuuksien minimi- ja maksimirajojen suodatuksen, sigmasuodatuksen ja USDA-protokollan. USDA-työnkulussa voi määrittää viljelykasvikohtaiset asetukset sadolle, kosteudelle, ajonopeudelle, ajoitukselle, työleveydelle ja päällekkäisyydelle.

**Kalibrointiasetuksilla** voidaan kohdistaa pellon keskiarvoon tai kokonaissatoon. Arvot voidaan rajata määritetylle välille. Kalibrointi voidaan myös tehdä koneen ajouran perusteella säädettävällä tasoituksella.

Synteettisen sadon muodostus tukee maissia, maissisäilörehua, soijapapua, vehnää, puuvillaa, riisiä, ohraa, kauraa, durraa, rapsia, auringonkukkaa ja ruista. Määritä tavoitekeskiarvo tai -kokonaismäärä, satovuosi ja päivämäärä.

{% hint style="info" %}
Satotietojen puhdistus ja kalibrointi edellyttävät ennakkotarkistusta. Tarkista aineiston tilastot ja vahvista epäselvät kohdeominaisuudet ennen korjausten suorittamista.
{% endhint %}

### Maanäytteenottosuunnitelmat

`generateSamplingPlan` luo tai päivittää `GRID` ja `ZONE` -suunnitelmat pellolle.

* **Sijoittelu:** GeoPard Core Line-, Optimized Coverage-, NZ- tai W-kuvio.
* **Reititys:** Vyöhykekohtainen reititys tai älykäs järjestys vyöhykkeiden välillä.
* **Näytteenotto:** Määritä pisteiden määrä vyöhykettä kohti, syvyys sekä Core- tai Composite-menetelmä.

Valitse analyysimenetelmät, kuten Olsen, Bray, Mehlich, DTPA, maaperän hiili, maaprofiilin nitraatti, kosteus, maalaji, kasvikudos, viljanäytteenotto, kasvuston tarkkailu, kasteluvesi ja lanta. Nimilappumallit pitävät suunnitelmat ja laboratorioon toimitettavat näytteet yhdenmukaisina.

Suunnitelmat lisätään tai päivitetään. Avustaja voi muokata olemassa olevia merkkejä tai reittejä luomatta kaksoiskappaleita.

### Vienti ja työkoneet

| Työkalu                         | Tarkoitus                                                           |
| ------------------------------- | ------------------------------------------------------------------- |
| `exportData`                    | Vie lohkot ja yhtälökartat ladattavana arkistona                    |
| `exportToJohnDeereAsFiles`      | Lähetä viety arkisto John Deere Operations Centeriin                |
| `exportToJohnDeereAsMapsLayers` | Lähetä GeoPard-kohde karttatasoksi                                  |
| `createJohnDeereWorkPlan`       | Luo kylvö- tai levitystyösuunnitelma viljelysuosituksen perusteella |
| `importJohnDeereData`           | Käynnistä asynkroninen John Deere -tuonti GeoPardiin                |

Vie muodossa `SHAPEFILE_MULTIPOLYGON`, `SHAPEFILE_POLYGON`, tai `ISOXML`. Koeruutujen geometria voidaan sisällyttää ilman päällekkäisyyttä emolohkon annosmäärien kanssa.

Karttatasot tukevat lohkoja, yhtälöitä, kuvantamista, maaperää, satoja ja topografiaa. Näin viljelijät saavat hyödyllistä visuaalista kontekstia viljelysuositusten rinnalle.

### Navigointi ja istunto

| Työkalu        | Tarkoitus                                                          |
| -------------- | ------------------------------------------------------------------ |
| `buildAppUrl`  | Luo syvälinkki tilalle, lohkolle, aineistoryhmälle tai aineistolle |
| `parseAppUrl`  | Poimi konteksti GeoPard-sovelluksen URL-osoitteesta                |
| `clearSession` | Tyhjennä istuntotiedot                                             |

Syvälinkit tukevat lopputarkastusta. Avaa täsmälleen oikea kartta GeoPardissa ennen peltotyötä.

### Tyypillinen työnkulku

1. **Selvitä konteksti.** Etsi tila ja lohko. Luettele käytettävissä olevat tasot.
2. **Arvioi vaihtelua.** Laske kasvustoindeksien tilastot. Tarkastele maaperän, topografian ja sadon tilastoja.
3. **Laadi viljelysuositus.** Tarkista yhtälö. Luo yhtälökartta tai annosmäärillä varustetut lohkot.
4. **Tarkastele ja vie.** Tarkasta viljelysuosituskartta ja vie se tai lähetä se John Deereen.
5. **Opi sadonkorjuun jälkeen.** Puhdista satotiedot. Vertaa niitä levitystietoihin. Hio seuraavan kasvukauden suunnittelua.

Tämä työnkulku auttaa kohdentamaan tuotantopanokset sinne, missä niistä saadaan paras tuotto. Se myös lyhentää analyysin ja peltotyön välistä aikaa.

### Esimerkkikehotteita

* *Anna lohkolle X Sentinel-2 NDVI -tilastot viimeiseltä 60 päivältä. Näytä, missä vaihtelu on suurinta.*
* *Luettele lohkon X topografiakartat. Selitä rinteen ja TPI:n avulla vuoden 2025 sadonkorjuun heikkosatoiset kaistat.*
* *Laadi typpiyhtälö NDVI:n ja maaperän orgaanisen aineksen perusteella. Tarkista se ja luo sitten 20 metrin ruudukko.*
* *Luo lohkolle X neljän vyöhykkeen lannoituskartta. Käytä MAP-annosmääriä 120, 100, 85 ja 70 kg/ha. Näytä esikatselu ennen tallentamista.*
* *Puhdista vuoden 2025 maissisadon aineisto USDA-protokollan mukaisesti. Kalibroi kokonaissadoksi 1 240 tonnia.*
* *Laadi vyöhykekohtainen näytteenottosuunnitelma: kolme näytettä vyöhykettä kohti, 20 cm:n syvyydestä, Mehlich3-analyysi ja älykäs reititys.*
* *Lähetä viljelysuosituskartta John Deere -organisaatiooni työsuunnitelmana.*

### Suojarajat

* **Rajattu käyttöoikeus.** OAuth-pohjainen käyttöoikeus noudattaa kunkin käyttäjän käyttöoikeuksia.
* **Vahvistusvaiheet.** Tuhoavat kirjoitustoiminnot edellyttävät esikatselua ja nimenomaista hyväksyntää.
* **Kuiva-ajot.** Yhtälöt validoidaan ennen kartan luomista.
* **Alkutarkistukset.** Satokorjaukset edellyttävät tarkistettuja tilastoja ja vahvistettuja määritteitä.
* **Tietosi pysyvät sinun ominasi.** GeoPard muotoilee tietosi päättelyä varten. Säilytät niiden omistajuuden ja hallinnan.

{% hint style="warning" %}
GeoPard MCP tukee päätöksentekoa, mutta ei korvaa paikallista agronomista harkintaa. Tarkista levitysmäärät, yhtälöt ja yksiköt viljelysuunnitelmien, maaperäanalyysien, tuoteselosteiden ja paikallisten määräysten mukaisiksi ennen levitystä.
{% endhint %}

### Aiheeseen liittyvät sivut

* [Yhdistä GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/connect-geopard-mcp.md)
* [Tarkista GeoPard MCP -yhteys](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/verify-geopard-mcp-connection.md)
* [Muokkauksen optimaalinen syvyys](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/optimal-tillage-depth.md)
* [Selitä kasvillisuuden jakautumista](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-mcp/explain-vegetation-patterns.md)
* [Puhdista ja kalibroi satotiedot](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/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/fin/tuote-esittely-verkkosovellus/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.
