نظرة عامة

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

تكون القوالب مفيدة عندما تستطيع OpenAI توفير سلوك التطبيق المشترك، بينما يجب على كل مساحة عمل مشتركة توفير تكوين خاص بالموفّر. بحسب القالب، يمكن أن يتضمن هذا التكوين اسم مستأجر أو مضيف، أو بيانات اعتماد عميل OAuth، أو عناوين URL لمعاودة الاتصال، أو نطاقات، أو تفاصيل webhook، أو عناوين URL لخوادم MCP المُدارة، أو إعدادات أخرى للموفّر. على سبيل المثال، قد ينشئ قالب GitHub Enterprise الموصل المخصص لمساحة العمل المشتركة الذي يستخدمه Codex للوصول إلى مضيف GitHub Enterprise الخاص بتلك المؤسسة.

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

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

استخدم هذه المقالة للتدفق العام للقوالب. للإعداد الخاص بالموفّر، راجع:

• GitHub Enterprise

• Snowflake

• Databricks

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

تشمل الأمثلة الشائعة ما يلي:

• يتضمن عنوان URL للموفّر مستأجرًا أو حسابًا أو مؤسسة أو اسم مضيف لمساحة العمل المشتركة خاصًا بالشركة.

• تحتاج المؤسسة إلى إحضار عميل OAuth أو بيانات اعتماد الموفّر الخاصة بها.

• يتطلب الموفّر إعداد عنوان URL لمعاودة الاتصال خاصًا بالعميل.

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

كيف تختلف القوالب عنالتطبيقات العادية

يمكن عادةً تفعيل التطبيق العادي مباشرة. أما القالب فيبدأ بدلًا من ذلك تدفق إعداد لمسؤول مساحة العمل المشتركة.

التدفق المعتاد هو:

• يعثر مسؤول على قالب في إعدادات مساحة العمل المشتركة > التطبيقات > الدليل.

• يدخل المسؤول التكوين المطلوب والمخصص لمساحة العمل المشتركة.

• ينشئ ChatGPT مسودة تطبيق لمساحة العمل المشتركة.

• يراجع المسؤول المسودة وينشرها.

• يضبط المسؤول إعدادات الوصول والإجراءات للتطبيق المنشور.

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

العثور على قالب تطبيق وإعداده

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

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

• ابحث عن اسم الموفّر أو التطبيق.

• ابحث عن الإدخالات المعلّمة كقوالب.

• اختر تفعيل لبدء تدفق الإعداد.

يطلب تدفق الإعداد التفاصيل اللازمة لإنشاء التطبيق المخصص لمساحة العمل المشتركة. تعتمد الحقول الدقيقة على القالب.

على سبيل المثال، قد يطلب قالب GitHub Enterprise تفاصيل مثل:

• اسم التطبيق ووصفه.

• اسم مضيف GitHub Enterprise.

• تكوين عنوان URL لمعاودة الاتصال.

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

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

• النطاقات المطلوبة.

• تفاصيل إعداد webhook.

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

راجع التعليمات الخاصة بكل تطبيق:GitHub، وSnowflake، وDatabricks.

إعداد عميل OAuth

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

أدخل معرّف عميل OAuth وسره في ChatGPT فقط بعد التأكد من أن تكوين الموفّر يطابق تعليمات إعداد القالب.

إذا كان القالب يتضمن نطاقات افتراضية، فاحتفظ بالافتراضيات ما لم تراجع مؤسستك أذونات الموفّر ولديها سبب واضح لتغييرها.

إنشاء مسودة

بعد إدخال المعلومات المطلوبة، اختر إنشاء مسودة.

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

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

بعد النشر، أدر التطبيق المخصص لمساحة العمل المشتركة من إعدادات مساحة العمل المشتركة > التطبيقات > مفعّلة.

الفحوصات الموصى بها بعد النشر:

• تأكد من ظهور التطبيق في التطبيقات المفعّلة.

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

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

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

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

• إذا كان التطبيق يتطلب مصادقة لدى الموفّر، فاطلب من مستخدم الاختبار توصيل حسابه لدى الموفّر.

• شغّل مطالبة اختبار منخفضة المخاطر للتأكد من أن التطبيق يعمل كما هو متوقع.

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

إذا كان لا يمكن استخدام القالب إلا مرة واحدة

قد تنشئ بعض القوالب تطبيقًا واحدًا فقط لكل مساحة عمل مشتركة. إذا كان القالب قد استُخدم بالفعل، فقد لا يكون زر تفعيل متاحًا. في هذه الحالة، أدر المسودة الحالية أو التطبيق المنشور بدلًا من إنشاء تطبيق آخر من القالب نفسه.

ما يراه الأعضاء

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

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

تحقق مما يلي:

• تم نشر التطبيق.

• تم تفعيل التطبيق لمساحة العمل المشتركة.

• دور العضو في مساحة العمل المشتركة لديه صلاحية الوصول.

• العضو موجود في مساحة العمل المشتركة الصحيحة.

• لدى العضو الأذونات المطلوبة في الموفّر الخارجي.

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

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

إذا فشل الإعداد أو لم يظهر التطبيق، فتأكد مما يلي:

• اسم المضيف للمستأجر أو الحساب أو مساحة العمل المشتركة صحيح.

• تم نسخ عنوان URL لمعاودة الاتصال بدقة إلى تكوين الموفّر.

• معرّف عميل OAuth وسر العميل صحيحان.

• النطاقات المطلوبة تطابق ما يسمح به تطبيق OAuth لدى الموفّر.

• تم إنشاء مسودة.

• تم نشر المسودة.

• يتيح الوصول حسب الدور لمستخدم الاختبار رؤية التطبيق.

• تسمح الأذونات من جهة الموفّر بالبيانات أو الإجراء قيد الاختبار.

ملاحظات الأمان

• تعامل مع أسرار عميل OAuth وبيانات اعتماد الموفّر على أنها معلومات حساسة.

• راجع النطاقات المطلوبة قبل إنشاء المسودة.

• استخدم التحكم في الإجراءات بعد النشر للحد مما يمكن للتطبيق فعله.

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

• لاحظ أن أذونات الموفّر تظل سارية بعد تفعيل التطبيق في ChatGPT.