> 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/ro/tur-de-produs-aplicatia-web/prelevarea-probelor-de-sol-planificare-automata.md).

# Prelevarea probelor de sol - planificare automată

Construiește planuri de prelevare a probelor de sol în câteva minute, pentru una sau mai multe parcele. Alege grilă sau zone, probă simplă sau compozită, lasă algoritmii inteligenți să plaseze punctele și să ruteze traseul, tipărește etichete de laborator, exportă și pornește.

## Tutorial dinamic de 1 minut

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

## Pentru cine este

Fermieri, agronomi, laboratoare de sol, retaileri și distribuitori care au nevoie de fluxuri de prelevare consecvente la scară mare (de la câteva parcele până la ferme întregi sau cultivatori).

## Exemple de planuri de prelevare a solului

<div align="center" data-full-width="false"><figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F5WUAtsiURQyxlgd42EKs%2FGeoPard%20mobile%20-%20soil%20sampling%20Execution.png?alt=media&amp;token=d5c783d9-5290-428c-ae12-1dd662b6e7e5" alt="Soil sampling on mobile app. Collect samples, mark points"><figcaption><p>Prelevare de sol în aplicația mobilă. Colectați probe, marcați punctele</p></figcaption></figure> <figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FS08wuU0lhUlg4PfWrqfx%2Fgeopard%20soil%20sampling%20plan%201.png?alt=media&amp;token=fc605b5a-c1bc-4477-b5d9-b0462f4f85d1" alt="Zonal Soil Sampling, Zone-By-Zone Option. Go to the next Zone only after finishing the previous one."><figcaption><p>Prelevare de sol pe zone, opțiunea Zonă cu zonă. Treceți la următoarea zonă doar după ce o finalizați pe cea anterioară.</p></figcaption></figure> <figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FxUsJ5sHyT0bBbmwxJ4hq%2Fgeopard%20soil%20sampling%20plan%202.png?alt=media&amp;token=e571a4dd-5bf3-4e83-887f-5dc1e2752a0e" alt="Zonal Soil Sampling, Zone-By-Zone Option, sample 2. Go to the next Zone only after finishing the previous one."><figcaption><p>Prelevare de sol pe zone, opțiunea Zonă cu zonă, ex. 2. Treceți la următoarea zonă doar după ce o finalizați pe cea anterioară.</p></figcaption></figure> <figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fx74rPlKVnfIIWQyfH8xR%2Fgeopard%20soil%20sampling%20plan%203.png?alt=media&amp;token=f73322bb-ab1a-4ddb-9486-636aa1cd5557" alt="Zonal Soil Sampling, Smart optimum Path Option. GeoPard locates points according to several best practices, incl. path optimum, points distribution, buffer zones"><figcaption><p>Prelevare de sol pe zone, opțiunea Traseu optim inteligent. GeoPard poziționează punctele conform mai multor bune practici, inclusiv traseu optim, distribuția punctelor și zone tampon</p></figcaption></figure></div>

