> 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/capacidades-do-mcp-do-geopard.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.

## Capacidades do GeoPard MCP

O GeoPard MCP concede aos assistentes de IA compatíveis acesso autorizado à sua conta GeoPard. Ele funciona com os dados reais da sua fazenda. Pode analisar a variabilidade do talhão, criar saídas operacionais e enviá-las para a máquina.

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

Para a configuração, consulte [Conectar o GeoPard MCP](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/conectar-o-geopard-mcp.md) e [Verificar conexão do GeoPard MCP](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/verificar-conexao-do-geopard-mcp.md).

{% hint style="info" %}
Cada ferramenta de dados é executada sob sua sessão OAuth. O assistente acessa apenas fazendas, talhões e conjuntos de dados disponíveis para o seu usuário GeoPard.
{% endhint %}

### Mapa de capacidades

| Grupo                                | O que faz                                                                      |
| ------------------------------------ | ------------------------------------------------------------------------------ |
| Descoberta                           | Encontrar fazendas, talhões e camadas de dados do talhão, incluindo topografia |
| Análise                              | Calcular estatísticas de vegetação, contexto de terreno e equações agronômicas |
| Zonas e VRA                          | Criar mapas de zonas e atribuir taxas de produto                               |
| Qualidade dos dados de produtividade | Limpar, calibrar e gerar conjuntos de dados de produtividade                   |
| Amostragem                           | Criar planos de amostragem em grade e baseados em zona com roteamento          |
| Exportação e máquinas                | Exportar arquivos, enviar para John Deere e criar WorkPlans                    |
| Navegação                            | Abrir visualizações precisas do GeoPard para revisão visual                    |

### Descoberta e contexto

O assistente primeiro resolve o contexto da sua fazenda e do talhão. Isso fundamenta cada resposta nos seus dados.

| Ferramenta                 | Finalidade                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------- |
| `searchFarms`              | Listar e filtrar fazendas                                                                               |
| `searchFields`             | Encontrar talhões por fazenda, nome ou filtros                                                          |
| `searchSatelliteImages`    | Encontrar imagens do talhão dentro de um intervalo de datas                                             |
| `searchSoilDatasets`       | Encontrar conjuntos de dados de laboratório e sensores de solo                                          |
| `searchTopographyDatasets` | Encontrar mapas de topografia: DEM, declividade, aspecto, sombreamento do relevo, TPI, TRI e rugosidade |
| `searchYieldDatasets`      | Encontrar conjuntos de dados de colheita por talhão e safra                                             |
| `searchAsAppliedDatasets`  | Encontrar registros de aplicação de máquinas                                                            |
| `searchZonesMaps`          | Encontrar mapas de zonas, geometrias e taxas atribuídas                                                 |
| `searchEquationMaps`       | Encontrar mapas de equações gerados anteriormente                                                       |
| `searchSamplingPlans`      | Encontrar planos por talhão, tipo, status ou mapa de zonas                                              |
| `searchTrials`             | Encontrar ensaios de taxa e variedade                                                                   |
| `searchProvider`           | Pesquisar organizações, fazendas, talhões e outras camadas de dados no John Deere, CNH e AGCO.          |

**Controle de projeção.** As pesquisas suportam `ids`, `resumo`, `estatísticas`e `completas` projeções. Use resultados compactos para listagens. Solicite detalhes completos apenas quando forem necessárias geometrias ou estatísticas de atributos. Isso reduz as idas e voltas em contas grandes.

### Análise

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

`searchSatelliteImageryByGeometry` calcula estatísticas de índice para um Point, MultiPoint, Polygon ou MultiPolygon em um intervalo de datas. Use-o 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 terreno

`searchTopographyDatasets` encontra as camadas de terreno disponíveis para um talhão. Use-o para explicar o movimento da água, o risco de erosão, pontos frios e padrões de produtividade que as imagens sozinhas não mostram.

* **Camadas:** DEM, declividade, aspecto, sombreamento do relevo, sombreamento do relevo combinado, TPI, TRI e rugosidade.
* **Filtros:** fazenda, talhão, UUIDs específicos de mapas de topografia e status `SALVO`, `EXECUTADO`, `ERRO`, ou `VAZIO`.
* **Projeções:** `ids`, `resumo`, `estatísticas`e `completas`, como nas outras buscas.

É necessário um filtro de fazenda ou talhão, porque os mapas de topografia pertencem aos talhões.

Os atributos do terreno entram diretamente em `generateEquationMap`. Combine a declividade com o solo e as imagens para posicionar calagem e drenagem, reduzir a semeadura em cristas erodidas ou definir profundidade variável de preparo do solo. Os mapas de topografia também podem ser enviados ao John Deere como Camadas de Mapas para contexto na cabine.

#### Agronomia baseada em equações

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

