> 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/release-web-may-2024-raw-view-for-satellite-images-export-of-zone-maps-as-workplan-to-the-john-deere.md).

# Web-julkaisu, toukokuu 2024 (satelliittikuvien raakadata, vyöhykekarttojen vienti WorkPlan-muodossa John Deere Operations Centeriin, Batch Analytics -toiminnon uudistettu käyttöliittymä)

Tämä julkaisu tuo Raakatila-näkymän satelliittikuville, vyöhykekarttojen viennin työsuunnitelmana John Deere Operations Centeriin, eräanalytiikan uudistuksen ja paljon muuta.

### Satelliittikuvien alkuperäiset versiot

Olemme lisänneet uuden ominaisuuden, jonka avulla käyttäjät voivat vaihtaa satelliittikuvien esitystapojen välillä, mukaan lukien <mark style="background-color:yellow;">Alkuperäinen (pikselöity) esitystapa</mark>. Satelliittikartalla olevaa ohjausta on päivitetty niin, että käyttäjät voivat ottaa alkuperäisen esitystavan käyttöön ja poistaa sen käytöstä. Ohjaus sisältää myös aiemmat vaihtoehdot: Oletus, Rajattu ja Kontrasti.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FXlEigD3EeU7l74OOxb7P%2Fraw%20satellites.gif?alt=media&amp;token=5b3f35dd-0492-435c-9b98-f57c10001de2" alt=""><figcaption><p>Satelliittikuvien alkuperäiset versiot</p></figcaption></figure>

### Kylvövyöhykekartan vienti työsuunnitelmana John Deere Ops Centeriin

Olemme lisänneet mahdollisuuden <mark style="background-color:yellow;">viedä kylvövyöhykekartat niille määritettyine määrineen työsuunnitelmina John Deereen synkronoiduille lohkoille</mark>. Jokaiselle lohkon sivulla olevalle vyöhykekartalle on lisätty uusi toiminto nimeltä ”Vie työsuunnitelmana”. Ominaisuus on käytettävissä vain lohkoilla, jotka on synkronoitu John Deere Operations Centeriin.

Viennin edellytykset:

* GeoPardille on myönnetty tarvittavat käyttöoikeudet John Deere Operations Centerissä.
* GeoPard-lohko on jo synkronoitu John Deeren kanssa.
* Vyöhykekartalle on määritetty määrät.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FiL0H0TZU3248nWtOGJtY%2Fexport%20as%20workplan.gif?alt=media&amp;token=e4e0c9f9-4877-4ee4-8b5e-9aa45f3cb0ea" alt=""><figcaption><p>Kylvövyöhykekartan vienti työsuunnitelmana John Deere Ops Centeriin – GeoPard</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FW1rmwpo16yMEz2qkPnoc%2FScreenshot%202024-05-31%20at%2014.01.52.png?alt=media&amp;token=381af9f1-6a44-4824-9d90-bca6262b8f84" alt=""><figcaption><p>Kylvövyöhykekartan vienti työsuunnitelmana John Deere Ops Centeriin – JD Ops Center</p></figcaption></figure>

### Tietojen palauttaminen lohkon reunoilla

Olemme parantaneet tietojen p<mark style="background-color:yellow;">alautusta lohkon reunojen tuntumassa puutteellisissa aineistoissa</mark>. Vaikka reunoilta puuttuisi tietoja, GeoPard palauttaa ne nyt tarkemmin hyödyntämällä jo saatavilla olevia tietoja. Näin käyttäjät voivat aina työskennellä aineistolla, joka kattaa koko lohkon.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FIhVI1MqQ9M939CSAtmem%2Fimage.png?alt=media&amp;token=a93efc2e-c9ae-47a0-9ba3-afb3c9899b7e" alt=""><figcaption><p>Tietojen palauttaminen lohkon rajojen reunoilla</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fdgivwsg6I0X70STdJQ2Q%2Fimage.png?alt=media&amp;token=53915b1e-7da0-4a01-89df-0c26aead84c6" alt=""><figcaption><p>Vyöhykekartta ja palautettu maanäyteaineisto</p></figcaption></figure>

