> 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/it/tour-del-prodotto-app-web/geopard-mcp/geopard-mcp-capabilities.md).

# Funzionalità di GeoPard MCP

Riferimento completo delle funzionalità di GeoPard MCP: cosa può leggere, analizzare, creare ed esportare un assistente AI nel tuo account GeoPard.

## Funzionalità di GeoPard MCP

GeoPard MCP consente agli assistenti IA compatibili di accedere al tuo account GeoPard con le autorizzazioni previste. Opera sui dati reali della tua azienda agricola. Può analizzare la variabilità degli appezzamenti, creare prodotti operativi e inviarli alle macchine agricole.

Usalo per creare mappe di zone, mappe di prescrizione, piani di campionamento e file pronti per le macchine. In questo modo riduci il tempo dedicato alla preparazione manuale, mantenendo il controllo della revisione e dell’approvazione.

Per la configurazione, consulta [Connettere GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/connect-geopard-mcp.md) e [Verificare la connessione a GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/verify-geopard-mcp-connection.md).

{% hint style="info" %}
Ogni strumento per i dati opera tramite la tua sessione OAuth. L’assistente accede solo alle aziende agricole, agli appezzamenti e ai dataset disponibili per il tuo utente GeoPard.
{% endhint %}

### Panoramica delle funzionalità

| Gruppo                           | Funzione                                                                                           |
| -------------------------------- | -------------------------------------------------------------------------------------------------- |
| Individuazione                   | Individua aziende agricole, appezzamenti e layer di dati degli appezzamenti, inclusa la topografia |
| Analisi                          | Calcola statistiche sulla vegetazione, dati sul contesto del terreno ed equazioni agronomiche      |
| Zone e VRA                       | Crea mappe di zone e assegna dosi di prodotto                                                      |
| Qualità dei dati di resa         | Pulisci e calibra i dati di resa e genera dataset                                                  |
| Campionamento                    | Crea piani di campionamento basati su griglie e zone, con percorsi                                 |
| Esportazione e macchine agricole | Esporta file, inviali a John Deere e crea WorkPlan                                                 |
| Navigazione                      | Apri viste GeoPard precise per una verifica visiva                                                 |

### Individuazione e contesto

Per prima cosa, l’assistente identifica l’azienda agricola e l’appezzamento pertinenti. In questo modo, ogni risposta si basa sui tuoi dati.

| Strumento                  | Scopo                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| `searchFarms`              | Elenca e filtra le aziende agricole                                                              |
| `searchFields`             | Individua gli appezzamenti in base all’azienda agricola, al nome o ai filtri                     |
| `searchSatelliteImages`    | Individua immagini degli appezzamenti in un intervallo di date                                   |
| `searchSoilDatasets`       | Individua dataset di analisi del suolo e dei sensori                                             |
| `searchTopographyDatasets` | Individua mappe topografiche: DEM, pendenza, esposizione, ombreggiatura, TPI, TRI e rugosità     |
| `searchYieldDatasets`      | Individua dataset di raccolta per appezzamento e stagione                                        |
| `searchAsAppliedDatasets`  | Individua registrazioni delle applicazioni effettuate dalle macchine agricole                    |
| `searchZonesMaps`          | Individua mappe di zone, geometrie e dosi assegnate                                              |
| `searchEquationMaps`       | Individua mappe di equazioni generate in precedenza                                              |
| `searchSamplingPlans`      | Individua piani in base all’appezzamento, al tipo, allo stato o alla mappa di zone               |
| `searchTrials`             | Trova le prove di dose e varietà                                                                 |
| `searchProvider`           | Cerca organizzazioni, aziende agricole, campi e altri livelli di dati in John Deere, CNH e AGCO. |

**Controllo delle proiezioni.** Le ricerche supportano le proiezioni `ids`, `summary`, `statistics` e `full` . Usa risultati compatti per gli elenchi. Richiedi i dettagli completi solo quando servono geometrie o statistiche degli attributi. In questo modo si riducono le chiamate di rete negli account di grandi dimensioni.

### Analisi

#### Statistiche degli indici di vegetazione su qualsiasi geometria

`searchSatelliteImageryByGeometry` calcola le statistiche degli indici per un Point, MultiPoint, Polygon o MultiPolygon in un intervallo di date. Usalo per esaminare un'area sospetta, confrontare zone o valutare strisce di prova.

* **Provider:** Sentinel-2, Landsat 4, 5, 7, 8, 9 e Planet.
* **Indici:** 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 e NDYI.

#### Topografia e terreno

`searchTopographyDatasets` individua i livelli del terreno disponibili per un campo. Usalo per spiegare il movimento dell'acqua, il rischio di erosione, le zone fredde e gli andamenti della resa che le sole immagini non mostrano.

* **Livelli:** DEM, pendenza, esposizione, hillshade, hillshade combinato, TPI, TRI e rugosità.
* **Filtri:** azienda agricola, campo, UUID specifici delle mappe topografiche e stato `SAVED`, `EXECUTED`, `ERROR` oppure `EMPTY`.
* **Proiezioni:** `ids`, `summary`, `statistics` e `full`, come per le altre ricerche.

