> 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/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/geopard-mcp-capabilities.md).

# Capacidades do MCP do GeoPard

Referência completa de capacidades do MCP do GeoPard: o que um assistente de IA pode ler, analisar, criar e exportar na sua conta GeoPard.

## Recursos do GeoPard MCP

O GeoPard MCP permite que assistentes de IA compatíveis acessem sua conta GeoPard com as permissões adequadas. Ele funciona com os dados reais da sua fazenda. Pode analisar a variabilidade dos talhões, criar materiais operacionais e enviá-los para as máquinas.

Use-o para criar mapas de zonas, mapas de prescrição, planos de amostragem e arquivos prontos para uso em máquinas. Isso reduz o tempo de preparação manual e mantém a revisão e a aprovação sob seu controle.

Para configurar, consulte [Conectar o GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/connect-geopard-mcp.md) e [Verificar a conexão do GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/verify-geopard-mcp-connection.md).

{% hint style="info" %}
Todas as ferramentas de dados são executadas na sua sessão OAuth. O assistente acessa apenas as fazendas, os talhões e os conjuntos de dados disponíveis para seu usuário do GeoPard.
{% endhint %}

### Mapa de recursos

| Grupo                                | O que faz                                                                       |
| ------------------------------------ | ------------------------------------------------------------------------------- |
| Descoberta                           | Encontra fazendas, talhões e camadas de dados dos talhões, incluindo topografia |
| Análises                             | Calcula estatísticas de vegetação, contexto do terreno e equações agronômicas   |
| Zonas e VRA                          | Cria mapas de zonas e atribui taxas de aplicação de produtos                    |
| Qualidade dos dados de produtividade | Limpa e calibra conjuntos de dados de produtividade e gera novos                |
| Amostragem                           | Cria planos de amostragem em grade ou por zonas, com rotas                      |
| Exportação e máquinas                | Exporta arquivos, envia dados para o John Deere e cria WorkPlans                |
| Navegação                            | Abre visualizações precisas do GeoPard para análise visual                      |

### Descoberta e contexto

Primeiro, o assistente identifica o contexto da sua fazenda e dos seus talhões. Assim, todas as respostas se baseiam nos seus dados.

| Ferramenta                 | Finalidade                                                                                         |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| `searchFarms`              | Lista e filtra fazendas                                                                            |
| `searchFields`             | Encontra talhões por fazenda, nome ou filtros                                                      |
| `searchSatelliteImages`    | Encontra imagens de talhões em um intervalo de datas                                               |
| `searchSoilDatasets`       | Encontra conjuntos de dados de análises de solo e sensores                                         |
| `searchTopographyDatasets` | Encontra mapas topográficos: DEM, declividade, orientação, relevo sombreado, TPI, TRI e rugosidade |
| `searchYieldDatasets`      | Encontra conjuntos de dados de colheita por talhão e safra                                         |
| `searchAsAppliedDatasets`  | Encontra registros de aplicação de máquinas                                                        |
| `searchZonesMaps`          | Encontra mapas de zonas, geometrias e taxas atribuídas                                             |
| `searchEquationMaps`       | Encontra mapas de equações gerados anteriormente                                                   |
| `searchSamplingPlans`      | Encontra planos por talhão, tipo, status ou mapa de zonas                                          |
| `searchTrials`             | Encontrar ensaios de taxa e variedade                                                              |
| `searchProvider`           | Pesquise organizações, fazendas, talhões e outras camadas de dados na John Deere, CNH e AGCO.      |

**Controle de projeção.** As buscas aceitam `ids`, `summary`, `statistics`, e `full` como projeções. Use resultados compactos em listagens. Solicite todos os detalhes somente quando precisar de geometrias ou estatísticas de atributos. Isso reduz as chamadas em contas grandes.

### Análises

#### Estatísticas de índices de vegetação em qualquer geometria

`searchSatelliteImageryByGeometry` calcula estatísticas de índices para um ponto, multiponto, polígono ou multipolígono ao longo de um intervalo de datas. Use-a para inspecionar uma área suspeita, comparar zonas ou avaliar faixas de ensaio.

* **Provedores:** Sentinel-2, Landsat 4, 5, 7, 8, 9 e Planet.
* **Índices:** 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 relevo

`searchTopographyDatasets` encontra as camadas de relevo disponíveis para um talhão. Use-a para explicar o movimento da água, o risco de erosão, as áreas mais frias e os padrões de produtividade que as imagens, sozinhas, não mostram.

* **Camadas:** DEM, declividade, orientação, relevo sombreado, relevo sombreado combinado, TPI, TRI e rugosidade.
* **Filtros:** fazenda, talhão, UUIDs específicos de mapas topográficos e status `SAVED`, `EXECUTED`, `ERROR`, ou `EMPTY`.
* **Projeções:** `ids`, `summary`, `statistics`, e `full`, assim como em outras buscas.

