> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/tr/veri-analizler/formulas-in-measurement-values.md). # Formüller içinde Ölçüm değerleri Bu Sayfa, GeoDin'in Ölçüm değerlerini nasıl düzenlediğini, nasıl **Hesaplama** işlev, önceden tanımlı ya da tekli Formüller kullanarak bir ölçüm Tablosunu, Tamamen Formül ve Durum söz dizimini, özel durumlu yapılarını ve Ölçüm düzenleyici'nin İçe aktar/ Gönder, diyagram ve Tablo biçimi Seçeneklerini kullanarak yeniden hesaplar. ## Ölçüm değerleri GeoDin, Nesneleri mekânsal olarak düzenler. Bunlar Derinlik Değeri olan ya da olmayan Nokta Nesneleridir. Bu Nesneler Üzerinde ölçümler yapılabilir. Bu tür verileri toplamak için GeoDin Kullanımı gereklidir; Ölçüm noktaları Genel veriler içinde tanımlanmalıdır. Genellikle Filtreler ve Örnek aralıkları Ölçüm noktaları olarak kullanılır. Ayrıca Nesne'nin kendisi de bir Ölçüm noktası olarak tanımlanabilir. GeoDin Nesne yöneticisinde Ölçüm noktaları üç Mavi küreyle gösterilir. GeoDin Demo Projesi Nesne Tüm nesneler Genel Sondaj logu Ölçüm noktası filtreler üst piezometre: (4.3-6.3m) alt piezometre (7.8-8.7m) numuneler BH01: (1-7m) BH01: (4-5 m) ### Terminoloji Aşağıdaki hiyerarşi, tek bir ölçülen değeri ölçüm noktası ait bir Ölçüm nesnesiyle ilişkilendirmek için Ölçüm noktası organizasyonunda kullanılır. Aşağıdaki farklı Tipler vardır: **ölçüm noktası türü** ölçüm noktası türü, bunun ne tipte bir Nesne olduğunu tanımlar. Bunlar bir Düşey bileşenle ya da bileşensiz olabilir. Düşey bileşenli bir Ölçüm noktası örneği bir Sondajdır. Bir Sondaj, Ölçüm noktası'nın kendisi olabilir (örn. tüm Uzunluk numunelendiği yerde) ya da diğer ölçüm noktası türleri onunla ilişkilendirilebilir (Sondajın Uzunluğu boyunca çeşitli aralıklarla alınan ayrık Numuneler). Nokta Numuneleri örnekleri (yani Düşey bir bileşen olmadan) yüzey suyu veya iklim ölçüm istasyonlarıdır. **Veri tipi** Kimyasal incelemeler, her Ölçüm noktası türü için çeşitli Nesneler üzerinde yapılabilir. Bu kombinasyonlar için Veri türleri tanımlanır. Örneğin bir Yeraltı suyu kuyusunda su kalitesi incelenebilir veya akış hızları ölçülebilir. Her durum için bir Veri tipi vardır. Her Veri tipi birkaç Ölçüm noktası türüne atanabilir. Dolayısıyla "Yeraltı suyu bileşimi" Veri tipi, bir Yeraltı suyu Ölçüm noktası için de bir kuyu için de girilebilir. Sonuçlar bir veri tipi tablosunda birleştirilir; ancak her Ölçüm noktası için veriler birbirinden farklıdır. **Kimyasal grup** Bir Veri tipi içindeki tek tek Parametreler sayısı büyük miktarlara ulaşabildiğinden, daha iyi bir toplu bakış sağlamak için Parametreler kimyasal gruplara ayrılır. Her grup, kimyasal Parametreler veya betimleyici özelliklerdeki benzerliklerle ayırt edilir ve en fazla 20 Parametreye sahip olabilir. **Parametre** Bir Parametre, bir Ad, bir alan kimliği ve bir Birim ile tanımlanan bireysel bir ölçümdür **Sorgula** Sorgular, verileri sorgulamak için Projeler veya Veritabanları içinde kullanılır. Bunlar, verinin miktarını ve Veri tipini tanımlar; Sonuçlar bunlardan türetilir. ### Özel değerler GeoDin Ölçüm değerleri sayısal girdiler olarak düzenler. Bu nedenle Saptama limiti altındaki değerler „<" karakteri olarak kaydedilemez. Bu gibi durumlarda negatif bir Saptama limiti girilir (örn. "-1"). Bu değerler istatistiksel analizler tarafından göz ardı edilir. Saptama limiti bilinmiyorsa (örn. eski veriler) "-88" değeri kullanılır. Değer saptanabilir değilse "-99" girilmelidir: | Giriş | Tasvir | | ----- | ------------------------------------------------------------ | | -XX | Saptama limitinin altında (XX = Saptama limiti) | | -88 | Saptama limitinin altında (saptama limiti değeri bilinmiyor) | | -99 | tespit edilemez | ## Formül Ölçüm değerleri'ni ızgara biçiminde sunmaya bir alternatif olarak Mevcut Veri kümesi'ni bir maske içinde görüntüleyebilirsiniz. Maskenin üst kısmında genel Örnek veri (Ad, Tarih, Saat) VE Grup görüntülenir. Altında, Mevcut Veri kümesi için tek tek Parametreler Satırlar halinde listelenir. Her Parametre için Ad, Ölçüm değeri, Birim, Saptama limiti VE Araştırma metodu gösterilir. Ad VE Birim düzenlenebilir değil.\ \ Bir Veri kümesine ait İçerikler, daha sonra yüklenebilecek bir düz metin dosyası olarak kaydedilebilir. Şuraya basarak **Tamam** şaltere basıldığında maskenin içerikleri Veri kümesine kaydedilir - basarak **İptal** İçerikler atılır. İsteğe bağlı olarak Kısa alan adı, Parametre sütunu için kullanılabilir. ## Hesaplama Bu işlev, Ölçüm düzenleyicide tüm tablo için Değerler'i yeniden hesaplamanızı sağlar. İki seçeneğiniz vardır: **-var olan formüller-** 1. Önceden tanımlanmış olanlardan bir veya daha fazla formülü Çalıştırın [Formüller](/geodin-desktop/tr/veri-analizler/formula-basics.md)Sistem yapılandırmasında bulunan veri tipinin. 2. İşaret kutusunu \[yalnızca formülleri etkinleştir] seçerseniz, yalnızca Sistem yapılandırmasında etkin olarak ayarlanmış olan formülleri görürsünüz [Genel Formüller](/geodin-desktop/tr/veri-analizler/formula-basics.md) Sistem yapılandırmasında. Not: Bu formüller, Hesaplama işlevi kullanılırken seçilen veri kayıtları için her zaman çalıştırılır. Bunun nedeni, bir veri kaydının güncellemesi etkin formüllerin hesaplanmasını tetiklemesidir. 3. Formüller, formüllerin Hedef alanı her zaman üzerine yazılacaksa, siyah bir Sembol yerine Kırmızı bir Sembol ile işaretlenir. 4. Formüller, Ad veya Hedef alan gibi gerçek Sütun başlığına tıklanarak sıralanabilir. ***Not:*** *Seçilen formüllerin Çalıştırma sırası, Sistem yapılandırmasının Veri tipi ayarlarında ayarlanmış olanla aynı olacaktır!* \*\*Bu önemlidir, özellikle birbirine bağımlı formüller için. **-Tek bir formülü Çalıştır-** 1. Tek bir formülü Çalıştırmak için önceden tanımlanmış formüllerden birini kullanabilir ve değiştirebilirsiniz [Genel Formüller](/geodin-desktop/tr/veri-analizler/formula-basics.md) Sistem yapılandırması ait ya da yeni bir formül tanımlarsınız. 2. Bir Formül'ü kabul etmek için sadece Ad üzerinde tıklayarak işaretleyin (bu İşlem için kutuyu işaretlemeniz gerekmez) ve şaltere tıklayın **Mevcut işaretli forumlayı kabul et**. Alanlar *"Hedef alan:", "Koşul:"* ve *"Formül:"* otomatik olarak doldurulur ve düzenlenebilir. 3. Alternatif olarak, bu alanları önceden tanımlı bir Formül Hariç, ama yeni bir Formül oluşturarak Düzenle edebilirsiniz; bu Formül Hedef alan şuraya uygulanır. *Hedef alanı üzerine yaz{.underline}* Aşağıdaki Hesaplama için Konfigürasyonu mevcut Değerler 'Üzerine yaz' seçeneğiyle şuraya ayarlayabilirsiniz. Standart olarak Hesaplama mevcut alanların üzerine yazmaz, ancak ilgili Hedef alan için Değerler Hariç olan alanlar için Sonuçlar hesaplar. *\[\[Bütün parametreler Değerler içerir]]{.underline}* Ayrıca, formülün içinde kullanılan alan olan Bütün parametreler hesaplama için Değerler içeriyorsa, yalnızca Hesaplama'yı şuraya Çalıştıracak şekilde belirtebilirsiniz. Bu nedenle, Hesaplama Boş veri alanları için Çalıştırılmayacaktır (İse bunlar formülün içinde kullanılan alan). ***-Hepsi Görünür veri Kayıtlar-*** Burada, hesaplamanın ölçüm verileri düzenleyicisi içinde listelenen Kayıtlar'ın Hepsi için yapılıp yapılmayacağını seçin. ***-Hepsi Seçildi veri Kayıtlar-*** Bu seçeneği, Ölçüm verileri düzenleyicisi içinde Seçildi Kayıtlar (Satırlar) için Hesaplama’yı yalnızca şuraya yönelik olarak Çalıştırmak için seçin. *** ## Referans: Formüller ait tanımı Bir Formül, karakterlere ait bir dize olarak tanımlanır (bir Başlık ayarlama tanımına şuraya benzer) ve bir Sonuç hesaplamak için matematiksel operatörler İçerikler. Örneğin: $DAT.PAR1$ \* 100 $ işaretlerinin içindeki karakterler bir GeoDin Veri alanı ile ilişkilidir. Aşağıdaki operatörler kullanılabilir: (x), GeoDin ait Tablo sütunu anlamına gelir (ör. $DAT:PAR1$) Boşluklar Formüller içinde bulunabilir. Sabit sayı Değerler (yukarıdaki örnekte 100) doğrudan Formül içine girilebilir. ### Durumlara ait Kullanım ***Not:*** *Formül, şaltere tıkladıktan sonra Ölçüm düzenleyici içinde doğrudan girilebilir* *veya Sistem sekmesi Üzerinde Veri türleri-> Veri tipi ayarları->Formüller* ([Genel Formüller](/geodin-desktop/tr/veri-analizler/formula-basics.md)). **Basit Durum için örnekÖrnek:** *Hedef:* WAS:NA\_CALC *Koşul:* $WAS:MG$>3 *Formül:* $WAS:NA$/2 Hedef Parametre NA\_CALC, Parametre MG'ye ait Değeri 3 veya daha yüksek İse Hesaplandı. **Birden fazla Durum için örnekÖrnek:** *Hedef:* WAS:NA\_CALC *Koşul:* $WAS:MG$>3 VE $WAS:CA$<10 *Formül:* $WAS:NA$/2 Hedef Parametre, İkisi birden Parametre MG'ye ait Değeri üçten büyük ve Parametre CA'ya ait Değeri 10'dan küçük İse Hesaplandı. **Değerleri değiştirmek için Durumlar** @O biçimlendirmesi kullanılarak bir veri kaydının son değişiklikten önceki orijinal Değeri Ölçüm düzenleyici içinde yeniden oluşturulabilir. Bu nedenle Farklar için kontrol etmek mümkündür. **Örnek:** *Koşul:* $WAS:PAR1$ - $WAS:PAR1\@O$ >10 Durum, hücre içinde PAR1'e ait Değer önceden girilen Değerin on katından fazlaysa Doğru'dur. **Ek Durum örnekleri** Bir Durum içinde, NULL İşlemci kullanılabilir. Bir Parametrenin bir Değeri olup olmadığını tanımlar. **Örnek:** *Hedef:* WAS:NA\_CALC *Koşul:* $WAS:MG$>3 VE $WAS:CA$=NULL *Formül:* $WAS:NA$/2 Hedef Parametre NA\_CALC, MG Parametresinin Değeri 3'ü aşarsa ve CA Parametresi Boşsa, NA Parametresine ait Değerin yarısı alınarak Hesaplandı. İse, dizeler bir Durum içinde kullanılıyorsa, Metin ters (veya yüksek) tırnak işaretleri içine alınmalıdır. Eksik tırnak işaretleri ve yanlış yazım, eşit olmayan olarak yorumlanır. Durumun yazımı büyük/küçük harfe duyarlıdır. **Örnek:** *Hedef:* WAS:NA\_CALC *Koşul:* $BEARBEIT$='Müller' *Formül:* $WAS:NA$/2 Veri kaydına ait Yazar Adı Müller ise, NA Parametresine ait Değerin yarısı olarak Hesaplandı. ### Özel kurallar kullanılarak Matematiksel işlemcilere ek olarak, GeoDin Tablolarına ait Değerlerin kullanılmasına yönelik özel sözdizimi yapıları, çok sayıda özel durumu dikkate almak için kullanılabilir. **Formül sözdizimi içinde özel durumlarAlgılama Sınırları** Saptama limiti özel bir durum sunar. Bunlar tanım gereği negatif Değerlerdir (örn. <1 için -1). İse bu Değerler Hariç dikkat edilmeden kullanılırsa, Yanlış Sonuçlar üretilebilir; örneğin tek tek Parametreler Şuradan toplamlar oluşturulurken. Bunu yapmak için, $-işaretleri içinde @B(x) biçimine ait bir yapı kullanılmalıdır; burada x, Saptama limiti'nin Hesaplama şuraya girdiği bir Faktördür. Örneğin 5 mg'a ait bir Saptama limiti ( -5 olarak girilmiş) Faktör 0.5 kullanıldığında 2.5 Sonuç verir. **Örnek:** $WAS:BENZEN\@B(0,5)$+$WAS:TOLUEN\@B(0,5)$+$WAS:XYLEN\@B(0,5)$ Yukarıdaki durumda içinde, bireysel Parametreler için -5 VEYA -1 Değerler bulunduğunda, Toplam Hesaplama bu Değerler ait yarısını kullanır. **standart Değerler** Belirli Hesaplamalar için, önceden tanımlanmış Ayarlar veya standartlarla çalışmak şuraya gerekli Mayıs olabilir. Bir Parametre ya mevcut değil ya da bir Veri kümesi içinde analiz edilmemiş değilse, bir Standart Değer varsayılabilir ve Hesaplama için kullanılabilir. Bu, $ işaretleri içinde @g(x) yapısının kullanılmasıyla gerçekleştirilir; burada x, alanda Değer yok olduğunda kullanılan önceden tanımlanmış Varsayılan değerdir. **Örnek:** Değer=$ORGANIC\@g(10)$/$Kil\@g(25) Hesaplandı Değer, bir toprak Örnek içinde organik maddeler VE Kil Şuradan alınan oranlara sahiptir. İse bu alanlarda Hayır Değerler bulunuyorsa standart Değerler kullanılır. **Ortalama değer** Ortalama değer, bir formüle ait dolar Sembollerinin içinde "@M" Semboller kullanılarak Hesaplandı. Bireysel Değerler ";" ile ayrılır ve yalnızca doldurulmuş alanlar kullanılabilir. **Örnek:** UWDRYMIN=$UWDRYMIN1;UWDRYMIN2;UWDRYMIN3\@M$ Sonuç, UWDRYMIN1 şuraya UWDRYMIN3 ait bir Ortalamadır. **Bir Sözlükten bir sayı kullanmak** Bir Kod girerken bir sayı üreten bir Sözlük kullanılıyorsa, bu bir Hesaplama için kullanılabilir. "@R" haneleri kullanılarak bir yeniden kodlama yapılır. **Örnek**: CU=($CONE\@R$)/SQRT($PEN1;PEN2;PEN3;PEN4;PEN5\@M$) Öncelikle CONE için olan Giriş, Sözlük'teki değerle değiştirilir. P1 ile P5 Değerleri için bir Ortalama alınır ve bunun karekökü Hesaplandı. Ardından CONE için olan Değer bu Değer'e bölünür. **Başka bir Veri tipinden Değerler kullanma** Bir Veri tipindeki Değerler, diğer Veri türlerinde Değerler hesaplamada kullanılabilir. Bunu yapmak için, bir Veri tipinin Kodu'nun ardından iki nokta üst üste gelir. Başka bir Veri tipindeki bir veri kaydına olan ilişki Saat ile tanımlanır. Değerleri Karşılaştır için tarih çeşitli sayı farklı biçimlerde kullanılır: | İşlemci | Anlam | | -------------------------- | -------------------------------------------- | | \[=SMPDATE] veya tanım yok | Tarih aynı olmalıdır | | \[<=SMPDATE] | Tarih aynı olabilir veya daha küçük olabilir | | \[\=SMPDATE] | Tarih aynı veya daha büyük olabilir | | \[\$ ***Dikkat:*** *Yalnızca aynı Tabloya ait Parametreler (Veri tipi) veya Nesne tipi Parametreler değerlendirilebilir. Mevcut Tablo Parametresi burada Tablo Kısaltması Hariç belirtilmelidir. Örneğe bakın.* ## Referans: İçe aktar/ Gönder GeoDin Nesne yöneticisi içinde, bir Ölçüm noktası VEYA ölçümlerin ait olduğu bir Grup Üzerinde Seviye Metodlar **"Gönder Ölçüm değerleri"** ve ![import measurement values](/files/6e72941168bec320369c5a206777f09d92049254) **"İçe aktar Ölçüm değerleri"** seçilebilir. Bu Yöntem başlatıldığında, tüm İçe aktar VEYA Gönder Ayarlar yapılabildiği bir iletişim kutusu görünür: [İçe aktar](/geodin-desktop/tr/veri-ice-aktarma/import.md) [Gönder](/geodin-desktop/tr/veri-disa-aktarma/export.md) ### Şemalar ve analizler İse onay kutusu *\[Şemalar ve analizler]* Etkin ise, Mevcut veri havuzu için Ek bilgi veri giriş gridi altında gösterilir. **Sütun çizelgesi** Mevcut sütunun Değerler, gösterilen Veri kümesi sırasına göre Grafiksel olarak temsil edilir ve veri giriş gridinde görüntülenir. Çizelgede belirli bir Parametreyi temsil etmek için (çizelgeyi Doldurmak için) uygun Sütundan bir Veri kümesi seçilmelidir (ör. CHLORIDE sütununun bir veri kaydı). Mevcut veri kaydı, çizelgede doldurulmuş bir Dikdörtgen olarak gösterilir. Dikdörtgene (doldurulmuş veya doldurulmamış) tıklanarak, veri giriş gridi içindeki veri kaydına gitmek mümkündür. **Satır çizelgesi** Mevcut satırın (veri kaydı) değerlerinin, Sütunlar'ın veri giriş gridinde görüntülendiği sıraya göre grafiksel gösterimi. veri giriş gridindeki Sütun'a gitmek için satır çizelgesinde istenen Parametre'nin çubuğuna tıklayın. **Güvenilirlik kontrolü** Bu sekme, şu anda kontrol edilen satırın Olasılık Analizler'ini gösterir. Bir [Olasılık](/geodin-desktop/tr/veri-analizler/data-checks-and-validations.md) içinde tanımlanabilir **Özellikler**. **Formüller** Son yürütülen formüller, yeni bir Veri kümesi kaydedildiğinde görüntülenecektir. Bu [Genel Formüller](/geodin-desktop/tr/veri-analizler/formula-basics.md) doğrudan Yöntem içinde tanımlanabilir **"Ölçüm verileri"** veya içinde **Özellikler**. **Karşılaştırmayı listele** Seçilen Mevcut veri kaydının Karşılaştırmayı listele işlemi gerçekleştirilecek ve Sonuç görüntülenecektir. Bu **Grup listele** içinde oluşturulabilir ve yönetilebilir **Özellikler**. **İyon dengesi** Mevcut veri kaydı için iyon dengesi görüntülenecektir. Bu [İyon dengesi](/geodin-desktop/tr/veri-analizler/geotechnical-analyses.md) DVWK 1992 önerilerine göre hesaplanır ve değerlendirilir. ### Format seçenekleri GeoDin, içe aktarılacak sekmeli veriler için iki genel düzeni destekler. Biçim **-Satıra göre tablola-** Her Örneği bir Satır içinde İçerikler; Parametreler ait Değerler, her Parametre için ayrı Sütunlar içinde saklanır. ``` AD TARİH NA MG NH3 ... Örnek 1 12.07.2012 2,4 4,5 1,23 ... ... ... ... ... ... ... ``` Biçim **-Sütuna göre tablola-** Bir Tabloyu açıklar; burada bir Parametre ait tek bir ölçüm bir Satır oluşturur. Bir Örnek, bu biçimde belirli sayıda Satırdan (ölçülen Parametreler kadar) oluşabilir. Bu biçim ayrıca her ölçülen Parametre için ek olarak Bilgi GeoDin'e de İçe aktarılmasına ve düzenlenmesine olanak tanır. ``` ÖRNEK TARİH PARAMETRE DEĞER YORUM Örnek 1 12.07.2012 NA 2,4 doğrulandı Örnek 1 12.07.2012 MG 4,5 doğrulanmadı Örnek 1 12.08.2012 NA 9,5 mantıksız ... ... ... ... ... ``` Bu Tip Tablo Şuradan Veri alanları İçe aktarmak için önce ek ayarlamalar yapmanız gerekir. Üzerinde birinci olarak, bir Örnek ait veri Kayıtlarını Gruplayan Sütunları Seçin. Bu nedenle, ait Liste içindeki uygun Sütunları işaretleyin **"Gruplama veri alanları"**; yukarıdaki örnekte ÖRNEK VE TARİH Sütunlarını işaretleyin. Bu Seçim ait Sonuç, birinci iki Satırın (12.07.2012 Şuradan Örnek 1) tek bir kümülatif İçe aktar Satırı oluşturması ve üçüncü Satırın (12.08.2012 Şuradan Örnek 2) başka bir Satır oluşturması olurdu. Açılır Liste Şuradan Seçin "**Parametre adıyla Veri alanı:"** parametre adını veya kimliği içeren sütun; yukarıdaki örnekte PARAM. Açılır listeden "**Ölçüm değeriyle Veri alanı:"** lütfen parametrenin değerini içeren sütunu seçin; yukarıdaki örnekte DEĞER. GeoDin şimdi içe aktarma tablosunu tablo biçimine -satırlara göre tablo- dönüştürecek (lütfen yukarıya bakın). Örnek verilerimizin içe aktarma önizlemesi şimdi aşağıdaki gibi görüntülenecektir: ``` NUMUNE TARİHİ NA MG ... Örnek 1 12.07.2012 2,4 4,5 ... Örnek 1 12.08.2012 9,5 ... ... ... ... ... ... ... ``` Lütfen Yorum sütunundaki bilginin kaybolmadığını unutmayın. İçe aktarma önizlemesinde ölçüm değerlerinin hücreleri sağ üst köşede kırmızı üçgenle etiketlenir. Ölçüm değeri için ek bilgiyi görüntülemek üzere lütfen fare İmlecini bu köşenin üzerinde tutun. NA=2,4 hücresi için 'Yorum:verified' bilgisi gösterilecektir. Bu bilgi şu kullanılarak içe aktarılabilir: [Ek ölçüm bilgileri](/geodin-desktop/tr/calisma-alani-ve-veri-yonetimi/working-with-measurement-data.md). Octoware formatı içinde Metin Veriler için ayrıca özel bir ön biçimlendirme Mevcut. Bu format için başka ayarlama gerekli değildir. Bir Octoware dosyasına ait örnek parça: ``` OCT>12072240RE0003\10.08.2000 09:10\\\\\\\\\T2000-07949\\\\\\\1\1 EST>FI1 PPA>pH 0\\\\\7.24 PPA>LF 0\\\\\998 PPA>Temp 0\\\\\11.1 ``` ## İlgili konular * Paylaşılan ölçüm/veri türü referans içeriği artık Ölçüm verileri düzenleyicisi referansında bulunuyor ([Ölçüm verileriyle çalışma](/geodin-desktop/tr/calisma-alani-ve-veri-yonetimi/working-with-measurement-data.md)) --- # 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.geodin.com/geodin-desktop/tr/veri-analizler/formulas-in-measurement-values.md?ask=&goal= ``` `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.