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

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

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

تم التحديث: 2 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 من إصدار رموز وصول خاصة بالتثبيت لتنفيذ عمليات المستودعات.

  • سر خطاف الويب وعنوان URL الخاص به لتمكين GitHub Enterprise من إرسال أحداث التثبيت والمستودعات إلى ChatGPT.

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

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

قبل البدء

تحتاج إلى:

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

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

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

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

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

أبقِ ChatGPT وGitHub Enterprise مفتوحين في علامتَي تبويب منفصلتين. لا تُنشئ عنوان URL لمعاودة الاتصال من عندك. انسخ عنوان URL لمعاودة الاتصال الظاهر في ChatGPT كما هو تمامًا.

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

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

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

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

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

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

  • سر خطاف الويب الذي يُولّده ChatGPT.

  • عنوان URL لخطاف الويب الذي يُولَّد بعد إنشاء مسودة التطبيق في ChatGPT.

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

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

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

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

  4. ابحث عن GitHub Enterprise.

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

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

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

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

  9. انسخ سر خطاف الويب المُولَّد إذا ظهر أثناء الإعداد.

مثال على عنوان 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 إذن الوصول إلى البيانات الوصفية.

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

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

  • Pull requests: للقراءة فقط، إذا كنت بحاجة إلى البحث عن pull request أو الاطّلاع على سياق المراجعة.

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

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

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

ولّد بيانات اعتماد تطبيق 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. ألصق المفتاح الخاص لتطبيق GitHub بصيغة PEM أو ارفعه في حقل المفتاح الخاص لتطبيق GitHub.

  7. تأكّد من وجود سر خطاف الويب المُولَّد.

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

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

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

أكمل إعداد خطاف الويب في GitHub Enterprise

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

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

  3. فعّل خيار خطافات الويب النشطة إذا لم يكن مفعّلًا بالفعل.

  4. ألصق عنوان URL لخطاف الويب من ChatGPT في حقل عنوان URL لخطاف الويب.

  5. ألصق سر خطاف الويب من ChatGPT في حقل سر خطاف الويب.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. نفّذ أولًا إجراء قراءة بسيطًا، مثل عرض قائمة المستودعات التي يمكنك الوصول إليها أو جلب pull request معروف.

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

اسم المضيف وآلية عمل OAuth

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

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

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

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

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

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

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

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

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

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

المراجع

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