> 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/de/produkt-tour-web-app/import-precision-agriculture-data.md).

# Daten der Präzisionslandwirtschaft importieren

Unterstützte Importformate für Präzisionslandwirtschaftsdaten.

{% hint style="success" %}
Laden Sie eigene Felddateien hoch und sehen Sie sie auf einer Karte: [Kostenlos starten](https://app.geopard.tech/auth/sign-up?utm_source=docs\&utm_medium=cta\&utm_campaign=import-precision-agriculture-data)
{% endhint %}

**Datenformate importieren**

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Shapefiles (Punkte oder Polygone)

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)GeoJSON (über API)

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)[SoilOptix](https://geopard.tech/blog/tpost/brrck2udr1-soiloptix-data-analysis-in-precision-agr) Bodenscanner

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)[TopSoilMapper/GeoProspectors](https://geopard.tech/blog/tpost/agte3p8ec1-analyze-geoprospectors-topsoilmapper-dat) Bodenscanner

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Ertragsdaten im SHP-Format

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Ertragsdaten im ISOXML-Format

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Bodendaten im SHP-Format

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Daten zu ausgebrachten Betriebsmitteln und zur Aussaat im SHP-Format

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Precision Planting (Datendateien) – 20/20-Dateien

<img src="https://lh5.googleusercontent.com/u7q3Q1k7efVChCpNozBAAymWkbRmKPfAUTxmWEcioDQ-_S2C0cYgLs2YX5dSy9WwbIY4u0utOzs04-lu3bB1TJHHwAMztBijQNrh_0bNd1PjZsOMLdUxUBXFK4X9rPCkIfwRhkzX" alt="" data-size="line">Ag Leader (`agdata` Dateien) – Demnächst verfügbar. Senden Sie uns die Daten, und wir konvertieren sie.

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)CNH-cn1-Ordner

### **Feldgrenzen importieren** <a href="#field-boundary-import" id="field-boundary-import"></a>

Wenn Sie ein Shapefile Ihres Feldes oder Ihrer Felder haben, können Sie es über **Daten importieren**. Gehen Sie zum Tab **Dateien hochladen** .

Beachten Sie dabei die folgenden Einschränkungen:

* Es werden nur Shape-Dateien im Koordinatenreferenzsystem WGS84 (EPSG:4326) unterstützt.
* Die maximale Dateigröße beträgt 5 MB.
* Die maximale Feldfläche beträgt 1236ac/500ha.
* Jede Shape-Datei wird als einzelnes Feld behandelt.
* Die Bezeichnungen werden aus der .dbf-Datei übernommen.

<figure><img src="https://1347797700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FgKjte01bGaesKV0p5CLJ%2Fimage.png?alt=media&amp;token=05497575-83a6-4fdb-b82d-cc760e4c5cc3" alt=""><figcaption></figcaption></figure>

1. Wählen Sie den Betrieb aus, in den die Daten hochgeladen werden sollen.
2. Klicken Sie auf die Schaltfläche **Durchsuchen** und wählen Sie eine Datei auf Ihrem Computer aus.
3. Klicken Sie auf die Schaltfläche **Hochladen** . Anschließend prüft die Anwendung, ob die Datei die Anforderungen erfüllt, und speichert die Fläche.

<figure><img src="https://lh6.googleusercontent.com/KRj9zcB08BXcSfaY4DV3jdMVxbVQNEcJVvEMIwLIb1ytnjEoZ35qxhHFso_NLWM_hohe7PQ3EedeYqvFJFEBZeb9pg98H_-DNCyvOZ9c17EakhGxGThO1dqgr8QAllzi0HCVYK0v" alt=""><figcaption></figcaption></figure>

\
Warten Sie, bis der Bestätigungsdialog anzeigt, dass die Feldgrenze erfolgreich hochgeladen wurde:

<figure><img src="https://lh3.googleusercontent.com/nlGv5apThqj41M-5fW0GUe2Nntju-RKcuAaGH-UwwzxoeIHRoCoghIcBPq-HtkTgrQOIUAGtayx13Qt8Vh-sGLmkpm2d7PQLpZxUeRXKP2iAaRYEeQbAGyXfIgqYhgtfKaXaFfx_" alt=""><figcaption></figcaption></figure>

