> 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/ar/jwlh-almntj-ttbyq-alwyb/import-precision-agriculture-data.md).

# استيراد بيانات الزراعة الدقيقة

تنسيقات الملفات المدعومة لاستيراد بيانات الزراعة الدقيقة.

{% hint style="success" %}
ارفع ملفات حقولك وشاهدها على الخريطة: [ابدأ مجانًا](https://app.geopard.tech/auth/sign-up?utm_source=docs\&utm_medium=cta\&utm_campaign=import-precision-agriculture-data)
{% endhint %}

**تنسيقات استيراد البيانات**

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Shapefiles (نقاط أو مضلعات)

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)GeoJSON (عبر API)

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)[SoilOptix](https://geopard.tech/blog/tpost/brrck2udr1-soiloptix-data-analysis-in-precision-agr) أجهزة مسح التربة

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)[TopSoilMapper/GeoProspectors](https://geopard.tech/blog/tpost/agte3p8ec1-analyze-geoprospectors-topsoilmapper-dat) أجهزة مسح التربة

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)بيانات الغلة بتنسيق SHP

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)بيانات الغلة بتنسيق ISOXML

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)بيانات التربة بتنسيق SHP

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)بيانات العمليات المنفذة وبيانات الزراعة بتنسيق SHP

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)Precision Planting (ملفات البيانات) – ملفات 20/20

<img src="https://lh5.googleusercontent.com/u7q3Q1k7efVChCpNozBAAymWkbRmKPfAUTxmWEcioDQ-_S2C0cYgLs2YX5dSy9WwbIY4u0utOzs04-lu3bB1TJHHwAMztBijQNrh_0bNd1PjZsOMLdUxUBXFK4X9rPCkIfwRhkzX" alt="" data-size="line">Ag Leader (`agdata` ملفات) – قريبًا. أرسل إلينا البيانات وسنحوّلها.

