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

# Webes kiadás – 2024. május (műholdképek nyers nézete, zónatérképek exportálása WorkPlan formátumban a John Deere Operations Centerbe, a kötegelt elemzés megújult megjelenése)

Ez a kiadás bevezeti a Nyers nézetet a műholdképekhez, a zónatérképek exportját WorkPlanként a John Deere Operations Centerbe, a kötegelt elemzések újratervezését és még sok mást.

### Nyers műholdképek

Új funkciót vezettünk be, amellyel a felhasználók válthatnak a műholdképek megjelenítési módjai között, köztük a <mark style="background-color:yellow;">Nyers (eredeti, pixeles) megjelenítés</mark>. A műholdképes térkép meglévő vezérlője frissült, így a nyers megjelenítés be- és kikapcsolható. Ez a vezérlő a meglévő nézetekkel, például az Alapértelmezett, a Vágott és a Kontrasztos nézettel együtt használható.

<figure><img src="https://4197117614-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>Nyers műholdképek</p></figcaption></figure>

### Vetési zónatérkép exportálása munkatervként a John Deere Ops Centerbe

Bevezettük annak lehetőségét, hogy <mark style="background-color:yellow;">a kiosztott kijuttatási mennyiségekkel rendelkező vetési zónatérképeket munkatervként exportáljuk a John Deere-rel szinkronizált táblákhoz</mark>. A táblák oldalán minden zónatérképhez elérhetővé vált az „Exportálás munkatervként” művelet. Ez a funkció csak a John Deere Operations Centerrel szinkronizált táblák esetén használható.

Az exportáláshoz az alábbi feltételeknek kell teljesülniük:

* A GeoPard számára hozzáférést kell biztosítani a John Deere Operations Centerben.
* A GeoPard-táblát már szinkronizálták a John Deere-rel.
* A zónatérképhez hozzá vannak rendelve a kijuttatási mennyiségek.

<figure><img src="https://4197117614-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>Vetési zónatérkép exportálása munkatervként a John Deere Ops Centerbe – GeoPard</p></figcaption></figure>

<figure><img src="https://4197117614-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>Vetési zónatérkép exportálása munkatervként a John Deere Ops Centerbe – JD Ops Center</p></figcaption></figure>

### Adatok helyreállítása a táblaszéleken

Továbbfejlesztettük az adatok<mark style="background-color:yellow;">helyreállítását a táblahatárok mentén, hiányos adatkészletek esetén</mark>. Mostantól akkor is pontosabban állítja helyre az adatokat a GeoPard a már rendelkezésre álló adatok alapján, ha a széleken hiányoznak. Így a gazdálkodók mindig olyan adatokkal dolgozhatnak, amelyek teljesen lefedik a táblát.

<figure><img src="https://4197117614-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>Adatok helyreállítása a táblahatárok mentén</p></figcaption></figure>

<figure><img src="https://4197117614-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>Zónatérkép és helyreállított talajadatkészlet összehasonlítása</p></figcaption></figure>

### **Hozamadatkészlet exportálása térképrétegként a John Deere-hez** Operations **Center**

Bevezettük a hozamadatkészletek közvetlen exportálását a John Deere Operations Centerbe. Ezzel a funkcióval a felhasználók <mark style="background-color:yellow;">a tisztított és kalibrált hozamadatkészleteket visszaküldhetik a John Deere-hez</mark> automatikusan vagy manuálisan.

<figure><img src="https://4197117614-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>Hozamadatkészlet exportálása térképrétegként a John Deere Operations Centerbe – manuális exportálás</p></figcaption></figure>

<figure><img src="https://4197117614-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>Hozamadatkészlet exportálása térképrétegként a John Deere Operations Centerbe – automatikus küldés</p></figcaption></figure>

<figure><img src="https://4197117614-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>Hozamadatkészlet exportálása térképrétegként a John Deere Operations Centerbe – JD Ops Center</p></figcaption></figure>

### **A kötegelt elemzés előnézeti lépésének újratervezése**

Újraterveztük a kötegelt elemzés előnézeti lépését, hogy javítsuk a felhasználói élményt, és több egyenlettérkép férjen el a képernyőn. Az <mark style="background-color:yellow;">új csempés elrendezés</mark> reszponzív: a képernyő szélességéhez igazítva változtatja az oszlopok számát, így a felhasználók hatékonyabban tekinthetik át és kezelhetik az egyenlettérképeket.

<figure><img src="https://4197117614-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>A kötegelt elemzés előnézeti lépésének újratervezése</p></figcaption></figure>

### **Címsablon kötegelt elemzéshez**

Annak érdekében, hogy a felhasználók név alapján könnyen megkülönböztethessék a létrehozott térképeket, címsablon-funkciót vezettünk be az egyenlettérképekhez. Ezzel a felhasználók <mark style="background-color:yellow;">egyéni címsablonokat állíthatnak be az egyenlettérképekhez</mark> , vagy használhatják az alapértelmezett sablont.