* **Variáveis de entrada** podem usar índices de imagens, atributos de 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`. Ela valida a sintaxe com valores de exemplo antes da geração.
* **Suporte a NumPy** permite lógica condicional com funções como `np.where` e `np.isnan`.

Escolha uma grade manual ou uma grade de linha AB. As grades de linha AB usam largura de trabalho da máquina, cabeceiras, seções, comprimento de aplicação e raio de giro. Isso alinha as prescrições com as operações reais do talhão.

As finalidades suportadas são `GERAL`, `SEMEADURA`, `FERTILIZAÇÃO`, `PULVERIZAÇÃO`e `IRRIGAÇÃO`.

#### Acesso a geometria e raster

| Ferramenta      | Finalidade                                                        |
| --------------- | ----------------------------------------------------------------- |
| `fetchGeoJson`  | Recuperar uma FeatureCollection GeoJSON de uma URL WFS do GeoPard |
| `getGeoMapUrls` | Resolver URLs de mapas renderizados para revisão visual           |

### Zonas e taxa variável

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

Cada produto tem um nome, uma unidade de taxa e um preço opcional por unidade. Um mapa pode incluir taxas de MAP, ureia e sementes. As unidades suportadas incluem massa métrica e imperial, volume, 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 de taxas. A GeoPard grava as alterações somente após confirmação explícita.
{% endhint %}

### Qualidade dos dados de produtividade

| Ferramenta                      | Finalidade                                                                                      |
| ------------------------------- | ----------------------------------------------------------------------------------------------- |
| `cleanCalibrateYieldDataset`    | Limpar e calibrar um conjunto de dados de produtividade                                         |
| `generateSyntheticYieldDataset` | Criar uma camada de produtividade quando os dados de colheita medidos não estiverem disponíveis |

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

**Opções de calibração** podem mirar uma média ou um total do talhão. Elas podem limitar os valores a um intervalo definido. Também podem calibrar por trajeto da máquina com suavização ajustável.

A produtividade sintética oferece suporte a milho, silagem de milho, soja, trigo, algodão, arroz, cevada, aveia, sorgo, canola, girassol, colza e centeio. Defina uma média ou total-alvo, ano da colheita e data.

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

### Planos de amostragem de solo

`generateSamplingPlan` cria ou atualiza `GRID` e `ZONE` planos para um talhão.

* **Posicionamento:** GeoPard Core Line, Cobertura Otimizada, NZ ou padrões em W.
* **Roteamento:** Roteamento zona a zona ou ordenação inteligente entre zonas.
* **Amostragem:** Defina pontos por zona, profundidade e técnicas Core ou Composite.

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

Os planos são gravados por upsert. O assistente pode ajustar pinos ou rotas existentes sem criar duplicatas.

### Exportação e máquinas

| Ferramenta                      | Finalidade                                                             |
| ------------------------------- | ---------------------------------------------------------------------- |
| `exportData`                    | Exportar zonas e mapas de equações como um arquivo para download       |
| `exportToJohnDeereAsFiles`      | Enviar um arquivo exportado para o John Deere Operations Center        |
| `exportToJohnDeereAsMapsLayers` | Enviar uma entidade do GeoPard como uma Camada de Mapa                 |
| `createJohnDeereWorkPlan`       | Criar um WorkPlan de semeadura ou aplicação a partir de uma prescrição |
| `importJohnDeereData`           | Iniciar uma importação assíncrona do John Deere para o GeoPard         |

Exportar como `SHAPEFILE_MULTIPOLYGON`, `SHAPEFILE_POLYGON`, ou `ISOXML`. As geometrias de parcelas de teste podem ser incluídas sem sobrepor taxas da zona-pai.

As Camadas de Mapas oferecem suporte a zonas, equações, imagens, solo, produtividade e topografia. Isso fornece aos operadores um contexto visual útil junto às prescrições.

### Navegação e sessão

| Ferramenta     | Finalidade                                                                            |
| -------------- | ------------------------------------------------------------------------------------- |
| `buildAppUrl`  | Criar um link profundo para uma fazenda, talhão, grupo de ativos ou conjunto de dados |
| `parseAppUrl`  | Extrair contexto de uma URL do aplicativo GeoPard                                     |
| `clearSession` | Limpar dados da sessão                                                                |

Os links profundos dão suporte à revisão final. Abra o mapa exato no GeoPard antes de uma operação no talhão.

### Fluxo de trabalho típico

1. **Resolver contexto.** Encontre a fazenda e o talhão. Liste as camadas disponíveis.
2. **Avaliar a variabilidade.** Calcule estatísticas de índice. Revise estatísticas de solo, topografia e produtividade.
3. **Montar a prescrição.** Valide uma equação. Gere um mapa de equação ou zonas com taxas.
4. **Revisar e exportar.** Inspecione o mapa de prescrição e depois exporte-o ou envie-o para o John Deere.
5. **Aprender após a colheita.** Limpe os dados de produtividade. Compare-os com os dados de aplicação. Refine a lógica da próxima safra.

Esse fluxo de trabalho ajuda a direcionar insumos para onde eles geram 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, me dê as estatísticas de NDVI do Sentinel-2 para os ú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 colheita de 2025.*
* *Monte uma equação de nitrogênio usando NDVI e matéria orgânica do solo. Valide-a e depois 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 USDA. Calibre o total para 1.240 toneladas.*
* *Monte um plano de amostragem baseado em 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 WorkPlan.*

### Proteções

* **Acesso com escopo.** O acesso com base em OAuth respeita as permissões de cada usuário.
* **Portões 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.** A GeoPard formata seus dados para raciocínio. Você mantém a propriedade e o controle.

{% hint style="warning" %}
O GeoPard MCP apoia decisões. Ele não substitui o julgamento agronômico local. Valide taxas, equações e unidades em relação aos planos de cultivo, análises de solo, rótulos e regulamentações locais antes da aplicação.
{% endhint %}

### Páginas relacionadas

* [Conectar o GeoPard MCP](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/conectar-o-geopard-mcp.md)
* [Verificar conexão do GeoPard MCP](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/verificar-conexao-do-geopard-mcp.md)
* [Profundidade ideal de preparo do solo](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/profundidade-ideal-de-preparo-do-solo.md)
* [Explicar padrões de vegetação](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/explicar-padroes-de-vegetacao.md)
* [Limpar e calibrar dados de produtividade](/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/geopard-mcp/limpar-e-calibrar-dados-de-produtividade.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/capacidades-do-mcp-do-geopard.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.