É obrigatório informar um filtro de fazenda ou talhão, pois os mapas topográficos pertencem aos talhões.

Os atributos do relevo alimentam diretamente `generateEquationMap`. Combine a declividade com dados de solo e imagens para definir a aplicação de calcário e os trabalhos de drenagem, reduzir a densidade de semeadura em cristas erodidas ou definir a profundidade variável do preparo do solo. Também é possível enviar mapas topográficos à John Deere como camadas de mapa para contextualização na cabine.

#### Agronomia baseada em equações

`generateEquationMap` aplica fórmulas transparentes a várias camadas e salva o resultado como um mapa.

* **Variáveis de entrada** podem usar índices de imagens, atributos do solo, dados de produtividade, dados de aplicação, topografia, mapas de zonas e mapas de equações.
* **Execução de teste** tem como padrão `true`. A sintaxe é validada com valores de exemplo antes da geração.
* **Suporte a NumPy** permite usar lógica condicional com funções como `np.where` e `np.isnan`.

Escolha uma grade manual ou uma grade baseada em linha AB. As grades de linha AB usam a largura de trabalho da máquina, as cabeceiras, as seções, o comprimento de aplicação e o raio de giro. Isso alinha as prescrições às operações reais no campo.

As finalidades compatíveis são `GENERAL`, `SEEDING`, `FERTILIZING`, `SPRAYING`, e `IRRIGATION`.

#### Acesso a geometrias e rasters

| Ferramenta      | Finalidade                                                       |
| --------------- | ---------------------------------------------------------------- |
| `fetchGeoJson`  | Recupera uma FeatureCollection GeoJSON de uma URL WFS do GeoPard |
| `getGeoMapUrls` | Resolve URLs de mapas renderizados para análise visual           |

### Zonas e taxa variável

| Ferramenta            | Finalidade                                                                             |
| --------------------- | -------------------------------------------------------------------------------------- |
| `saveZonesMap`        | Cria zonas a partir de geometrias Polygon ou MultiPolygon, com taxas e cores opcionais |
| `assignZonesMapRates` | Atribui taxas de até três produtos a um mapa existente                                 |

Cada produto tem um nome, uma unidade de taxa e um preço por unidade opcional. Um mapa pode incluir taxas de MAP, ureia e sementes. As unidades compatíveis incluem massa e volume nos sistemas métrico e imperial, contagem de sementes, moeda por área e profundidade de preparo do solo.

{% hint style="warning" %}
`assignZonesMapRates` atualiza um mapa existente. A primeira chamada retorna uma prévia de comparação das taxas. O GeoPard só grava as alterações após confirmação explícita.
{% endhint %}

### Qualidade dos dados de produtividade

| Ferramenta                      | Finalidade                                                               |
| ------------------------------- | ------------------------------------------------------------------------ |
| `cleanCalibrateYieldDataset`    | Limpa e calibra um conjunto de dados de produtividade                    |
| `generateSyntheticYieldDataset` | Cria uma camada de produtividade quando não há dados medidos da colheita |

**Opções de limpeza** incluem limpeza automática, filtros de valor mínimo/máximo de atributos, filtros sigma e o protocolo do USDA. O fluxo de trabalho do USDA oferece configurações específicas por cultura para produtividade, umidade, velocidade, horário, largura de passada e sobreposição.

**Opções de calibração** podem ter como referência a média ou o total do campo. Também podem limitar os valores a um intervalo definido e calibrar ao longo do trajeto da máquina, com suavização ajustável.

A geração de produtividade sintética é compatível com milho, milho para silagem, soja, trigo, algodão, arroz, cevada, aveia, sorgo, canola, girassol, colza e centeio. Defina uma média ou um total de referência, o ano da colheita e a data.

{% hint style="info" %}
A limpeza e a calibração de produtividade exigem uma verificação prévia. Analise as estatísticas do conjunto de dados e confirme os atributos de destino ambíguos antes de executar as correções.
{% endhint %}

### Planos de amostragem de solo

`generateSamplingPlan` cria ou atualiza `GRID` e `ZONE` para um campo.

* **Posicionamento:** Padrões GeoPard Core Line, Optimized Coverage, NZ ou W.
* **Roteamento:** Roteamento zona por zona ou ordenação inteligente entre zonas.
* **Amostragem:** Defina pontos por zona, profundidade e técnicas de coleta de amostra simples ou composta.

Selecione métodos de análise, incluindo Olsen, Bray, Mehlich, DTPA, carbono no solo, nitrato no perfil do solo, umidade, textura, tecido vegetal, amostragem de grãos, inspeção de campo, água de irrigação e esterco. Os modelos de etiquetas mantêm os planos e os envios ao laboratório consistentes.

