> 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/svn/predstavitev-izdelka-spletna-aplikacija/vzorcenje-tal-avtomatizirano-nacrtovanje.md).

# Vzorčenje tal - avtomatizirano načrtovanje

Načrte vzorčenja tal pripravite v nekaj minutah za eno ali več polj. Izberite mrežo ali cone, izberite osnovni ali sestavljeni vzorec, prepustite pametnim algoritmom razporeditev točk in načrtovanje poti, natisnite laboratorijske etikete, izvozite in na teren.

## 1-minutna dinamična vadnica

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

## Komu je namenjeno

Kmetom, agronomom, talnim laboratorijem, trgovcem na drobno in prodajalcem, ki potrebujejo dosledne delovne tokove vzorčenja v velikem obsegu (od nekaj polj do celotnih kmetij ali pridelovalcev).

## Primeri načrtov vzorčenja tal

<div align="center" data-full-width="false"><figure><img src="https://29491374-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>Vzorčenje tal v mobilni aplikaciji. Zbirajte vzorce, označujte točke</p></figcaption></figure> <figure><img src="https://29491374-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>Conično vzorčenje tal, možnost po conah. Na naslednjo cono pojdite šele po končanju prejšnje.</p></figcaption></figure> <figure><img src="https://29491374-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>Conično vzorčenje tal, možnost po conah, npr. 2. Na naslednjo cono pojdite šele po končanju prejšnje.</p></figcaption></figure> <figure><img src="https://29491374-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>Conično vzorčenje tal, možnost pametne optimalne poti. GeoPard umešča točke po več najboljših praksah, vključno z optimalno potjo, razporeditvijo točk in varovalnimi pasovi</p></figcaption></figure></div>

## Funkcije in nastavitve

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Vzorčenje po conah ali mreži</strong> vrst vzorčenja tipa Core in Composite</td><td></td></tr><tr><td><strong>Načrtovanje za več polj</strong>: ustvarite načrte za eno ali več polj v enem zagonu.</td><td></td></tr><tr><td><strong>Logike umeščanja točk, podprte z umetno inteligenco</strong>:</td><td><ul><li><em>Pametna priporočila</em> (prilagodljivo obliki in spremenljivosti cone)</li><li><em>Osrednja linija</em> (osnova con/poligonov)</li><li><em>N/Z</em> (4 točke na cono, cik-cak)</li><li><em>W</em> (5 točk na cono, vzorec W)</li></ul></td></tr><tr><td><strong>Možnosti usmerjanja in umestitev točk</strong>:</td><td><ul><li><em>Pametna optimalna pot</em> (skupno najhitrejša)</li><li><em>Po conah.</em> Na naslednjo cono pojdite šele po končanju prejšnje.</li></ul></td></tr><tr><td><strong>Konfiguracija načrta vzorčenja</strong></td><td><ul><li>Število točk na cono / mrežno celico</li><li>Velikost mrežne celice</li><li>Kot rotacije mreže</li><li>Tip agrokemijske analize tal ali analize rastlin</li><li>Globina vzorca</li></ul></td></tr><tr><td><p>Po želji nastavite:</p><ul><li><strong>Začetek in konec</strong> Točke</li><li><strong>Zaporedje con</strong> rišite ročno</li></ul></td><td></td></tr><tr><td><p><strong>Tiskanje etiket</strong> za laboratorij in vzorčevalce:</p><ul><li>Določite logiko, kaj naj bo navedeno na talni sondi</li><li>Prenesite in natisnite PDF z etiketami</li><li>Tiskanje iz spleta ali mobilne aplikacije</li></ul></td><td></td></tr><tr><td>Izvoz načrta vzorčenja:</td><td><ul><li>KML (cone, pot in točke)</li><li>Shapefile (kmalu na voljo)</li></ul></td></tr><tr><td>Izvajanje na polju z mobilno aplikacijo GeoPard</td><td><ul><li>Uporabite <a href="https://docs.geopard.tech/geopard-tutorials/product-tour-mobile-app/installation"><strong>mobilno aplikacijo GeoPard</strong> </a>za ogled načrtov na polju, dodajanje opomb in označevanje napredka.</li><li>Brez povezave</li><li>Navigacija / sledenje smeri gibanja (kot Google Maps)</li></ul></td></tr></tbody></table>

## Delovni potek

### 1. Začnite nov načrt

Odprite **Načrti vzorčenja** v levem meniju ali odprite v novem zavihku brskalnika <https://app.geopard.tech/#/sampling-plans>.

<figure><img src="https://29491374-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>Modul načrta vzorčenja, kako začeti</p></figcaption></figure>

Izberite eno ali več polj. Po želji kopirajte nastavitve iz obstoječega načrta (za dosleden trend tal skozi leta).

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

### 2. Izberite vrsto analize: mreža ali cone, Core ali Composite

* **Na osnovi mreže**: razdeli polje na enake celice; najboljše za izhodiščno analizo ali kadar je zgodovinskih podatkov malo.
* **Na osnovi con**: za usmerjanje vzorčenja uporablja upravljavske cone (posnetki, pridelek, tla itd.), kjer je spremenljivost najpomembnejša.