È necessario applicare un filtro per azienda agricola o campo, perché le mappe topografiche appartengono ai campi.

Gli attributi del terreno confluiscono direttamente in `generateEquationMap`. Combina la pendenza con i dati del suolo e le immagini per pianificare gli interventi di calcitazione e drenaggio, ridurre la semina sui dossi erosi o impostare una profondità di lavorazione variabile. Le mappe topografiche possono anche essere inviate a John Deere come Map Layers per fornire un contesto in cabina.

#### Agronomia basata su equazioni

`generateEquationMap` applica formule trasparenti a più livelli e salva il risultato come mappa.

* **Variabili di input** possono utilizzare indici delle immagini, attributi del suolo, dati di resa, dati di applicazione, topografia, mappe delle zone e mappe basate su equazioni.
* **Esecuzione di prova** è impostata per impostazione predefinita su `true`. Convalida la sintassi con valori di esempio prima della generazione.
* **Supporto NumPy** consente di usare la logica condizionale con funzioni come `np.where` e `np.isnan`.

Scegli una griglia manuale o una griglia basata su linee AB. Le griglie basate su linee AB utilizzano la larghezza di lavoro della macchina, le capezzagne, le sezioni, la lunghezza di applicazione e il raggio di svolta. In questo modo, le prescrizioni corrispondono alle effettive operazioni in campo.

Gli scopi supportati sono `GENERAL`, `SEEDING`, `FERTILIZING`, `SPRAYING`, e `IRRIGATION`.

#### Accesso a geometrie e raster

| Strumento       | Scopo                                                            |
| --------------- | ---------------------------------------------------------------- |
| `fetchGeoJson`  | Recupera una FeatureCollection GeoJSON da un URL WFS di GeoPard  |
| `getGeoMapUrls` | Recupera gli URL delle mappe renderizzate per l'ispezione visiva |

### Zone e rateo variabile

| Strumento             | Scopo                                                                       |
| --------------------- | --------------------------------------------------------------------------- |
| `saveZonesMap`        | Crea zone da geometrie Polygon o MultiPolygon, con ratei e colori opzionali |
| `assignZonesMapRates` | Assegna i ratei di un massimo di tre prodotti a una mappa esistente         |

Ogni prodotto ha un nome, un'unità di misura del rateo e, facoltativamente, un prezzo per unità. Una mappa può includere i ratei di MAP, urea e sementi. Le unità supportate comprendono massa e volume metrici e imperiali, quantità di sementi, valuta per superficie e profondità di lavorazione.

{% hint style="warning" %}
`assignZonesMapRates` aggiorna una mappa esistente. La prima chiamata restituisce un'anteprima comparativa dei ratei. GeoPard applica le modifiche solo dopo una conferma esplicita.
{% endhint %}

### Qualità dei dati di resa

| Strumento                       | Scopo                                                                       |
| ------------------------------- | --------------------------------------------------------------------------- |
| `cleanCalibrateYieldDataset`    | Pulisci e calibra un dataset di resa                                        |
| `generateSyntheticYieldDataset` | Crea un layer di resa quando non sono disponibili dati di raccolta misurati |

**Le opzioni di pulizia** includono la pulizia automatica, i filtri min/max degli attributi, i filtri sigma e il protocollo USDA. Il flusso di lavoro USDA supporta impostazioni specifiche per coltura relative a resa, umidità, velocità, tempistica, larghezza di lavoro e sovrapposizione.

**Le opzioni di calibrazione** possono avere come obiettivo una media o un totale del campo. Possono limitare i valori a un intervallo definito. Inoltre, possono calibrare lungo il percorso della macchina con una levigatura regolabile.

La resa sintetica supporta mais, mais da insilato, soia, frumento, cotone, riso, orzo, avena, sorgo, colza, girasole, ravizzone e segale. Imposta una media o un totale obiettivo, l'anno di raccolta e la data.

{% hint style="info" %}
La pulizia e la calibrazione della resa richiedono un controllo preliminare. Esamina le statistiche del dataset e conferma gli attributi obiettivo ambigui prima di avviare le correzioni.
{% endhint %}

### Piani di campionamento del suolo

`generateSamplingPlan` crea o aggiorna `GRID` e `ZONE` piani per un campo.

* **Posizionamento:** GeoPard Core Line, Optimized Coverage, NZ o schemi a W.
* **Percorso:** Percorso zona per zona o ordinamento intelligente tra le zone.
* **Campionamento:** Imposta i punti per zona, la profondità e le tecniche Core o Composite.

Seleziona i metodi di analisi, tra cui Olsen, Bray, Mehlich, DTPA, carbonio organico del suolo, nitrati nel profilo del suolo, umidità, tessitura, tessuti vegetali, campionamento dei cereali, scouting, acqua irrigua e letame. I modelli di etichette assicurano coerenza tra i piani e i campioni inviati al laboratorio.

I piani vengono creati o aggiornati. L’assistente può modificare i segnaposto o i percorsi esistenti senza creare duplicati.