![](https://lh5.googleusercontent.com/Yh-lc95H9SW_soTBpZGLA4p7FWU-vZheoW6MX7aaSyFcwm2h2StzqQiQSWOw9AqRzmj4I2-XtHcxYYvwUM7bOQv6qqxV5dIX3XHTOyc9sLdfBsaR-DteaZL4AFz9ixGzKxTAPPzI)مجلدات CNH cn1

### **استيراد حدود الحقول** <a href="#field-boundary-import" id="field-boundary-import"></a>

إذا كان لديك ملف Shapefile لحقل أو حقولك، فيمكنك رفعه من خلال **استيراد البيانات**. انتقل إلى علامة التبويب **رفع الملفات** .

يرجى مراعاة القيود التالية:

* لا تُدعم إلا ملفات الأشكال بنظام WGS84 (EPSG:4326)
* الحد الأقصى لحجم الملف هو 5MB
* الحد الأقصى لمساحة الحقل هو 1236ac/500ha
* يُعامل كل ملف شكل على أنه حقل واحد
* تُنشأ التسميات من ملف .dbf

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FgKjte01bGaesKV0p5CLJ%2Fimage.png?alt=media&amp;token=05497575-83a6-4fdb-b82d-cc760e4c5cc3" alt=""><figcaption></figcaption></figure>

1. حدد المزرعة التي تريد رفع الملفات إليها.
2. انقر على **استعراض** زر، ثم اختر ملفًا من جهاز الكمبيوتر.
3. انقر على زر **تحميل** . بعد ذلك، سيتحقق التطبيق من استيفاء الملف للمتطلبات ويحفظ الحقل.

<figure><img src="https://lh6.googleusercontent.com/KRj9zcB08BXcSfaY4DV3jdMVxbVQNEcJVvEMIwLIb1ytnjEoZ35qxhHFso_NLWM_hohe7PQ3EedeYqvFJFEBZeb9pg98H_-DNCyvOZ9c17EakhGxGThO1dqgr8QAllzi0HCVYK0v" alt=""><figcaption></figcaption></figure>

\
انتظر ظهور مربع حوار التأكيد للتأكد من تحميل الحدود بنجاح:

<figure><img src="https://lh3.googleusercontent.com/nlGv5apThqj41M-5fW0GUe2Nntju-RKcuAaGH-UwwzxoeIHRoCoghIcBPq-HtkTgrQOIUAGtayx13Qt8Vh-sGLmkpm2d7PQLpZxUeRXKP2iAaRYEeQbAGyXfIgqYhgtfKaXaFfx_" alt=""><figcaption></figcaption></figure>

### **استيراد بيانات التربة** <a href="#soil-data-import" id="soil-data-import"></a>

يُعد التحليل الكيميائي للتربة من أهم طبقات البيانات في إنتاج المحاصيل. وعادةً ما تأتي معلومات التربة من مختبرات زراعية كيميائية تحلل عينات تربة الحقول المجمّعة وفق منهجية شبكية أو مناطقية. وقد يتراوح عدد خصائص التربة في الملف الواحد بين 5 و10 من المغذيات الكبرى، مثل النيتروجين (N) والفوسفور (P) والبوتاسيوم (K) وسعة التبادل الكاتيوني (CEC) ومحتوى المادة العضوية في التربة (OM)، وبين 40 و50 خاصية عند تضمين جميع خصائص المغذيات الصغرى.

يمكنك رفع ملفات أخذ عينات التربة إلى GeoPard Agriculture والحصول على خريطة حرارية سهلة القراءة لكل سمة في الملف. كما يمكنك إنشاء مناطق إدارة استنادًا إلى أي سمة، ومقارنتها بطبقات أخرى مثل إنتاجية المحاصيل التاريخية، وإعداد توصيات التسميد بمعدلات متغيرة.

يمكنك رفع مجموعات بيانات التربة عبر خيار القائمة **استيراد البيانات** حدد **رفع الملفات**.

يرجى مراعاة القيود التالية:

* لا تُدعم إلا ملفات الأشكال (Shapefile) بنظام WGS84 ‏(EPSG:4326)، على أن تكون البيانات قائمة على نقاط أو مضلعات.
* يجب أن تكون السمات من النوع الرقمي (عدد صحيح أو حقيقي، وليس سلسلة نصية).
* الحد الأقصى لحجم الملف هو 100MB.
* حاول تجنب استخدام الرموز الخاصة مثل %+@ في عناوين السمات.
* الحد الأقصى لعدد السمات هو 20.
* يُعامل كل ملف شكل على أنه مجموعة بيانات واحدة (الملفان ‎\*.shp و‎\*.dbf إلزاميان).<br>

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FU2xqTtxLaLtoUanaOZwv%2Fimage.png?alt=media&amp;token=8fd54f33-3124-4165-829c-33a4c577fb7f" alt=""><figcaption></figcaption></figure>

1. يمكنك سحب مجموعة بيانات تربة واحدة أو عدة مجموعات وإفلاتها في اللوحة، أو النقر على زر **استعراض** واختيار مجموعة بيانات من جهاز الكمبيوتر.
2. انقر على زر **رفع** بعد ذلك، سيتحقق التطبيق من استيفاء الملف للمتطلبات ويحفظ البيانات.

انتظر ظهور مربع حوار التأكيد للتأكد من تحميل مجموعة البيانات بنجاح:

<figure><img src="https://lh6.googleusercontent.com/GUuMs3oG97HGoZZQ2YI3c5Yxzu1b_FmnlCB-7sA7rpcqwn_qam1Bh1chsF0SVKzTHotYU1AT-wg1cfB8OLJbpwXuKn9Y_opGwBGhiuWGHBrHHyPVfxUnpf6B8-h9GFmvfFTghzJ8" alt=""><figcaption></figcaption></figure>

ستظهر بيانات التربة في قسم **بيانات التربة** وستكون متاحة لاتخاذ إجراءات إضافية، بما في ذلك إنشاء خريطة المناطق.

<figure><img src="https://lh3.googleusercontent.com/ERU19-KCgMO1LlWduMZ82AAap4miaEGLIeWo99XQafW_vVWX4A35auS2JjnNP2kWuMIJKQVUSKcnyOhBa_2CFbZwPnlQxn0P4Fc9MSNNfd_HFPZmF9-qlU1l6MRjoVJKVwJy3DHu" alt=""><figcaption></figcaption></figure>

اطّلع على [خرائط المناطق والتحليلات](https://docs.geopard.tech/geopard-tutorials/ar/jwlh-almntj-ttbyq-alwyb/zones-maps-and-analytics.md) لمعرفة مزيد من التفاصيل حول إنشاء خريطة مناطق باستخدام بيانات التربة.

يساعد GeoPard أيضًا في التخطيط السليم لأخذ عينات التربة على أساس المناطق. يمكنك تخطيط نقاط أخذ عينات التربة ومسارها استنادًا إلى مناطق GeoPard متعددة السنوات، التي تعكس أنماط تطور المحاصيل التاريخية.

### **استيراد بيانات الغلة** <a href="#yield-data-import" id="yield-data-import"></a>

لرفع ملفات أخذ عينات الغلة، اختر **استيراد البيانات** عنصر القائمة. ثم اختر **تحميل الملفات**.

يرجى مراعاة القيود التالية:

* لا تُدعم إلا ملفات الأشكال (Shapefile) بنظام WGS84 ‏(EPSG:4326)، على أن تكون البيانات قائمة على نقاط أو مضلعات.
* يجب أن تكون السمات من النوع الرقمي (عدد صحيح أو حقيقي، وليس سلسلة نصية).
* الحد الأقصى لحجم الملف هو 100MB.
* حاول تجنب استخدام الرموز الخاصة مثل `%+@` في عناوين السمات.
* الحد الأقصى لعدد السمات هو 20.
* يُعامل كل ملف شكل على أنه مجموعة بيانات واحدة (الملفان ‎\*.shp و‎\*.dbf إلزاميان).

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fgh274tUbThwBbn7ZlaHm%2Fimage.png?alt=media&amp;token=e1f8b6da-8510-423e-afbe-9b5fb97b7dfd" alt=""><figcaption></figcaption></figure>

1. يمكنك سحب مجموعة بيانات واحدة أو عدة مجموعات لبيانات الغلة وإفلاتها في اللوحة، أو النقر على **استعراض** واختيار مجموعة بيانات من جهاز الكمبيوتر.
2. انقر على زر **رفع** بعد ذلك، سيتحقق التطبيق من استيفاء الملف للمتطلبات ويحفظ البيانات.

انتظر ظهور مربع حوار التأكيد للتأكد من تحميل مجموعة البيانات بنجاح:

<figure><img src="https://lh6.googleusercontent.com/8Dk9Poz900uimyYo-W8XuuMHeauRkDNo6-Klo8ejFsZt0Gd_ktEhXOxALfxZPV7kl86DfkQSJo1X3UvP6Vw9ib1RtSd--3dQ1ZC4gLLoV733quEp7YYbaJMXYrbLC7vZPa3ItCgA" alt=""><figcaption></figcaption></figure>

ستظهر مجموعة البيانات في قسم **بيانات الغلة** وستكون متاحة لإجراءات أخرى، بما فيها إنشاء خريطة المناطق.

<figure><img src="https://lh5.googleusercontent.com/mDqfJIosDlhKNvM6JkSd7f6I4zZ_tDAYg2WoubwjEZU5SKh32FDwePQBJc-7zxIGR4wNtzME0Yzmqopdo6YM7zb6jP6Ex6annMrfjWr6ougD0V8hz2f3mn0e9QWFn1HoJKjoiiDM" alt=""><figcaption></figcaption></figure>

اطّلع على [خرائط المناطق والتحليلات](https://docs.geopard.tech/geopard-tutorials/ar/jwlh-almntj-ttbyq-alwyb/zones-maps-and-analytics.md) لمزيد من التفاصيل حول إنشاء خريطة مناطق باستخدام بيانات الغلة.

### **استيراد بيانات التطبيق الفعلي/الزراعة الفعلية** <a href="#as-applied-as-planted-data-import" id="as-applied-as-planted-data-import"></a>

لتحميل ملفات بيانات التطبيق الفعلي، اختر عنصر القائمة **استيراد البيانات** ثم اختر **تحميل الملفات**.

يرجى مراعاة القيود التالية:

* لا تُدعم إلا ملفات الأشكال (Shapefile) بنظام WGS84 ‏(EPSG:4326)، على أن تكون البيانات قائمة على نقاط أو مضلعات.
* يجب أن تكون السمات من النوع الرقمي (عدد صحيح أو حقيقي، وليس سلسلة نصية).
* الحد الأقصى لحجم الملف هو 40MB.
* حاول تجنب استخدام الرموز الخاصة مثل `%+@` في عناوين السمات.
* الحد الأقصى لعدد السمات هو 20.
* يُعامل كل ملف شكل على أنه مجموعة بيانات واحدة (الملفان ‎\*.shp و‎\*.dbf إلزاميان).

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FpuLGp6GIs6yny6NKlRcU%2Fimage.png?alt=media&amp;token=0dbab65c-3026-4176-b086-7eedb7650b68" alt=""><figcaption></figcaption></figure>

1. يمكنك سحب مجموعة بيانات واحدة أو أكثر للتطبيق الفعلي وإفلاتها في اللوحة، أو النقر على **استعراض** واختيار مجموعة بيانات من جهاز الكمبيوتر.
2. انقر على زر **رفع** بعد ذلك، سيتحقق التطبيق من استيفاء الملف للمتطلبات ويحفظ البيانات.

انتظر ظهور مربع حوار التأكيد للتأكد من تحميل مجموعة البيانات بنجاح:

<figure><img src="https://lh4.googleusercontent.com/xoQ_v-Ze506YEJkMtaG_Hg1rih-yQwCPBpqwHyNMSELmDnSvLmf_YhGOH3wXpTZ6AjpW4uyXXK6JD_A-CIC1kf4awf1Gf_4lsQSvri-VYREeMynsdor4ZMoWWt5bTKVEOfaEQN5U" alt=""><figcaption></figcaption></figure>

ستظهر مجموعة البيانات في قسم **التطبيق الفعلي/الزراعة الفعلية** وستكون متاحة لإجراءات أخرى، بما فيها إنشاء خريطة المناطق.

<figure><img src="https://lh5.googleusercontent.com/Z-aDK0Y1tt4n_nL3e9e0SlEXqqgKAMWDuNh8N_FaZZWZI9KRmBxQHoVVqIfqcE7iKck85RxwriH803iZveFt0P2oLIoTyKuXDVCwqBaylRQqyMg6eaOp6rH31uPzBsmlMQhV3zLH" alt=""><figcaption></figcaption></figure>

اطّلع على [خرائط المناطق والتحليلات](https://docs.geopard.tech/geopard-tutorials/ar/jwlh-almntj-ttbyq-alwyb/zones-maps-and-analytics.md) لمزيد من التفاصيل حول إنشاء خريطة مناطق باستخدام بيانات التطبيق الفعلي.

### **الاستيراد من MyJohnDeere** <a href="#import-from-myjohndeere" id="import-from-myjohndeere"></a>

يمكن لمستخدمي GeoPard استيراد البيانات، مثل الحدود وبيانات الغلة ومجموعات بيانات الزراعة الفعلية أو التطبيق الفعلي، من مركز عمليات John Deere إلى GeoPard.

يمكنك تحميل مجموعات البيانات عبر عنصر القائمة **استيراد البيانات** اختر **من MyJohnDeere**.

1. لاستيراد كل البيانات المتاحة، اختر حقلًا وانقر على **استيراد الكل** أو استخدم وظيفة التحديد.

<figure><img src="https://lh5.googleusercontent.com/mkTB9VxchwaIRnC_Hg3SFrtVuPWDWSc1lPxHPd3-ErURtDixoIGLegdfo-GAvqlWtnIWyBbGnev0HosjZdH4fiQcsh0uH7pkU3_fkb8xttmfd0Z-ADxYbQP31VbtHvuXkdhilZIG" alt=""><figcaption></figcaption></figure>

إذا لم تكن المؤسسة الصحيحة متاحة، فانتقل إلى **هنا يمكنك تغيير المؤسسات** وأضف المؤسسة. إذا كانت مؤسسة John Deere معطّلة (يظهر اسمها باللون الرمادي)، فأضف صلاحية الوصول إلى مركز عمليات John Deere.

بعد التحديد، انقر على **استيراد المحدد** زر.

<figure><img src="https://i0.wp.com/help.geopard.tech/wp-content/uploads/2021/12/image-1.png?resize=896%2C442&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

2. في الخطوة التالية، ستظهر إعدادات الاستيراد. إذا كنت تريد استيراد الحدود فقط، فاختر **حدود الحقول** زر الاختيار، ثم انقر على **تم** لبدء عملية الاستيراد. إذا سبق استيراد الحدود، فسيتم تحديث البيانات.

<figure><img src="https://lh3.googleusercontent.com/3-lV63PcGzerVqbtyhMVONR0_L-ZQ-pOr3lO4GnNgtyWKtVCJK5fHKulmlrgBn2tT76E-FIeV8Ix_DF85VbaEuug7DZpucDiusrnvhg2M2H4a3oNYnrSfi6-HJVD6C75rY0bxL6A" alt=""><figcaption></figcaption></figure>

إذا كنت تريد استيراد الأصول مع حدودها، فاختر **ملفات البيانات** زر الاختيار، ثم انقر على **التالي** زر. إذا سبق استيراد أصول تتضمن حدودًا، فسيتم تحديث البيانات.

<figure><img src="https://lh5.googleusercontent.com/7ENyHLNqNPEnknHHR6bctm1L1joqisrL18ZzvmJWfUTT4CwItPnAU4Q_sZXzImxrkAdVf9LJoUxxseZmG-x0dbBnOFimRs6gCgAKcitKrgN2cmpu9QRTB6IvHik5r5qFZ85rPV40" alt=""><figcaption></figcaption></figure>

بعد النقر، ستتاح لك فرصة اختيار **النوع** و **الفترة** للأصول. **الفترة** تتيح لك القائمة المنسدلة اختيار نطاق من الفترات.

<figure><img src="https://lh4.googleusercontent.com/MhNODjSyqYRWjfYEv3gD8cDbFUj-OHsJ-lMQq1FWFTt0ogjk04STQiFU9qLDxaxWNEzSnzO5i-JG5bO3wX0MyhmiCplW4w1pLC3jCIk5KZ54whiHXcu6nquy1b-2Be0mqbSPDHE2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh5.googleusercontent.com/9japjeGiD2WucUKFq-j-fQiKGNIp1kHWEkgOq-2vakbRvHbGUxR1fea25Ga23v8DMzL6ctl86I02Roxc0gE_mXGEwtRbjinQsWvYk4arXmET5WgpI8XPnA-Bpx6ZMZMR6zRoX6aT" alt=""><figcaption></figcaption></figure>

بعد اختيار **النوع** و **الفترة**، انقر على **تم** لبدء عملية الاستيراد.

<figure><img src="https://lh6.googleusercontent.com/veKRBXj3TPMmavBPOSYABPmpbaBTJnmbrqn-5BRpX7xA-lvRIxpVvWCFy4rUTqaHsgx_56oHB_nf1KhSQ_GiGU6w8mLAvuV-A0DNEeGeSnbh04rJRueMhec3ut4r-3zLNktH5BhT" alt=""><figcaption></figcaption></figure>

انتظر رسالة التأكيد للتحقق من تحميل مجموعة البيانات بنجاح. بعد ترحيل البيانات، يمكنك النقر على **الانتقال إلى الحقل** لمراجعة البيانات.

<figure><img src="https://lh4.googleusercontent.com/pvnmZQM0RZ9BCNqadNfFPUFaPRBJMLeBoT_v9p_aDOdHkcbX2i2Bemya6aZgRpTO1Rb6iAQEqfrdY95vFKQacMadSiTAVOioU9M0E-k4y28zxmRmYp45DJEqWVDU61K57sCWMHPa" alt=""><figcaption></figcaption></figure>


---

# 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/ar/jwlh-almntj-ttbyq-alwyb/import-precision-agriculture-data.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.
