إعداد قالب تطبيق 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 Plus أو Pro.

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

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

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

• تحديد ما إذا كان التطبيق يحتاج إلى وصول عام إلى واجهات API في Databricks أم إلى Databricks SQL فقط.

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

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

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

القيم التي ينبغي تجهيزها

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

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

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

• نطاقات صلاحيات الوصول في Databricks المناسبة لإمكانات التطبيق، مثل جميع واجهات API أو SQL، عند استخدام عميل OAuth مخصّص.

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

OAuth المدمج

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

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

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

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

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

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

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

عميل OAuth مخصّص

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

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

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

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

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

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

5. في مربع حوار الاتصال بـ Databricks Genie، ابحث عن قسم عميل 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. أدخل اسمًا للتطبيق، مثل موصّل Databricks لـ ChatGPT.

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

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

8. استخدم جميع واجهات API لتطبيق Databricks عام يحتاج إلى واجهات API في Databricks تتجاوز SQL.

9. استخدم SQL فقط إذا كان التطبيق يقتصر على واجهات API الخاصة بـ Databricks SQL.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

7. نفّذ أولًا إجراء قراءة منخفض المخاطر، مثل جلب معلومات المستخدم الحالي أو الاستعلام عن مورد Databricks SQL معتمد.

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 هناك. تأكد من أن نطاقات الصلاحيات تدعم نقطة النهاية والإمكانات التي تستخدمها، بما في ذلك الوصول العام إلى واجهات API أو الوصول إلى SQL فقط، حسب الحاجة.

• فشل إجراءات 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