إعداد قالب تطبيق Databricks في ChatGPT

استخدم هذا الدليل إذا كنت مسؤول مساحة عمل مشتركة في ChatGPT أو مستخدمًا لخطة ChatGPT Plus أو Pro وتُعِدّ تطبيق Databricks Genie باستخدام OAuth المدمج أو عميل OAuth الخاص بمؤسستك.

• OAuth المدمج: استخدم الاتصال المُعَدّ مسبقًا إذا كان متاحًا في ChatGPT ومُفعّلًا لمساحة عملك في Databricks. لا تحتاج إلى إنشاء تطبيق OAuth أو إدخال معرّف عميل أو سرّ عميل. اتبع التعليمات الواردة في قسم «OAuth المدمج» أدناه.

• عميل OAuth مخصّص: استخدم هذا المسار إذا لم يكن OAuth المدمج متاحًا أو كانت مؤسستك تشترط استخدام عميل OAuth خاص بها. اتبع التعليمات الواردة في قسم «عميل OAuth مخصّص» أدناه.

ما الذي ستُعِدّه

ستُنشئ اتصالًا بتطبيق Databricks لحسابك أو مساحة عملك المشتركة في ChatGPT. يتطلّب كلا المسارين تفاصيل موفّر Databricks التي يطلبها ChatGPT، وأذونات الموارد التي تنوي استخدامها. إذا كنت تستخدم عميل OAuth مخصّصًا، فجهّز أيضًا ما يلي:

• اتصال بتطبيق OAuth على Databricks أُنشئ في وحدة تحكّم حساب Databricks.

• معرّف عميل OAuth وسرّ العميل في Databricks.

• عنوان URL للاستدعاء الراجع منسوخًا من ChatGPT كما هو تمامًا.

• نطاقات Databricks التي تتوافق مع إمكانات التطبيق التي تريد تفعيلها.

• أي تفاصيل لموفّر Databricks تطلبها خطوات الإعداد في ChatGPT، مثل مضيف مساحة العمل أو مضيف الحساب أو معرّف الحساب أو المستودع.

قبل البدء

للإعداد على مستوى مساحة عمل مشتركة، افتح وحدة تحكّم المسؤول، وحدّد مساحة العمل المشتركة المطلوبة في ChatGPT، ثم افتح «المكونات الإضافية». حدّد «إدارة التطبيقات القديمة» لفتح صفحة «التطبيقات» التي لا تزال متاحة. للتعرّف على التنقّل في مساحة العمل المشتركة والوصول إلى التطبيقات القديمة، راجع عناصر تحكّم المسؤول والأمان والامتثال للمكونات الإضافية والتطبيقات.

تحتاج إلى:

• صلاحيات مسؤول أو مالك مساحة عمل مشتركة في ChatGPT، أو حساب ChatGPT Plus أو Pro.

• صلاحيات مسؤول حساب Databricks، إذا كنت تستخدم عميل OAuth مخصّصًا. قد تكفي صلاحيات مسؤول مساحة العمل لبعض المهام، لكن اتصالات التطبيقات المخصّصة تُضبط من وحدة تحكّم حساب Databricks. لاستخدام OAuth المدمج، يجب أن يتحقّق مسؤول Databricks من أن تطبيق ChatGPT متاح ومُفعّل لمساحة عملك.

• فتح وحدة تحكّم حساب Databricks في علامة تبويب منفصلة، إذا كنت تستخدم عميل OAuth مخصّصًا.

• فتح شاشة الاتصال بـ Databricks Genie في ChatGPT لتتمكّن من نسخ عنوان URL للاستدعاء الراجع كما هو تمامًا، إذا كنت تستخدم عميل OAuth مخصّصًا.

• تحديد الإمكانات التي يحتاجها التطبيق: Genie ولوحات معلومات AI/BI، أو وصول أوسع إلى واجهات Databricks البرمجية، أو تطبيق يقتصر على واجهات Databricks SQL البرمجية. الوصول المقتصر على SQL لا يكفي لإجراءات Genie أو لوحات المعلومات.

