> 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/pl/dziennik-zmian-i-wydania-produktu/release-sep-2026-yield-report-ai-assistant-attachments-guidance-lines-tillage-workplans.md).

# Wydanie wrzesień 2026: Raport plonów, załączniki Asystenta AI, linie prowadzące, plany prac uprawowych

Zamień dane ze zbioru w opłacalne decyzje VRA dzięki Raportowi plonów, naprowadzaniu maszyn, załącznikom Asystenta AI i eksportom uprawy do John Deere.

## Karta Raport plonu na stronie pola

Nowa karta **Raport plonu** znajduje się obok kart Warstwy danych i Szczegóły pola. Przekształca dane ze zbiorów w decyzje dotyczące poszczególnych stref. Analizuj wyniki pola, reakcję na dawkę i kolejne działania.

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

Raport najlepiej działa z **oczyszczonymi i skalibrowanymi** zbiorami danych. Porównaj plon z **mapą stref** aby zweryfikować zalecenie. Porównaj go z **mapą wykonanych zabiegów** aby zweryfikować pracę maszyn. Korzystaj z obu widoków, by odróżnić problemy agronomiczne od problemów z wykonaniem zabiegu.

Wyświetl kafelki KPI ze średnim i całkowitym plonem, powierzchnią zbioru oraz **zmiennością (CV %)**. Analizuj widoki mapy z podziałem i nakładkami, porównania dawek, podsumowania stref, rozkłady plonów i trendy wieloletnie. **Dawka a plon** porządkuje strefy według dawki. Pokazuje, gdzie dodatkowe nakłady przestały przynosić korzyści.

Dodaj ceny plonów i produktów. Tryb **Ekonomia** ocenia każdy poziom dawki względem plonu zapewniającego próg rentowności. Poziomy są oznaczone jako **opłacalne**, **nieopłacalne**, lub **próg rentowności**. Sprawdź cenę plonu zapewniającą próg rentowności i pozostały potencjał uzyskania zysku.

Wyeksportuj **raport PDF** na spotkania z rolnikami. Utwórz **nowe strefy na podstawie tych danych o plonie**. Otwórz warstwy w widoku **Porównaj warstwy**. To porównanie nie przedstawia rachunku zysków i strat całego gospodarstwa. Przed wdrożeniem zmian na większą skalę potwierdź ich skuteczność na pasach testowych.