### **Satotason aineiston vienti karttatasoina John Deereen** Operations **Centeriin**

Olemme lisänneet mahdollisuuden viedä satotason aineistoja suoraan John Deere Operations Centeriin. Ominaisuuden avulla käyttäjät voivat <mark style="background-color:yellow;">lähettää puhdistetut ja kalibroidut satotason aineistot takaisin John Deereen</mark> automaattisesti tai manuaalisesti.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FC7HhisCATqSSm6mSQXoS%2Fexport%20as%20map%20layers%201.png?alt=media&amp;token=cf4e3380-60c7-4692-bce1-0640250a9c54" alt="" width="375"><figcaption><p>Satotason aineiston vienti karttatasoina John Deere Operations Centeriin – manuaalinen vienti</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FN9HaUDHqRa73Ib7n2PSL%2Fexport%20as%20map%20layers%203.png?alt=media&amp;token=cd97dc51-456c-4fa7-8408-693eabd18108" alt=""><figcaption><p>Satotason aineiston vienti karttatasoina John Deere Operations Centeriin – automaattinen lähetys</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F0Tx6QNqQjE099z79tpwR%2Fexport%20as%20map%20layers%202.png?alt=media&amp;token=f3074b34-1a56-41bc-b2c4-2f36c0e9bb21" alt=""><figcaption><p>Satotason aineiston vienti karttatasoina John Deere Operations Centeriin – JD Ops Center</p></figcaption></figure>

### **Eräanalyysin esikatseluvaiheen uudistus**

Olemme uudistaneet eräanalyysin esikatseluvaiheen parantaaksemme käyttökokemusta ja sovittaaksemme näytölle useampia yhtälökarttoja. Uusi <mark style="background-color:yellow;">ruutunäkymä</mark> mukautuu näytön leveyteen muuttamalla sarakkeiden määrää, joten käyttäjät voivat tarkastella ja hallita yhtälökarttojaan tehokkaasti.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FHklMWeBwewjYWYLcyFHK%2Fredesign%20batch.png?alt=media&amp;token=ac1a50d6-ce29-4c60-8fbe-42048eec7dcc" alt=""><figcaption><p>Eräanalyysin esikatseluvaiheen uudistus</p></figcaption></figure>

### **Eräanalyysin otsikkomalli**

Jotta käyttäjien olisi helppo erottaa luodut kartat nimien perusteella, olemme lisänneet yhtälökartoille otsikkomallin. Sen avulla käyttäjät voivat määrittää <mark style="background-color:yellow;">yhtälökarttojen otsikoille omia malleja</mark> tai käyttää oletusmallia.

* **Valmiit vaihtoehdot:** Mallieditorissa on neljä valmista vaihtoehtoa: yhtälön nimi, lohkon nimi, tilan nimi ja nykyinen päivämäärä.
* **Vedä ja pudota:** Mallin osien järjestystä voi muuttaa vetämällä ja pudottamalla.
* **Vapaateksti:** Käyttäjät voivat lisätä otsikkomalliin omaa tekstiä kirjoittamalla sen ja painamalla Enter-näppäintä.
* **Muutosten käyttöönotto:** Muokkauksen jälkeen muutokset koskevat kaikkia yhtälökarttoja.
* **Mallin ohittaminen:** Käyttäjät voivat ohittaa käytössä olevan mallin yksittäisen yhtälökartan otsikossa.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F1hDBQg9xI40ve0XDkEQO%2Ftitle%20template.gif?alt=media&amp;token=4c317fa7-8bf3-46d5-82b8-708ad1bf5de1" alt=""><figcaption><p>Eräanalyysin otsikkomalli</p></figcaption></figure>

### **Muuttujien älykäs linkitys aineistoihin ja ominaisuuksiin eräanalytiikassa**