### **Bodendaten importieren** <a href="#soil-data-import" id="soil-data-import"></a>

Die chemische Bodenanalyse ist eine der wichtigsten Datenebenen im Ackerbau. Bodeninformationen stammen üblicherweise von agrarchemischen Laboren, die Bodenproben aus dem Feld analysieren. Die Probenahme erfolgt dabei nach einem Raster- oder Zonenkonzept. Die Anzahl der Bodenmerkmale in einer konkreten Datei kann zwischen 5 und 10 Makronährstoffen wie Stickstoff (N), Phosphor (P), Kalium (K), Kationenaustauschkapazität (CEC) und Gehalt an organischer Bodensubstanz (OM) und 40 bis 50 Merkmalen einschließlich aller Mikronährstoffe liegen.

Sie können Bodenprobendaten in GeoPard Agriculture hochladen und für jedes Merkmal in der Datei eine leicht verständliche Heatmap erstellen. Außerdem können Sie anhand beliebiger Merkmale Managementzonen erstellen, diese mit anderen Datenebenen wie der historischen Ertragsleistung vergleichen und teilflächenspezifische Düngepläne erstellen.

Sie können Bodendatensätze über den Menüpunkt **Daten importieren** hochladen. Wählen Sie **Dateien hochladen**.

Beachten Sie dabei die folgenden Einschränkungen:

* Es werden nur Shape-Dateien im Koordinatenreferenzsystem WGS84 (EPSG:4326) mit Punkt- oder Polygongeometrien unterstützt.
* Die Attribute müssen numerische Werte enthalten (Ganzzahl oder reelle Zahl, kein Text).
* Die maximale Dateigröße beträgt 100 MB.
* Vermeiden Sie möglichst Sonderzeichen wie %+@ in den Bezeichnungen der Attribute.
* Es sind maximal 20 Attribute zulässig.
* Jede Shape-Datei wird als einzelner Datensatz behandelt (\*.shp- und \*.dbf-Dateien sind erforderlich).<br>

<figure><img src="https://1347797700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FU2xqTtxLaLtoUanaOZwv%2Fimage.png?alt=media&amp;token=8fd54f33-3124-4165-829c-33a4c577fb7f" alt=""><figcaption></figcaption></figure>

1. Sie können einzelne oder mehrere Bodendatensätze per Drag-and-drop in das Feld ziehen oder auf die Schaltfläche **Durchsuchen** klicken und einen Datensatz auf Ihrem Computer auswählen.
2. Klicken Sie auf die Schaltfläche **Hochladen**  . Anschließend prüft die Anwendung, ob die Datei die Anforderungen erfüllt, und speichert die Daten.

Warten Sie, bis der Bestätigungsdialog anzeigt, dass der Datensatz erfolgreich hochgeladen wurde:

<figure><img src="https://lh6.googleusercontent.com/GUuMs3oG97HGoZZQ2YI3c5Yxzu1b_FmnlCB-7sA7rpcqwn_qam1Bh1chsF0SVKzTHotYU1AT-wg1cfB8OLJbpwXuKn9Y_opGwBGhiuWGHBrHHyPVfxUnpf6B8-h9GFmvfFTghzJ8" alt=""><figcaption></figcaption></figure>

Die Bodendaten werden im Abschnitt **Bodendaten** angezeigt und stehen für weitere Aktionen zur Verfügung, darunter das Erstellen von Zonenkarten.

<figure><img src="https://lh3.googleusercontent.com/ERU19-KCgMO1LlWduMZ82AAap4miaEGLIeWo99XQafW_vVWX4A35auS2JjnNP2kWuMIJKQVUSKcnyOhBa_2CFbZwPnlQxn0P4Fc9MSNNfd_HFPZmF9-qlU1l6MRjoVJKVwJy3DHu" alt=""><figcaption></figcaption></figure>