### Esportazione e macchine agricole

| Strumento                       | Scopo                                                                      |
| ------------------------------- | -------------------------------------------------------------------------- |
| `exportData`                    | Esporta zone e mappe basate su equazioni come archivio scaricabile         |
| `exportToJohnDeereAsFiles`      | Invia un archivio esportato al John Deere Operations Center                |
| `exportToJohnDeereAsMapsLayers` | Invia un’entità GeoPard come livello cartografico                          |
| `createJohnDeereWorkPlan`       | Crea un WorkPlan di semina o di applicazione a partire da una prescrizione |
| `importJohnDeereData`           | Avvia un’importazione asincrona da John Deere a GeoPard                    |

Esporta come `SHAPEFILE_MULTIPOLYGON`, `SHAPEFILE_POLYGON`, oppure `ISOXML`. È possibile includere le geometrie delle parcelle sperimentali senza sovrapporre le dosi delle zone circostanti.

I livelli cartografici supportano zone, equazioni, immagini, dati del suolo, rese e topografia. Offrono agli operatori un utile contesto visivo insieme alle prescrizioni.

### Navigazione e sessione

| Strumento      | Scopo                                                                                |
| -------------- | ------------------------------------------------------------------------------------ |
| `buildAppUrl`  | Crea un deep link a un’azienda agricola, un campo, un gruppo di risorse o un dataset |
| `parseAppUrl`  | Estrae il contesto da un URL dell’app GeoPard                                        |
| `clearSession` | Cancella i dati della sessione                                                       |

I deep link supportano la revisione finale. Apri in GeoPard la mappa esatta prima di un’operazione in campo.

### Flusso di lavoro tipico

1. **Individua il contesto.** Trova l’azienda agricola e il campo. Elenca i livelli disponibili.
2. **Valuta la variabilità.** Calcola le statistiche degli indici. Esamina le statistiche del suolo, della topografia e della resa.
3. **Crea la prescrizione.** Convalida un’equazione. Genera una mappa basata su equazioni o zone con dosi.
4. **Esamina ed esporta.** Esamina la mappa di prescrizione, quindi esportala o inviala a John Deere.
5. **Impara dopo il raccolto.** Pulisci i dati di resa. Confrontali con i dati di applicazione. Perfeziona la strategia per la prossima stagione.

Questo flusso di lavoro aiuta a distribuire gli input dove garantiscono il miglior ritorno. Riduce anche il tempo tra l’analisi e l’esecuzione in campo.

### Esempi di prompt

* *Per il campo X, forniscimi le statistiche NDVI di Sentinel-2 degli ultimi 60 giorni. Mostrami dove la variabilità è più elevata.*
* *Elenca le mappe topografiche del campo X. Usa pendenza e TPI per spiegare le strisce a bassa resa nel raccolto del 2025.*
* *Crea un’equazione per l’azoto usando NDVI e sostanza organica del suolo. Convalidala, quindi genera una griglia di 20 m.*
* *Crea una mappa di fertilizzazione a quattro zone per il campo X. Usa dosi di MAP di 120, 100, 85 e 70 kg/ha. Mostra l’anteprima prima di salvare.*
* *Pulisci il dataset di resa del mais del 2025 usando il protocollo USDA. Calibra il totale a 1.240 tonnellate.*
* *Crea un piano di campionamento basato su zone con tre carote per zona, profondità di 20 cm, metodo Mehlich3 e percorso ottimizzato.*
* *Invia la mappa di prescrizione alla mia organizzazione John Deere come WorkPlan.*

### Vincoli di sicurezza

* **Accesso limitato all’ambito previsto.** L’accesso basato su OAuth rispetta le autorizzazioni di ciascun utente.
* **Passaggi di conferma.** Le scritture che modificano i dati in modo irreversibile richiedono un’anteprima e un’approvazione esplicita.
* **Esecuzioni di prova.** Le equazioni vengono convalidate prima di generare la mappa.
* **Controlli preliminari.** Le correzioni della resa richiedono statistiche esaminate e attributi confermati.
* **I tuoi dati restano tuoi.** GeoPard prepara i tuoi dati per l’elaborazione. Mantieni la proprietà e il controllo dei tuoi dati.

{% hint style="warning" %}
GeoPard MCP supporta il processo decisionale, ma non sostituisce il giudizio agronomico locale. Prima dell’applicazione, verifica i dosaggi, le equazioni e le unità di misura confrontandoli con i piani colturali, le analisi del suolo, le etichette dei prodotti e le normative locali.
{% endhint %}

### Pagine correlate

* [Connettere GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/connect-geopard-mcp.md)
* [Verificare la connessione a GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/verify-geopard-mcp-connection.md)
* [Profondità ottimale di lavorazione del terreno](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/optimal-tillage-depth.md)
* [Spiegare i pattern della vegetazione](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/geopard-mcp/explain-vegetation-patterns.md)
* [Pulire e calibrare i dati di resa](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/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/it/tour-del-prodotto-app-web/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.