Olemme päivittäneet <mark style="background-color:yellow;">muuttujien automaattista määritystä eräanalyysissä</mark> moduulilogiikka varmistaa, että puhdistetuista tai kalibroiduista aineistoista peräisin olevat attribuutit ovat etusijalla raaka-aineistoista peräisin oleviin nähden. Tästä lähtien jos puhdistetuissa/kalibroiduissa ja raaka-aineistoissa on samoja attribuutteja, muuttujaan sijoitetaan parannetusta aineistosta peräisin oleva attribuutti.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FkWBEFOR1mAT3V4u5b26M%2Fassign%20clean%3Acalibrated%20datasets.gif?alt=media&amp;token=3dff7f97-5b52-4840-a934-3a56bc47b778" alt=""><figcaption><p>Satomuuttujien yhdistäminen puhdistettuihin tai kalibroituihin aineistoihin</p></figcaption></figure>

### Parannetut lokitapahtumat

Olemme parantaneet [toimintojen lokia](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/operations-log-track-errors-imports-and-analytics.md) tuomalla esiin olennaiset tapahtumat, mikä parantaa selkeyttä ja käytettävyyttä. Tapahtumat ryhmitellään nyt suoritettujen toimintojen mukaan, joten voit seurata kaikkia kenttiäsi, jotka liittyvät tiettyyn ladattuun aineistoon.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FIshcHmAbowv8ZQcGhPza%2Frefined%20ops%20log.png?alt=media&amp;token=a86157e1-fdf1-4c08-8e59-9223efefd557" alt=""><figcaption><p>Parannetut lokitapahtumat</p></figcaption></figure>

### Interpolointi eräanalyysissä

Olemme lisänneet "Käytä interpolointia" -valintaruudun erämuotoiseen yhtälökarttojen luontiin. Sen avulla voit <mark style="background-color:yellow;">hallita interpoloinnin käyttöä</mark> (kullekin yhtälökartalle erikseen tai kaikille kerralla) yhtälökarttoja erämuodossa luotaessa. Valintaruutu toimii samalla tavalla kuin yhtälöpohjaisessa analyysissä.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FHNks3OnpftHNAC9iZD7A%2Fuse%20interpolation%201.png?alt=media&amp;token=508a5ff7-0fa0-4686-8957-7840a2af80eb" alt=""><figcaption><p>Interpolointi eräanalyysissä – yhtälövaihe</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FzIeyEjIjzPxGlgaeMLsW%2Fzones%20maps%20contrast.png?alt=media&amp;token=c939a4b3-029b-41c1-8422-1419997156fd" alt=""><figcaption><p>Interpolointi eräanalyysissä – esikatseluvaihe</p></figcaption></figure>

### Kontrastin säätimet vyöhykekarttojen luonnissa

Olemme lisänneet <mark style="background-color:yellow;">satelliittikuvien kontrastin säätöasetukset vyöhykekarttatoimintoihin</mark>. Voit nyt helposti vaihtaa satelliittikuvien tilaa vyöhykekarttoja luotaessa samalla tavalla kuin Peltosivulla.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FIhWmYJZMzB9iNxr8yvHE%2Fzones%20map%20contrast.png?alt=media&amp;token=3ebd34eb-b6e1-484e-bc84-d6e23dc6c9aa" alt=""><figcaption><p>Kontrastin säätimet vyöhykekarttojen luonnissa</p></figcaption></figure>

### Kontrastin säätimet vertailutasotilassa

