> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/technical-library-ar/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/overview.md).

# نظرة عامة

### ما هي خاصية الاستمرارية المحلية في Zoom Phone؟

#### <mark style="color:أزرق;">ZPLS هو جهاز افتراضي محلي يدعم المكالمات الهاتفية الداخلية بين المستخدمين في موقع مشترك عندما يتعذر الوصول إلى مراكز بيانات Zoom</mark>

وحدة ZPLS هي جهاز محلي يسمح للمستخدمين ضمن نفس **موقع** إجراء مكالمات هاتفية مع بعضهم البعض عندما يتعذر الوصول إلى مراكز بيانات Zoom. وهذا يوفّر حلاً للاستمرارية التشغيلية في حال حدوث فعالية انقطاع في الشبكة.

{% hint style="danger" %}
ضمن هذا الدليل، **موقع** هو مصطلح محدد يُستخدم داخل Zoom Phone لتجميع المستخدمين معًا تحت هوية مشتركة، مثل موقع مكتب. بالنسبة لبعض العملاء، تُمثَّل عدة مبانٍ بواسطة موقع واحد؛ وبالنسبة لآخرين، قد يشكّل كل مبنى في الحرم الجامعي موقعه الخاص. ينبغي للعملاء أن يكونوا على دراية بتكوينات الموقع الحالية أو المحتملة لديهم عند النظر في وحدة ZPLS نظرًا لاعتبارات التصميم المذكورة في هذه المقالة.
{% endhint %}

**كما يدعم ZPLS أيضًا المكالمات بين المواقع عندما تكون أجهزة ZPLS والمواقع المرتبطة بها متصلة عبر شبكة مشتركة**

بحد ذاته، فإن جهاز ZPLS (ويشار إليه أيضًا كوحدة، أي  *وحدة Zoom Node*) يوفر الاستمرارية للمستخدمين ضمن موقع Zoom Phone مشترك **موقع**ومع ذلك، يمكن لوحدات ZPLS المتعددة المتصلة عبر شبكة محلية أو شبكة الحرم الجامعي أو شبكة واسعة النطاق أن تدعم الاتصال عبر المواقع، لِاتصال المستخدمين من مواقع مختلفة أثناء فعالية استمرارية، ما دامت الشبكة الداخلية تعمل.

#### <mark style="color:أزرق;">يمكن للعملاء دمج ZPLS مع SBC لإجراء واستقبال مكالمات شبكة الهاتف العامة المترابطة عندما يتعذر الوصول إلى مراكز بيانات Zoom</mark>

يمكن للعملاء دمج وحدة ZPLS مع جهاز التحكم بحدود الجلسة (SBC) لإجراء الاتصال الخارجي عبر شبكة الهاتف العامة التبديلية (شبكة الهاتف العامة المترابطة) عندما يتعذر الوصول إلى مراكز بيانات Zoom. ويتيح ذلك للمستخدمين الذين لديهم أرقام شبكة الهاتف العامة المترابطة المقدمة من Zoom أو من مزودي BYOC من الجهات الخارجية استقبال مكالمات واردة من أطراف خارجية عند تمكين تحويل المكالمات للاستمرارية في السحابة، وإجراء مكالمات هاتفية خارجية بغض النظر عن ظروف الشبكة المحلية أو توافر مراكز بيانات Zoom؛ ومع ذلك، قد تكون المكالمات الداخلية محدودة بتصميم الموقع.

#### <mark style="color:أزرق;">تُعد وحدة ZPLS نقطة التسجيل ذات الأولوية الثالثة للأجهزة المدعومة، مع تفضيل مناطق SIP الأساسية والثانوية الخاصة بـ Zoom Phone داخل السحابة عندما تكون متاحة</mark>

أثناء عملية تشغيل اعتيادية، يحمّل عميل Zoom Phone سجلات DNS SRV لمناطق SIP الأساسية والثانوية (نقاط التسجيل) الموجودة داخل مراكز بيانات Zoom. ومع ذلك، بالنسبة إلى المواقع الممكّنة للاستمرارية والتي تحتوي على وحدة ZPLS، تتم أيضًا تهيئة أجهزة العميل المدعومة مع *الثالث* سجل SRV، الذي يشير إلى عنوان بروتوكول الإنترنت (IP) لوحدة الموقع.

#### <mark style="color:أزرق;">تراقب وحدة ZPLS توافر سحابة Zoom من خلال عمليات OPTIONS ping الروتينية إلى مناطق SIP الخاصة بالموقع</mark>