<figure><img src="https://29491374-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>Izberite tip načrta vzorčenja na osnovi mreže ali con</p></figcaption></figure>

<figure><img src="https://29491374-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>Izberite tip načrta vzorčenja na osnovi mreže ali con</p></figcaption></figure>

* **Sestavljeni**: združi več jedrnih vzorcev v en sam vzorec na cono ali mrežno celico → stroškovno učinkovito.
* **Jedrni vzorec**: posamezni jedrni vzorci na vsaki ustvarjeni točki → najvišja prostorska ločljivost (več laboratorijskih vzorcev).

### 3. Konfigurirajte logiko umeščanja točk in poti (na osnovi con)

Med možnostmi:

* **Pametna priporočila**: prilagodljiv algoritem uravnava pokritost in napor vožnje.
* **Osrednja linija**: umešča točke vzdolž vzporednih linij (odlično za opremo za ravne prehode).
* **N/Z** vzorci (4 točke) in **W** (5 točk) vzorec: klasični agronomski vzorci za gradient in ozke pasove.
* Nastavite **št. točk na cono** in **globino vzorca**.
* **Globina vzorca**: nastavite globino vzorcev tal.
* **Tip agrokemijske analize**: prilagodite glede na vrsto talnega testa, ki ga potrebujete.

<figure><img src="https://29491374-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>Logika umeščanja točk in poti pri vzorčenju tal</p></figcaption></figure>

<figure><img src="https://29491374-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>Nastavite število točk na cono</p></figcaption></figure>

<figure><img src="https://29491374-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>Izberite tip agrokemijske analize</p></figcaption></figure>

### 4. Nastavite možnosti usmerjanja in poti

* **Pametna optimalna pot**: ena učinkovita pot čez polje (lahko prečka cone).
  * Odlično je za avtomatizirane vzorčevalnike tal (kot [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), itd.)
* **Po conah**: na naslednjo cono pojdite po končanem vzorčenju v trenutni coni.
  * Zelo primerno za ročne vzorčevalce
* Po želji narišite **poljubno zaporedje con** za določitev vrstnega reda vožnje.

### 5. Etikete za laboratorij in tiskanje **(6×6 cm, 5×7 cm, 10×10 cm, A4)**

* *Tip jedrnega vzorčenja*: nalepke se ustvarijo za **točke**.
* *Načrt sestavljenega vzorčenja*: nalepke se ustvarijo za **cone**.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Naslovna slika</th></tr></thead><tbody><tr><td>Pri sestavljenem vzorčenju predloga oznake cone nastavi imena con, ki se nato uporabijo za tiskanje etiket za vsako cono.</td><td><a href="https://29491374-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>Pri jedrnem vzorčenju predloga oznake točke nastavi imena točk, ki se nato uporabijo za tiskanje etiket za vsako točko.</td><td><a href="https://29491374-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. Ustvari in preglej

* Kliknite **Ustvari načrt**. Preglejte točke, pot in zaporedje con na zemljevidu.

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

### 7. Prilagodite načrt (izberite cone, začetne/končne točke, premaknite, izbrišite točke, zaporedje con)

Prilagodite nastavitve in **ponovno ustvarite** po potrebi (brez dodatnega stroška):

* **Izberite zemljevid con za vsako izbrano polje:** Privzeto GeoPard samodejno izbere najnovejši zemljevid con ali ustvari mrežo glede na izbrane parametre.

<figure><img src="https://29491374-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>Izberite cone glede na to, na kateri strani vzorčenja je ustvarjen</p></figcaption></figure>

* Uredite začetne/končne točke. GeoPard samodejno preračuna optimalno pot

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

* Premaknite ali izbrišite točke

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

### 8. Izvozi (za vzorčenje v programski opremi tretjih ponudnikov)

* **Poti, točke in poligoni v eni datoteki**: izvozite kot KML za navigacijske aplikacije.
* **Točke/Poligoni**: po potrebi izvozite kot Shapefile/GeoJSON (kmalu na voljo).

<figure><img src="https://29491374-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>Izvozite cone vzorčenja tal, pot in točke kot KML</p></figcaption></figure>

#### Primeri izvoza KML (cone, meja, točke in pot) - vse v eni datoteki KML

<div><figure><img src="https://29491374-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>Primer izvoza KML za vzorčenje 1</p></figcaption></figure> <figure><img src="https://29491374-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>Primer izvoza KML za vzorčenje 2</p></figcaption></figure></div>

### 9. Izvajanje na polju z mobilno aplikacijo GeoPard

Uporabite [**mobilno aplikacijo GeoPard** ](/geopard-tutorials/svn/predstavitev-izdelka-mobilna-aplikacija/namestite-mobilno-aplikacijo-geopard.md)za ogled načrtov na polju, dodajanje opomb in označevanje napredka.

* Način navigacije (podobno kot Google Maps)
* Brez povezave
* Tiskajte etikete iz mobilne aplikacije
* Označite točke kot izvedene

