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

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

تعرّف على كيفية ضبط مسؤولي مساحة العمل المشتركة لقالب تطبيق GitHub Enterprise في ChatGPT باستخدام تطبيق GitHub الخاص بمؤسستهم.

تم التحديث: 7 days ago

نظرة عامة

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

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

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

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

  • تطبيق GitHub مسجّل على مضيف GitHub Enterprise لديك.

  • معرّف عميل تطبيق GitHub وسر العميل لتفويض المستخدم عبر OAuth.

  • المفتاح الخاص لتطبيق GitHub كي يتمكن ChatGPT من إصدار رموز تثبيت لعمليات المستودع.

  • سر webhook وعنوان URL لـ webhook حتى يتمكن GitHub Enterprise من إرسال أحداث التثبيت والمستودع مرة أخرى إلى ChatGPT.

  • اسم مضيف GitHub Enterprise، مثل github.example.com.

أنشئ تطبيق GitHub، وليس تطبيق GitHub OAuth مستقلًا. يتطلب إعداد قالب ChatGPT بيانات اعتماد تطبيق GitHub ومفتاحًا خاصًا وإعدادات webhook.

قبل أن تبدأ

تحتاج إلى:

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

  • وصول مسؤول GitHub Enterprise أو مالك مؤسسة يمكنه إنشاء تطبيقات GitHub وتثبيتها.

  • اسم مضيف GitHub Enterprise فقط، دون https:// أو مسار.

  • قرار بشأن إجراءات المستودع التي يجب أن يدعمها ChatGPT، مثل البحث في المستودعات للقراءة فقط، أو سير عمل طلبات السحب، أو سير عمل المشكلات، أو تعديلات الملفات، أو GitHub Actions، أو سير عمل Codex الأوسع.

  • مكان آمن للتعامل مع المفتاح الخاص وسر العميل لتطبيق GitHub.

أبقِ ChatGPT وGitHub Enterprise مفتوحين في علامتي تبويب منفصلتين. لا تخترع عنوان URL لمعاودة الاتصال. انسخ عنوان URL لمعاودة الاتصال الدقيق المعروض في ChatGPT.

القيم التي يجب تحضيرها

  • اسم مضيف GitHub Enterprise: على سبيل المثال، github.example.com.

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

  • معرّف عميل تطبيق GitHub.

  • سر عميل تطبيق GitHub.

  • PEM للمفتاح الخاص بتطبيق GitHub.

  • سر webhook الذي أنشأه ChatGPT.

  • عنوان URL لـ webhook الذي يتم إنشاؤه بعد إنشاء التطبيق المسودة في ChatGPT.

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

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

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

  3. حدد الدليل.

  4. ابحث عن GitHub Enterprise.

  5. حدد قالب تطبيق GitHub Enterprise وابدأ الإعداد.

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

  7. أدخل اسم مضيف GitHub Enterprise، مثل github.example.com.

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

  9. انسخ سر webhook المُنشأ إذا عُرض أثناء الإعداد.

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

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

أنشئ تطبيق GitHub في GitHub Enterprise

  1. افتح مضيف GitHub Enterprise لديك، مثل https://github.example.com.

  2. انتقل إلى المؤسسة أو الحساب الذي يجب أن يملك التطبيق.

  3. افتح الإعدادات > إعدادات المطور > تطبيقات GitHub.

  4. حدد تطبيق GitHub جديد.

  5. أدخل اسمًا واضحًا للتطبيق، مثل موصل ChatGPT GitHub Enterprise.

  6. أدخل عنوان URL للصفحة الرئيسية. إذا لم تكن هناك صفحة داخلية مخصصة، فاستخدم عنوان URL لمؤسسة GitHub Enterprise.

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

  8. أبقِ خيار انتهاء صلاحية رموز تفويض المستخدم مفعّلًا ما لم يكن لدى فريق الأمان سبب محدد لتغييره.

  9. فعّل طلب تفويض المستخدم أثناء التثبيت ليتمكن المستخدمون من تفويض التطبيق أثناء مسار التثبيت أو الاتصال.

  10. ضمن أين يمكن تثبيت تطبيق GitHub هذا؟، اختر أضيق خيار يناسب طرحك.

  11. أنشئ تطبيق GitHub.

اضبط الأذونات والأحداث

اختر الحد الأدنى من الأذونات المطلوبة لإجراءات ChatGPT التي تخطط لتمكينها.

