> For the complete documentation index, see [llms.txt](https://vesta-guide.gitbook.io/vesta-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vesta-guide.gitbook.io/vesta-guide/finnish-fi/vesta-357.md).

# VESTA-357

**VST-892EX-BUS**

## **JOHTOINEN ULKOPUOLINEN PIR-liiketunnistinkamera BUSille**&#x20;

<figure><img src="/files/1c09ba49d86d4caa0dc49ffe6cc3b492956b6a9d" alt=""><figcaption></figcaption></figure>

VST-892EX-BUS on johtoinen ulkokäyttöön tarkoitettu passiivinen infrapuna (PIR) -liiketunnistinkamera. Se pystyy lähettämään johtoisia signaaleja ja kaapattuja kuvia (kuvanlaatu jopa 640 x 480 pikseliä) BUS-väylän kautta ohjauspaneelille liikkeen havaitsemisen yhteydessä.

VST-892EX-BUSissa on yövalaistusmahdollisuus, UV-suojattu kotelo ja se on IPX6-vesitiivis, joten se soveltuu erinomaisesti takapihoille, nurmikoille, porteille sekä ulkoisille käytäville ja käytävätiloihin.

Ulkoinen PIR-kamera on suunniteltu tyypillisellä havaintamatkalla 10 metriä, kun se on asennettu 2,3 metrin korkeudelle maan pinnasta. Se tarjoaa lemmikkisuojausta lemmikeille jopa 60 kiloa ja siinä on kolme valittavaa herkkyystasoa erilaisiin ympäristöihin sopeutumista varten.

Lisäksi VST-892EX-BUS on varustettu digitaalisella läheisyyshavaitsemella. Anti-masking-toiminto mahdollistaa yritysten havaita laitteen sokaiseminen asettamalla esineitä sen näkökenttään.

PIR-liiketunnistinkameran etäkonfigurointi on tuettu. DIP-kytkimen lisäksi käyttäjät voivat myös ottaa käyttöön/poistaa käytöstä kaksoisiskutoiminnon ja lemmikkisuojaamisen sekä säätää PIR-kameran herkkyyttä ohjauspaneelin verkkosivun tai Home Portal Serverin kautta.

## ***Osien tunnistus***

![](/files/15045c0ae74765671b54b7ff44cf66f1953789c3)

1. **Digitaalinen lähestymishavaitseja**

Digitaalista läheisyyshavaitinta käytetään havaitsemaan mahdolliset peittämisyritykset (estot) tunkeilijan toimesta.

2. **LED-osoitin (punainen)**

LED-osoitinta käytetään järjestelmän tilan näyttämiseen.

3. **Salama-LED**

Salama-LED antaa riittävän valon kuvan ottamiseen heikossa valaistuksessa.

4. **IR-anturi**

Anturi on tarkoitettu liikkuvien kohteiden havaitsemiseen.

5. **PIR-kameran objektiivi**
6. **Sisäinen väärinkäsittelyilmaisin**
7. **Testi- ja opetuspainike**

\- Paina painiketta kerran siirtyäksesi testitilaan 10 minuutiksi.

8. **DIP-kytkinlohko**

Toiminnon ja havaitsemisherkkyystasojen asettamiseen on 8 DIP-kytkintä.

9. **Päätteen vastuksen hyppykytkin**

Kun PIR-liiketunnistinkamera on kytketty kauimmaksi BUS-laitteeksi BUS-linjassa, aseta PIR-kameran pääteresistoria hyppyrin avulla ja ensimmäisen BUS-laitteen (yleensä Hybrid-paneelin) hyppy-kytkin ON-asentoon toimimaan päätelävastuksina. Liitetyn BUS-linjan viestintäkyky paranee.

**Hyppy päällä:** Hyppyliitin on asetettu yhdistäen kaksi nastaa.

**Hyppy pois päältä:** Hyppyliitin on poistettu tai “**parkissa**” yhdellä nastalla.

* Jos hyppykytkin on OFF, tiedonsiirtokyky on normaali taso.
* Jos hyppyri on ON, viestintäkyky paranee.

10. **BUS-pääte**
11. **BUS-kaapelointireikä**
12. **Asennusteline**
13. **Koukut**
14. **Kiinnitysreiät**

## ***LED-ilmaisin***

Kun LED-osoitin on käytössä, se syttyy seuraavissa tilanteissa:

* Kun PIR-kamera on vikatilassa (vääriintulkinta- tai jatkuva peittymistila), se väläyttää LEDiä kerran aina kun se lähettää havaitun liikkeen.
* Kun testipainiketta painetaan kerran siirtymistä varten testitilaan, LED välähtää 60 sekuntia osoittaen, että PIR-kamera lämpenee.
* Testitilassa LED välähtää kerran aina kun liike havaitaan.

LED ei välähdä, jos PIR-kamera on normaalitilassa eikä testitilassa.

{% hint style="warning" %}
Huom:

LED-osoitin voidaan ottaa käyttöön asettamalla DIP-kytkin 2 ON-asentoon. Katso lisätietoja **DIP-kytkimen asento -taulukosta** alla.
{% endhint %}

* LED-osoitin voidaan ottaa käyttöön asettamalla DIP-kytkin 2 ON-asentoon. Katso lisätietoja **DIP-kytkimen asento -taulukosta** alla.

## ***Kuvanotto***

Kun hälytysjärjestelmä on kytketty päälle, PIR-kamera ottaa liikkeen havaitsemisesta 1, 3 tai 6 hälytyskuvaa resoluutiolla 640 x 480 tai 320 x 240 (ohjelmoitavissa ohjauspaneelista). Voit myös pyytää PIR-kameraa ottamaan kuvan manuaalisesti ohjauspaneelin kautta. Kaapatut kuvat siirretään ohjauspaneeliin visuaalista hälytysvahvistusta varten.

{% hint style="warning" %}
Huom:

Jos PIR-kamera on asennettu paikkaan, jossa kameran näkökenttä on monimutkainen ympäristö voimakkaine valoineen tai runsaine väreineen, otettujen kuvien tiedostokoko voi olla suuri, mikä saattaa johtaa kuvien katkeamiseen niiden siirron aikana ohjauspaneeliin.
{% endhint %}

## ***Lämmitysjakso***

PIR-kamera lämpenee 60 sekuntia, kun ohjauspaneeli kytkee sen päälle siirtyessään valvottuun tilaan.

## ***Testitila***

* PIR-kamera voidaan asettaa testitilaan 10 minuutiksi painamalla testipainiketta kerran.
* Testitilassa kuvien ottotoiminnot ovat pois käytöstä. LED-osoitin välähtää kerran aina kun liike havaitaan.
* PIR-kamera poistuu automaattisesti testitilasta 10 minuutin jälkeen ja palaa normaaliin tilaan.
* Testitilassa LED-osoitin on oltava käytössä asettamalla DIP-kytkin 2 ON-asentoon, ja kaksoisisku-toiminto on oltava poistettuna asettamalla DIP-kytkin 7 OFF-asentoon, jotta käyttäjät voivat testata havaitsemisalueen.

## ***Kaksoisisku-toiminto***

* PIR-kamerassa on kaksoisnaputus-toiminto. Jos kaksoisnaputus-toiminto on käytössä, PIR-kamera ilmoittaa hälytyksen ohjauspaneelille vain, jos kaksi liikettä havaitaan 10 sekunnin sisällä. Jos kaksoisnaputus-toiminto on pois käytöstä, PIR-kamera ilmoittaa hälytyksen ohjauspaneelille, kun liikettä havaitaan.

## ***DIP-kytkimen asento -taulukosta***

Jokaisen DIP-kytkimen toiminto on lueteltu alla olevassa taulukossa. DIP-kytkin on joko ON tai OFF. Ylin asento tarkoittaa ONia ja alin asento OFFia.

<figure><img src="/files/3ee3fbf27f7fde5c29308b68969f878bf77764d1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Huom:

Muuttamisen jälkeen kytke PIR-kamera uudelleen virtaan, jotta uudet DIP-kytkinasetukset tulevat voimaan.
{% endhint %}

## ***Etäasetus***

* PIR-liiketunnistinkamera tukee kaksoisisku-toiminnon, herkkyyden ja lemmikkisuojauksen etäasetuksia.
* Kun PIR-kamera kytketään päälle, sen kaksoisisku-toiminto määräytyy DIP SW7 -asetuksesta, herkkyys määräytyy DIP SW5 & SW6 -asetuksista ja lemmikkisuojaus DIP SW8 -asetuksesta. Käyttäjät voivat joko säätää DIP-kytkimien asetuksia tai muuttaa kaksoisisku-, herkkyys- ja lemmikkisuojausasetuksia etänä ohjauspaneelin verkkosivulla tai Home Portal Serverissä. Etäasetukset korvaavat DIP-kytkinasetukset.

### **Ohjauspaneelin verkkosivu**:

1. Paneelin paikallisella verkkosivulla siirry Muokkaa laitetta -sivulle ja syötä PIR-kameran asetukset Anturiasetukset-osioon. Napsauta OK vahvistaaksesi.

Katso alla olevaa taulukkoa kokoonpanon yksityiskohtia varten. Esimerkiksi, jos haluat poistaa kaksoisiskun käytöstä ja asettaa herkkyydeksi Matala, voit syöttää 00.

| **IR-määritys** | **Kaksoisisku** | **Herkkyys**                  | **Lemmikkisieto** |
| --------------- | --------------- | ----------------------------- | ----------------- |
| 00              | Ei              | Matala                        | Kyllä             |
| 20              | Ei              | Keskitaso                     | Kyllä             |
| 40              | Ei              | Korkea                        | Kyllä             |
| 60              | Ei              | Lemmikkisuojaus pois käytöstä | Ei                |
| 80              | Kyllä           | Matala                        | Kyllä             |
| A0              | Kyllä           | Keskitaso                     | Kyllä             |
| C0              | Kyllä           | Korkea                        | Kyllä             |
| E0              | Kyllä           | Lemmikkisuojaus pois käytöstä | Ei                |

### **Home Portal -palvelin**:

1. Home Portal Serverissä siirry Laiteasetukset-sivulle, napsauta VST-892EX-laiteriviä ja valitse ”IR Configuration” (IR-konfiguraatio).
2. Valitse alasvetovalikosta Kaksoisisku-toiminto (Ota käyttöön/Poista käytöstä), Herkkyys (Korkea/Keski/Matala) ja Lemmikkisuojaus (Ota käyttöön/Poista käytöstä) ja napsauta Lähetä vahvistaaksesi asetuksen.

## ***Valvontasignaali***

* Asennuksen jälkeen PIR-kamera lähettää automaattisesti valvontasignaaleja ohjauspaneelille satunnaisin välein 20–30 sekunnin aikana.

## ***Manipulointisuoja***

* PIR-kamera on suojattu sisäisellä väärinkäsittelykytkimellä, joka puristuu kasaan kun PIR-kamera kiinnitetään asennustelineeseen. Kun PIR-kamera poistetaan asennustelineestä, väärinkäsittelykytkin aktivoituu ja PIR-kamera lähettää väärinkäsittelyn avausilmoituksen ohjauspaneelille muistuttaakseen käyttäjää tilanteesta.

## ***Anti-masking (peittämisen esto)***

* PIR-kamerassa on digitaalinen lähestymishavaitseja, joka voi havaita yritykset peittää (estää) laite.
* Kun peittämistapahtuma havaitaan ja peittymistila jatkuu 3 minuuttia, VST-892EX-BUS lähettää peittymishälytyksen ohjauspaneelille ilmoittaakseen käyttäjälle peittymistilasta.
* Kun peittäminen/estäminen on poistettu 3 minuutin ajaksi, VST-892EX-BUS lähettää palautusviestin ohjauspaneelille.

## ***Virtalähde***

* Kun VST-892EX-BUS on kytketty suoraan Hybrid-paneeliin, Hybrid-paneeli voi toimittaa 13,5 V virransyötön.

{% hint style="danger" %}
***Varoitus***&#x20;

* PIR-kameran johdotuksen saa suorittaa vain sertifioidut teknikot, joilla on asianmukainen tietämys ja koulutus sähkölaitteista.
* Ennen asennusta tai huoltotöitä varmista, että virtalähde on katkaistu.
  {% endhint %}

## ***Ulkopir-kameran kaapelointi***

* Ennen kuin kytket PIR-kameran järjestelmäväylään, katkaise virta.
* Apuohjelmana kaapeliliitännöissä kunkin BUS-järjestelmämoduulin liittimet on värikoodattu.

<figure><img src="/files/ca1f45b3c4b9fd5d1fabefe9f689ada1d9a0f02d" alt=""><figcaption></figcaption></figure>

* Useita BUS-laitteita voidaan kytkeä sarjaan hybridipaneeliin. Liitetyn BUS-väylän optimaalisen tiedonsiirron varmistamiseksi varmista, että ensimmäisen (yleensä hybridipaneelin) ja kauimpana olevan BUS-laitteen napavastushyppykytkimet on asetettu ON-asentoon toimimaan päätevastuksina. Varmista, että käytössä ovat vain edellä mainitut 2 hyppykytkintä, äläkä aseta ON-asentoon muiden väliin kytkettyjen BUS-laitteiden hyppykytkimiä.

{% hint style="warning" %}
Huom:

Irrotettava BUS-liittimien muotoilu parantaa asennuksen tehokkuutta. Ennen kytkentää voit poistaa liittimet piirilevyltä käytön helpottamiseksi ja liittää ne takaisin kytkennän jälkeen.

Irrottamisen jälkeen, kun asennat liittimen takaisin levylle, varmista, että asennat liittimen samaan suuntaan välttääksesi mahdolliset vaaratilanteet
{% endhint %}

* Virheelliset liitännät aiheuttavat toimintahäiriön tai virheellisen toiminnan. Tarkista johdotukset ja varmista oikeat liitännät ennen virran kytkemistä.

<figure><img src="/files/19ec8fe8ee848e24b4eaf989eb5b7483174cb318" alt=""><figcaption></figcaption></figure>

## ***Aloitus – PIR-kameran opettaminen ohjauspaneeliin***

Noudata alla olevia vaiheita ottaaksesi laitteen Hybrid-paneeliin.

Vaihe 1. Kytke laite paneeliin. Kytke sitten paneeli päälle.

Vaihe 2. Paneelin verkkosivulla napsauta "**Oppiminen**" siirtyäksesi oppimis­sivulle.

Vaihe 3. Napsauta "**Aloita**" siirtyäksesi oppimistilaan.

Vaihe 4. Napsauta "**Lisää**" lisätäksesi laitteen paneeliin.

Vaihe 5. Jos laite on onnistuneesti opittu paneeliin, se näkyy "Opitut laitteet" -osiossa.

### ***Tunnistus***

Toiminto "**Tunnista**" käytetään paikallistamaan tietty BUS-laite langallisessa BUS-järjestelmässä. Tämä toiminto auttaa erottamaan laitteet toisistaan erityisesti laajassa asennuksessa, jossa on useita BUS-laitteita.

Löytääksesi PIR-kameran BUS-järjestelmässä:

**Vaihe 1.** Hybrid-paneelin verkkosivulla napsauta laitelistassa "Tunnista" IR-kameran laiterivin jälkeen.

**Vaihe 2.** Jos PIR-kamera vastaanottaa signaalin Hybrid-paneelilta, verkkosivu näyttää onnistumisilmoituksen ja PIR-kameran LED-osoitin välähtää 10 kertaa osoittaakseen käyttäjälle sijaintinsa.

{% hint style="warning" %}
Huom:

Jos verkkosivulla näkyy aikakatkaisuviesti, se tarkoittaa, että PIR-kamera ei vastaanottanut signaalia paneelilta. Tarkista, onko PIR-kamera kytketty asianmukaisesti paneeliin sopivalla johdotusetäisyydellä.
{% endhint %}

### ***Kävelytesti***

* Varmistaaksesi, että PIR-kamera pystyy kommunikoimaan paneelin kanssa oppimisen jälkeen, aseta ohjauspaneeli Kävelytestitilaan ja paina VST-892EX-BUSin testipainiketta lähettääksesi testisignaalin paneeliin.
* Kun paneeli vastaanottaa testisignaalin, se antaa yhden piippauksen ja näyttää PIR-kameran tiedot vastaavasti laiteluettelon yläosassa.

{% hint style="warning" %}
Huom:

Jos paneelista ei tule vastausta testipainiketta painettaessa, se tarkoittaa, että paneeli ei vastaanottanut testisignaalia laitteelta. Tarkista, onko PIR-kamera kytketty asianmukaisesti paneeliin sopivalla johdotusetäisyydellä.
{% endhint %}

## ***Kiinnitys- ja asennustapa***

* **Asennus kiinnitystelineellä:**
  * PIR-kamera voidaan kiinnittää tasaiselle pinnalle mukana toimitetuilla kiinnitysruuveilla, seinätulppilla ja kiinnitystelineellä.
  * Toimitetussa kiinnitystelineessä on irrotettavia kohtia, joissa muovi on ohuempaa ja jotka voidaan rikkoa asennustarkoituksessa.

<figure><img src="/files/a1d0007a89d7df895c8d5cedf02c6b416624fd51" alt=""><figcaption></figcaption></figure>

* Asentaaksesi VST-892EX-BUSin kiinnitystelineellä:

  1. Käytä kiinnitystelinettä mallina ja poraa 2 reikää seinään seinätulppia varten.
  2. Työnnä seinätulpat paikalleen ja kiinnitä kiinnitysteline seinään ruuveilla.
  3. Koukkusta VST-892EX-BUS kiinnitystelineeseen ja sitten **työnnä alaspäin kunnes kuulet naksahduksen**.

*

```
<figure><img src="/files/e4e5b16503fbe588ba36f75e3726fa0804fdced8" alt=""><figcaption></figcaption></figure>
```

{% hint style="warning" %}
Huom:

Varmista, että PIR-kamera on kunnolla kiinnittynyt kiinnitystelineeseen siten, että sisäinen väärinkäsittelykytkin on täysin painettuna.
{% endhint %}

* **Asennus kiinnitystelineellä ja kääntyvällä pidikkeellä:**

Kääntyvä pidike toimitetaan käyttäjäystävällisenä kiinnitysvalintana **(valinnainen osa, myydään erikseen)**. Se koostuu kiinnitysalustasta, joka kiinnitetään pintaan, ja pyörivästä pallosta, johon kiinnitysteline kiinnitetään kääntyvään pidikkeeseen.

Kääntyvän pidikkeen avulla PIR-kameraa voidaan kiertää vaakasuunnassa optimaalisen peiton saavuttamiseksi.

<figure><img src="/files/5cd6c6e164ebb015f79f5d4e0d1f8a3ef0a9dbb2" alt=""><figcaption></figcaption></figure>

Erityinen ruuvimeisseli, jossa on käännettävä kaksipuolinen kärki, ja kolme tähtikiskoruuvia toimitetaan kääntyvän pidikkeen kiinnitystä varten seinään. Käytä mukana toimitettua ruuvimeisseliä kiristääksesi/avaaksesi tähtikiskoruuvit.

<figure><img src="/files/98d3ba16ac428e7b6fa2fc1b09d8585c68091251" alt=""><figcaption></figcaption></figure>

* Asentaaksesi VST-892EX-BUSin kiinnitystelineellä ja kääntyvällä pidikkeellä:

1. Kiinnitä kääntyvä pidike seinään mukana toimitetuilla ruuveilla.
2. Kiinnitä kiinnitysteline pyörivään palloon kiinnitysruuvilla, joka kulkee läpi turvallisen asennusreijän.
3. Koukkusta VST-892EX-BUS kiinnitystelineeseen ja työnnä alaspäin kunnes kuulet naksahduksen.
4. Kierrä pyörivää palloa vaakasuunnassa säätääksesi VST-892EX-BUSin havaitsevaa kulmaa. (Kun kulman säätöruuvi on puoli löysällä, pyörivää palloa voi silti kääntää.)
5. Kun VST-892EX-BUS on käännetty haluttuun havaintakattavuuteen, voit lukita asennon kiristämällä kulman säätöruuvin tiukasti.

<figure><img src="/files/b9d92c01a4ce814346fb2bdf40a7018ddfc4b358" alt=""><figcaption></figcaption></figure>

* ***Asennussuositukset***

**Suositellaan asentamaan PIR-kamera seuraaviin paikkoihin:**

* Parhaan suorituskyvyn saavuttamiseksi 2,3 metrin korkeudella (mitattuna kameran alareunasta) maanpinnasta
* Kulmassa, jotta näköala olisi laajin
* Paikkaan, jossa tunkeilija normaalisti liikkuisi PIR-kameran näkökentän poikki
* Pinnalle tai kulmaan, jossa eläinten on vaikea päästä käsiksi laitteeseen
* PIR-kameran havaitsemiskantama on 10 metriä, kun se on asennettu 2,3 metrin korkeudelle maanpinnasta.

<figure><img src="/files/5817ce0178c5e6df5f59230170eb78b42bca80f5" alt=""><figcaption></figcaption></figure>

**Rajoitukset:**

* Älä altista PIR-kameraa suoraan kirkkaalle auringonvalolle.
* Vältä suuria esteitä havaitsemisalueella.
* Älä kohdistu lämpölähteisiin kuten tulipaloihin ja kattiloihin suoraan äläkä asenna pattereiden yläpuolelle.
* Älä koskaan yritä purkaa tai muokata laitetta.
* Asenna PIR-kamera suorassa asennossa. Älä kallista sitä.

<figure><img src="/files/48f228d264d86e8d9f7766f883c59d813f2976d9" alt=""><figcaption></figcaption></figure>

* Älä asenna liiketunnistinkameraa paikkaan, jossa esineet liikkuvat tuulen vaikutuksesta, kuten puut ja pyykit, sillä ne voivat peittää kameran näkökentän.

<figure><img src="/files/d561866269049406706f1995c349f6946061e8dd" alt=""><figcaption></figcaption></figure>

* Poista kaikki valoa heijastavat pinnat havaintoalueelta sekä vesilammikot.

<figure><img src="/files/afe34d11a25f569adc96ffe6b138d45e09496770" alt=""><figcaption></figcaption></figure>

* Vältä suuntaamasta kameraa ulkoyksikön ilmansuotimen imu- tai poistoilmavirran tielle.

<figure><img src="/files/b6cd3d9ba52fede679890eba5014d083d8518c2d" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
*TÄRKEÄ HUOMAUTUS*

* Säädä DIP-kytkimiä PIR-kameran asennuspaikan mukaan optimaalisen suorituskyvyn saavuttamiseksi. Jos DIP-kytkinasetukset eivät vastaa asennusympäristöä, PIR-kameran suorituskyky heikkenee ja voi aiheuttaa joko vääriä hälytyksiä tai kyvyttömyyden havaita liikettä.
* PIR-kamera havaitsee eroja liikkuvan kohteen ja taustan välillä. Jos kohde on paikallaan (eli ei liiku), PIR-kamera ei pysty havaitsemaan sitä.
* PIR-kameralla on suuntaava ominaisuus ja se on tehokkaimmillaan havaitsemaan tunkeilijoita, jotka liikkuvat sen havaintakentän poikki. Se on vähemmän herkkä havaitsemaan liikettä suoraan kameran edessä.
* Parhaan suorituskyvyn varmistamiseksi muista säätää liiketunnistinkameran asennuskorkeus suhteessa talon suurimman lemmikin korkeuteen. Pidemmät koirat edellyttävät kameran asentamista korkeammalle lemmikkiystävällisyyden säilyttämiseksi.
* PIR-kameralla on noin 1 metrin pituinen kuolleen kulman alue kameran alapuolella, kun se on asennettu 2,3 metrin korkeuteen. Kuolleen kulman alue suurenee, jos kamera asennetaan yli 2,3 metrin korkeuteen, ja pienenee jos asennus tehdään alemmaksi.
* Ellei toisin vaadita, suositellaan pitää PIR-kameran asennuspaikka noin 2,3 metrin korkeudessa optimaalisen suorituskyvyn saavuttamiseksi. Jos muutat asennuskorkeutta, tee havaintotesti varmistaaksesi, että PIR-kamera pystyy normaalisti havaitsemaan tunkeilijat valitulla korkeudella.
  {% endhint %}


---

# 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://vesta-guide.gitbook.io/vesta-guide/finnish-fi/vesta-357.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.