• مكان آمن للتعامل مع سرّ عميل Databricks، إذا كنت تستخدم عميل OAuth مخصّصًا.

• إذا كان حسابك أو مساحة عملك في Databricks يقيّدان الوصول عبر قائمة وصول لعناوين IP، أو ضوابط للاتصالات الواردة مستندة إلى السياق، أو جدار حماية، أو سياسة شبكة أخرى، فستحتاج إلى مساعدة مسؤول Databricks يمكنه السماح بـنطاقات عناوين IP الحالية للاتصالات الصادرة من تطبيقات ChatGPT.

إذا كنت تستخدم عميل OAuth مخصّصًا، فانسخ عنوان URL للاستدعاء الراجع المعروض في ChatGPT كما هو تمامًا.

القيم المطلوب تجهيزها

• لعميل OAuth المخصّص، عنوان URL للاستدعاء الراجع: انسخه من خطوات إعداد التطبيق في ChatGPT.

• لعميل OAuth المخصّص، معرّف عميل OAuth في Databricks.

• لعميل OAuth المخصّص، سرّ عميل OAuth في Databricks.

• لعميل OAuth المخصّص، نطاقات الوصول في Databricks المناسبة لإمكانات التطبيق. إذا كان اتصال جديد بـ Genie أو لوحات المعلومات يعرض ai-gateway وdashboards وoffline_access، فجهّز هذه النطاقات. يظل خيار جميع واجهات API (all-apis مع offline_access) البديل الأقدم والأوسع نطاقًا. استخدم SQL فقط لتطبيق يقتصر على واجهات Databricks SQL البرمجية.

• حقول مساحة العمل أو الحساب في Databricks التي تطلبها خطوات الإعداد في ChatGPT.

OAuth المدمج

استوفِ المتطلبات الأساسية أعلاه أولًا. استخدم هذه الطريقة فقط عندما يكون OAuth المدمج متاحًا في ChatGPT ومفعّلًا لمساحة عملك في Databricks.

1. اطلب من مسؤول Databricks التحقق من أن تطبيق ChatGPT متاح في إعدادات تكامل التطبيقات بوحدة تحكم الحساب، ومفعّل لمساحة عملك. إذا لم يكن تطبيق ChatGPT مُدرجًا في وحدة تحكم حسابك في Databricks، فتواصل مع ممثل حسابك لدى Databricks للاستفسار عما إذا كانت الميزة متاحة لحسابك.

2. في ChatGPT، انتقل إلى الحساب أو مساحة العمل المشتركة التي تريد إتاحة التطبيق فيها. انتقل إلى الإعدادات > المكونات الإضافية للإعداد الشخصي، أو إلى وحدة تحكم المشرف > المكونات الإضافية بصفتك مسؤول مساحة العمل المشتركة أو مالكها لإعداد التطبيق فيها.

3. اختر Databricks Genie، ثم اختر إضافة اتصال تطبيق.

4. أدخل اسم مضيف مساحة العمل (مطلوب) من دون https:// أو مسار URL.

   يستنتج ChatGPT نقطة نهاية Genie MCP المحلية لمساحة العمل، https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp، من اسم المضيف هذا. لا حاجة إلى نقطة نهاية MCP إقليمية منفصلة.

5. اختر متابعة، ثم سجّل الدخول إلى Databricks وراجع طلب الموافقة.

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

عميل OAuth مخصّص

استوفِ المتطلبات الأساسية أعلاه أولًا. اتبع هذا المسار إذا لم يكن OAuth المدمج متاحًا أو كانت مؤسستك تشترط استخدام عميل OAuth خاص بها. بعد الإعداد، أكمل التعليمات في قسمَي «التوصيل والاختبار» و«إدارة الوصول» أدناه.

بدء إعداد OAuth المخصص في ChatGPT

1. في ChatGPT، انتقل إلى الحساب أو مساحة العمل المشتركة التي تريد إتاحة التطبيق فيها.

