> 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/muutosloki-ja-tuotejulkaisut/julkaisu-syyskuussa-2026-yield-report-ai-assistant-liitteet-ajolinjat-muokkaustyosuunnitelmat.md).

# Julkaisu syyskuussa 2026: Yield Report, AI Assistant -liitteet, ajolinjat, muokkaustyösuunnitelmat

Muunna satodata kannattaviksi VRA-päätöksiksi Yield Reportin, koneohjauksen, AI Assistant -liitteiden ja John Deere -muokkausvientien avulla.

## Sato-raportti-välilehti lohkon sivulla

Uusi **Sato-raportti** välilehti on Data Layers- ja Field Details -välilehtien rinnalla. Se muuntaa sadonkorjuutiedot vyöhyketasoisiksi päätöksiksi. Tarkastele lohkon suorituskykyä, annosvastetta ja seuraavia toimenpiteitä.

{% @arcade/embed url="<https://app.arcade.software/share/SwzWASz2x8iJs9Lci6Sw>" flowId="SwzWASz2x8iJs9Lci6Sw" %}

Raportti suosii **puhdistettuja ja kalibroituja** aineistoja. Vertaa satoa **vyöhykekarttaan** määrityksen varmistamiseksi. Vertaa sitä **toteutuskarttaan** koneen toteutuksen varmistamiseksi. Käytä molempia näkymiä erottaaksesi agronomiset ongelmat toteutusongelmista.

Tarkastele KPI-laattoja keskimääräiselle ja kokonaissadolle, korjatulle pinta-alalle ja **vaihtelulle (CV %)**. Tutki jaettuja ja päällekkäiskarttanäkymiä, annosvertailuja, vyöhykeyhteenvetoja, satojakaumia ja monivuotisia trendejä. **Annos vs. sato** järjestää vyöhykkeet annoksen mukaan. Se korostaa, missä lisäpanos lakkasi tuottamasta.

Lisää kasvin ja tuotteen hinnat. The **Taloustarkastelu** tila arvioi jokaisen annosvaiheen sen kannattavuusrajan mukaisen satovasteen perusteella. Vaiheet merkitään **kannatti**, **ei kannattanut**, tai **kannattavuusraja**. Näe kannattavuusrajan mukainen kasvin hinta ja jäljellä oleva kannattava liikkumavara.

Vie  **PDF-raportti** viljelijäpalavereihin. Luo **uusia vyöhykkeitä tämän sadon perusteella**. Avaa kerrokset **Vertaa kerroksia**. Tämä vertailu ei ole koko tilan tuloslaskelma. Vahvista muutokset koeriveillä ennen kuin laajennat niitä.