في سياق العمليات العادية، تكون وحدة ZPLS عادةً غير نشطة داخل الشبكة المحلية ولا تتولى معالجة المكالمات. وبدلاً من ذلك، ترسل وحدة ZPLS عمليات OPTIONS ping الروتينية إلى مناطق SIP الخاصة بالموقع لمراقبة الاتصال النشط بين المواقع.

#### <mark style="color:أزرق;">لا يتم تفعيل وضع الاستمرارية إلا عندما تعجز كل من وحدة ZPLS وأجهزة العميل عن الاتصال بمناطق SIP الخاصة بالموقع</mark>

لا تدخل وحدة ZPLS في وضع البقاء إلا عندما تفشل عمليات OPTIONS ping الروتينية بين وحدة ZPLS ومناطق SIP الأساسية والثانوية. ستسجل أجهزة العميل التي تفقد الاتصال بمناطق SIP في الوقت نفسه الذي تفقد فيه وحدة ZPLS الاتصال، بشرط وجود اتصال IP بين الأجهزة. إذا حافظت وحدة ZPLS على الاتصال مع سحابة Zoom Phone، فلن تقبل تسجيلات SIP.

#### <mark style="color:أزرق;">الوقت التقريبي للتبديل الاحتياطي إلى وحدة ZPLS هو حوالي ثلاث دقائق، لكنه قد يختلف حسب عدد الأجهزة</mark>

في فعالية تعذر الوصول إلى مناطق SIP الخاصة بالموقع، يكون وقت التبديل التقريبي للجهاز إلى وحدة ZPLS ضمن ثلاث دقائق. ومع ذلك، قد يختلف هذا الوقت حسب عدد الأجهزة المتزامنة التي تحاول التسجيل لدى كل وحدة ZPLS.

#### <mark style="color:أزرق;">تُخطر عملاء سطح المكتب المستخدمين عند الدخول إلى وضع البقاء وعند الخروج منه</mark>

عندما ينتقل عملاء Zoom لسطح المكتب إلى وضع البقاء، يتلقى المستخدمون تنبيهًا يُبلغهم بأنه لا يوجد اتصال بالإنترنت، لكن خدمة الهاتف لا تزال متاح.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/iBKBV5KVuU1xKsH2Br2r/Unknown%20image" alt=""></div>

بمجرد استعادة الخدمات، يتلقى المستخدمون تنبيهًا باستعادة الاتصال.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/j5OMSJ3osllv4Daik6bQ/Unknown%20image" alt=""></div>

{% hint style="info" %}
هذا التنبيه فريد لعملاء Zoom لسطح المكتب؛ فلن يتم عرض تنبيه التبديل الاحتياطي أو الرجوع على هواتف IP.
{% endhint %}

#### <mark style="color:أزرق;">ستسقط المكالمات النشطة عند تفعيل وضع البقاء، ويجب على المستخدمين إعادة إنشاء المكالمة يدويًا</mark>

سيسمع المستخدمون المشاركون في مكالمة نشطة، عند انقطاع الاتصال عن مناطق SIP الخاصة بموقعهم، إشارة مشغول سريعة قبل قطع المكالمة. وبعد الانقطاع والتبديل إلى وضع البقاء، يجب على المستخدمين إعادة إنشاء المكالمة يدويًا.

#### <mark style="color:أزرق;">يمكن لإعادة توجيه المكالمات توجيه المكالمات الواردة إلى رقم BYOC عندما يكون وضع البقاء نشط</mark>

أثناء فعالية استمرارية، لا يمكن الوصول إلى الأجهزة التي تم تسجيل أرقام الهاتف الخاصة بها في سحابة Zoom Phone بسبب فقدان الاتصال بالإنترنت. ومع ذلك، يمكن لعملاء ZPLS الذين لديهم SBC ومشغّل مستقل إعداد قواعد تحويل المكالمة في بوابة الويب للاتصال الداخلي المباشر. عند التمكين، تُعيد قواعد تحويل المكالمة توجيه المكالمة الواردة إلى رقم مسجّل في Zoom Phone، إلى *منفصل* رقم مرتبط بوصلة شبكة الهاتف العامة المترابطة المحلية الخاصة بالعميل. يتيح ذلك للعملاء المرونة في شراء الأرقام مباشرةً من Zoom مع الاستمرار في إمكانية الرد على مكالمة مباشرةً في موقع فقد الاتصال بالسحابة.