2. انتقل إلى الإعدادات > المكونات الإضافية للإعداد الشخصي، أو إلى وحدة تحكم المشرف > المكونات الإضافية بصفتك مسؤول مساحة العمل المشتركة أو مالكها لإعداد التطبيق فيها.

3. اختر Databricks Genie في الدليل.

4. اختر إضافة اتصال تطبيق.

5. في مربع الحوار توصيل Databricks Genie، ابحث عن حقلَي معرّف عميل OAuth وسر عميل OAuth. إدخال بيانات الاعتماد في هذين الحقلين الظاهرين هو طريقة إعداد العميل المخصص؛ ولا حاجة إلى خيار منفصل لتحديده.

6. انسخ عنوان URL لمعاودة الاتصال من ChatGPT. أبقِ مربع الحوار هذا مفتوحًا.

مثال على عنوان URL لمعاودة الاتصال:

https://chatgpt.com/connector/oauth/<callback_id>

لا تحذف معرّف معاودة الاتصال، ولا تضف شرطة مائلة في النهاية، ولا تستبدل العنوان بعنوان URL عام لـ ChatGPT. يجب أن يطابق عنوان URL المسجّل في Databricks تمامًا عنوان URL لمعاودة الاتصال الظاهر في ChatGPT.

إنشاء اتصال بتطبيق OAuth مخصّص في Databricks

1. افتح وحدة تحكّم الحساب الخاصة بحسابك في Databricks.

2. من الشريط الجانبي الأيسر، افتح الإعدادات.

3. افتح علامة التبويب اتصالات التطبيقات.

4. حدّد إضافة اتصال.

   

5. أدخل اسمًا للتطبيق، مثل ChatGPT Databricks.

6. في عناوين URL لإعادة التوجيه، الصق عنوان URL للاستدعاء الراجع الذي نسخته من ChatGPT كما هو تمامًا.

7. ضمن نطاقات الوصول، اختر النطاقات التي يحتاجها التطبيق.

8. إذا كان اتصال جديد بـ Genie أو لوحات المعلومات يعرض ai-gateway وdashboards وoffline_access في ChatGPT، فاسمح بالنطاقات نفسها في تطبيق OAuth على Databricks.

9. يظل خيار جميع واجهات API البديل الأقدم والأوسع نطاقًا للوصول العام إلى واجهات Databricks البرمجية. لهذا الإعداد، استخدم all-apis وoffline_access في ChatGPT، وتأكّد من أن تطبيق OAuth على Databricks يسمح بكليهما. يُفضّل استخدام النطاقات المحدّدة المعروضة عند إنشاء اتصال جديد بـ Genie أو لوحات المعلومات.

10. استخدم SQL فقط لتطبيق يقتصر على واجهات Databricks SQL البرمجية. الوصول المقتصر على SQL لا يكفي لإجراءات Genie أو لوحات المعلومات.

11. تأكّد من تفعيل كل نطاق سيُدرَج لاحقًا في ChatGPT على تطبيق OAuth هذا في Databricks. يسمح Databricks تلقائيًا بالنطاقات openid وemail وprofile وoffline_access للتطبيقات التي تُنشأ في واجهة المستخدم.

12. أبقِ مدد صلاحية الرموز على القيم الافتراضية في Databricks ما لم تكن لمؤسستك سياسة محدّدة: 60 دقيقة لرمز الوصول و10080 دقيقة لرمز التحديث.

13. فعّل إنشاء سرّ عميل. يحتاج ChatGPT إلى عميل OAuth من النوع السرّي لهذا المسار.

14. أنشئ الاتصال.

نسخ بيانات الاعتماد من Databricks

1. في مربع الحوار تم إنشاء الاتصال، انسخ معرّف العميل.

2. انسخ سرّ العميل فورًا واحفظه بأمان.

3. إذا أغلقت مربع الحوار قبل نسخ السرّ، فأنشئ بيانات اعتماد لتطبيق OAuth أو استبدل البيانات الحالية، واستخدم السرّ الجديد.