## Caracteristici și setări

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Prelevare zonală sau pe grilă</strong> tipuri. Suport pentru tipurile de prelevare Core și Composite</td><td></td></tr><tr><td><strong>Planificare pe mai multe parcele</strong>: creați planuri pentru una sau mai multe parcele într-o singură rulare.</td><td></td></tr><tr><td><strong>Logici de poziționare a punctelor bazate pe AI</strong>:</td><td><ul><li><em>Recomandare inteligentă</em> (adaptivă la forma/variabilitatea zonei)</li><li><em>Linia-schelet</em> (scheletul zonelor/poligoanelor)</li><li><em>N/Z</em> (4 puncte pe zonă, zig-zag)</li><li><em>W</em> (5 puncte pe zonă, model W)</li></ul></td></tr><tr><td><strong>Opțiuni de rutare și poziționare a punctelor</strong>:</td><td><ul><li><em>Traseu optim inteligent</em> (cel mai rapid per ansamblu)</li><li><em>Zonă cu zonă.</em> Treceți la următoarea zonă doar după ce o finalizați pe cea anterioară.</li></ul></td></tr><tr><td><strong>Configurarea planului de prelevare</strong></td><td><ul><li>Numărul de puncte pe zonă / grilă</li><li>Dimensiunea celulei de grilă</li><li>Unghiul de rotație al grilei</li><li>Tipul de analiză agrochimică a solului sau a plantei</li><li>Adâncimea probei</li></ul></td></tr><tr><td><p>Opțional, setați:</p><ul><li><strong>Puncte de început și de sfârșit</strong> Puncte</li><li><strong>Secvența zonelor</strong> desenați manual</li></ul></td><td></td></tr><tr><td><p><strong>Imprimarea etichetelor</strong> pentru laborator și prelevatori:</p><ul><li>Definiți logica a ceea ce se pune pe sonda de sol</li><li>Descărcați și imprimați PDF-ul cu etichete</li><li>Imprimați de pe web sau mobil</li></ul></td><td></td></tr><tr><td>Exportați planul de prelevare:</td><td><ul><li>KML (zone, traseu și puncte)</li><li>Shapefile (în curând)</li></ul></td></tr><tr><td>Executare pe teren cu aplicația mobilă GeoPard</td><td><ul><li>Folosiți <a href="https://docs.geopard.tech/geopard-tutorials/product-tour-mobile-app/installation"><strong>aplicația mobilă GeoPard</strong> </a>pentru a vizualiza planurile pe teren, a adăuga note și a marca progresul.</li><li>Mod offline</li><li>Navigare / urmărirea direcției de deplasare (ca Google Maps)</li></ul></td></tr></tbody></table>

## Flux de lucru

### 1. Începeți un plan nou

Deschideți **Planuri de prelevare** în meniul din stânga sau deschideți într-o filă nouă din browser <https://app.geopard.tech/#/sampling-plans>.

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FSSpzFJsoGKxGPAFCQZWB%2FScreenshot%202025-09-26%20at%2014.20.07.png?alt=media&amp;token=1beb3da0-47c1-4527-a159-8c0d196475c4" alt="Sampling Plan Module, how to start" width="241"><figcaption><p>Modulul Plan de prelevare, cum să începeți</p></figcaption></figure>

Selectați una sau mai multe parcele. Opțional, copiați setările dintr-un plan existent (pentru a obține o evoluție consecventă a solului de la un an la altul).

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

### 2. Alegeți tipul de analiză pe grilă sau zonală, Core sau Composite

* **Bazat pe grilă**: împarte parcela în celule egale; cel mai bun pentru stabilirea valorii de referință sau când datele istorice sunt limitate.
* **Bazat pe zone**: folosește zone de management (imagini, producție, sol etc.) pentru a ghida prelevarea acolo unde variabilitatea contează cel mai mult.

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fve4fDd0qcHt8QfCZVJv6%2Fanalysis-type.png?alt=media&amp;token=b6b2c3d5-d7d6-4cc5-b60c-446cf8dd3e8a" alt="Choose Grid or Zonal based sampling plan type" width="375"><figcaption><p>Alegeți tipul de plan de prelevare bazat pe grilă sau zonal</p></figcaption></figure>

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FqC6XSPZUkBvLHPNQtBEp%2Fsampling-type.png?alt=media&amp;token=a2c23d31-5065-4111-9c8b-fa290d278379" alt="Choose Core or Composite based sampling plan type" width="375"><figcaption><p>Alegeți tipul de plan de prelevare bazat pe grilă sau zonal</p></figcaption></figure>

* **Compozit**: combinați mai multe probe individuale într-o singură probă pe zonă sau pe grilă → cost-eficient.
* **Core**: probe individuale la fiecare punct generat → cea mai mare rezoluție spațială (mai multe probe de laborator).

### 3. Configurați logica de poziționare a punctelor și a traseului (bazat pe zone)

Printre opțiuni:

* **Recomandare inteligentă**: algoritmul adaptiv echilibrează acoperirea și efortul de deplasare.
* **Linia-schelet**: poziționează punctele de-a lungul liniilor paralele (excelent pentru echipamentele cu treceri drepte).
* **N/Z** modelele (4 puncte) și **W** modelul (5 puncte): modele agronomice clasice pentru gradienți și benzi înguste.
* Setați **numărul de puncte pe zonă** și **adâncimea de prelevare**.
* **Adâncimea probei**: Setați adâncimea probelor de sol.
* **Tipul de analiză agrochimică**: Adaptați-l la tipul de test de sol de care aveți nevoie.

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F5ctPg4NpfgURP6XOZQhd%2Fpoint-placement-logic.png?alt=media&amp;token=b47fb716-3e0f-47eb-937f-5b24ff206922" alt="Soil sampling Points &#x26; Path Placement Logic" width="563"><figcaption><p>Logica de poziționare a punctelor și a traseului pentru prelevarea solului</p></figcaption></figure>

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Flugxdvc2RQ3iQlEKpKzJ%2Fnumber-of-points-per-zone.png?alt=media&amp;token=3e695130-6b2a-4735-807a-e0f79dfc9236" alt="Number of points per zone" width="375"><figcaption><p>Setați numărul de puncte pe zonă</p></figcaption></figure>

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FRy1RVv0vjy3VGCNNxIcE%2Fagrochemical-analysis-type.jpg?alt=media&amp;token=ceeefb89-7741-459e-b4cc-ab90e7be8356" alt="Select Agrochemical Analysis Type" width="375"><figcaption><p>Selectați tipul de analiză agrochimică</p></figcaption></figure>

### 4. Setați opțiunile de rutare și traseu