* **Előre megadott lehetőségek:** A sablonszerkesztőben 4 előre megadott lehetőség érhető el: az egyenlet neve, a tábla neve, a gazdaság neve és az aktuális dátum.
* **Fogd és vidd:** A sablonelemek áthúzásával módosítható a sorrendjük.
* **Szabadon megadható szöveg:** A felhasználók egyéni szöveget adhatnak a címsablonhoz: írják be a szöveget, majd nyomják meg az Enter billentyűt.
* **Módosítások alkalmazása:** A szerkesztést követően a módosítások az összes egyenlettérképre érvényesek.
* **Sablon felülírása:** A felhasználók felülírhatják az alkalmazott sablont az egyes egyenlettérképek címében.

<figure><img src="https://4197117614-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>Címsablon kötegelt elemzéshez</p></figcaption></figure>

### **Változók intelligens hozzárendelése adatkészletekhez és attribútumokhoz a kötegelt elemzésben**

Frissítettük a <mark style="background-color:yellow;">változók automatikus hozzárendelését a kötegelt elemzésben</mark> modullogika annak biztosítására, hogy a tisztított vagy kalibrált adathalmazok attribútumai elsőbbséget élvezzenek a nyers adathalmazok attribútumaival szemben. Mostantól, ha a tisztított/kalibrált és a nyers adathalmazokban azonos attribútumok szerepelnek, a továbbfejlesztett adathalmaz attribútuma kerül a változóhoz.

<figure><img src="https://4197117614-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>Hozamváltozók hozzárendelése tisztított vagy kalibrált adathalmazokhoz</p></figcaption></figure>

### Továbbfejlesztett műveleti naplóesemények