Weitere Informationen finden Sie unter [Zonenkarten und Analysen](https://docs.geopard.tech/geopard-tutorials/de/produkt-tour-web-app/zones-maps-and-analytics.md) dazu, wie Sie anhand von Bodendaten eine Zonenkarte erstellen.

GeoPard unterstützt auch die sachgerechte Planung zonaler Bodenprobenahmen. Sie können anhand der mehrjährigen Zonen von GeoPard, die historische Muster der Bestandsentwicklung abbilden, Probenahmepunkte und Routen planen.

### **Ertragsdaten importieren** <a href="#yield-data-import" id="yield-data-import"></a>

Um Ertragsdaten hochzuladen, wählen Sie **Daten importieren** Menüelement. Wählen Sie dann **Dateien hochladen**.

Beachten Sie dabei die folgenden Einschränkungen:

* Es werden nur Shape-Dateien im Koordinatenreferenzsystem WGS84 (EPSG:4326) mit Punkt- oder Polygongeometrien unterstützt.
* Die Attribute müssen numerische Werte enthalten (Ganzzahl oder reelle Zahl, kein Text).
* Die maximale Dateigröße beträgt 100 MB.
* Vermeiden Sie nach Möglichkeit Sonderzeichen `%+@` in den Attributnamen.
* Die maximale Anzahl an Attributen beträgt 20.
* Jede Shape-Datei wird als einzelner Datensatz behandelt (\*.shp- und \*.dbf-Dateien sind erforderlich).

<figure><img src="https://1347797700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fgh274tUbThwBbn7ZlaHm%2Fimage.png?alt=media&amp;token=e1f8b6da-8510-423e-afbe-9b5fb97b7dfd" alt=""><figcaption></figcaption></figure>

1. Sie können einzelne oder mehrere Ertragsdatensätze per Drag-and-drop in den Bereich ziehen oder auf die Schaltfläche **Durchsuchen** klicken und einen Datensatz auf Ihrem Computer auswählen.
2. Klicken Sie auf die Schaltfläche **Hochladen**  . Anschließend prüft die Anwendung, ob die Datei die Anforderungen erfüllt, und speichert die Daten.

Warten Sie, bis der Bestätigungsdialog anzeigt, dass der Datensatz erfolgreich hochgeladen wurde:

<figure><img src="https://lh6.googleusercontent.com/8Dk9Poz900uimyYo-W8XuuMHeauRkDNo6-Klo8ejFsZt0Gd_ktEhXOxALfxZPV7kl86DfkQSJo1X3UvP6Vw9ib1RtSd--3dQ1ZC4gLLoV733quEp7YYbaJMXYrbLC7vZPa3ItCgA" alt=""><figcaption></figcaption></figure>

Der Datensatz wird im Abschnitt **Ertragsdaten** angezeigt und steht für weitere Aktionen zur Verfügung, darunter die Erstellung von Zonen-Karten.

<figure><img src="https://lh5.googleusercontent.com/mDqfJIosDlhKNvM6JkSd7f6I4zZ_tDAYg2WoubwjEZU5SKh32FDwePQBJc-7zxIGR4wNtzME0Yzmqopdo6YM7zb6jP6Ex6annMrfjWr6ougD0V8hz2f3mn0e9QWFn1HoJKjoiiDM" alt=""><figcaption></figcaption></figure>

Weitere Informationen dazu, wie Sie mit Ertragsdaten eine Zonen-Karte erstellen, finden Sie unter [Zonen-Karten und Analysen](https://docs.geopard.tech/geopard-tutorials/de/produkt-tour-web-app/zones-maps-and-analytics.md) .

### **Import von Ausbringungs- und Aussaatdaten** <a href="#as-applied-as-planted-data-import" id="as-applied-as-planted-data-import"></a>

Um Ausbringungsdaten hochzuladen, wählen Sie das Menüelement **Daten importieren** aus. Wählen Sie dann **Dateien hochladen**.

Beachten Sie dabei die folgenden Einschränkungen:

* Es werden nur Shape-Dateien im Koordinatenreferenzsystem WGS84 (EPSG:4326) mit Punkt- oder Polygongeometrien unterstützt.
* Die Attribute müssen numerische Werte enthalten (Ganzzahl oder reelle Zahl, kein Text).
* Die maximale Dateigröße beträgt 40 MB.
* Vermeiden Sie nach Möglichkeit Sonderzeichen `%+@` in den Attributnamen.
* Die maximale Anzahl an Attributen beträgt 20.
* Jede Shape-Datei wird als einzelner Datensatz behandelt (\*.shp- und \*.dbf-Dateien sind erforderlich).

<figure><img src="https://1347797700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FpuLGp6GIs6yny6NKlRcU%2Fimage.png?alt=media&amp;token=0dbab65c-3026-4176-b086-7eedb7650b68" alt=""><figcaption></figcaption></figure>

1. Sie können einen oder mehrere Ausbringungsdatensätze per Drag-and-drop in den Bereich ziehen oder auf die Schaltfläche **Durchsuchen** klicken und einen Datensatz auf Ihrem Computer auswählen.
2. Klicken Sie auf die Schaltfläche **Hochladen**  . Anschließend prüft die Anwendung, ob die Datei die Anforderungen erfüllt, und speichert die Daten.

Warten Sie, bis der Bestätigungsdialog anzeigt, dass der Datensatz erfolgreich hochgeladen wurde:

<figure><img src="https://lh4.googleusercontent.com/xoQ_v-Ze506YEJkMtaG_Hg1rih-yQwCPBpqwHyNMSELmDnSvLmf_YhGOH3wXpTZ6AjpW4uyXXK6JD_A-CIC1kf4awf1Gf_4lsQSvri-VYREeMynsdor4ZMoWWt5bTKVEOfaEQN5U" alt=""><figcaption></figcaption></figure>

Der Datensatz wird im Abschnitt **Ausbringungs- und Aussaatdaten** angezeigt und steht für weitere Aktionen zur Verfügung, darunter die Erstellung von Zonen-Karten.

<figure><img src="https://lh5.googleusercontent.com/Z-aDK0Y1tt4n_nL3e9e0SlEXqqgKAMWDuNh8N_FaZZWZI9KRmBxQHoVVqIfqcE7iKck85RxwriH803iZveFt0P2oLIoTyKuXDVCwqBaylRQqyMg6eaOp6rH31uPzBsmlMQhV3zLH" alt=""><figcaption></figcaption></figure>

Weitere Informationen dazu, wie Sie mit Ausbringungsdaten eine Zonen-Karte erstellen, finden Sie unter [Zonen-Karten und Analysen](https://docs.geopard.tech/geopard-tutorials/de/produkt-tour-web-app/zones-maps-and-analytics.md) .

### **Import aus MyJohnDeere** <a href="#import-from-myjohndeere" id="import-from-myjohndeere"></a>

GeoPard-Nutzer können Daten wie Feldgrenzen, Ertragsdatensätze sowie Aussaat- und Ausbringungsdatensätze aus dem John Deere Operations Center in GeoPard importieren.

Sie können die Datensätze über das Menüelement **Daten importieren** hochladen. Wählen Sie **Aus MyJohnDeere**.

1. aus. Um alle verfügbaren Daten zu importieren, wählen Sie ein Feld aus und klicken Sie auf **Alle importieren** oder verwenden Sie die Auswahlfunktion.

<figure><img src="https://lh5.googleusercontent.com/mkTB9VxchwaIRnC_Hg3SFrtVuPWDWSc1lPxHPd3-ErURtDixoIGLegdfo-GAvqlWtnIWyBbGnev0HosjZdH4fiQcsh0uH7pkU3_fkb8xttmfd0Z-ADxYbQP31VbtHvuXkdhilZIG" alt=""><figcaption></figcaption></figure>

Wenn die richtige Organisation nicht verfügbar ist, rufen Sie den Link **Hier können Sie Organisationen ändern** auf und fügen Sie die Organisation hinzu. Wenn die John-Deere-Organisation deaktiviert ist (der Name wird grau angezeigt), gewähren Sie Zugriff auf das John Deere Operations Center.

Klicken Sie nach der Auswahl auf **Ausgewählte importieren** .

<figure><img src="https://i0.wp.com/help.geopard.tech/wp-content/uploads/2021/12/image-1.png?resize=896%2C442&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

2. Im nächsten Schritt werden die Importeinstellungen angezeigt. Wenn Sie nur Feldgrenzen importieren möchten, wählen Sie das Optionsfeld **Feldgrenzen** aus und klicken Sie auf die Schaltfläche **Fertig** , um den Import zu starten. Wenn die Feldgrenze bereits importiert wurde, werden die Daten aktualisiert.

<figure><img src="https://lh3.googleusercontent.com/3-lV63PcGzerVqbtyhMVONR0_L-ZQ-pOr3lO4GnNgtyWKtVCJK5fHKulmlrgBn2tT76E-FIeV8Ix_DF85VbaEuug7DZpucDiusrnvhg2M2H4a3oNYnrSfi6-HJVD6C75rY0bxL6A" alt=""><figcaption></figcaption></figure>

Wenn Sie Daten zusammen mit einer Feldgrenze importieren möchten, wählen Sie das Optionsfeld **Datendateien** aus und klicken Sie auf die Schaltfläche **Weiter** -Schaltfläche. Wenn zuvor Assets mit Grenzen importiert wurden, werden die Daten aktualisiert.

<figure><img src="https://lh5.googleusercontent.com/7ENyHLNqNPEnknHHR6bctm1L1joqisrL18ZzvmJWfUTT4CwItPnAU4Q_sZXzImxrkAdVf9LJoUxxseZmG-x0dbBnOFimRs6gCgAKcitKrgN2cmpu9QRTB6IvHik5r5qFZ85rPV40" alt=""><figcaption></figcaption></figure>

Nach dem Klicken können Sie **Typ** und **Zeitraum** der Assets auswählen. **Zeitraum** Im Dropdown-Menü können Sie einen Zeitraum auswählen.

<figure><img src="https://lh4.googleusercontent.com/MhNODjSyqYRWjfYEv3gD8cDbFUj-OHsJ-lMQq1FWFTt0ogjk04STQiFU9qLDxaxWNEzSnzO5i-JG5bO3wX0MyhmiCplW4w1pLC3jCIk5KZ54whiHXcu6nquy1b-2Be0mqbSPDHE2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh5.googleusercontent.com/9japjeGiD2WucUKFq-j-fQiKGNIp1kHWEkgOq-2vakbRvHbGUxR1fea25Ga23v8DMzL6ctl86I02Roxc0gE_mXGEwtRbjinQsWvYk4arXmET5WgpI8XPnA-Bpx6ZMZMR6zRoX6aT" alt=""><figcaption></figcaption></figure>

Nachdem Sie **Typ** und **Zeitraum**ausgewählt haben, klicken Sie auf die Schaltfläche **Fertig** um den Importvorgang zu starten.

<figure><img src="https://lh6.googleusercontent.com/veKRBXj3TPMmavBPOSYABPmpbaBTJnmbrqn-5BRpX7xA-lvRIxpVvWCFy4rUTqaHsgx_56oHB_nf1KhSQ_GiGU6w8mLAvuV-A0DNEeGeSnbh04rJRueMhec3ut4r-3zLNktH5BhT" alt=""><figcaption></figcaption></figure>

Warten Sie auf die Bestätigung, dass der Datensatz erfolgreich hochgeladen wurde. Nach der Datenmigration können Sie auf den Link **Zum Feld** klicken, um die Daten zu überprüfen.

<figure><img src="https://lh4.googleusercontent.com/pvnmZQM0RZ9BCNqadNfFPUFaPRBJMLeBoT_v9p_aDOdHkcbX2i2Bemya6aZgRpTO1Rb6iAQEqfrdY95vFKQacMadSiTAVOioU9M0E-k4y28zxmRmYp45DJEqWVDU61K57sCWMHPa" alt=""><figcaption></figcaption></figure>


---

# 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/de/produkt-tour-web-app/import-precision-agriculture-data.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.