Os planos são criados ou atualizados. O assistente pode ajustar pinos ou rotas existentes sem criar duplicatas.

### Exportação e máquinas

| Ferramenta                      | Finalidade                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------ |
| `exportData`                    | Exporte zonas e mapas de equações como um arquivo compactado para download     |
| `exportToJohnDeereAsFiles`      | Envie um arquivo compactado exportado para o John Deere Operations Center      |
| `exportToJohnDeereAsMapsLayers` | Envie uma entidade do GeoPard como uma camada de mapa                          |
| `createJohnDeereWorkPlan`       | Crie um plano de trabalho de semeadura ou aplicação a partir de uma prescrição |
| `importJohnDeereData`           | Inicie uma importação assíncrona do John Deere para o GeoPard                  |

Exportar como `SHAPEFILE_MULTIPOLYGON`, `SHAPEFILE_POLYGON`, ou `ISOXML`. As geometrias das parcelas experimentais podem ser incluídas sem sobrepor as taxas das zonas principais.

As camadas de mapa são compatíveis com zonas, equações, imagens, solo, produtividade e topografia. Isso oferece aos operadores um contexto visual útil junto com as prescrições.

### Navegação e sessão

| Ferramenta     | Finalidade                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------- |
| `buildAppUrl`  | Crie um link direto para uma fazenda, um talhão, um grupo de ativos ou um conjunto de dados |
| `parseAppUrl`  | Extraia o contexto de uma URL do aplicativo GeoPard                                         |
| `clearSession` | Limpe os dados da sessão                                                                    |

Os links diretos ajudam na revisão final. Abra o mapa exato no GeoPard antes de uma operação no campo.

### Fluxo de trabalho típico

1. **Identifique o contexto.** Encontre a fazenda e o talhão. Liste as camadas disponíveis.
2. **Avalie a variabilidade.** Calcule as estatísticas dos índices. Analise as estatísticas de solo, topografia e produtividade.
3. **Crie a prescrição.** Valide uma equação. Gere um mapa de equação ou zonas com taxas.
4. **Revise e exporte.** Inspecione o mapa de prescrição e, em seguida, exporte-o ou envie-o para o John Deere.
5. **Aprenda após a colheita.** Limpe os dados de produtividade. Compare-os com os dados de aplicação. Refine a estratégia para a próxima safra.

Esse fluxo de trabalho ajuda a direcionar os insumos para onde proporcionam o melhor retorno. Também reduz o tempo entre a análise e a execução no campo.

### Exemplos de prompts

* *Para o talhão X, apresente as estatísticas de NDVI do Sentinel-2 dos últimos 60 dias. Mostre onde a variabilidade é maior.*
* *Liste os mapas de topografia do talhão X. Use a declividade e o TPI para explicar as faixas de baixa produtividade na safra de 2025.*
* *Crie uma equação de nitrogênio usando NDVI e matéria orgânica do solo. Valide-a e, em seguida, gere uma grade de 20 m.*
* *Crie um mapa de fertilização com quatro zonas para o talhão X. Use taxas de MAP de 120, 100, 85 e 70 kg/ha. Mostre a prévia antes de salvar.*
* *Limpe o conjunto de dados de produtividade de milho de 2025 usando o protocolo do USDA. Calibre o total para 1.240 toneladas.*
* *Crie um plano de amostragem por zonas com três amostras por zona, profundidade de 20 cm, Mehlich3 e roteamento inteligente.*
* *Envie o mapa de prescrição para minha organização John Deere como um plano de trabalho.*

### Salvaguardas

* **Acesso com escopo definido.** O acesso baseado em OAuth respeita as permissões de cada usuário.
* **Etapas de confirmação.** Gravações destrutivas exigem uma prévia e aprovação explícita.
* **Execuções de teste.** As equações são validadas antes da geração do mapa.
* **Verificações prévias.** As correções de produtividade exigem estatísticas revisadas e atributos confirmados.
* **Seus dados continuam sendo seus.** O GeoPard formata seus dados para análise. Você mantém a propriedade e o controle.

{% hint style="warning" %}
O GeoPard MCP auxilia na tomada de decisões. Ele não substitui o julgamento agronômico local. Valide as taxas, as equações e as unidades com base nos planos de cultivo, nas análises de solo, nos rótulos dos produtos e nas regulamentações locais antes da aplicação.
{% endhint %}

### Páginas relacionadas

* [Conectar o GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/connect-geopard-mcp.md)
* [Verificar a conexão do GeoPard MCP](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/verify-geopard-mcp-connection.md)
* [Profundidade ideal de preparo do solo](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/optimal-tillage-depth.md)
* [Explicar padrões de vegetação](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/explain-vegetation-patterns.md)
* [Limpar e calibrar dados de produtividade](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-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/pt-br/tour-do-produto-aplicativo-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.