على سبيل المثال، إذا كان لدى مستخدم رقم الهاتف X55-555-5555 مسجّلًا لدى Zoom Phone ودخل موقع المستخدم في وضع الاستمرارية، يصبح رقم هاتف المستخدم غير متاح من منظور سحابة Zoom. إذا كان تحويل المكالمة ممكّنًا وتم الاتصال برقمهم، يمكن لـ Zoom Phone إعادة توجيه الطلب إلى رقم الهاتف المخصص للتحويل لديهم (مثل X11-111-1111) عبر شبكة الهاتف العامة المترابطة إلى SBC الخاص بالعميل. ونتيجةً لذلك، يمكن للمتصلين الخارجيين الوصول إلى المستخدمين داخل موقع متأثر يمر بفعالية استمرارية.

#### <mark style="color:أزرق;">يدعم ZPLS مجموعات توزيع الاستمرارية، موفّرًا قدرات توجيه مكالمة دقيقة أثناء فعالية استمرارية</mark>

تدعم وحدات ZPLS مجموعات توزيع الاستمرارية (SDGs) لتكوينات توجيه مكالمة دقيقة أثناء فعالية استمرارية. مع SDGs، يمكن للشركة توجيه المكالمات الداخلية والواردة عبر شبكة الهاتف العامة المترابطة إلى مستخدم فردي، أو مجموعة من المستخدمين (بما يشبه طابور مكالمات أو مجموعة خط مشترك)، أو قائمة IVR، أو رقم هاتف آخر، أو، عند الحاجة، SDG أخرى.

على الرغم من أن SDGs لا توفر نفس الوظائف الكاملة مثل طوابير المكالمات في التشغيل المعياري، أو مجموعات الخط المشترك، أو موظفي الاستقبال الآليين، يمكن لـ SDGs أن تتابع دعم احتياجات توجيه المكالمة الحرجة لدى الشركة حتى تتم استعادة العمليات العادية.

يمكن إضافة SDG باستخدام **إضافة مجموعة التوجيه** التكوين ضمن بوابة المسؤول.

<div data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-b686a448099c61746dcb50fee9f35eb9d2f42178%2Fimage.png?alt=media" alt="" width="508"><figcaption></figcaption></figure></div>

#### <mark style="color:أزرق;">تستمر المكالمات الداخلية بين المستخدمين في وضع الاستمرارية في أن تكون محمية بواسطة SRTP</mark>

أثناء وضع الاستمرارية، تتم حماية المكالمات الهاتفية الداخلية بين المستخدمين بواسطة بروتوكول النقل الآمن في الوقت الحقيقي (SRTP) باستخدام معيار التشفير المتقدم بمفتاح 128 أو 256 بت، حسب [قدرات الجهاز](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Voice-Supported-Devices).

#### <mark style="color:أزرق;">ستتم استعادة خدمات السحابة/التوجيه بعد أن تحافظ وحدة ZPLS على اتصال موثوق بمناطق SIP لمدة خمس دقائق تقريبًا</mark>

بمجرد أن تعيد أجهزة العميل ووحدة ZPLS إنشاء اتصال مع مناطق SIP الخاصة بالموقع، يكون وقت العودة الاحتياطي التقريبي إلى العمليات العادية خمس دقائق. ويشمل ذلك فترة زمنية للتأكد من أن اتصالات الشبكة مستقرة في حال حدوث تعافٍ شبكي متقطع أو جزئي (flapping). إذا كانت إمكانية الاتصال بالشبكة متقطعة، فستظل أجهزة العميل ووحدة ZPLS في وضع الاستمرارية حتى يُتأكد من استقرار الاتصالات.

#### <mark style="color:أزرق;">ستحمّل وحدة ZPLS سجلات تفاصيل المكالمات لجميع المكالمات التي أُجريت بعد الخروج من وضع الاستمرارية</mark>

بعد أن تخرج وحدة ZPLS بنجاح من وضع الاستمرارية وتصبح إمكانية الاتصال بمناطق SIP مستقرة، سترفع الوحدة سجلات تفاصيل المكالمات (CDRs) لجميع المكالمات التي أُجريت في وضع الاستمرارية. وتُعلَّم هذه السجلات في التقارير على أنها مكالمات أُكملت أثناء وجودها في وضع الاستمرارية.

#### <mark style="color:أزرق;">تتم مزامنة تغييرات الموقع، بما في ذلك إضافة المستخدمين أو الأجهزة أو تعديلهم، مع وحدة ZPLS مرة كل 10 ساعات</mark>

