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

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

ما الذي تقوم بإعداده

أنت تنشئ تطبيق Databricks خاصًا بمساحة العمل المشتركة في ChatGPT. يستخدم التطبيق:

• اتصال تطبيق Databricks OAuth تم إنشاؤه في وحدة تحكم حساب Databricks لديك.

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

• عنوان URL الدقيق لمعاودة الاتصال المنسوخ من ChatGPT.

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

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

قبل أن تبدأ

تحتاج إلى:

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

• وصول مسؤول حساب Databricks. قد يكون وصول مسؤول مساحة العمل المشتركة كافيًا لبعض المهام، لكن اتصالات التطبيقات المخصصة تُضبط من وحدة تحكم حساب Databricks.

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

• افتح شاشة إعداد قالب تطبيق Databricks في ChatGPT حتى تتمكن من نسخ عنوان URL الدقيق لمعاودة الاتصال.

• اتخذ قرارًا بشأن ما إذا كان التطبيق يحتاج إلى وصول عام إلى واجهة برمجة تطبيقات Databricks أم إلى وصول Databricks SQL فقط.

• مكان آمن للتعامل مع سر عميل Databricks.

لا تخترع عنوان URL لمعاودة الاتصال. انسخ عنوان URL الدقيق لمعاودة الاتصال المعروض في ChatGPT.

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

• عنوان URL لمعاودة الاتصال: انسخه من تدفّق إعداد قالب ChatGPT.

• معرّف عميل Databricks OAuth.

• سر عميل Databricks OAuth.

• نطاقات وصول Databricks، مثل ALL APIs أو SQL.

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

نشر التطبيق وإدارته في ChatGPT

إنشاء مسودة التطبيق لا يجعلها متاحة للأعضاء تلقائيًا. بعد مراجعة المسودة:

1. انشر مسودة التطبيق.

2. تأكّد من ظهور التطبيق في إعدادات مساحة العمل المشتركة > التطبيقات > مفعّلة.

3. اضبط وصول المستخدمين للأدوار التي ينبغي أن تستخدمه.

4. راجع التحكم في الإجراءات لإجراءات Databricks التي يتيحها التطبيق.

5. راجع أذونات التطبيق لاختيار متى يطلب ChatGPT من الأعضاء الإذن قبل استخدام التطبيق.

6. اطلب من مستخدم اختبار مسموح له فتح التطبيقات في ChatGPT والتأكد من ظهور التطبيق.

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

بدء إعداد القالب في ChatGPT

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

2. افتح إعدادات مساحة العمل المشتركة > التطبيقات.

3. اختر الدليل.

4. ابحث عن Databricks.

5. اختر قالب تطبيق Databricks وابدأ الإعداد.

6. أدخل اسمًا ووصفًا واضحين للتطبيق، مثل Databricks أو Databricks - Data Platform.

7. في قسم عميل OAuth، انسخ عنوان URL لمعاودة الاتصال من ChatGPT. أبقِ علامة التبويب هذه مفتوحة.

مثال على عنوان URL لمعاودة الاتصال: https://chatgpt.com/connector/oauth/<callback_id>

لا تُزل معرّف معاودة الاتصال، أو تضف شرطة مائلة في النهاية، أو تستبدله بعنوان URL عام لـ ChatGPT.

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

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

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

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

4. اختر إضافة اتصال.

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

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

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

8. استخدم ALL APIs لتطبيق Databricks عام يحتاج إلى واجهات برمجة تطبيقات Databricks إلى جانب SQL.

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

10. اترك مدد صلاحية الرموز وفق الإعدادات الافتراضية في Databricks ما لم تكن لدى مؤسستك سياسة محددة.

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

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

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

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

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

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

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

إكمال الإعداد في ChatGPT

1. ارجع إلى علامة تبويب إعداد قالب ChatGPT.

2. الصق معرّف عميل Databricks في معرّف عميل OAuth.

3. الصق سر عميل Databricks في سر عميل OAuth.

4. اترك النطاقات من دون تغيير ما لم تكن بحاجة عن قصد إلى تجاوز الإعدادات الافتراضية للقالب.

5. املأ أي حقول لموفر Databricks يتطلبها تدفّق الإعداد، مثل مضيف مساحة العمل المشتركة أو مضيف الحساب أو معرّف الحساب أو المستودع أو قيم أخرى خاصة بـ Databricks.

6. أنشئ مسودة التطبيق.

اختبار التطبيق كمستخدم

1. ابدأ تدفّق الاتصال من ChatGPT كمستخدم اختبار مسموح له.

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

3. وافق على النطاقات المطلوبة.

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

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

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

إدارة الوصول

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

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

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

استكشاف الأخطاء وإصلاحها

• عدم تطابق URI لإعادة التوجيه: تأكّد من أن عنوان URL لإعادة التوجيه في Databricks يطابق تمامًا عنوان URL لمعاودة الاتصال المعروض في ChatGPT، بما في ذلك المسار ومعرّف معاودة الاتصال.

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

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

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

• فشل إجراءات SQL: تأكّد من نطاق SQL، وإعداد المستودع، وأذونات Databricks.

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

• يتعذر على المستخدمين الاتصال: تأكّد من أن المستخدم لديه وصول إلى Databricks ومسموح له بتفويض تطبيق OAuth.

المراجع

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

• مستندات Databricks: إدارة اتصالات تطبيق OAuth