لاكتشاف المستودعات وطرح الأسئلة والأجوبة للقراءة فقط، ابدأ بأذونات قراءة مثل:

  • البيانات الوصفية: قراءة فقط. يتطلب GitHub البيانات الوصفية لتطبيقات GitHub.

  • المحتويات: قراءة فقط، للوصول إلى محتوى الملفات والمستودعات.

  • المشكلات: قراءة فقط، إذا كان البحث في المشكلات أو قراءتها مطلوبًا.

  • طلبات السحب: قراءة فقط، إذا كان البحث في طلبات السحب أو سياق المراجعة مطلوبًا.

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

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

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

أنشئ بيانات اعتماد تطبيق GitHub وانسخها

  1. في إعدادات تطبيق GitHub، انسخ معرّف العميل.

  2. أنشئ سر العميل وانسخه فورًا.

  3. ضمن المفاتيح الخاصة، أنشئ مفتاحًا خاصًا.

  4. نزّل ملف .pem وخزّنه بأمان.

  5. افتح ملف .pem محليًا وانسخ نص PEM الكامل، بما في ذلك سطرا البداية والنهاية.

المفتاح الخاص حساس. عامله مثل بيانات اعتماد. إذا انكشف، فأنشئ مفتاحًا خاصًا جديدًا، وحدّث إعداد تطبيق ChatGPT، واحذف المفتاح المخترق في GitHub Enterprise.

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

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

  2. الصق معرّف عميل تطبيق GitHub في معرّف عميل OAuth.

  3. الصق سر عميل تطبيق GitHub في سر عميل OAuth.

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

  5. تأكد من أن اسم مضيف GitHub Enterprise هو اسم المضيف فقط، مثل github.example.com.

  6. الصق أو حمّل PEM للمفتاح الخاص بتطبيق GitHub في المفتاح الخاص بتطبيق GitHub.

  7. تأكد من وجود سر webhook المُنشأ.

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

  9. افتح تفاصيل التطبيق المسودة المُنشأ في ChatGPT وانسخ عنوان URL لـ webhook المُنشأ.

يجب أن يبدو عنوان URL لـ webhook هكذا: https://connectors.api.openai.org/connectors/<connector_id>/webhook

أكمِل إعداد webhook في GitHub Enterprise

  1. ارجع إلى إعدادات تطبيق GitHub في GitHub Enterprise.

  2. افتح الإعدادات العامة لتطبيق GitHub.

  3. فعّل webhooks النشطة إذا لم تكن مفعّلة بالفعل.

  4. الصق عنوان URL لـ webhook الخاص بـ ChatGPT في عنوان URL لـ Webhook.

  5. الصق سر webhook الخاص بـ ChatGPT في سر Webhook.

  6. أبقِ التحقق من SSL مفعّلًا.

  7. تأكد من أن أحداث webhook المشترك فيها تطابق الأذونات والإجراءات التي مكّنتها.

  8. احفظ التغييرات.

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

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

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

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

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

  4. راجع التحكم في الإجراءات لإجراءات القراءة والكتابة.

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

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

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

ثبّت تطبيق GitHub واختبره

  1. في GitHub Enterprise، ثبّت تطبيق GitHub على المؤسسة أو الحساب.

  2. اختر كل المستودعات أو مستودعات محددة وفقًا لسياسة مساحة العمل المشتركة.

  3. ابدأ مسار الاتصال من ChatGPT كمستخدم مسموح له.

  4. فوّض تطبيق GitHub عند مطالبتك بذلك.

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

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

اسم المضيف وسلوك OAuth

يستخدم ChatGPT اسم المضيف لاشتقاق نقاط نهاية GitHub Enterprise. أدخل المضيف فقط، مثل github.example.com أو octocorp.ghe.com.

لا تدخل مسار API أو مسار مستودع أو github.com ما لم يكن ذلك هو مضيف GitHub Enterprise الدقيق لهذا التطبيق.

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

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

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

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

  • تعيد API الخطأ 403 أو أذونات غير كافية: أضف إذن تطبيق GitHub المفقود واطلب من مالك التثبيت الموافقة على الأذونات المحدّثة إذا طُلب ذلك.

  • لا تظهر أي مستودعات: تأكد من أن تثبيت التطبيق يتضمن المستودعات المتوقعة وأن المستخدم الذي يجري التفويض في ChatGPT لديه وصول إليها.

  • تفشل عمليات تسليم webhook: تأكد من أن عنوان URL لـ webhook وسر webhook يطابقان القيم من ChatGPT، وأبقِ التحقق من SSL مفعّلًا، وتأكد من أن مضيف GitHub Enterprise يمكنه الوصول إلى connectors.api.openai.org.

  • أخطاء المفتاح الخاص: تأكد من نسخ محتوى PEM الكامل، بما في ذلك سطرا البداية والنهاية.

المراجع

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