<figure><img src="https://29491374-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>Zbiranje vzorcev tal z mobilno aplikacijo GeoPard</p></figcaption></figure>

### 9. Povežite laboratorijske rezultate nazaj s pravim poljem

Ko laboratorij pošlje rezultate nazaj, jih lahko GeoPard na več načinov poveže s pravilnim poljem in potekom vzorčenja:

1. **ID načrta vzorčenja**\
   Vsak načrt vzorčenja ima edinstven ID. Uporabite ga pri uvozu laboratorijskih rezultatov za najbolj zanesljivo ujemanje.
2. **Koordinate točke (`Dolg` / `Šir`)**\
   GeoPard prostorsko poveže točke, ko ležijo znotraj meje polja.
3. **Geometrija WKT**\
   GeoPard lahko tudi poveže en stolpec geometrije WKT z mejo polja.
4. **Ime polja / ID polja**\
   GeoPard primerja vrednost s poljem `TagString`. Filtriranje oznak je neobvezno.\
   `ID polja` je UUID polja v GeoPardu.

To pomaga laboratorijem, agronomom in prodajalcem ohraniti uvoze čiste ter se izogniti ročnemu premapiranju.

## Obračunavanje in sledenje

* Vse aktivnosti vzorčenja se prikažejo v **Dnevniku aktivnosti**, kar zagotavlja popolno sledljivost.

  <figure><img src="https://29491374-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>
* Ustvarjanje novega načrta je vključeno v letno naročnino in sproži enkratni strošek pri načrtu po uporabi (ponovna ustvaritev je brezplačna).

## Nasveti in dobre prakse

* Uporabite **Na osnovi con + pametna priporočila** na poljih z močno spremenljivostjo (posnetki/pridelek/topografija).
* Dajte prednost **Sestavljeni** za zmanjšanje stroškov laboratorija; preklopite na **Jedrni vzorec** za podrobno diagnostiko.
* Nastavite **globino vzorca** da se ujema z laboratorijskim protokolom in potrebami posevka.
* Za ravne vrste, **Osrednja linija** zagotavlja čisto pokritost; za pasove in ozke cone uporabite **W**.
* Kadar upravljavci dajejo prednost strukturi pred hitrostjo, izberite **Po conah** in določite **ročno zaporedje con**.
* Ponovno uporabite načrte vzorčenja skozi leta, da razumete trende tal prek doslednih lokacij vzorčenja

## Pogosta vprašanja

{% hint style="info" %}

* **Ali lahko kopiram nastavitve načrta na drugo polje?** Da, uporabite **Kopiraj nastavitve** pri začetku novega načrta.
* **Ali pametna optimalna pot upošteva meje con?** Prednost da najkrajši vožnji. Uporabite način po conah, da ostanejo obiski združeni po conah.
* **Kako se ustvarjajo etikete?** Glede na izbrano predlogo etiket (točka ali cona), ko izberete Core ali Composite.
* **Kaj je vključeno v strošek?**
  * Načrt po uporabi: enkratni strošek za **nov** načrt. Prilagoditve in ponovna ustvarjanja so brezplačna.
  * Letna naročnina: modul je vključen v ceno
    {% endhint %}

## Znane omejitve (trenutne)

{% hint style="warning" %}

* Izjemno nepravilne oblike polj lahko zahtevajo ročno natančno prilagajanje zaporedja con.
* Če polje nima con in izberete način na osnovi con, boste pozvani, da najprej ustvarite zemljevid con.
  {% endhint %}

## Povezana dokumentacija

* [**Zemljevidi con in analitika**](/geopard-tutorials/svn/predstavitev-izdelka-spletna-aplikacija/karte-con-in-analitika.md) (ustvarjanje con spremenljivosti) - osnova za vzorčenje tal po conah
* [**Izvoz / prenos**](/geopard-tutorials/svn/predstavitev-izdelka-spletna-aplikacija/izvoz-prenos.md) (Shapefile, GeoTIFF/GeoJSON)
* [**Dnevnik operacij**](/geopard-tutorials/svn/predstavitev-izdelka-spletna-aplikacija/dnevnik-operacij-sledenje-napakam-uvozom-in-analitiki.md) (sledljivost)
* [**Mobilna aplikacija**](/geopard-tutorials/svn/predstavitev-izdelka-mobilna-aplikacija/delo-na-polju-ogled-kart-con.md)**: delo na polju**

## Dnevnik sprememb

[**september 2025** — začetna izdaja](/geopard-tutorials/svn/dnevnik-sprememb-in-izdaje-izdelkov/izdaja-za-splet-in-mobilne-naprave-september-2025-avtomatizirano-vzorcenje-tal-cone-iz-enacb-portal.md): načrti za več polj, analiza mreže/con, vzorčenje Core/Composite, umeščanje Smart/N‑Z/W/Core‑Line, usmerjanje po Smart Optimal Path ali po conah, etikete, dnevnik aktivnosti, obračunavanje za vsak nov načrt.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/svn/predstavitev-izdelka-spletna-aplikacija/vzorcenje-tal-avtomatizirano-nacrtovanje.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.