Koko ohjeistus [Sato-raportin dokumentaatiossa](https://docs.geopard.tech/geopard-tutorials/agronomy/yield-report).

[Sato-raportin aloitussivu](https://geopard.tech/yield-report) ja UKK:lla.

## Ominaisuustaulukko CSV- ja Excel-viennillä

Valitse maaperäaineisto avataksesi **Ominaisuustaulukon** paneelin. Se listaa jokaisen ominaisuuden jokaista vyöhykettä vasten. Mukana ovat orgaaninen hiili, pH, savi, hiesu, hiekka, typpi, kalium, fosfori, vyöhykkeen pinta-ala ja keskiarvorivi.

Näytä, piilota ja järjestä sarakkeet uudelleen laboratorion, neuvojan tai raportointimallin mukaan. Vie määritetty näkymä suoraan **CSV- tai Excel-muotoon**. Paneeli kutistuu, kun sitä ei käytetä. Arvot pysyvät vain luku -tilassa.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FXTJYy0BJfIwyFy5LaHEi%2FScreenshot%202026-09-14%20at%2013.25.31.png?alt=media&amp;token=dcc6029f-dcd1-4b71-b9fe-16cbae978fda" alt="GeoPard Attributes Table showing soil dataset values by management zone"><figcaption><p>Vie valitut maaperäominaisuudet ja vyöhyke-arvot CSV- tai Excel-muotoon.</p></figcaption></figure>

## Kloonaa polygonit mitatuilla arvoilla

Clone polygons -vaihe tukee nyt myös kloonattuja ominaisuusarvoja Soil Data-, Yield- ja As-Applied-aineistoille. Valitse enintään kolme numeerista ominaisuutta. GeoPard siirtää jokaisen arvon omaan annossarakkeeseensa, yksi per ominaisuus. Arvot säilyvät tallennuksen jälkeen.

Säilytä mittaukset ja säädä sitten annoksia. Mukana kuljetetut arvot täyttävät levitteen annossarakkeet. Ne toimivat hinnoittelulaskelmien ja konevientien kanssa. Kloonaus ilman ominaisuuksia toimii kuten ennenkin.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FmBIQfBDgu0DPEZiSBp7r%2FScreenshot%202026-09-14%20at%2014.05.10.png?alt=media&amp;token=605824fd-7293-4437-a341-dfc450a9af43" alt="Clone Polygons dialog with numeric soil attributes selected as rate columns"><figcaption><p>Siirrä mitatut maaperä-, sato- tai toteutusarvot kloonattuihin polygoneihin.</p></figcaption></figure>

<div><figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FWzSfIHCMLEbQZtZWXaaN%2FScreenshot%202026-09-14%20at%2014.06.22.png?alt=media&amp;token=a6c1a001-c99d-4cc0-a2cc-2e41b24b2232" alt="GeoPard Clone Polygons workflow with source attributes enabled"><figcaption><p>Valitse enintään kolme numeerista lähdeominaisuutta.</p></figcaption></figure> <figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FyDoMjtm9EbfcEwlf5JDK%2FScreenshot%202026-09-14%20at%2014.06.43.png?alt=media&amp;token=626b6f60-ff95-43c8-8869-ca12c5c5ef69" alt="GeoPard rate columns populated with values from cloned polygons"><figcaption><p>Käytä säilytettyjä arvoja annoslaskelmissa ja konevienneissä.</p></figcaption></figure></div>

## Ohjauslinjat yhtälökartoille

Yhtälökartat voivat nyt näyttää **koneohjauslinjan** lohkon sivulla.

Ohjauskytkin tarjoaa **Pois**, **AB-linja**, ja **Reitti**. **Reitti** näyttää ajokerrat ja päistekaaret ajovärillä. Käännökset näkyvät katkoviivaisina käännösvärillä. **AB-linja** säilyttää kahden pisteen kylvölinjanäkymän. Käytä tätä näkymää tarkistaaksesi ajosuunnan, päisteet ja käännökset suhteessa lohkon muotoon ja esteisiin.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FWFTk6sw91Jw7bnnr3qWb%2FScreenshot%202026-09-14%20at%2017.50.24.png?alt=media&amp;token=f41a6214-e723-47c5-bc88-8736cbfc58c4" alt="Equation map showing machinery guidance paths, headland rings, and turning passes"><figcaption><p>Tarkista ajosuunta ja päisteet ennen lohkon toteutusta.</p></figcaption></figure>

## Muuttuvan annoksen muokkaus John Deereen

Lähetä muuttuvan annoksen muokkausmääritykset John Deere Operations Centeriin nimellä **Muokkaustyösuunnitelmat**. Tämä on olemassa olevien kylvö- ja levitystyösuunnitelmien rinnalla.\
\
GeoPard lataa syvyysmäärityksen ja luo työsuunnitelman vastaavalle lohkolle. Lohko on ensin synkronoitava John Deeren kanssa.

<div><figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FDRG5Acjsl3UM0NmxIy3r%2FScreenshot%202026-09-14%20at%2016.17.51.png?alt=media&amp;token=3b22bb64-3f25-4790-b839-67c3fa2bc0ff" alt="GeoPard variable-rate tillage prescription ready for John Deere export"><figcaption><p>Lähetä syvyysmääritys GeoPardista.</p></figcaption></figure> <figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FJXn3Ms4fDTgTnxM9dUr6%2FScreenshot%202026-09-14%20at%2016.06.41.png?alt=media&amp;token=e2233b6e-eae7-4360-92c0-a00a0f0d5212" alt="John Deere Operations Center tillage work plan created from GeoPard"><figcaption><p>GeoPard luo vastaavan muokkaustyösuunnitelman.</p></figcaption></figure></div>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FvVXp5xxArSIkGnVuTl2a%2FScreenshot%202026-09-14%20at%2016.16.27.png?alt=media&amp;token=33990c1b-eb63-4569-be35-5b616fffd2bb" alt="John Deere Operations Center view of a GeoPard variable-rate tillage work plan"><figcaption><p>Tarkista viety suunnitelma John Deere Operations Centerissä.</p></figcaption></figure>

## AI-avustaja: liitteet, telakointitila ja nopeammat jatkokysymykset

GeoPardin AI-avustaja hyväksyy nyt **tiedostoliitteet chatissa**. Pudota mukaan maanäytteen laboratoriotulos tai CSV ja kysy siitä selkokielellä. **PDF, Word, Excel, CSV, TXT, Markdown ja HTML ovat tuettuja**.

Tutustu [GeoPard AI Assistant](/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-ai-assistant.md), [Agronomian tietopohja](/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-ai-assistant/agronomian-tietopohja.md), ja [Kehotekirjasto](/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-ai-assistant/kehotekirjasto.md). Tarkista [Tarkkuus ja arviointi](/geopard-tutorials/fin/tuote-esittely-verkkosovellus/geopard-ai-assistant/tarkkuus-ja-arviointi.md) ymmärtääksesi, miten tulokset varmennetaan.

{% @arcade/embed url="<https://app.arcade.software/share/gsPcot19n9T84X7idzjX>" flowId="gsPcot19n9T84X7idzjX" %}

Säilyttääksesi asiakirjan, **lisää se tietopohjaan** liitteen kuvaketta käyttäen. Se käsitellään taustalla, kun työskentelet. Avustaja voi käyttää sitä tulevissa istunnoissa.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FvC9GOW32qrMNkeaIP3L9%2FScreenshot%202026-09-15%20at%2015.43.47.png?alt=media&amp;token=4bd52a7d-5bc2-4bc0-9714-5864c6179596" alt="GeoPard AI Assistant chat with a document attached to the knowledge base"><figcaption><p>Lisää lähdeasiakirjat tietopohjaan tulevia Avustaja-istuntoja varten.</p></figcaption></figure>

#### Telakointitila

Kiinnitä Avustaja **koon mukaan mukautuvana oikean reunan paneelina peitekerroksen sijaan**. Karttasi, vyöhykkeesi ja kerroksesi pysyvät näkyvissä ja klikattavina, kun esität kysymyksiä. Tila ja leveys muistetaan, ja vaihtaminen säilyttää keskustelun ja luonnosviestisi.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FZdAyheGrkbA44iEtbegF%2FScreenshot%202026-09-15%20at%2015.47.19.png?alt=media&amp;token=449646bd-fafa-40d7-9c0a-bac084837e18" alt="GeoPard AI Assistant docked as a resizable panel beside a field map"><figcaption><p>Pidä lohkon kartat ja kerrokset näkyvissä työskennellessäsi Avustajan kanssa.</p></figcaption></figure>

#### Nopeammat jatkokysymykset ja selkeämmät päätökset

Jokainen vastaus päättyy nyt **klikattaviin seuraaviin vaiheisiin**: luo VRA-kartta, suunnittele maanäytteenotto, vie John Deere Operations Centeriin niin, että lohko ja kerros siirtyvät valmiiksi mukana. Kun Avustaja kysyy sinulta jotain, **suositeltu valinta merkitään**, ja "Muu" **vapaatekstivaihtoehto antaa sinun vastata omin sanoin**. Viesteissä on nyt myös aikaleimat, ja Tänään / Eilen -erottimet, joten pitkissä istunnoissa on helpompi navigoida.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FtoRU5h5TWlbfpBMai2wS%2Fimage.png?alt=media&amp;token=90c07ff7-3da2-44b4-a93d-2795bc4c5df7" alt="GeoPard AI Assistant response with recommended choices and clickable next steps"><figcaption><p>Siirry suosituksesta lohkolla toteutettavaan toimenpiteeseen vähemmillä klikkauksilla.</p></figcaption></figure>

### AI-avustaja mobiilissa

AI-avustaja on nyt GeoPardin mobiilisovelluksessa **iOS:ssä ja Androidissa**. Sama Avustaja, samat keskustelut, sama historia kuin verkossa, joten voit **aloittaa kysymyksen lohkolla ja viimeistellä sen työpöydällä.**

## Parannukset

* **Hallitse lohkoa -valikko.** "Field Operations" -valikon nimi on nyt Hallitse lohkoa, ja kohteiden nimet on yksinkertaistettu.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FKKmVhufBlMttKtqKQE0H%2FScreenshot%202026-09-14%20at%2015.07.46.png?alt=media&amp;token=60a473f0-7ad1-467a-9c0c-57e08aad1e8e" alt="GeoPard Manage Field menu with simplified field management options"><figcaption><p>Nimeä muutettu valikko kokoaa tavalliset lohkon toiminnot.</p></figcaption></figure>

* **Näytteenottosuunnitelman selite.** Selite näytetään lohkon sivulla, kun näytteenottosuunnitelma on valittuna.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FQWsHUpnwnMAms2MDhpiF%2FScreenshot%202026-09-14%20at%2015.14.10.png?alt=media&amp;token=71ea8cd7-c10a-4969-9533-c049e7cb9b4f" alt="GeoPard Field page showing the legend for a selected soil sampling plan"><figcaption><p>Käytä selitettä tulkitaksesi näytteenottosuunnitelman vyöhykkeet nopeasti.</p></figcaption></figure>

* **Topografialuettelo siistitty.** Koneaineistosta johdetut topografiakartat on ryhmitelty erilleen muista kartoista kokoontuvassa "Koneaineistosta"-lohkossa.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FlJEYhXSrgO0SAQcuQaWb%2FScreenshot%202026-09-14%20at%2015.55.09.png?alt=media&amp;token=b1544802-e0b2-4168-8bb3-e735b137e438" alt="GeoPard topography layer list grouped under From Machinery data"><figcaption><p>Erota koneaineistosta johdetut topografiakartat muista lohkon kerroksista.</p></figcaption></figure>

* **Tarkempi ryhmittely Compare Layers -näkymässä.** Toteutuskerrokset on ryhmitelty vuoden mukaan, ja koneaineistosta tuotetut topografiakartat ovat omassa ryhmässään erillään muista.
* **Syvälinkit avautuvat oikealle kerrokselle.** Jaetun linkin avaaminen vierittää automaattisesti valittuun aineistoon kaikissa kerrostyypeissä.
* **Välitön palaute poistettaessa.** Kohteet katoavat luettelosta heti, kun poistat ne.
* **Selkeämpi annosnäyttö.** Tuoteyhteissummat piilotetaan syvyyteen perustuvilta yksiköiltä, joissa yhteissumma on merkityksetön.
* **Lukukelpoiset ominaisuuksien nimet.** Koneen ominaisuuskoodeille on annettu ihmisluettavat nimet.
* **Laajempi API- ja MCP-kattavuus.** Heinäkuussa julkaistun työkalukokonaisuuden pohjalta API ja MCP-palvelin kattavat nyt myös vyöhykekartan luonnin ja annosmäärityksen, topografian haun, sadon puhdistuksen ja kalibroinnin sekä tietojen tuonnin rajoille, sadolle, maaperälle, toteutukselle, laboratoriotuloksille ja VRA-vyöhykekartoille.
* **Suurten aineistojen nopeampi puhdistus.** Sato- ja toteutusaineistojen puhdistus käsittelee nyt vaivatta yli 1,5 miljoonan geometrian tiedostoja.
* **Parannettu satelliittikuvien laatu.** Pilvi- ja varjotunnistus on päivitetty, ja historiallinen Landsat-arkisto on siirretty uudempaan kokoelmaan.
* **Maannäyteskannerin arkistot.** Maannäyteskannerin ZIP-tiedostot käsitellään natiivisti GeoPardissa.
* **Avustajan vastausten laatu.** Aikomusten reititys, suunnittelu, tiedonhaku ja dokumentaatioon ankkurointi on uudistettu, ja automaattinen laatuvertailu ajetaan jokaisella muutoksella.

## Virhekorjaukset

* **Yhtälövyöhykekartat luodaan luotettavasti.** Ei enää "Täällä ei ole mitään" -viestiä luotaessa.
* **Täydelliset yhtälökartat mukautetulla ruudukkotarkkuudella.** Ei tyhjiä laikkuja eikä arvoja väärissä soluissa.
* **Luotettavat analyysikartat.** Vektorianalyysikartat luodaan johdonmukaisesti sen sijaan, että ne epäonnistuisivat kesken.
* **Esikatselut vähäisen vaihtelun ominaisuuksille.** Ominaisuudet, joilla on yksi arvo tai hyvin vähän eri arvoja, näkyvät nyt.
* **Tarkkarajaiset vyöhykekartat tallentuvat.** Tallennus ei enää aikakatkaise kartoilla, joilla on tiheä geometria.
* **Turvallisempi vyöhykekartan muokkaus.** Muualla lohkolla tapahtuva toiminta ei enää häiritse tallentamattoman muokkauksen palauttamista.
* **Näytteenottosuunnitelmat monimutkaisille vyöhykkeille.** Suunnitelmat luodaan nyt vyöhykekartoille, joiden geometria aiemmin esti sen.
* **Valitse kaikki Tulostettavat tarrat -kohdassa.** Valitse kaikki -valinnan poistaminen näytteenottosuunnitelman tarran ponnahdusikkunassa toimii.
* **Clone Polygons lataa maaperägeometrian.** Lähdeaineisto piirretään sen sijaan, että se epäonnistuisi näkymään.
* **Vyöhykekarttojen suodatus tyypin mukaan.** Tyyppisuodattimet palauttavat oikeat kartat myös tilan sisällä.
* **Laboratoriotulokset tuodaan myös puutteellisista tiedostoista.** Tuonti valmistuu, kun tiedosto on vain osittain luettavissa.
* **Tulostetut tarrat vastaavat suunnitelman vyöhykkeitä.** Tulostettujen tarrojen vyöhykkeen nimet kohdistuvat oikeaan näytteenottosuunnitelman vyöhykkeeseen.
* **Konetiedostot tuodaan oikein.** Tiedostot, jotka aiemmin jäivät jumiin, käsitellään nyt.
* **Tekstiarvot säilyvät puhdistuksessa.** Sato- ja toteutusaineistojen puhdistus käsittelee kasvi-, tuote- ja lajikenimet ilman virhettä.
* **Hyvin pienten aineistojen puhdistus.** Vain muutaman pisteen aineistot eivät enää anna virhettä.
* **Luotettava toteutusaineistojen puhdistus.** Korjattu virhe, joka esti joidenkin toteutusaineistojen käsittelyn.
* **Koko värialue maaperäkartoilla.** Käsitellyt maaperäkartat käyttävät koko asteikkoa yhden värin sijaan.
* **Vertaa neljää kerrosta kerralla.** Kerroslaskuri ei enää sisällä ryhmärivejä, joten raja ei täyty liian aikaisin.
* **Maaperä- ja satotietoaineistojen vertailu.** Vertailu avautuu virheen palauttamisen sijaan.
* **Satelliittiseuranta aktivoituu.** Lohkot eivät enää jää odottamaan kuvia, jotka eivät koskaan saavu.
* **Tarkka kuvapeitto.** Peitto ilmoitetaan oikein, ja käytössä on varamenetelmä, kun ensisijainen tarkistus ei ole käytettävissä.
* **Palautettavat kuva- ja rajavirheet.** Selkeä viesti ja uudelleenyritys korvaavat tyhjän kartan, kun lataus epäonnistuu.
* **Topografiavienti kunnioittaa puskuria.** Viennit sisältävät määritetyn marginaalin lohkon ympärillä.
* **Lohkotietojen poistaminen tyhjentää niiden karttakerrokset.** Poistettu data ei enää jää lojumaan kartalle.
* **Päivämäärät seuraavat kieltäsi.** Kausien aikavälit ja satelliittipäivämäärät käyttävät valittua käyttöliittymän kieltä.
* **Chat tyhjenee tilinvaihdossa.** Edellisen kirjautumisen keskustelut eivät enää näy tilin vaihtamisen tai uloskirjautumisen jälkeen.
* **Keskustelut avautuvat uusimpaan viestiin.** Pitkän ketjun alusta ei tarvitse enää vierittää alas.
* **Viimeisin viestisi pysyy paikallaan.** Viesti ja sen vastaus säilyvät ketjussa paneelin sulkemisen jälkeen.
* **Chat-historia latautuu kokonaan.** Oikeat otsikot, kiinnitystila säilyy, eikä uudelleenavauksessa ole tyhjää paneelia.
* **Toimivat latauslinkit.** Avustajan jakamat vientilinkit avautuvat oikein.
* **Liitteet ilman viestiä.** Tiedoston lähettäminen ilman tekstiä käsitellään sujuvasti.
* **Avustaja jatkaa siitä, mihin se jäi.** Keskustelut jatkuvat siististi keskeytyksen tai pitkään kestävän pyynnön jälkeen.


---

# 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/muutosloki-ja-tuotejulkaisut/julkaisu-syyskuussa-2026-yield-report-ai-assistant-liitteet-ajolinjat-muokkaustyosuunnitelmat.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.