تتيح مفاتيح المشرف لمالكي مساحات العمل المشتركة ومشرفيها المصرح لهم ربط الأدوات والخدمات بواجهات API المدعومة لإدارة ChatGPT وCodex. بحسب مساحة العمل المشتركة والأذونات التي تحددها، يمكن للمفتاح دعم التحليلات وإدارة المستخدمين والمجموعات والدعوات وحدود الاستخدام وسجلات الامتثال والنشاط أو إدارة حسابات الخدمة.
ينطبق كل مفتاح مشرف على مساحة عمل مشتركة واحدة في ChatGPT. ولا يمنح الوصول إلى مساحات عمل مشتركة أخرى أو إدارة المستأجر بالكامل أو مؤسسات منصّة الـ API أو حسابات الإعلانات أو النماذج أو استدلال النماذج.
للمساعدة في اختيار المستأجر أو مساحة العمل المشتركة، راجع: إدارة المستأجر في وحدة تحكم المشرف.
التحقق من توفر مساحة العمل المشتركة وإمكانية الوصول إليها
تتوفر مفاتيح المشرف لمساحات العمل المشتركة المُدارة والمؤهلة على ChatGPT، بما فيها مساحات ChatGPT Enterprise وChatGPT Edu وChatGPT للرعاية الصحية. يجب أن يكون لديك دور المالك أو المشرف في مساحة العمل المشتركة المحددة التي تريد إدارتها.
تعتمد إمكانية الوصول على دور المالك أو المشرف المعيّن في مساحة عمل ChatGPT المشتركة المحددة. لا يكفي أن تكون مشرفًا عامًا أو مالك مؤسسة على منصّة الـ API أو مستخدمًا بدور مخصص في مساحة العمل المشتركة للحصول على صلاحية استخدام مفاتيح المشرف.
للتعرف على الأدوار المضمنة في مساحة العمل المشتركة، راجع: إدارة الأعضاء وأدوار مساحة العمل المشتركة والمقاعد.
فهم صلاحيات الوصول حسب الدور
يمكن لمالكي مساحة العمل المشتركة إنشاء مفاتيح بأذونات الكل أو للقراءة فقط أو مخصص. ويمكنهم تعديل أي مفتاح مشرف في مساحة العمل المشتركة أو إلغاؤه.
ينشئ مشرفو مساحة العمل المشتركة مفاتيح بنطاقات مخصصة عبر اختيار مستوى الوصول المتاح لكل فئة أذونات. يُصنّف المفتاح الناتج بأنه مخصص. ولا يمكنهم تعديل سوى المفاتيح التي أنشؤوها أو إلغائها، وفقط عندما تكون أذونات المفتاح متاحة لدورهم الحالي.
لا يمكن للمشرفين العامين الذين لا يشغلون دور المالك أو المشرف في مساحة العمل المشتركة المحددة إنشاء مفاتيح المشرف الخاصة بها أو إدارتها.
اختيار أذونات مفتاح المشرف
إعدادات الأذونات المسبقة للمالكين
يمكن لمالكي مساحة العمل المشتركة اختيار أحد إعدادات الأذونات المسبقة التالية:
يمنح الخيار الكل أذونات المشرف المتاحة لمساحة العمل المشتركة المحددة، بما فيها الأذونات المخصصة للمالكين فقط عند توفرها.
يمنح الخيار للقراءة فقط أذونات القراءة فقط المتاحة لمساحة العمل المشتركة المحددة.
يتيح لك الخيار مخصص اختيار مستوى الوصول المتاح لكل فئة أذونات.
أذونات المشرف حسب الفئة
لا يظهر لمشرفي مساحة العمل المشتركة محدد الإعدادات المسبقة الكل أو للقراءة فقط أو مخصص. ضمن الأذونات، يختارون لا شيء أو قراءة أو كتابة لكل فئة متاحة. يُصنّف المفتاح الناتج بأنه مخصص.
قد تشمل الفئات المتاحة، بحسب مساحة العمل المشتركة، التطبيقات وحدود الاستخدام وإدارة المجموعات والمستخدمين والدعوات وواجهة API لتحليلات Codex وواجهة API لتحليلات المؤسسات وتحليلات مساحة العمل المشتركة والتكاليف وحسابات الخدمة. لا تدعم بعض الفئات سوى القراءة أو الكتابة، ولا يظهر بعضها إلا عند توفر الميزة المرتبطة بها.
تشمل تعيينات الأذونات الشائعة ما يلي:
واجهة 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، عند توفره.
لا تتوفر أذونات الامتثال الشاملة ورسائل المحادثة والأدوار والأذونات إلا لمالكي مساحة العمل المشتركة، عند دعمها. قد يظل بإمكان مشرفي مساحة العمل المشتركة تحديد فئات منفردة من سجلات النشاط، مثل سجلات التدقيق أو المصادقة.
أذونات إدارة المجموعات
لإنشاء مجموعات أو تحديثها أو حذفها باستخدام واجهة API لإدارة المجموعات في مساحة عمل مشتركة مؤهلة على ChatGPT، استخدم مفتاح مشرف خاصًا بتلك المساحة.
راجع إدارة المجموعات عند اختيار أذونات المفتاح، وامنح الأذونات التي تتطلبها نقطة النهاية. لا يسمح مفتاح القراءة فقط بإجراء تغييرات على المجموعات.
لا يمنح تعيين الشخص مديرًا للمجموعة وحده إذنًا بإنشاء مفاتيح المشرف أو استخدام واجهة API لإدارة المجموعات. لا يمكن إنشاء مفاتيح المشرف إلا لمالكي مساحة العمل المشتركة ومشرفيها؛ وتتطلب طلبات API مفتاحًا يحمل الأذونات اللازمة.
للتعرف على إدارة المجموعات المفوضة، راجع: إدارة المجموعات ومديري المجموعات.
للاطلاع على مسارات نقاط النهاية والعمليات المدعومة وحقول الطلب والنطاقات المطلوبة، راجع مرجع واجهة Admin API. أدِر المجموعات المتزامنة من خلال سير عمل SCIM لدى موفر الهوية. للحصول على إرشادات المزامنة، راجع: توفير SCIM وإدارته.
إنشاء مفتاح مشرف
سجّل الدخول إلى وحدة تحكم المشرف.
حدد المستأجر عند الحاجة، ثم حدد مساحة عمل ChatGPT المشتركة التي لديك فيها دور المالك أو المشرف.
افتح بيانات الاعتماد، ثم حدد مفاتيح المشرف.
حدد إنشاء مفتاح مشرف جديد وأدخل اسمًا وصفيًا.
اختر مدة انتهاء الصلاحية: أبدًا أو 30 يومًا أو 60 يومًا أو 90 يومًا أو مخصصة. يمكن أن تتراوح مدة انتهاء الصلاحية المخصصة بين يوم واحد و365 يومًا.
اختر الأذونات التي يحتاج إليها تكاملك. يمكن لمالكي مساحة العمل المشتركة تحديد الكل أو للقراءة فقط أو مخصص؛ أما المشرفون فيحددون الإذن المتاح لكل فئة.
حدد إرسال، ثم انسخ السر وخزّنه بأمان. لن تتمكن من عرض السر مرة أخرى.
قد تكون أذونات مفاتيح مالكي مساحة العمل المشتركة مضبوطة افتراضيًا على الكل، وقد تكون مدة انتهاء الصلاحية مضبوطة افتراضيًا على أبدًا. راجع الإعدادين قبل إنشاء المفتاح.
مراجعة مفتاح المشرف أو تعديله أو إلغاؤه
افتح مساحة عمل ChatGPT المشتركة في وحدة تحكم المشرف، ثم انتقل إلى بيانات الاعتماد > مفاتيح المشرف. راجع اسم كل مفتاح وحالته ومعرّف التتبع والسر المحجوب والمنشئ والأذونات وتاريخ آخر استخدام وانتهاء الصلاحية.
لتغيير اسم مفتاح أو أذوناته، افتح قائمة المزيد من الخيارات (•••)، وحدد تعديل، وأجرِ تغييراتك، ثم حدد حفظ التغييرات.
لإيقاف استخدام مفتاح، افتح قائمة المزيد من الخيارات (•••)، وحدد إلغاء، ثم أكد باستخدام إلغاء مفتاح المشرف.
يمكن لمالكي مساحة العمل المشتركة تعديل أي مفتاح خاص بالمساحة المحددة أو إلغاؤه. لا يمكن لمشرفي مساحة العمل المشتركة تعديل سوى المفاتيح التي أنشؤوها أو إلغائها، وفقط عندما تكون أذونات المفتاح متاحة لدورهم الحالي. اطلب من مالك مساحة العمل المشتركة إدارة المفاتيح ذات الأذونات المخصصة للمالكين فقط. لا يمكن تغيير تواريخ انتهاء الصلاحية الحالية.
تتوقف المفاتيح الملغاة عن العمل بعد سريان التغيير. أنشئ مفتاحًا بديلًا وحدّث أي عمليات تكامل متأثرة قبل إلغاء مفتاح لا يزال قيد الاستخدام.
فهم الامتثال والبيانات الحساسة
قد تكشف بعض أذونات مفتاح المشرف نشاطًا أو محتوى حساسًا في مساحة العمل المشتركة. لا يمكن إلا لمالكي مساحة العمل المشتركة منح صلاحية امتثال شاملة أو صلاحية الوصول إلى رسائل المحادثة.
قد يستطيع مشرفو مساحة العمل المشتركة منح صلاحية الوصول إلى فئات منفردة ومدعومة من السجلات، ومنها سجلات التدقيق أو المصادقة أو التطبيقات. راجع كل فئة بعناية؛ إذ قد تظل السجلات المنفردة محتوية على معلومات حساسة.
للتعرف على واجهات API الخاصة بالامتثال والوصول إلى البيانات، راجع: منصة الامتثال من OpenAI لعملاء Enterprise وEdu.
تستخدم طلبات واجهة Admin API لمساحة عمل ChatGPT المشتركة العنوان https://api.chatgpt.com/v1. على سبيل المثال، استخدم /manage/workspaces/{workspace_id}/users لعرض أعضاء مساحة العمل المشتركة الحاليين. تدير نقاط النهاية ضمن /v1/organization/ مؤسسات منصّة الـ API، وتتطلب مفتاح مشرف لمؤسسة على منصّة الـ API.
للاطلاع على مسارات نقاط النهاية ومخططات الطلبات والاستجابات والنطاقات المطلوبة، راجع مرجع واجهة Admin API.
تمييز مفاتيح المشرف عن بيانات الاعتماد الأخرى
تُستخدم مفاتيح مشرف مساحة العمل المشتركة لمصادقة واجهات API المدعومة لإدارة ChatGPT وCodex في مساحة عمل ChatGPT مشتركة واحدة. ولا تمنح الوصول إلى استدلال النماذج.
تُستخدم رموز وصول حسابات خدمة Codex لمصادقة هوية غير بشرية في مساحة العمل المشتركة بهدف أتمتة Codex. ولا تصادق على طلبات واجهة Admin API. للحصول على إرشادات الإعداد، راجع: إنشاء حسابات خدمة Codex وإدارتها.
تُدار مفاتيح مشرف مؤسسات منصّة الـ API بشكل منفصل في منصّة الـ API، ولا تدير مساحات عمل ChatGPT المشتركة.
إذا كنت تحتاج إلى مفتاح لمؤسسة على منصّة الـ API، فافتح مفاتيح مشرف مؤسسات منصّة الـ API. استخدم نقاط نهاية واجهة ChatGPT Admin API الخاصة بمساحة العمل المشتركة مع مفتاح مشرف للمساحة؛ إذ تتطلب نقاط نهاية مؤسسات منصّة الـ API بيانات اعتماد منفصلة.
استكشاف مشكلات الوصول والأذونات المفقودة وإصلاحها
تأكد من تسجيل الدخول باستخدام حساب OpenAI الصحيح ومن تحديد المستأجر ومساحة عمل ChatGPT المشتركة المقصودين.
تحقق من أن عضويتك في مساحة العمل المشتركة نشطة وأن دورك فيها هو المالك أو المشرف.
تأكد من أن مساحة عمل ChatGPT المشتركة مؤهلة لاستخدام مفاتيح المشرف. قد يختلف التوفر بحسب الخطة ومرحلة الطرح.
إذا كانت إحدى فئات الأذونات مفقودة، فتأكد من توفر الميزة في مساحة العمل المشتركة المحددة ومن أن دورك يسمح بالوصول إليها. إذا ظلت الفئة المطلوبة غير متاحة، فتواصل مع دعم OpenAI بدلًا من تحديد إذن غير ذي صلة.
إذا تعذر عليك تعديل مفتاح أو إلغاؤه، فتأكد من أنك أنشأته وأن أذوناته متاحة لدورك الحالي. اطلب من مالك مساحة العمل المشتركة إدارة المفاتيح ذات الأذونات المخصصة للمالكين فقط.
إذا توقف مفتاح كان يعمل سابقًا، فتحقق من حالته وانتهاء صلاحيته، وتأكد من أن صلاحيته لم تنتهِ وأنه لم يُلغَ، وتحقق من أن منشئه لا يزال يشغل دورًا نشطًا في مساحة العمل المشتركة ويتمتع بالأذونات المطلوبة.
إذا استمرت المشكلة، فتواصل مع دعم OpenAI. أدرج معرّف المستأجر واسم مساحة العمل المشتركة أو معرّفها ولقطة شاشة إذا طُلبت، لكن لا تشارك سر مفتاح المشرف مطلقًا.
حماية مفاتيح المشرف
اختر أذونات مخصصة، ولا تمنح إلا صلاحية الوصول التي يحتاج إليها تكاملك.
حدد مدة انتهاء الصلاحية متى أمكن. يعني الخيار أبدًا أن المفتاح ليس له تاريخ انتهاء صلاحية مجدول. قد يتوقف المفتاح عن العمل رغم ذلك إذا أُلغي، أو فقد منشئه صلاحية الوصول المطلوبة إلى مساحة العمل المشتركة، أو أُلغي تنشيط حساب المنشئ.
استخدم مفاتيح منفصلة لعمليات التكامل أو مهام سير العمل المختلفة.
خزّن الأسرار في أداة آمنة لإدارة الأسرار. لا ترسلها مطلقًا عبر البريد الإلكتروني أو الدردشة أو طلب دعم.
راجع الاستخدام وانتهاء الصلاحية بانتظام، وألغِ المفاتيح التي لم تعد بحاجة إليها.