Olemme lisänneet uusia säätimiä, jotka parantavat [vertailutasotilaa](https://docs.geopard.tech/geopard-tutorials/fin/tuote-esittely-verkkosovellus/compare-layers.md), ja joiden avulla käyttäjät voivat <mark style="background-color:yellow;">vaihtaa satelliittikuvan näkymää</mark> (oletus, kasvusto ja kontrasti) kullakin tasolla erikseen. Säätimet toimivat tasokohtaisesti samaan tapaan kuin Peltosivun säätimet.

<div data-full-width="false"><figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FjLk8nv91ACj5RTpQBQSG%2Fcontrast%20in%20compare%20mode.png?alt=media&amp;token=68919e17-b88e-42ef-87f3-b156b1cc455f" alt=""><figcaption><p>Kontrastin säätimet vertailutasotilassa</p></figcaption></figure></div>

### **Satelliittikuvien kontrastin säätöä on parannettu**

Olemme parantaneet satelliittikuvien "Kontrastinäkymä"-säätimen ulkoasua. Jos kontrastikuvaa ei ole saatavilla, säädin ilmaisee sen nyt selkeästi, mikä ehkäisee sekaannuksia.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F59c2osR6EpLiGqbP62yh%2Fimproved%20contrast.png?alt=media&amp;token=97e208af-ca8b-4ca8-aa49-8def7573a0ea" alt="" width="563"><figcaption><p>Satelliittikuvien kontrastin säätöä on parannettu</p></figcaption></figure>

### Karttojen nopeampi renderöinti optimoiduilla tiilipyyntöillä

Olemme optimoineet karttojen renderöintiprosessia <mark style="background-color:yellow;">suorituskyvyn parantamiseksi</mark> ja käyttökokemuksen nopeuttamiseksi. Kasvatimme pyydettyjen karttatiilien määrää, pienensimme samalla niiden aluetta ja jaoimme kuormitusta. Näin keskimääräinen latausaika lyheni 30 %.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fqjc2EpmXPBluiV2vu9qq%2Ftile%20rendering.gif?alt=media&amp;token=df334d05-c4c7-4cef-ab17-0707bda56b0f" alt=""><figcaption><p>Karttojen nopeampi renderöinti optimoiduilla tiilipyyntöillä</p></figcaption></figure>

### Eräanalyysin muuttujien automaattista määritystä on parannettu

Käyttökokemus on parantunut, sillä käsin määritetyt muuttujat säilyvät, kun esikatseluvaiheesta palataan takaisin. Muuttujia ei enää korvata sen jälkeen, kun käyttäjä on määrittänyt ne, joten työnkulku jatkuu sujuvammin.

* Käsin määritetyt muuttujat säilyvät ennallaan, vaikka käyttäjä päivittäisi yhtälön tai valitsisi uuden yhtälön.
* Vain uudet tai muuttuneet muuttujat määritetään automaattisesti.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FJkU7RFvqv9kPWxdpdhqu%2Fauto-assignment.gif?alt=media&amp;token=29324122-fb44-4aec-8f9a-2057afc8285a" alt=""><figcaption><p>Eräanalyysin muuttujien automaattista määritystä on parannettu</p></figcaption></figure>

### Yhtälön nimi erämuotoisten yhtälökarttojen luonnissa

Tästä lähtien eräanalyysissä käytetyn yhtälön nimi näkyy esikatseluvaiheessa. Näin käyttäjä voi tarkistaa käytettävän yhtälön tiedot.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FiqUX2PX3kmHmCIUmibEO%2Feq%20title%201.png?alt=media&amp;token=3727f498-9980-4a1c-957c-badde4f21524" alt=""><figcaption><p>Yhtälön nimi erämuotoisten yhtälökarttojen luonnissa – supistettu</p></figcaption></figure>

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FPtZDqV8HWGvgxhHTeLjQ%2Feq%20title%202.png?alt=media&amp;token=66afef6b-0a92-4083-b512-f5ee6b7d7b55" alt=""><figcaption><p>Yhtälön nimi erämuotoisten yhtälökarttojen luonnissa – laajennettu</p></figcaption></figure>

### Kenttäaineistopuun näkymän klikattavat attribuutit

Olemme parantaneet puunäkymää niin, että käyttäjät voivat valita kartalla näytettävät attribuutit monivalintatilassa. Tästä lähtien aineiston attribuutit ja yhtälökartan näkymätyypit ovat klikattavia, kun puunäkymä on monivalintatilassa (esimerkiksi PDF-viennissä tai vertailutasotilassa).

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F6kPEGndDmLQwVVcyMeou%2Fasset%20tree%20select%20attribute.gif?alt=media&amp;token=5d3d9da8-043f-4afb-9285-70b03e8846f0" alt=""><figcaption><p>Kenttäaineistopuun näkymän klikattavat attribuutit</p></figcaption></figure>

### Vyöhykekarttasivun paluupainikkeen navigointia on parannettu

Olemme parantaneet vyöhykekarttasivun navigointia yleisimmän käyttötarpeen mukaisesti. Kun uuden vyöhykekartan levitysmäärät on määritetty, käyttäjät voivat nyt palata käsittelemälleen pellolle "Takaisin"-painikkeella.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FKa2H0PCFTnSZ3iqHQXwh%2Fzones%20map%20navigation.gif?alt=media&amp;token=b3530513-8c7e-4fc7-bcaf-b9e7598e0629" alt=""><figcaption><p>Vyöhykekarttasivun paluupainikkeen navigointia on parannettu</p></figcaption></figure>

### Kirjautumis- ja rekisteröitymissivujen säätimiä on parannettu

Olemme parantaneet kirjautumis- ja rekisteröitymissivujen käytettävyyttä keskittämällä säätimet, jotta ne löytyvät ja niitä on helpompi käyttää.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FPARCCbsbGEo3P3napIIO%2Flogin%20page.png?alt=media&amp;token=d26e65cc-fc67-468f-b6ae-d92ede14351f" alt=""><figcaption><p>Kirjautumis- ja rekisteröitymissivujen säätimiä on parannettu</p></figcaption></figure>

### John Deere -integraatiosivun osiot ovat nyt laajennettuina

Olemme parantaneet John Deere -integraatiosivua, jotta kaikki ominaisuudet näkyvät käyttäjille heti. Selkeyden ja käytettävyyden parantamiseksi kaikki Tilaukset-osion kohdat ovat nyt oletusarvoisesti laajennettuina.

<figure><img src="https://49925783-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FzORkrvo16XQgnODH1Ait%2Fexpanded%20jd%20integration.png?alt=media&amp;token=9d03848a-46ec-4571-9fb7-86ac61125c9e" alt=""><figcaption><p>John Deere -integraatiosivun osiot ovat nyt laajennettuina</p></figcaption></figure>

### Muita parannuksia ja korjauksia

* Vyöhykekartan levitysmäärien ja geometrioiden päivitysten käsittely on nyt helppokäyttöisempää suurilla pelloilla. Sivua ei tarvitse enää ladata uudelleen.
* Korjattu peltoluettelon virheellinen toiminta suodattimia käytettäessä.
* Varmistettu, että tietyt vientiasetukset ovat käytettävissä vain John Deereen synkronoiduille pelloille.
* Korjattu virhe, joka ilmeni tallennettaessa käsin piirrettyä vyöhykekarttaa, jossa oli useita monimutkaisia geometrioita.
* Palautettiin tilastotaulukko äskettäin luoduille pellon potentiaali- ja vakausvyöhykekartoille.
* Sallitaan rivinvaihtomerkit nastojen kommenteissa ja kuvauksissa.
* Sallitaan topografiakartan ominaisuuksien valinta Taustataso-ponnahdusikkunassa.
* Varmistetaan, että mukautetulla ajanjaksolla toimintalokissa on valittuna koko päivä.
* Korjattiin ongelma, jonka vuoksi vanha muuttujan nimi oli edelleen käytössä, vaikka käyttäjä oli vaihtanut sen.
* Tehdään tilastotaulukko kokonaan näkyväksi vyöhykekarttasivulla.
* Korjataan englanninkielisen lokalisoinnin kielioppivirheitä.


---

# 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/release-web-may-2024-raw-view-for-satellite-images-export-of-zone-maps-as-workplan-to-the-john-deere.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.