Pełny przewodnik znajdziesz w [dokumentacji Raportu plonu](https://docs.geopard.tech/geopard-tutorials/agronomy/yield-report).

[Strona główna Raportu plonu](https://geopard.tech/yield-report) z sekcją FAQ.

## Tabela atrybutów z eksportem do CSV i Excela

Wybierz zbiór danych o glebie, aby otworzyć panel **Tabela atrybutów** . Zawiera listę wszystkich atrybutów dla każdej strefy: zawartość węgla organicznego, pH, gliny, pyłu, piasku, azotu, potasu i fosforu, powierzchnię strefy oraz wiersz podsumowujący wartości średnie.

Wyświetlaj, ukrywaj i zmieniaj kolejność kolumn zgodnie z wymaganiami laboratorium, doradcy lub szablonu raportu. Eksportuj skonfigurowany widok bezpośrednio do pliku **CSV lub Excel**. Gdy panel nie jest używany, można go zwinąć. Wartości pozostają tylko do odczytu.

<figure><img src="https://3832317038-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>Eksportuj wybrane atrybuty gleby i wartości dla stref do pliku CSV lub Excel.</p></figcaption></figure>

## Klonowanie poligonów z pomierzonymi wartościami

W kroku Klonuj poligony można teraz klonować także wartości atrybutów w zbiorach danych o glebie, plonach i wykonanych zabiegach. Wybierz maksymalnie trzy atrybuty liczbowe. GeoPard przeniesie każdą wartość do osobnej kolumny dawek — po jednej dla każdego atrybutu. Wartości zostaną zachowane po zapisaniu.

Zachowaj pomiary, a następnie dostosuj dawki. Przeniesione wartości wypełnią kolumny dawek produktów stosowanych w zabiegu. Można ich używać w obliczeniach cenowych i eksportach dla maszyn. Klonowanie bez atrybutów działa jak dotychczas.

<figure><img src="https://3832317038-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>Przenieś pomierzone wartości gleby, plonów lub wykonanych zabiegów do sklonowanych poligonów.</p></figcaption></figure>

<div><figure><img src="https://3832317038-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>Wybierz maksymalnie trzy liczbowe atrybuty źródłowe.</p></figcaption></figure> <figure><img src="https://3832317038-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>Używaj zachowanych wartości w obliczeniach dawek i eksportach dla maszyn.</p></figcaption></figure></div>

## Linie prowadzące do map równań

Mapy równań mogą teraz wyświetlać **wytyczne dotyczące maszyn** na stronie pola.

Przełącznik wskazówek oferuje opcje **Wyłączone**, **Linia AB** oraz **Ścieżka**. **Ścieżka** wyświetla przejazdy i pierścienie uwroci w kolorze przejazdu. Skręty są oznaczone linią przerywaną w kolorze skrętu. **Linia AB** zachowuje widok linii siewu wyznaczonej przez dwa punkty. Użyj tego widoku, aby sprawdzić kierunek przejazdów, uwrocia i skręty w odniesieniu do kształtu pola i przeszkód.

<figure><img src="https://3832317038-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>Przed rozpoczęciem prac na polu sprawdź kierunek przejazdów i uwrocia.</p></figcaption></figure>

## Uprawa zmienną dawką w John Deere

Wysyłaj zalecenia dotyczące uprawy zmienną dawką do John Deere Operations Center jako **plany prac uprawowych**. Ta funkcja uzupełnia dotychczasowe plany prac siewnych i aplikacyjnych.\
\
GeoPard przesyła zalecenie głębokości i tworzy plan prac dla odpowiedniego pola. Pole musi być wcześniej zsynchronizowane z John Deere.

<div><figure><img src="https://3832317038-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>Wyślij zalecenie głębokości z GeoPard.</p></figcaption></figure> <figure><img src="https://3832317038-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 tworzy odpowiedni plan prac uprawowych.</p></figcaption></figure></div>

<figure><img src="https://3832317038-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>Sprawdź wyeksportowany plan w John Deere Operations Center.</p></figcaption></figure>

## Asystent AI: załączniki, tryb dokowania i szybsze pytania uzupełniające

Asystent AI GeoPard przyjmuje teraz **załączniki plików na czacie**. Dodaj raport z laboratorium gleby lub plik CSV i zadawaj pytania prostym językiem. **Obsługiwane formaty: PDF, Word, Excel, CSV, TXT, Markdown i HTML**.

Poznaj [Asystent AI GeoPard](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/geopard-ai-assistant.md), [Baza wiedzy agrotechnicznej](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/geopard-ai-assistant/agronomy-knowledge-base.md) oraz [Biblioteka promptów](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/geopard-ai-assistant/prompt-library.md). Zapoznaj się z [Dokładność i ewaluacja](https://docs.geopard.tech/geopard-tutorials/pl/przewodnik-po-produkcie-aplikacja-webowa/geopard-ai-assistant/accuracy-and-evaluation.md) , aby dowiedzieć się, jak weryfikowane są wyniki.

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

Aby zachować dokument, **dodaj go do bazy wiedzy** za pomocą ikony załącznika. Dokument jest przetwarzany w tle, gdy pracujesz. Asystent może korzystać z niego podczas kolejnych sesji.

<figure><img src="https://3832317038-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>Dodaj dokumenty źródłowe do bazy wiedzy, aby Asystent mógł korzystać z nich w przyszłych sesjach.</p></figcaption></figure>

#### Tryb dokowania

Przypnij Asystenta jako **zmieniany rozmiar panelu po prawej stronie zamiast nakładki**. Mapa, strefy i warstwy pozostają widoczne i można z nich korzystać podczas zadawania pytań. Tryb i szerokość są zapamiętywane, a przełączanie zachowuje rozmowę i wpisaną wiadomość.

<figure><img src="https://3832317038-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FBmMuMAK7MbyPIuuvU1AO%2FScreenshot%202026-09-15%20at%2015.47.19.png?alt=media&amp;token=cf99ea18-ed57-4f97-a935-e41e9136338d" alt="GeoPard AI Assistant docked as a resizable panel beside a field map"><figcaption><p>Podczas pracy z Asystentem mapa pola i warstwy pozostają widoczne.</p></figcaption></figure>

#### Szybsze pytania uzupełniające i jaśniejsze decyzje

Każda odpowiedź kończy się teraz sekcją **klikalnych kolejnych kroków**: utwórz mapę VRA, zaplanuj pobieranie próbek gleby lub wyeksportuj dane do John Deere Operations Center — pole i warstwa zostaną automatycznie uwzględnione. Gdy Asystent zadaje pytanie, **zalecana odpowiedź jest oznaczona**, a opcja „Inne” **pozwala wpisać własną odpowiedź**. Wiadomości mają teraz również znaczniki czasu i są oddzielone nagłówkami „Dzisiaj” i „Wczoraj”, co ułatwia poruszanie się po dłuższych sesjach.

<figure><img src="https://3832317038-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>Przejdź od rekomendacji do działania gotowego do wykonania na polu, wykonując mniej kliknięć.</p></figcaption></figure>

### Asystent AI na urządzeniach mobilnych

Asystent AI jest teraz dostępny w aplikacji mobilnej GeoPard **na iOS i Androidzie**. To ten sam Asystent, te same rozmowy i ta sama historia co w wersji internetowej, więc możesz **zacząć zadawać pytanie na polu i dokończyć je przy biurku.**

## Ulepszenia

* **Menu „Zarządzaj polem”.** Menu „Operacje polowe” nosi teraz nazwę „Zarządzaj polem”, a nazwy jego pozycji zostały uproszczone.

<figure><img src="https://3832317038-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>Zmienione menu grupuje najczęściej używane działania na polu.</p></figcaption></figure>

* **Legenda planu próbkowania.** Po wybraniu planu próbkowania na stronie pola wyświetla się legenda.

<figure><img src="https://3832317038-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>Skorzystaj z legendy, aby szybko zinterpretować strefy planu próbkowania.</p></figcaption></figure>

* **Uporządkowana lista topografii.** Mapy topograficzne utworzone na podstawie danych maszynowych są oddzielone od pozostałych map i zgrupowane w zwijanej sekcji „Z danych maszynowych”.

<figure><img src="https://3832317038-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>Oddziel mapy topograficzne utworzone na podstawie danych maszynowych od pozostałych warstw pola.</p></figcaption></figure>

* **Dokładniejsze grupowanie w porównaniu warstw.** Warstwy zastosowanych dawek są grupowane według roku, a mapy topograficzne wygenerowane na podstawie danych maszynowych są umieszczane we własnej grupie, oddzielnie od pozostałych.
* **Linki bezpośrednie otwierają właściwą warstwę.** Po otwarciu udostępnionego linku strona automatycznie przewija się do wybranego zbioru danych, niezależnie od typu warstwy.
* **Natychmiastowa informacja po usunięciu.** Usunięte zasoby od razu znikają z listy.
* **Czytelniejszy widok dawek.** Sumy produktów są ukrywane dla jednostek opartych na głębokości, dla których suma nie ma znaczenia.
* **Czytelne nazwy atrybutów.** Kody atrybutów maszynowych są mapowane na czytelne nazwy.
* **Rozszerzona obsługa API i MCP.** Rozszerzając zestaw narzędzi udostępniony w lipcu, API i serwer MCP obsługują teraz również generowanie map stref i przypisywanie dawek, wyszukiwanie topografii, czyszczenie i kalibrację plonów oraz import danych dotyczących granic pól, plonów, gleby, zastosowanych dawek, wyników laboratoryjnych i map stref VRA.
* **Szybsze czyszczenie dużych zbiorów danych.** Czyszczenie danych o plonach i zastosowanych dawkach sprawnie obsługuje teraz pliki zawierające ponad 1,5 miliona geometrii.
* **Lepsza jakość zdjęć satelitarnych.** Ulepszono wykrywanie chmur i cieni, a archiwum historycznych danych Landsat przeniesiono do nowszej kolekcji.
* **Archiwa skanerów gleby.** Pliki ZIP ze skanerów gleby są przetwarzane bezpośrednio w GeoPard.
* **Jakość odpowiedzi asystenta.** Przebudowano rozpoznawanie intencji, planowanie, wyszukiwanie wiedzy i opieranie odpowiedzi na dokumentacji. Przy każdej zmianie uruchamiany jest automatyczny test jakości.

## Poprawki błędów

* **Mapy stref z równań są generowane niezawodnie.** Podczas ich generowania nie pojawia się już komunikat „Nic tu nie ma”.
* **Kompletne mapy równań w niestandardowej rozdzielczości siatki.** Bez pustych fragmentów i wartości przypisanych do niewłaściwych komórek.
* **Niezawodne mapy analizy.** Wektorowe mapy analizy są generowane bez problemów, zamiast przerywać pracę w połowie.
* **Podglądy atrybutów o niewielkim zróżnicowaniu.** Atrybuty o jednej wartości lub niewielu różnych wartościach są teraz wyświetlane.
* **Zapisywanie map stref ze szczegółowymi granicami.** Zapisywanie map o gęstej geometrii nie kończy się już przekroczeniem limitu czasu.
* **Bezpieczniejsza edycja map stref.** Aktywność w innych częściach pola nie przeszkadza już w odzyskaniu niezapisanej zmiany.
* **Plany próbkowania dla złożonych stref.** Plany można generować na mapach stref, których geometria wcześniej to uniemożliwiała.
* **Opcja „Zaznacz wszystko” w etykietach do wydruku.** Odznaczenie opcji „Zaznacz wszystko” w oknie etykiet planu próbkowania działa prawidłowo.
* **Funkcja „Klonuj poligony” wczytuje geometrię gleby.** Zbiór danych źródłowych jest wyświetlany zamiast nie pojawiać się na ekranie.
* **Filtrowanie map stref według typu.** Filtry typów zwracają właściwe mapy, także w obrębie gospodarstwa.
* **Wyniki badań laboratoryjnych można importować z niedoskonałych plików.** Import kończy się pomyślnie, nawet gdy plik można odczytać tylko częściowo.
* **Etykiety drukowane odpowiadają strefom planu.** Nazwy stref z drukowanych etykiet są przypisywane do właściwych stref planu pobierania próbek.
* **Pliki maszyn można importować poprawnie.** Pliki, których przetwarzanie wcześniej się zawieszało, są teraz przetwarzane.
* **Wartości tekstowe są zachowywane podczas czyszczenia danych.** Czyszczenie danych plonowania i zabiegów zachowuje nazwy upraw, produktów i odmian, nie powodując błędów.
* **Czyszczenie bardzo małych zbiorów danych.** Zbiory danych zawierające zaledwie kilka punktów nie powodują już błędów.
* **Niezawodne czyszczenie danych zabiegów.** Naprawiono błąd, który uniemożliwiał przetwarzanie niektórych zbiorów danych zabiegów.
* **Pełna skala kolorów na mapach glebowych.** Przetworzone mapy glebowe wykorzystują całą skalę, a nie tylko jeden kolor.
* **Porównuj jednocześnie cztery warstwy.** Licznik warstw nie uwzględnia już wierszy grup, więc limit nie jest osiągany przedwcześnie.
* **Porównywanie zbiorów danych glebowych i plonowania.** Porównanie otwiera się zamiast zwracać błąd.
* **Monitorowanie satelitarne zostaje uruchomione.** Pola nie pozostają już w oczekiwaniu na zdjęcia, które nigdy nie nadchodzą.
* **Dokładne informacje o zasięgu zdjęć.** Zasięg jest podawany poprawnie, a gdy podstawowe sprawdzenie jest niedostępne, stosowana jest metoda zastępcza.
* **Możliwość odzyskania po błędach zdjęć i granic pól.** W razie błędu podczas wczytywania zamiast pustej mapy pojawia się czytelny komunikat i możliwość ponowienia próby.
* **Eksport danych topograficznych uwzględnia bufor.** Eksporty obejmują skonfigurowany margines wokół pola.
* **Usunięcie danych pola usuwa również jego warstwy mapy.** Usunięte dane nie pozostają już na mapie.
* **Daty są wyświetlane zgodnie z wybranym językiem.** Zakresy sezonów i daty zdjęć satelitarnych są wyświetlane w wybranym języku interfejsu.
* **Czat jest czyszczony po zmianie konta.** Rozmowy z poprzedniej sesji nie są już widoczne po zmianie konta lub wylogowaniu.
* **Rozmowy otwierają się przy najnowszej wiadomości.** Nie trzeba już przewijać długiego wątku od początku.
* **Ostatnia wiadomość pozostaje na swoim miejscu.** Wiadomość i odpowiedź pozostają w wątku po zamknięciu panelu.
* **Historia czatu wczytuje się w całości.** Prawidłowe tytuły, zachowany stan przypięcia i brak pustego panelu po ponownym otwarciu.
* **Działające linki do pobierania.** Linki do eksportu udostępnione przez Asystenta otwierają się poprawnie.
* **Załączniki bez wiadomości.** Wysyłanie pliku bez tekstu jest teraz prawidłowo obsługiwane.
* **Asystent kontynuuje od miejsca, w którym skończył.** Rozmowy są wznawiane bez problemów po przerwaniu lub długotrwałym żądaniu.


---

# 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/pl/dziennik-zmian-i-wydania-produktu/release-sep-2026-yield-report-ai-assistant-attachments-guidance-lines-tillage-workplans.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.