يعرض Databricks السرّ مرة واحدة فقط. تعامل معه باعتباره من بيانات الاعتماد، ولا تُدرجه في لقطات الشاشة أو تذاكر الدعم أو التعليقات أو المحادثات.

إكمال إعداد OAuth المخصص في ChatGPT

1. عُد إلى مربع الحوار توصيل Databricks Genie.

2. أدخل معرّف عميل Databricks في معرّف عميل OAuth.

3. أدخل سر عميل Databricks في سر عميل OAuth.

   يؤدي إدخال بيانات الاعتماد هذه إلى استخدام عميل OAuth المخصص لديك؛ ولا حاجة إلى خيار منفصل لتحديده.

4. في النطاقات (اختياري)، أدخل النطاقات المطلوبة لنقطة نهاية Databricks التي يستخدمها تطبيقك وإمكاناته. تأكد من مطابقتها للنطاقات المفعّلة في تطبيق OAuth في Databricks.

   إذا كان الاتصال الجديد بـ Genie أو لوحات المعلومات يعرض ai-gateway وdashboards وoffline_access، فأبقِ هذه النطاقات كما هي. تأكد من أن تطبيق OAuth في Databricks يسمح بالنطاقات نفسها. يتيح ai-gateway اتصال Genie MCP المحلي لمساحة العمل، ويتيح dashboards إجراءات لوحات معلومات AI/BI، ويتيح offline_access رموز التحديث.

   لا يزال البديل الأقدم والأوسع نطاقًا، all-apis وoffline_access، مدعومًا لإتاحة وصول أوسع إلى واجهات API، لكنه ليس الخيار المفضّل لهذا الاتصال بـ Genie أو لوحات المعلومات. إذا كان تطبيق Databricks يسمح فقط بـ all-apis، فحدّثه أو أعد إنشاءه ليسمح بـ ai-gateway وdashboards وoffline_access. إذا لم تتوفر النطاقات الدقيقة، فاضبط ChatGPT صراحةً على all-apis وoffline_access، وتأكد من أن تطبيق Databricks يسمح بكليهما. لا تطلب النطاقات الدقيقة الثلاثة في ChatGPT بينما يسمح تطبيق Databricks فقط بـ all-apis.

5. أدخل كل نطاق في سطر مستقل، أو افصل النطاقات بفواصل. يجب تفعيل كل نطاق مُدرج في ChatGPT ضمن تطبيق OAuth في Databricks.

6. أدخل اسم مضيف مساحة العمل (مطلوب) من دون https:// أو مسار URL. املأ أي حقول أخرى مطلوبة لمزوّد Databricks تظهر ضمن خطوات الإعداد.

   يستنتج ChatGPT نقطة نهاية Genie MCP المحلية لمساحة العمل، https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp، من اسم المضيف هذا. لا حاجة إلى نقطة نهاية MCP إقليمية منفصلة.

7. اختر متابعة.

يطلب ChatGPT النطاقات المُدخلة في النطاقات (اختياري) دون غيرها. ولا يضيف تلقائيًا نطاقات أوسع من القالب.

الاتصال والاختبار

أكمل اختبارات الاتصال وعمليات التحقّق من الوصول التالية، أيًّا كان مسار OAuth الذي تستخدمه.

1. راجع تفاصيل التطبيق وإجراءاته وإعدادات المصادقة.

2. إذا كنت مسؤول مساحة عمل مشتركة، ففعّل التطبيق لها وحدّد من يمكنه استخدامه وفقًا لسياستها.

3. ابدأ خطوات الاتصال من ChatGPT بحساب مستخدم اختباري مسموح له باستخدام التطبيق، ثم سجّل الدخول إلى Databricks.

4. تأكّد من أن المتصفح يفتح حساب Databricks أو مساحة العمل المتوقّعة.

5. راجع النطاقات المطلوبة، ثم حدّد تفويض.

   

6. تحقّق من أن المتصفح يعود إلى ChatGPT وأن التطبيق يظهر على أنه متصل.