تتم مزامنة التحديثات التي تُجرى على إعدادات الموقع عبر بوابة Zoom على الويب، بما في ذلك إضافة المستخدمين أو الأجهزة أو تعديلهم، مع وحدة ZPLS مرة كل 10 ساعات. إذا وقعت فعالية توقف قبل مزامنة تغييرات الإعدادات الجديدة مع وحدة ZPLS، فستستخدم الوحدة آخر إعدادات معروفة.

#### <mark style="color:أزرق;">يمكن للعملاء اختبار أحداث التحول الاحتياطي أو محاكاتها باستخدام وضع الاختبار</mark>

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

بينما يكون وضع الاختبار نشطًا، ستعمل وحدة ZPLS كما لو كانت فعالية تجاوز الفشل تحدث. يمكن للمستخدمين الداخليين إجراء مكالمات إلى مستخدمين آخرين داخل موقعهم. بالإضافة إلى ذلك، سيتم توجيه المكالمات الصادرة والواردة عبر SBC المتصل إذا كان مُهيأً، وستتبع المكالمات الواردة قواعد تحويل المكالمات إذا كانت مُهيأة ومفعلة.

بعد تعطيل وضع الاختبار، يجب إعادة تشغيل وحدة ZPLS لاستئناف عمليات الشبكة العادية.

{% hint style="info" %}
لا ينطبق وضع الاختبار على أجهزة هاتف IP. لا يمكن اختبار وضع الاختبار إلا باستخدام تطبيقات Zoom لسطح المكتب.
{% endhint %}

### الميزات والعملاء المدعومون

#### <mark style="color:أزرق;">الميزات المتاحة في وضع البقاء</mark>

تتضمن القائمة التالية الميزات المدعومة من وحدة ZPLS عند تفعيل وضع البقاء:

**ميزات المكالمة**

* طلب الامتداد الداخلي
* طلب الامتداد الكامل باستخدام رمز الموقع
* الطلب من سجل المكالمة
* DTMF (RFC 2833)
* مؤتمر ثلاثي الأطراف فوري
* تحويل المكالمة\*
* الواردة/الصادرة عبر شبكة الهاتف العامة المترابطة\*
* البحث/الطلب عن جهة الاتصال (أول 25,000 جهة اتصال)
* الطلب بالاسم
* كتم الصوت/إلغاء كتم الصوت
* تعليق/استئناف المكالمة
* إيقاف مؤقت للمكالمة

**تحويل وتوجيه**

* تحويل استشاري
* تحويل مخفي
* رقم تحديد الموقع للطوارئ
* المكالمات بين وحدات ZPLS

**توزيع الاستمرارية**

* التوجيه إلى مستخدم
* التوجيه إلى أعضاء المجموعة
* التوجيه إلى رقم هاتف\*
* التوجيه إلى IVR
* ساعات العمل
* رنين تتابعي
* رنين متزامن
* مطالبات صوتية

<sub>*\*يتطلب تكامل SBC وBYOC*</sub>

#### <mark style="color:أزرق;">الميزات غير المتاحة في وضع البقاء</mark>

تتضمن القائمة التالية الميزات غير المدعومة عند تفعيل وضع البقاء:

* إضافة/إزالة جهة الاتصال
* البريد الصوتي
* تصعيد إلى مؤتمر متعدد الأطراف (4+ مستخدمين)
* تصعيد إلى اجتماع
* التقاط المكالمة
* التبديل إلى الناقل
* المكالمات e911 المتنقلة
* الطلب السريع
* المراقبة (Barge/Monitor/الهمس)
* تفويض المكالمة
* الاتصال الداخلي
* المكالمات المشفرة من طرف إلى طرف (E2EE)
* المجيب الآلي
* طابور المكالمة

#### <mark style="color:أزرق;">أجهزة العميل المدعومة</mark>

