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

يسري كل مفتاح مشرف على مساحة عمل مشتركة واحدة في ChatGPT. ولا يمنح إمكانية الوصول إلى مساحات عمل مشتركة أخرى أو الإدارة على مستوى المستأجر أو مؤسسات منصّة الـ API أو حسابات الإعلانات أو النماذج أو استدلال النماذج.

للمساعدة في تحديد المستأجر أو مساحة العمل المشتركة، راجع: إدارة المستأجر في وحدة تحكم المشرف.

التحقق من توفر مساحة العمل المشتركة وإمكانية الوصول إليها

تتوفر مفاتيح المشرف لمساحات عمل ChatGPT المشتركة المُدارة والمؤهلة، ومنها مساحات عمل ChatGPT Enterprise وChatGPT Edu وChatGPT للرعاية الصحية. يجب أن تتمتع بدور المالك أو المشرف في مساحة العمل المشتركة المحددة التي تريد إدارتها.

تعتمد إمكانية الوصول على دور المالك أو المشرف المعيّن في مساحة عمل ChatGPT المشتركة المحددة. لا يكفي أن تكون مشرفًا عامًا أو مالكًا لمؤسسة في منصّة الـ API أو مستخدمًا له دور مخصّص في مساحة العمل المشتركة للحصول على إمكانية الوصول إلى مفاتيح المشرف.

للاطلاع على تفاصيل الأدوار المضمّنة في مساحة العمل المشتركة، راجع: إدارة الأعضاء وأنواع المقاعد والأدوار وإمكانية الوصول في ChatGPT Enterprise.

فهم صلاحيات الوصول حسب الدور

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

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

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

اختيار أذونات مفتاح المشرف

إعدادات الأذونات المسبقة للمالك

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

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

• يمنح خيار للقراءة فقط أذونات القراءة فقط المتاحة لمساحة العمل المشتركة المحددة.

• يتيح لك خيار مخصّص اختيار مستوى الوصول المتاح لكل فئة أذونات.

أذونات المشرف حسب الفئة

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

بحسب مساحة عملك المشتركة، قد تشمل الفئات المتاحة التطبيقات وحدود الاستخدام وإدارة المجموعات والمستخدمين والدعوات وواجهة API لتحليلات Codex وواجهة API لتحليلات Enterprise وتحليلات مساحة العمل المشتركة والتكاليف وحسابات الخدمة. لا تدعم بعض الفئات سوى القراءة أو الكتابة، ولا تظهر فئات أخرى إلا عند توفر الميزة المرتبطة بها.

تشمل تعيينات الأذونات الشائعة ما يلي:

• واجهة API لتحليلات Codex > قراءة: codex.enterprise.analytics.read.

• حدود الاستخدام > قراءة: chatgpt.enterprise.usage_limit.read.

• حدود الاستخدام > كتابة: chatgpt.enterprise.usage_limit.write وchatgpt.enterprise.usage_limit.read.

• المستخدمون > قراءة: chatgpt.enterprise.user.read، حيثما كان متاحًا.

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

إنشاء مفتاح مشرف

1. سجّل الدخول إلى وحدة تحكم المشرف.

2. حدّد المستأجر عند الحاجة، ثم حدّد مساحة عمل ChatGPT المشتركة التي تتمتع فيها بدور المالك أو المشرف.

3. افتح بيانات الاعتماد، ثم حدّد مفاتيح المشرف.

4. حدّد إنشاء مفتاح مشرف جديد وأدخل اسمًا وصفيًا.

5. اختر مدة انتهاء الصلاحية: أبدًا أو 30 يومًا أو 60 يومًا أو 90 يومًا أو مخصّصة. يمكن أن تتراوح مدة انتهاء الصلاحية المخصّصة بين يوم واحد و365 يومًا.

6. اختر الأذونات التي يحتاج إليها تكاملك. يمكن لمالكي مساحة العمل المشتركة تحديد الكل أو للقراءة فقط أو مخصّص؛ أما مشرفوها فيحددون الإذن المتاح لكل فئة.

7. حدّد إرسال، ثم انسخ الرمز السري وخزّنه بأمان. لن تتمكن من عرض الرمز السري مرة أخرى.

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

مراجعة مفتاح مشرف أو تعديله أو إلغاؤه

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

• لتغيير اسم مفتاح أو أذوناته، افتح قائمة مزيد من الخيارات (•••)، وحدّد تعديل، وأجرِ تغييراتك، ثم حدّد حفظ التغييرات.

• لإيقاف استخدام مفتاح، افتح قائمة مزيد من الخيارات (•••)، وحدّد إلغاء، ثم أكّد باستخدام إلغاء مفتاح المشرف.

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

تتوقف المفاتيح الملغاة عن العمل بعد سريان التغيير. أنشئ مفتاحًا بديلًا وحدّث أي عمليات تكامل متأثرة قبل إلغاء مفتاح لا يزال قيد الاستخدام.

فهم الامتثال والبيانات الحساسة

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

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

للحصول على معلومات حول واجهات API للامتثال والوصول إلى البيانات، راجع: منصة الامتثال من OpenAI لعملاء Enterprise وEdu.

تستخدم طلبات واجهة API لمشرف مساحة عمل ChatGPT المشتركة العنوان https://api.chatgpt.com/v1. على سبيل المثال، استخدم /manage/workspaces/{workspace_id}/users لعرض أعضاء مساحة العمل المشتركة الحاليين. تدير نقاط النهاية ضمن /v1/organization/ مؤسسات منصّة الـ API، وتتطلب مفتاح مشرف خاصًا بمؤسسة في منصّة الـ API.

للاطلاع على مسارات نقاط النهاية ومخططات الطلبات والاستجابات والنطاقات المطلوبة، راجع مرجع واجهة API للمشرف.

التمييز بين مفاتيح المشرف وبيانات الاعتماد الأخرى

• تُستخدم مفاتيح مشرف مساحة العمل المشتركة لمصادقة واجهات API المدعومة لإدارة ChatGPT وCodex لمساحة عمل ChatGPT مشتركة واحدة. ولا تمنح إمكانية الوصول إلى استدلال النماذج.

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

• تُدار مفاتيح مشرف مؤسسات منصّة الـ API بصورة منفصلة في منصّة الـ API، ولا تدير مساحات عمل ChatGPT المشتركة.

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

استكشاف مشكلات الوصول والأذونات المفقودة وإصلاحها

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

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

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

• إذا كانت إحدى فئات الأذونات مفقودة، فتأكد من توفر الميزة في مساحة العمل المشتركة المحددة ومن أن دورك يسمح بالوصول إليها. إذا ظلت الفئة المطلوبة غير متاحة، فتواصل مع دعم OpenAI بدلًا من تحديد إذن لا صلة له بها.

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

• إذا توقف مفتاح كان يعمل سابقًا، فتحقق من حالته وانتهاء صلاحيته، وتأكد من أنه لم تنتهِ صلاحيته ولم يُلغَ، وتحقق من أن منشئه لا يزال يتمتع بدور نشط في مساحة العمل المشتركة وبالأذونات المطلوبة.

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

حماية مفاتيح المشرف

• اختر أذونات مخصّصة ولا تمنح سوى إمكانية الوصول التي يحتاج إليها تكاملك.

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

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

• خزّن الرموز السرية في أداة آمنة لإدارة الأسرار. لا ترسلها مطلقًا عبر البريد الإلكتروني أو الدردشة أو طلب دعم.

• راجع الاستخدام وانتهاء الصلاحية بانتظام، وألغِ المفاتيح التي لم تعد بحاجة إليها.