OpenAI
هذه الصفحة مترجمة باستخدام الترجمة الآلية. تفضل بالاطّلاع على المقال الأصلي بالإنجليزية.

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

تعرّف على كيفية ربط Databricks باستخدام عميل OAuth الخاص بالمؤسسة، لمسؤولي مساحات عمل ChatGPT المشتركة ومستخدمي ChatGPT Plus أو Pro.

تم التحديث: yesterday

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

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

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

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

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

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

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

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

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

قبل البدء

تحتاج إلى ما يلي:

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

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

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

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

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

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

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

ملاحظة: يجب نسخ عنوان URL لمعاودة الاتصال الظاهر في ChatGPT بدقة.

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

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

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

  • سر عميل Databricks OAuth.

  • نطاقات وصول Databricks، مثل جميع واجهات API أو SQL.

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

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

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

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

  3. اختر Databricks Genie من الدليل.

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

  5. في مربع الحوار ربط Databricks Genie، ابحث عن قسم عميل OAuth.

  6. عنوان URL لمعاودة الاتصال من ChatGPT. اترك مربع الحوار هذا مفتوحًا.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

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

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

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

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

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

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

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

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

    Databricks Account Console Settings page showing the App connections tab and Add connection button.

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

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

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

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

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

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

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

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

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

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

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

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

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

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

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

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

  1. ارجع إلى مربع الحوار ربط Databricks Genie.

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

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

  4. في النطاقات (اختياري)، احتفظ بالنطاقين all-apis وoffline_access للوصول العام إلى واجهة API.

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

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

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

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

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

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

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

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

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

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

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

    Databricks permission request for a mock ChatGPT Databricks Connector showing requested access and the Authorize button.

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

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

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

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

إدارة الوصول

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

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

  • وصول المستخدم، لتحديد أدوار مساحة العمل التي يمكنها استخدام الموصل.

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

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

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

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

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

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

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

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

  • النطاق غير كافٍ أو غير متطابق: قارن النطاقات (اختياري) في ChatGPT مع نطاقات الوصول في تطبيق Databricks OAuth. يجب تمكين كل نطاق يطلبه ChatGPT هناك. بالنسبة إلى واجهات API بخلاف SQL، تأكد من تمكين all-apis في Databricks وبقائه في قائمة نطاقات ChatGPT.

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

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

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

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

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

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

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

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

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

المراجع

هل كانت هذه المقالة مفيدة؟