7. نفّذ إجراء قراءة منخفض المخاطر يتوافق مع إمكانات الاتصال. لاتصال Genie، أرسل طلبًا إلى Genie بشأن بيانات يُسمح للمستخدم الاختباري بالوصول إليها. للإمكانات المدعومة الأخرى، اجلب معلومات المستخدم الحالي أو نفّذ استعلامًا على مورد Databricks SQL معتمد. تأكّد من أن المستخدم لديه أذونات موارد Databricks المطلوبة؛ فنطاقات OAuth وحدها لا تمنح الوصول إلى البيانات.

8. إذا كانت إجراءات الكتابة مُفعّلة، فاختبر سير عمل في Databricks تتأكّد من انخفاض مخاطره قبل إتاحة التطبيق على نطاق أوسع.

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

إدارة الوصول

يساهم كلٌّ من Databricks وChatGPT في التحكّم في الوصول.

في ChatGPT، يتحكّم مسؤولو مساحة العمل المشتركة في إتاحة التطبيق وكيفية استخدام الأعضاء له. في Business، يتحكّم المسؤولون في تفعيل التطبيق على مستوى مساحة العمل المشتركة بأكملها. راجع عناصر تحكّم المسؤول لتطبيقات Databricks (إعدادات مساحة العمل المشتركة > التطبيقات أو وحدة تحكّم المسؤول > المكونات الإضافية > إدارة التطبيقات القديمة) للاطّلاع على:

• وصول المستخدمين، لتحديد الأدوار التي يمكنها استخدام التطبيق في مساحات العمل المشتركة المدعومة في Enterprise وEdu.

• التحكّم في الإجراءات، لتحديد إجراءات Databricks المُفعّلة.

• أذونات التطبيق، لتحديد متى يطلب ChatGPT موافقة الأعضاء قبل استخدام التطبيق.

تنطبق أذونات التطبيق هذه على محادثات ChatGPT. يستخدم وكلاء مساحة العمل المشتركة عناصر تحكّم خاصة بكل وكيل يضبطها منشئه لتحديد إجراءات التطبيق المتاحة ومتى يُطلب من المستخدمين النهائيين الموافقة عليها. لمعرفة كيفية عمل الوكلاء، راجع: وكلاء مساحة العمل المشتركة في ChatGPT لخطتَي Enterprise وBusiness.

في Databricks، يحدّد المسؤولون المستخدمين الذين يمكنهم منح تفويض لتطبيق OAuth وموارد Databricks التي يمكن لهؤلاء المستخدمين الوصول إليها. تظل أذونات الموفّر سارية بعد تفعيل التطبيق في ChatGPT.

للتعرّف على التنقّل في مساحة العمل المشتركة والوصول إلى التطبيقات وعناصر التحكّم الخاصة بكل خطة، راجع: عناصر تحكّم المسؤول والأمان والامتثال في التطبيقات.

استكشاف مشكلات إعداد تطبيق Databricks وإصلاحها

• عدم تطابق URI لإعادة التوجيه: إذا كنت تستخدم عميل OAuth مخصّصًا، فتأكّد من أن قيمة عناوين URL لإعادة التوجيه في Databricks تطابق تمامًا عنوان URL للاستدعاء الراجع المعروض في ChatGPT، بما في ذلك المسار ومعرّف الاستدعاء الراجع. لا تحذف معرّف الاستدعاء الراجع، ولا تُضِف شرطة مائلة في النهاية، ولا تستبدل العنوان بعنوان URL آخر لإعادة التوجيه في ChatGPT.

• السرّ مفقود: إذا كنت تستخدم عميل OAuth مخصّصًا، فتذكّر أن Databricks يعرض الأسرار مرة واحدة فقط. أنشئ سرّ عميل جديدًا إذا لم تكن قد نسخته.

• تطبيق OAuth غير متاح فورًا: توضح Databricks أن معالجة تحديثات تطبيقات OAuth قد تستغرق ما يصل إلى 30 دقيقة.

