> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/id/versions/2026.md).
# 2026
Catatan rilis untuk build Navixy On-Premise pada 2026. Rincian fitur baru, integrasi perangkat, solusi pihak ketiga, peningkatan platform, dan perbaikan galat.
## 2026.07 (30 Jul 2026)
Build 2026.07 membangun ulang antarmuka Panel Admin Navixy dan Laporan, serta menambahkan fungsionalitas Perintah. Rilis ini juga memperluas IoT Logic, menambahkan integrasi Ford Pro, mencakup perangkat GPS baru, dan perbaikan.
{% hint style="warning" %}
### Sebelum Anda memperbarui
* **Java:** Build mandiri 2026.07 memerlukan Java 25. Pastikan versi Java Anda adalah 25 sebelum menjalankan skrip pembaruan.
* **Cadangan:** Lakukan pencadangan sebelum pembaruan versi Navixy apa pun. Jika Anda melakukan migrasi ke MySQL 8.4, buat dan simpan cadangan terpisah pada setiap tahap utama: sebelum memperbarui Navixy, sebelum memigrasikan MySQL, dan setelah memverifikasi migrasi selesai. Hubungi dukungan Navixy sebelum merencanakan atau melakukan migrasi basis data.
{% endhint %}
### Instalasi dan pembaruan
Perubahan ini memengaruhi cara instans Standalone diinstal dan diperbarui. Untuk prosedur lengkap, lihat [panduan pembaruan](/docs/on-premise/id/on-premise/how-to-guide/installation/update.md).
* Program pembaruan memasang Panel Admin Navixy v3 dan memperbarui konfigurasi server web terkait.
* Instalasi baru mendukung Ubuntu 26.04 LTS selain rilis Ubuntu yang sebelumnya didukung.
* Skrip instalasi Windows Server kini menggunakan MySQL 8.4.10.
### Perintah
Blok baru [**Perintah**](/docs/user/id/guide/devices-and-settings/object-management/commands.md) di halaman pengaturan perangkat memungkinkan Anda menyimpan instruksi sekali dan mengirimkannya sesuai permintaan, alih-alih menyusunnya setiap kali.
Ada dua jenis perintah. Sebuah **perintah perangkat** mengirim string instruksi tingkat protokol langsung ke perangkat keras, misalnya untuk mengirim perintah CAN atau mengaktifkan keluaran. Sebuah **perintah perangkat lunak** mengirim permintaan HTTP POST dengan isi JSON ke URL eksternal. Permintaan dapat menyertakan data perangkat saat ini seperti lokasi, kecepatan, atau ID perangkat. Perintah disimpan per perangkat dan dikirim dengan satu klik dari widget Pelacak perangkat di modul pelacakan.
Perintah juga dapat dibuat, diperbarui, didaftar, dan dijalankan melalui [API Perintah](/docs/navixy-api/user-api/resources/tracking/tracker/commands.md). Untuk pengiriman otomatis berbasis aturan pada beberapa perangkat, gunakan IoT Logic sebagai gantinya.
### Pembaruan IoT Logic
> IoT Logic adalah fitur berlisensi terpisah. Pembaruan ini diterapkan secara otomatis pada instans Standalone yang sudah mengaktifkannya.
[IoT Logic](/docs/user/id/guide/account/iot-logic.md) memproses telemetri masuk melalui aliran yang dapat dikonfigurasi sebelum mencapai platform. Rilis ini memperluasnya ke dua arah: sistem eksternal dapat memasukkan data ke dalam aliran dan aliran dapat mengirim data keluar, serta menambahkan aksi yang menargetkan perangkat selain perangkat yang memicunya.
Apa yang tersedia dalam rilis ini
### Membawa data eksternal masuk
Tab **perangkat lunak** di [simpul Sumber Data](/docs/user/id/guide/account/iot-logic/nodes/data-source-node.md) menyediakan endpoint HTTP yang menerima JSON dari sistem eksternal. Nilai masuk dicocokkan dengan perangkat yang sudah ada di akun Navixy, lalu tersedia bersama telemetri perangkat sendiri selama sisa aliran. Lihat [Menggabungkan data sistem eksternal ke dalam aliran](/docs/iot-logic-api/navixy-iot-guide/merging-external-data-into-a-flow.md).
### Mengirim data keluar
Blok baru [simpul Webhook](/docs/user/id/guide/account/iot-logic/nodes/webhook-node.md) mengirim permintaan HTTP terstruktur dari aliran menggunakan URL, header, dan isi JSON yang dapat dikonfigurasi. Memungkinkan transmisi data yang terfokus ke sistem eksternal alih-alih penerusan data lengkap. Dapat berguna untuk integrasi dan peringatan.
### Bertindak pada perangkat lain
Tab [simpul Aksi](/docs/user/id/guide/account/iot-logic/nodes/action-node.md) memiliki tab baru **Lanjutan** tab yang mencantumkan perangkat tambahan untuk menerima perintah yang sama saat simpul dipicu. Pembacaan dari satu perangkat karena itu dapat bertindak pada perangkat lain, misalnya untuk menyalakan keluaran pada perangkat kedua.
### Pembaruan lain
Rilis ini juga mencakup perubahan berikut:
* Halaman awal dan editor aliran yang didesain ulang, dengan sebuah [Templat aliran](/docs/user/id/guide/account/iot-logic/quick-start-guide/templates.md) galeri templat aliran yang membuat aliran siap pakai dari kartu templat. Mengurangi hambatan awal pembuatan aliran.
* [Fungsi perimeter](/docs/user/id/guide/account/iot-logic/nodes/geofence-functions.md) di simpul logika. `inGeofence()`, `enterGeofence()`, dan `leaveGeofence()` memungkinkan logika aliran bercabang berdasarkan apakah perangkat berada di dalam perimeter, baru saja memasukinya, atau meninggalkannya.
* Dukungan untuk menyertakan perangkat dalam beberapa [aliran yang diaktifkan](/docs/user/id/guide/account/iot-logic/flow-management.md) secara bersamaan, sehingga skenario pemrosesan terpisah tidak lagi harus digabungkan menjadi satu aliran.
* [Simpul](/docs/user/id/guide/account/iot-logic/nodes.md) dialog konfigurasi dipindahkan dari kanvas ke panel samping. Kini aliran tetap terlihat saat Anda mengedit simpul.
* Sebuah [tabel pemetaan perangkat](/docs/user/id/guide/account/iot-logic/flow-management.md#mapping-table) di antarmuka aliran yang memungkinkan pencarian cepat distribusi perangkat antar aliran.
* Tab **Opsi waktu penggunaan** dihapus dari [simpul Inisiasi Atribut](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node.md). `genTime()` dan `srvTime()` tetap tersedia di dalam formula, hanya saja pengenalan otomatis nilai-nilai ini dihapus. Nilai yang sebelumnya dideklarasikan melalui **Opsi waktu penggunaan** dilewati.
* [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md) indikator yang menampilkan atribut untuk perintah dari simpul Aksi perangkat atau simpul Webhook yang dikirim selama pemrosesan aliran. Indikator tersebut mengonfirmasi eksekusi simpul, bukan pengiriman ke tujuan eksternal.
* Aliran default yang terlihat dihapus dari daftar aliran. [Pemrosesan default](/docs/user/id/guide/account/iot-logic/flow-management/default-flow.md) tetap berjalan otomatis untuk perangkat yang tidak disertakan dalam aliran lain.
* Aliran dapat diekspor dan diimpor sebagai file, sehingga konfigurasi dapat dipindahkan antar akun atau disimpan di luar platform.
* Formula divalidasi sebelum aliran disimpan, dan galat dilaporkan di editor.
* Tab `device_label` atribut tersedia dalam aliran, sehingga label perangkat dapat digunakan dalam kondisi dan dalam payload keluar.
* Paket data BLE tersedia untuk aliran dan dapat dibedakan di Penganalisis Data.
Daftar di bawah mencakup integrasi dan perangkat baru, peningkatan platform, dan perbaikan galat.
Terintegrasi
### **Iridium SBD**
Iridium Short Burst Data (transport data satelit) memungkinkan perangkat melapor melalui jaringan satelit Iridium saat tidak ada jangkauan seluler. Navixy kini dapat menerima data pelacakan SBD untuk integrasi Teltonika dan Galileosky yang didukung, dan perintah kontrol keluaran yang didukung dapat menggunakan saluran satelit ketika koneksi terakhir dari perangkat datang melalui SBD. Perangkat pada jaringan satelit diaktifkan secara manual, seperti dijelaskan dalam [Aktifkan perangkat GPS](/docs/user/id/guide/quick-start/activate-gps-device.md).
### Perangkat
| Produsen | Perangkat | Jenis |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Assistant Telematics** | [AVT80](https://navixy.com/devices/assistant-telematics/assistant-telematics-avt80/) | Perangkat GPS kendaraan |
| **Ford** | [Ford Pro](/docs/user/id/guide/quick-start/activate-oem-device.md) | Telematika OEM untuk kendaraan dengan FordPass Connect. Memerlukan umpan data yang disiapkan oleh penyedia layanan, hubungi dukungan Navixy sebelum mengaktifkan. |
| **Xirgo Global** | [LX41](https://navixy.com/en/devices/xirgo-global/xirgo-lx41-mqtt-iotm/), [LX42](https://navixy.com/en/devices/xirgo-global/xirgo-lx42-mqtt-iotm/), [LX43](https://navixy.com/en/devices/xirgo-global/xirgo-lx43-mqtt-iotm/), [LX44](https://navixy.com/en/devices/xirgo-global/xirgo-lx44-mqtt-iotm/), [LX45](https://navixy.com/en/devices/xirgo-global/xirgo-lx45-mqtt-iotm/), [XG37 One](https://navixy.com/en/devices/xirgo-global/xirgo-xg37-one-mqtt-iotm/), [XG37 Light](https://navixy.com/en/devices/xirgo-global/xirgo-xg37-light-mqtt-iotm-2/), [XG37 Light+](https://navixy.com/en/devices/xirgo-global/xirgo-xg37-light-mqtt-iotm/), [XG37 Tacho](https://navixy.com/en/devices/xirgo-global/xirgo-xg37-tacho-mqtt-iotm/), [XG37 XtCAN](https://navixy.com/en/devices/xirgo-global/xirgo-xg37-xtcan-mqtt-iotm/), [XG47 CAN](https://navixy.com/en/devices/xirgo-global/xirgo-xg47-can-mqtt-iotm/), [XG47 RS232](https://navixy.com/en/devices/xirgo-global/xirgo-xg47-rs232-mqtt-iotm/) Profil MQTT/IOTM | Profil perangkat GPS kendaraan dan aset |
| **Inmosat** | Carfindersat | Perangkat GPS satelit |
| **Jimi IoT (Concox)** | JC171 | Perangkat GPS |
| **Megastek** | S921 | Perangkat GPS |
| **Micodus** | [ML300](https://navixy.com/en/devices/micodus/micodus-ml300/) | Perangkat GPS |
| **Navtelecom** | SIGNAL S-4751, SIGNAL S-4753 | Perangkat GPS kendaraan |
| **Qianfeng** | J16 | Perangkat GPS |
| **Queclink** | GV30CAU | Perangkat GPS kendaraan |
| **RAMAC** | AT1L | Perangkat GPS dan LBS, terhubung melalui [NGP](/docs/iot-logic-api/technologies/navixy-generic-protocol.md) |
| **SEEWORLD** | [R16](https://navixy.com/devices/seeworld/seeworld-r16/) | Perangkat GPS kendaraan |
| **Suntech** | [ST390](https://navixy.com/en/devices/suntech/suntech-st390/), ST419, SD8000U, ST4230, ST4280, ST4315B, ST6952, ST8210P, ST9730B | Perangkat GPS |
| **Teltonika** | [ATC700](https://navixy.com/en/devices/teltonika-telematics/teltonika-atc700/), [ATM700](https://navixy.com/en/devices/teltonika-telematics/teltonika-atm700/) | Perangkat GPS aset |
| | [FTC134](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftc134/), [FTM134](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftm134/), FTC164, FTM164, [FTC920](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftc920/), [FTC924](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftc924/), [FTC927](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftc927/), [FTC965](https://navixy.com/en/devices/teltonika-telematics/teltonika-ftc965/) | Perangkat GPS kendaraan |
| **ThinkRace** | [PT400HT](https://navixy.com/en/devices/thinkrace/thinkrace-pt400ht/), [MT4](https://navixy.com/en/devices/thinkrace/thinkrace-mt4/), [TR40](https://navixy.com/en/devices/thinkrace/thinkrace-tr40/) | Perangkat GPS yang dapat dikenakan dan pribadi |
| **ATrack** | [AK300](https://navixy.com/en/devices/atrack/atrack-ak300/) | Perangkat GPS kendaraan |
| **X3Tech** | XT40 | Perangkat GPS |
Peningkatan
* **Peningkatan platform umum**
* Menerapkan ulang [Panel Admin Navixy](/docs/admin/id/overview.md), [Laporan](/docs/user/id/guide/reports.md), serta panduan aktivasi perangkat pada tumpukan frontend Navixy saat ini. Fungsionalitas dan tata letak layar yang ada dipertahankan, sehingga operator tidak perlu mempelajari ulang bagian ini.
* Perangkat yang disembunyikan dan dihapus tidak lagi dihitung dalam kuota perangkat akun.
* Meningkatkan persyaratan kekuatan sandi dan memperluas set karakter khusus yang diterima. Sandi baru kini harus sepanjang 12-20 karakter, menggabungkan huruf besar dan huruf kecil, digit, dan satu karakter khusus. Sandi tidak boleh mengulang satu pun dari 10 sandi terakhir yang digunakan pada akun.\
Sandi yang sudah ada tidak terpengaruh.
* Perangkat kini dapat ditemukan berdasarkan tag di pemilih perangkat, bukan hanya berdasarkan nama, sehingga daftar perangkat panjang dapat dipersempit lebih cepat.
* Daftar tugas layanan tidak lagi dibatasi hingga 1.000 entri. Akun dengan lebih banyak tugas kini dapat melihat, mencetak, dan mengekspor daftar lengkap.
* Menambahkan ekspor CSV perangkat GPS milik pengguna ke kartu detail pengguna di Panel Admin Navixy.
* **Pelacakan dan data**
* Penerjemahan ulang NWS kini mengidentifikasi perangkat berdasarkan ID eksternal alih-alih ID perangkat internal Navixy, sehingga sistem penerima dapat mencocokkan perangkat berdasarkan pengenal Anda sendiri.
* Impor perimeter KML telah dirombak dan kini mengimpor perimeter melingkar, yang sebelumnya tidak dapat dibuat dari berkas KML.
* Menambahkan waktu koneksi terakhir ke ekspor CSV pelacakan.
* Akurasi sensor pengukuran dan sensor agregasi kini menerima nilai desimal seperti 0,25, alih-alih dibulatkan ke satuan bulat.
* Memperbaiki pembacaan muatan baterai untuk perangkat yang melaporkan persentase dan voltase. Ketika perangkat mengirim persentase dan skala pengisian modelnya dinyatakan dalam volt, platform kini mengonversi nilai yang dilaporkan ke skala tersebut alih-alih menampilkan keduanya pada skala yang berbeda. Tingkat baterai dan voltase baterai kini juga ditangani secara terpisah di seluruh protokol perangkat.
* Meningkatkan pemuatan saat mengedit tautan Geo yang berisi banyak perangkat GPS.
* **Laporan dan notifikasi**
* Nama perimeter dan POI kini disembunyikan di alamat laporan perjalanan secara default. Aktifkan **Sertakan POI dalam alamat lokasi** dan **Sertakan perimeter dalam alamat lokasi** di [parameter laporan](/docs/user/id/guide/reports/specific-report-details/trip-report.md) untuk menampilkannya.
* Mengadopsi konvensi penamaan dan format baru untuk berkas DDD takograf.
* Mengonversi nilai dalam notifikasi aturan rentang sensor ke satuan pengukuran akun.
* Penjadwalan dengan pilihan perangkat atau karyawan yang besar kini tersimpan dengan andal, padahal sebelumnya penyimpanan bisa gagal.
* **Perangkat dan protokol**
* Menambahkan decoding alarm getaran untuk perangkat GT06N, sehingga peristiwa getaran dapat memicu aturan peringatan Pengemudian kasar atau laporan kecelakaan.
* Menambahkan identifikasi supir dari pembaca kartu serial eksternal pada perangkat Suntech, sehingga pembaca seperti Jmak JM15 dapat digunakan untuk mengidentifikasi supir.
* Menambahkan input jarak tempuh perangkat keras untuk Jimi VL111.
* Menambahkan data jam mesin untuk Assistant Telematics AVT50.
* Menambahkan pembacaan Pengapian serta status dan kontrol immobilizer untuk Dunasys DCAR S.
* Menambahkan dukungan Pengemudian kasar untuk Gosafe G1C+ dan G1C+ 5W.
* Menambahkan parameter kelembapan dan suhu untuk Megastek MT60Pro.
* Menambahkan pembacaan data sistem manajemen baterai ANT dari kendaraan listrik.
* Memperbarui dukungan SinoTrack ST906 setelah produsen berpindah dari protokol V1 ke V8.
* Memperbaiki skema mode pemantauan untuk model Concox dan Jimi serta klonnya.
* Memperbarui nama produsen dan model Navtelecom agar menggunakan karakter Latin.
* Memisahkan profil aktivasi Jimi JC400, JC400D, dan JC400P untuk firmware yang lebih lama dari 1.6.3 dan firmware 1.6.3 atau yang lebih baru.
* Teltonika FMC150 kini diaktifkan per varian perangkat keras, FMC150-QJIB0 (2 keluaran digital) atau FMC150-QKIB0 (3 keluaran digital), alih-alih satu profil generik, sehingga pengaturan keluaran cocok dengan perangkat.
Perbaikan
* **Keamanan dan kontrol akses**
* Memperbaiki masalah pengguna yang dapat melihat perimeter di luar cakupan akses mereka.
* Memperbaiki email peringatan yang masih terkirim setelah alamat notifikasi dihapus.
* **Perangkat dan protokol**
* Memperbaiki perangkat yang terhubung melalui UDP agar tidak lagi mengirim data.
* Memperbaiki data dari Galileosky 10 yang tidak didekode, serta nilai suhu yang hilang untuk Galileosky 7x.
* Memperbaiki data Globalstar SmartOne yang tidak diproses.
* Memperbaiki data lokasi yang hilang dari Xexun GPS Ankle DDX14.
* Memperbaiki Digital Matter Eco5 Lite yang mengirim heartbeat tanpa data lokasi.
* Memperbaiki penanganan ACK dan `getio` perintah untuk Ruptela Pro5 Lite.
* Memperbaiki perintah konfigurasi otomatis SERVER untuk Jimi VL802 dan perintah mode pelacakan untuk Jointech JT710D.
* Memperbaiki pemetaan input untuk Teltonika [FMC125](https://navixy.com/en/devices/teltonika-telematics/teltonika-fmc125/) dan [FMC225](https://navixy.com/en/devices/teltonika-telematics/teltonika-fmc225/).
* Memperbaiki jumlah input diskret yang tersedia untuk Suntech ST8300V menjadi 5.
* Memperbaiki pembacaan baterai untuk Suntech ST4290 dan pemetaan nilai baterai untuk Jimi JM-LL301, JM-LL302, dan JM-LL303.
* Memperbaiki informasi jaringan seluler yang hilang untuk Suntech ST300.
* Mengembalikan blok informasi Bluetooth untuk Jimi JM-LL301.
* Memperbaiki status input dan output digital yang salah pada Queclink GV305CEU.
* Memperbaiki decoding peristiwa aksesori untuk Queclink GV50CEU dan GV30CEU.
* Memperbaiki titik Jointech JT709A yang salah diklasifikasikan sebagai posisi LBS.
* Memperbaiki pemicu aturan palsu untuk perangkat Arnavi dan Autolink.
* Menghapus jarak tempuh perangkat keras yang tidak presisi dari model Assistant Telematics AVT. Jarak tempuh GPS adalah sumber odometer yang direkomendasikan untuk model ini.
* Memperbaiki kegagalan aktivasi Satsol dan Fleetguide akibat galat sandi.
* Memperbaiki Kontrol keluaran yang mengalamatkan keluaran berdasarkan posisinya di widget alih-alih nomor keluaran sebenarnya.
* Memperbaiki kegagalan penggantian perangkat untuk model yang didukung, dan mengizinkan penggantian perangkat yang baru saja terdaftar.
* **Pelacakan, perimeter, dan aturan peringatan**
* Memperbaiki peristiwa keluar perimeter duplikat yang dihasilkan untuk satu keberangkatan.
* Memperbaiki tautan notifikasi peringatan yang membuka peta yang salah.
* Memperbaiki aturan peringatan Waktu mengemudi palsu yang disebabkan oleh deteksi tempat parkir.
* Memperbaiki odometer yang tidak diperbarui dengan segera.
* Memperbaiki pembacaan sensor level bahan bakar yang valid yang dibuang oleh penyaringan data.
* Memperbaiki panah rentang tanggal yang tidak memindahkan periode terpilih di Pelacakan.
* Memperbaiki peristiwa Riwayat yang hilang saat banyak perangkat GPS dipilih.
* Memperbaiki warna rute yang tidak diperbarui setelah mengubah rentang yang digunakan oleh **Warna berdasarkan kecepatan**.
* Memperbaiki galat yang disebabkan oleh mengeklik parameter yang sudah ditampilkan di widget Pelacak.
* Memperbaiki nilai suhu yang ditampilkan dengan label satuan duplikat.
* **Laporan dan ekspor**
* Memperbaiki titik akhir perjalanan yang dilaporkan di wilayah yang salah.
* Memperbaiki unduhan DDD takograf yang menghasilkan data kendaraan tidak lengkap.
* Memperbaiki unduhan data perangkat yang gagal atau menghasilkan berkas tidak lengkap.
* Memperbaiki halaman pertama laporan perimeter yang tidak ditampilkan, di layar maupun di PDF yang diunduh.
* Memperbaiki urutan tanggal pada bagan jarak tempuh Ikhtisar.
* Memperbaiki bagan Kalibrasi sensor yang terpotong.
* Memperbaiki pekerjaan pemeliharaan yang tidak muncul dengan benar saat diurutkan berdasarkan tanggal pembuatan.
* Memperbaiki durasi tugas dan durasi tinggal negatif yang salah format dalam formulir yang diunduh.
* Memperbaiki kegagalan unduhan gambar massal di Pengelola Berkas.
* Memperbaiki pratinjau peta tautan Geo yang tidak ditampilkan.
* **Akun dan akses**
* Memperbaiki peran subpengguna yang tidak dapat diubah, dan editor Menu yang tidak mencerminkan perubahan yang dibuat pada templat.
* Memperbaiki data pengguna yang tidak diperbarui setelah pengguna dipindahkan antar akun.
* Memperbaiki permintaan panduan pengguna yang dikirim dari antarmuka platform tidak sampai ke penerimanya.
* **Layanan Lapangan**
* Memperbaiki tugas Layanan Lapangan yang tidak dapat diselesaikan atau statusnya diubah.
* Memperbaiki ekspor PDF Layanan Lapangan yang gagal saat browser memblokir pop-up, dan tautan unduhan yang rusak dalam undangan karyawan.
---
# 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://navixy.com/docs/on-premise/id/versions/2026.md?ask=&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.