* **Traseu optim inteligent**: un singur traseu eficient pe întregul câmp (poate traversa zonele).
  * Este excelent pentru prelevatoarele automate de sol (precum [Wintex](https://www.wintexagrousa.com/automatic-soil-samplers/), [Amity](https://www.amitytech.com/crop-management-tools/soil-samplers-2/), [Falcon](https://falconsoil.com/), [AutoProbe](https://agronomicinnovations.com/product/), [Dakota Fluid Power](https://www.dakotafluidpower.com/product/dfp-soil-probe), etc.)
* **Zonă cu zonă**: mergeți la următoarea zonă după ce terminați prelevarea în zona curentă.
  * Este foarte potrivit pentru prelevatorii manuali
* Desenați opțional o **secvență personalizată a zonelor** pentru a defini ordinea de deplasare.

### 5. Etichete pentru laborator și imprimare **(6×6 cm, 5×7 cm, 10×10 cm, A4)**

* *Tipul de prelevare Core*: stickerele sunt generate pentru **puncte**.
* *Plan de prelevare compozit*: stickerele sunt generate pentru **zone**.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Imagine de copertă</th></tr></thead><tbody><tr><td>Pentru prelevarea compozită, șablonul de etichetă pentru zonă stabilește numele zonelor, care sunt apoi folosite pentru imprimarea etichetelor pentru fiecare zonă.</td><td><a href="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FlGORsDE2lNEUkqF10VDj%2Fzone-name.png?alt=media&amp;token=21c8ab92-35e0-4f64-97bf-62e5c0579858">zone-name.png</a></td></tr><tr><td>Pentru prelevarea Core, șablonul de etichetă pentru puncte stabilește numele punctelor, care sunt apoi folosite pentru imprimarea etichetelor pentru fiecare punct.</td><td><a href="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FWO22KN4FsWPq4mr0ewcL%2Fpoint-name.png?alt=media&amp;token=8c709063-7200-44a6-a956-0f23fdf8bd4d">point-name.png</a></td></tr></tbody></table>

### 6. Generați și verificați

* Faceți clic pe **Generați planul**. Inspectați punctele, traseul și secvența zonelor pe hartă.

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

### 7. Ajustați planul (selectați zone, puncte de început/sfârșit, mutați, ștergeți puncte, secvența zonelor)

Ajustați setările și **regenerați** dacă este nevoie (nu se aplică costuri suplimentare):

* **Selectați harta zonelor pentru fiecare parcelă selectată:** În mod implicit, GeoPard selectează automat cea mai recentă hartă de zone sau generează o grilă pe baza parametrilor aleși.

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fh7jaXBbrvRuj0FXnuNW3%2FScreenshot%202025-09-29%20at%2014.15.00.png?alt=media&amp;token=8296f85f-5469-4a9f-b4ae-b810fd82dda1" alt="Select Zones based on which Sampling page is generated" width="563"><figcaption><p>Selectați zonele în funcție de care se generează pagina de prelevare</p></figcaption></figure>

* Editați punctele de început/sfârșit. GeoPard face recalcularea automată a traseului optim

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

* Mutați sau ștergeți puncte

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

### 8. Exporturi (pentru prelevare în software terț)

* **Trasee, puncte și poligoane într-un singur fișier**: exportați ca KML pentru aplicații de navigație.
* **Puncte/Poligoane**: exportați ca Shapefile/GeoJSON la nevoie (în curând).

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fr4vmPuRCwKrQqhtYJ1fb%2Fimage.png?alt=media&amp;token=c8ef8c39-efc6-4ac9-abde-bd59757aadb2" alt="Export Soil Sampling zones, route and points as kml"><figcaption><p>Exportați zonele de prelevare a solului, traseul și punctele ca KML</p></figcaption></figure>

#### Exemple de export KML (zone, limită, puncte și traseu) - toate într-un singur fișier KML

<div><figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FpWH2FID5H2yCbBlMz5id%2FScreenshot%202025-09-29%20at%2012.35.29.png?alt=media&amp;token=3c67f675-1e84-4a6a-879b-4cf5991a3e34" alt="Sampling KML export example" width="375"><figcaption><p>Exemplu de export KML pentru prelevare 1</p></figcaption></figure> <figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F0EfSzpz5yz4GGKyZB81f%2FScreenshot%202025-09-29%20at%2012.36.42.png?alt=media&amp;token=c8c57710-f807-452e-b295-29748daa5102" alt="Sampling KML export example 2" width="375"><figcaption><p>Exemplu de export KML pentru prelevare 2</p></figcaption></figure></div>

### 9. Executarea pe teren cu aplicația mobilă GeoPard

Folosiți [**aplicația mobilă GeoPard** ](/geopard-tutorials/ro/tur-de-produs-aplicatia-mobila/instaleaza-aplicatia-mobila-geopard.md)pentru a vizualiza planurile pe teren, a adăuga note și a marca progresul.

* Mod de navigare (ca Google Maps)
* Mod offline
* Imprimați etichetele de pe mobil
* Marcați punctele ca executate

<figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2F5WUAtsiURQyxlgd42EKs%2FGeoPard%20mobile%20-%20soil%20sampling%20Execution.png?alt=media&amp;token=d5c783d9-5290-428c-ae12-1dd662b6e7e5" alt="Soil Sampling collection with the mobile application" width="375"><figcaption><p>Colectarea probelor de sol cu aplicația mobilă GeoPard</p></figcaption></figure>

### 9. Asociați rezultatele de laborator cu parcela corectă

Când laboratorul trimite rezultatele înapoi, GeoPard le poate conecta la parcela și fluxul de prelevare corecte în mai multe moduri:

1. **ID plan de prelevare**\
   Fiecare plan de prelevare are un ID unic. Folosiți-l în timpul importului rezultatelor de laborator pentru cea mai fiabilă potrivire.
2. **Coordonatele punctului (`Lon` / `Lat`)**\
   GeoPard potrivește punctele spațial atunci când acestea se află în interiorul limitei parcelei.
3. **Geometrie WKT**\
   GeoPard poate potrivi și o coloană de geometrie WKT cu limita parcelei.
4. **Numele parcelei / ID-ul parcelei**\
   GeoPard compară valoarea cu parcela `TagString`. Filtrarea etichetelor este opțională.\
   `ID-ul parcelei` este UUID-ul parcelei din GeoPard.

Acest lucru îi ajută pe laboratoare, agronomi și retaileri să păstreze importurile curate și să evite remaparea manuală.

## Facturare și urmărire

* Toate activitățile de prelevare apar în **Jurnalul activităților**, asigurând trasabilitate completă.

  <figure><img src="https://1279602871-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FCIAuqePR5s0wxJIOrYqT%2Factivity-log.png?alt=media&amp;token=e067cb7b-ce81-4fb7-9e7e-0c9e49c58f5a" alt=""><figcaption></figcaption></figure>
* Crearea unui plan nou este inclusă în abonamentul anual și declanșează o taxă unică pentru planul pay-as-you-go (regenerarea este gratuită).

## Sfaturi și bune practici

* Folosiți **Bazat pe zone + Recomandare inteligentă** pe parcele cu variabilitate puternică (imagini/producție/topografie).
* Preferați **Compozit** pentru a reduce costurile de laborator; treceți la **Core** pentru diagnostice detaliate.
* Setați **adâncimea de prelevare** pentru a se potrivi cu protocolul laboratorului și cu nevoile culturii.
* Pentru rânduri drepte, **Linia-schelet** oferă o acoperire curată; pentru benzi și zone înguste, folosiți **W**.
* Când operatorii preferă structura în locul vitezei, mergeți pe **Zonă cu zonă** și definiți o **secvență manuală a zonelor**.
* Reutilizați planurile de prelevare de la un an la altul pentru a înțelege tendințele solului prin locații de prelevare consecvente

## Întrebări frecvente

{% hint style="info" %}

* **Pot copia setările unui plan pe o altă parcelă?** Da, folosiți **Copiați setările** când începeți un plan nou.
* **Respectă Smart Optimal Path limitele zonelor?** Prioritizează cel mai scurt traseu. Folosiți Zonă cu zonă pentru a păstra vizitele grupate pe zone.
* **Cum sunt generate etichetele?** De către șablonul de etichetă selectat (Punct sau Zonă) atunci când alegeți Core vs Composite.
* **Ce este inclus într-o taxă?**
  * Plan Pay-As-You-Go: o singură taxă pentru **un plan** nou. Ajustările și regenerările sunt gratuite.
  * Abonamentul anual: modulul este inclus în preț
    {% endhint %}

## Limitări cunoscute (actuale)

{% hint style="warning" %}

* Formele extrem de neregulate ale parcelei pot necesita ajustare manuală fină a secvenței zonelor.
* Dacă o parcelă nu are zone și alegeți bazat pe zone, vi se va solicita mai întâi să creați o hartă de zone.
  {% endhint %}

## Documentație asociată

* [**Hărți de zone și analize**](/geopard-tutorials/ro/tur-de-produs-aplicatia-web/harti-si-analize-ale-zonelor.md) (crearea zonelor de variabilitate) - Baza pentru prelevarea zonală a solului
* [**Export / Descărcare**](/geopard-tutorials/ro/tur-de-produs-aplicatia-web/export-descarcare.md) (Shapefile, GeoTIFF/GeoJSON)
* [**Jurnalul operațiunilor**](/geopard-tutorials/ro/tur-de-produs-aplicatia-web/jurnal-de-operatiuni-urmareste-erorile-importurile-si-analizele.md) (trasabilitate)
* [**Aplicație mobilă**](/geopard-tutorials/ro/tur-de-produs-aplicatia-mobila/lucru-pe-camp-scoutingul-hartilor-zonelor.md)**: Lucru pe teren**

## Jurnal de modificări

[**Septembrie 2025** — Lansare inițială](/geopard-tutorials/ro/jurnal-de-modificari-si-lansari-de-produs/lansare-web-and-mobile-septembrie-2025-prelevare-automata-a-probelor-de-sol-zone-din-ecuatii-portal.md): planuri multi-parcelă, analiză pe grilă/zone, prelevare Core/Composite, poziționare Smart/N-Z/W/Core-Line, rutare Traseu optim inteligent vs Zonă cu zonă, etichete, Jurnalul activităților, facturare pentru fiecare plan nou.


---

# 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/ro/tur-de-produs-aplicatia-web/prelevarea-probelor-de-sol-planificare-automata.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.