• نطاق غير كافٍ أو غير متطابق: إذا كنت تستخدم عميل OAuth مخصّصًا، فقارن النطاقات (اختياري) في ChatGPT مع نطاقات الوصول في تطبيق OAuth على Databricks. يجب تفعيل كل نطاق يطلبه ChatGPT هناك. تأكّد من أن النطاقات تدعم نقطة النهاية والإمكانات التي تستخدمها.

  إذا كان اتصال جديد بـ Genie أو لوحات المعلومات يعرض ai-gateway وdashboards وoffline_access، فأبقِ هذه النطاقات في ChatGPT وتأكّد من أن تطبيق Databricks يسمح بها جميعًا. إذا كان التطبيق يسمح بنطاق all-apis فقط، فحدّثه أو أعِد إنشاءه ليسمح بالنطاقات الثلاثة المحدّدة.

  إذا لم تكن النطاقات المحدّدة متاحة، فاستخدم البديل الأوسع المدعوم: اضبط ChatGPT على all-apis وoffline_access، وتأكّد من أن تطبيق Databricks يسمح بكليهما. التطبيق الذي يسمح بنطاق all-apis فقط لا يتوافق مع طلب من ChatGPT للنطاقات ai-gateway وdashboards وoffline_access. الوصول المقتصر على SQL مناسب فقط لتطبيق يقتصر على واجهات Databricks SQL البرمجية؛ وهو لا يكفي لإجراءات Genie أو لوحات المعلومات.

• فشل إجراءات SQL: إذا كان التطبيق يقتصر على واجهات Databricks SQL البرمجية، فتحقّق من نطاق SQL وإعدادات المستودع وأذونات Databricks.

• مساحة العمل المشتركة في ChatGPT غير صحيحة: أنشئ التطبيق وفعّله في مساحة العمل المشتركة نفسها في ChatGPT التي سيستخدمها المستخدمون للاتصال به.

• حساب Databricks أو مساحة العمل غير صحيحين: تحقّق من قيمة اسم مضيف مساحة العمل (مطلوب)، ثم كرّر خطوات تسجيل الدخول وتأكّد من أن Databricks يفتح الحساب أو مساحة العمل المتوقّعة.

• يتعذّر على المستخدمين الاتصال: تأكّد من أن المستخدم لديه صلاحية الوصول إلى Databricks ويُسمح له بمنح تفويض لتطبيق OAuth. في Business، تأكّد من تفعيل التطبيق على مستوى مساحة العمل المشتركة بأكملها. في مساحات العمل المشتركة المدعومة في Enterprise وEdu، تأكّد أيضًا من أن إعداد وصول المستخدمين في ChatGPT يسمح باستخدام التطبيق.

• سياسة الشبكة في Databricks تحظر التطبيق: إذا كان Databricks يسمح بعناوين IP مصدر محدّدة فقط، فيجب على مسؤول Databricks تحديث قوائم الوصول لعناوين IP الخاصة بالحساب أو مساحة العمل المعنية، أو ضوابط الاتصالات الواردة المستندة إلى السياق، أو جدار الحماية، أو قواعد الشبكة الأخرى التي يتحكّم فيها العميل.

  • اسمح بالاتصالات الواردة من نطاقات عناوين IP الحالية للاتصالات الصادرة من تطبيقات ChatGPT.

  • اضبط قائمة السماح هذه في Databricks أو في طبقة الشبكة التي يتحكّم فيها العميل. وهي منفصلة عن قائمة السماح لعناوين IP الخاصة بمساحة العمل المشتركة في ChatGPT.

  • قد تتغيّر النطاقات المنشورة. اجعل التحديثات من ملف JSON تلقائية متى أمكن.

  • لا تستبدل سرّ العميل أو تغيّر نطاقات OAuth لمحاولة تجاوز حظر الشبكة. تحقّق أولًا مما إذا كان Databricks يرفض عناوين IP المصدر الخاصة بالتطبيق.

المراجع

• وثائق Databricks: المصادقة باستخدام OAuth من المستخدم إلى الجهاز

• وثائق Databricks: إدارة اتصالات تطبيقات OAuth

• وثائق Databricks: إدارة قوائم الوصول عبر IP