Továbbfejlesztettük a [Műveleti naplót](https://docs.geopard.tech/geopard-tutorials/hu/termektura-webalkalmazas/operations-log-track-errors-imports-and-analytics.md) hogy a lényeges eseményeket jelenítse meg, így átláthatóbbá és könnyebben használhatóvá vált. Az eseményeket mostantól a végrehajtott műveletek szerint csoportosítjuk, így nyomon követhetők az adott feltöltött adathalmazhoz kapcsolódó táblák.

<figure><img src="https://4197117614-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>Továbbfejlesztett műveleti naplóesemények</p></figcaption></figure>

### Interpoláció kötegelt elemzésben

A kötegelt egyenlettérkép-generálási folyamatban megjelent a „Interpoláció használata” jelölőnégyzet. Ezzel <mark style="background-color:yellow;">szabályozhatja az interpoláció használatát</mark> az egyenlettérképek kötegelt generálásakor, egyenként vagy egyszerre mindegyiknél. A jelölőnégyzet ugyanúgy működik, mint az egyenletalapú elemzésben található megfelelője.

<figure><img src="https://4197117614-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>Interpoláció kötegelt elemzésben – Egyenlet lépés</p></figcaption></figure>

<figure><img src="https://4197117614-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>Interpoláció kötegelt elemzésben – Előnézet lépés</p></figcaption></figure>

### Kontrasztbeállítások zónatérképek készítésekor

Új <mark style="background-color:yellow;">kontrasztbeállításokat adtunk a műholdképekhez a zónatérkép-műveleteknél</mark>. A zónatérképek létrehozásakor mostantól egyszerűen válthat a különböző műholdkép-módok között, ugyanúgy, mint a Táblák oldalon.

<figure><img src="https://4197117614-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>Kontrasztbeállítások zónatérképek készítésekor</p></figcaption></figure>

### Kontrasztbeállítások az összehasonlító rétegek módjában

Új beállításokat adtunk hozzá az [Összehasonlító rétegek mód](https://docs.geopard.tech/geopard-tutorials/hu/termektura-webalkalmazas/compare-layers.md)továbbfejlesztéséhez, így a felhasználók <mark style="background-color:yellow;">különböző műholdkép-nézetek között válthatnak</mark> (Alapértelmezett, Növényállomány és Kontraszt), rétegenként külön-külön. A beállítások minden rétegnél egymástól függetlenül működnek, hasonlóan a Tábla oldalon található vezérlőkhöz.

<div data-full-width="false"><figure><img src="https://4197117614-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>Kontrasztbeállítások az összehasonlító rétegek módjában</p></figcaption></figure></div>

### **Továbbfejlesztett kontrasztbeállítás műholdképekhez**

Továbbfejlesztettük a műholdképek „Kontrasztnézet” vezérlőjének megjelenését. Ha nem érhető el kontrasztkép, a vezérlő ezt most egyértelműen jelzi, így elkerülhető a félreértés.

<figure><img src="https://4197117614-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>Továbbfejlesztett kontrasztbeállítás műholdképekhez</p></figcaption></figure>

### Gyorsabb térképrenderelés optimalizált csempékérésekkel

Optimalizáltuk a térképek renderelését, hogy <mark style="background-color:yellow;">javítsuk a teljesítményt</mark> és gyorsabb felhasználói élményt biztosítsunk. Növeltük a lekért csempék számát, miközben csökkentettük a méretüket, és elosztottuk a terhelést. Ezzel az átlagos betöltési idő 30%-kal csökkent.

<figure><img src="https://4197117614-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>Gyorsabb térképrenderelés optimalizált csempékérésekkel</p></figcaption></figure>

### Továbbfejlesztett változó-automatikus hozzárendelés kötegelt elemzéshez

A felhasználói élmény javítása érdekében biztosítottuk, hogy az előnézeti lépésből visszalépve megmaradjanak a kézzel hozzárendelt változók. Ez a fejlesztés megakadályozza a felhasználó által már hozzárendelt változók felülírását, és gördülékenyebbé teszi a munkafolyamat folytatását.

* A kézzel hozzárendelt változók változatlanok maradnak akkor is, ha a felhasználó frissít vagy új egyenletet választ.
* A rendszer csak az új vagy módosult változókat rendeli hozzá automatikusan.

<figure><img src="https://4197117614-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>Továbbfejlesztett automatikus változó-hozzárendelés kötegelt elemzéshez</p></figcaption></figure>

### Az egyenlet címe a kötegelt egyenlettérkép-készítési folyamatban

Mostantól az előnézeti lépésben is megjelenik a kötegelt elemzéshez használt egyenlet címe. Így a felhasználók áttekinthetik az alkalmazott egyenlet adatait.

<figure><img src="https://4197117614-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>Az egyenlet címe a kötegelt egyenlettérkép-készítési folyamatban – összecsukva</p></figcaption></figure>

<figure><img src="https://4197117614-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>Az egyenlet címe a kötegelt egyenlettérkép-készítési folyamatban – kibontva</p></figcaption></figure>

### Kattintható attribútumok a táblák eszközfájának fanézetében

Továbbfejlesztettük a fanézetet, így a felhasználók többszörös kijelölési módban kiválaszthatják, mely attribútumok jelenjenek meg a térképen. Mostantól többszörös kijelölési módban az adathalmazok attribútumai és az egyenlettérkép-nézettípusok is kattinthatók (például PDF-exportáláskor vagy az összehasonlító rétegek mód használatakor).

<figure><img src="https://4197117614-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>Kattintható attribútumok a táblák eszközfájának fanézetében</p></figcaption></figure>

### Továbbfejlesztett visszalépés a zónatérkép oldaláról

Javítottuk a zónatérkép oldalán a navigációt, figyelembe véve a leggyakoribb felhasználói igényeket. Az új zónatérképhez tartozó kijuttatási mennyiségek megadása után a „Vissza” gombbal visszatérhet a használt táblához.

<figure><img src="https://4197117614-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>Továbbfejlesztett visszalépés a zónatérkép oldaláról</p></figcaption></figure>

### Továbbfejlesztett vezérlők a bejelentkezési és regisztrációs oldalakon

A bejelentkezési és regisztrációs oldalakon középre rendeztük a vezérlőket, hogy könnyebb legyen megtalálni és használni őket.

<figure><img src="https://4197117614-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>Továbbfejlesztett vezérlők a bejelentkezési és regisztrációs oldalakon</p></figcaption></figure>

### Kibontott szakaszok a John Deere-integrációs oldalon

Továbbfejlesztettük a John Deere-integrációs oldalt, hogy a felhasználók első pillantásra lássák az összes funkciót. Az átláthatóság és a használhatóság érdekében az Előfizetések alatti összes szakasz alapértelmezés szerint kibontva jelenik meg.

<figure><img src="https://4197117614-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>Kibontott szakaszok a John Deere-integrációs oldalon</p></figcaption></figure>

### További fejlesztések és hibajavítások

* A zónatérképek mennyiségeinek és geometriáinak frissítése mostantól egyszerű a nagy táblák esetén is. Nincs szükség az oldal újratöltésére.
* Javítottuk a szűrők használatakor jelentkező hibás működést a táblalistában.
* Biztosítottuk, hogy bizonyos exportálási lehetőségek csak a John Deere-rel szinkronizált táblákhoz legyenek elérhetők.
* Javítottuk a több összetett geometriát tartalmazó, kézzel rajzolt zónatérkép mentésekor jelentkező hibát.
* Visszahoztuk a statisztikai táblázatot az újonnan létrehozott potenciálzóna- és stabilitási zónatérképekhez.
* A sortörések megjelenítése a jelölők megjegyzéseiben és leírásaiban.
* Lehetővé tettük a domborzati térkép attribútumainak kiválasztását a Háttérréteg felugró ablakban.
* Gondoskodtunk róla, hogy egyéni dátumtartomány megadásakor a műveleti naplóban a teljes nap legyen kijelölve.
* Javítottuk azt a hibát, amely miatt a régi változónév használatban maradt akkor is, ha a felhasználó megváltoztatta.
* Gondoskodtunk róla, hogy a statisztikai táblázat teljes egészében látható legyen a Zónatérkép oldalon.
* Javítottunk néhány nyelvtani hibát az angol fordításban.


---

# 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/hu/valtozasnaplo-es-termekkiadasok/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.