راجع مركز الدعم لدينا للحصول على قائمة بـ [أجهزة العميل المدعومة](https://support.zoom.us/hc/en-us/articles/360029698771-Supported-desk-phone-features#h_01GGF32MEZ6DDT3VBE8Y2D6JH3) و [إصدارات البرامج الثابتة المدعومة](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Phone-Certified-Hardware).

### منافذ الشبكة وتدفق البيانات

#### <mark style="color:أزرق;">مخطط عام</mark>

يوضح المخطط التالي منافذ الشبكة وتدفقات البيانات المستخدمة مع وحدة ZPLS وتكوين SBC.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/jwJPyOKbR2KlSvR4WyaJ/Unknown%20image" alt=""></div>

#### <mark style="color:أزرق;">متطلبات جدار الحماية لاستمرارية ZPLS</mark>

يسرد الجدول التالي منافذ الشبكة التي يستخدمها Zoom Phone أثناء العمليات العادية عندما لا يكون هناك انقطاع في الاتصال بالسحابة. راجع مركز الدعم لدينا للحصول على [القائمة الكاملة لعناوين بروتوكول الإنترنت (IP)](https://support.zoom.us/hc/en-us/articles/201362683-Zoom-network-firewall-or-proxy-server-settings#h_01EEBSGCKBYVB20MCVPR78T0NN) المستخدمة لسحابة Zoom Phone.

| النقل | عنوان بروتوكول الإنترنت (IP) المصدر | عنوان بروتوكول الإنترنت (IP) الوجهة | منفذ الوجهة | الغرض                               |
| ----- | ----------------------------------- | ----------------------------------- | ----------- | ----------------------------------- |
| TCP   | عميل Zoom Phone                     | سحابة Zoom Phone                    | 5091        | حركة إشارات SIP                     |
| TCP   | عميل Zoom Phone                     | سحابة Zoom Phone                    | 443         | حركة الويب - إعدادات العميل         |
| TCP   | عميل Zoom Phone                     | سحابة Zoom Phone                    | 390         | البحث في الدليل من الهواتف المكتبية |
| UDP   | عميل Zoom Phone                     | سحابة Zoom Phone                    | 20000-64000 | حركة وسائط SRTP                     |
| TCP   | ZPLS                                | سحابة Zoom Phone                    | 5091        | اختبار Ping لخيارات SIP (Keepalive) |
| TCP   | ZPLS                                | سحابة Zoom Phone                    | 443         | حركة إدارة العقدة / نظام التشغيل    |
| TCP   | ZPLS                                | سحابة Zoom Phone                    | 9669        | سجل المكالمة / مزامنة الاسترداد     |
| TCP   | SBC                                 | سحابة Zoom Phone                    | 5061        | حركة إشارات SIP (BYOC)              |
| UDP   | SBC                                 | سحابة Zoom Phone                    | 10000-64000 | حركة وسائط SRTP (BYOC)              |

يوضح الجدول التالي منافذ TCP وUDP التي يستخدمها Zoom Phone عندما يكون التحول الاحتياطي إلى ZPLS نشطًا بسبب انقطاع الاتصال بالسحابة.

| النقل | عنوان بروتوكول الإنترنت (IP) المصدر | عنوان بروتوكول الإنترنت (IP) الوجهة | منفذ الوجهة | الغرض                               |
| ----- | ----------------------------------- | ----------------------------------- | ----------- | ----------------------------------- |
| TCP   | عميل Zoom Phone                     | ZPLS                                | 5091        | حركة إشارات SIP                     |
| UDP   | عميل Zoom Phone                     | ZPLS                                | 20000-64000 | حركة وسائط SRTP                     |
| TCP   | ZPLS                                | SBC                                 | 5061        | البحث في الدليل من الهواتف المكتبية |
| UDP   | ZPLS                                | SBC                                 | 20000-64000 | حركة وسائط SRTP                     |

#### <mark style="color:أزرق;">متطلبات جدار الحماية للربط المحلي لـ BYOC</mark>

يجب على العملاء الذين يدمجون وحدة ZPLS مع SBC للاتصال الخارجي أثناء فعالية الاستمرارية تمكين المنافذ المطلوبة للربط المحلي. بعد تكوين مجموعة توجيه، تصبح عناوين IP اللازمة لمجموعة التوجيه متاحة على الويب. للوصول إلى عناوين IP، اتبع الخطوات التالية:

1. سجّل الدخول إلى بوابة الويب الخاصة بـ Zoom.
2. في [**مركز المسؤول**](https://zoom.com/account) قائمة التنقل، انقر على **تهيئة المنتج**، ثم **نظام الهاتف**، ثم [**معلومات الشركة**](https://zoom.com/pbx/page/telephone/settings#/settings).
3. انقر **إعدادات الحساب**
4. حدّد خيار **مجموعات التوجيه**. انقر على **إدارة** لتحميل صفحة جديدة.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Vo7n7pkdGHHqoBDVLd4l/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
5. في الصفحة التالية، حدّد مجموعة التوجيه المقصودة، ومرّر المؤشر فوق **"i"** الرمز.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/pCUJ8WVkYAnR5nDgfvLU/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
6. تمكين عنوان بروتوكول الإنترنت (IP) المحدد والمنافذ داخل النافذة حسب الحاجة ضمن شبكتك.

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/BnIojqs0sYIsQSisquSv/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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://library.zoom.com/technical-library/technical-library-ar/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/overview.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.
