نظرة عامة
تنظّم المشاريع العمل داخل المؤسسة التي تستخدم API. استخدمها لإدارة الوصول، وضبط حدود النماذج وحدود الاستخدام، وإنشاء حسابات الخدمة، وتتبع الاستخدام والفوترة وحدود الإنفاق لمجموعة محددة من الموارد، مثل النماذج والقدرات وسلاسل المحادثات والمساعدين والضبط الدقيق والتخزين.
يمكن لمالكي المؤسسة عرض جميع المشاريع النشطة والمؤرشفة في صفحة المشاريع.
قبل البدء
تحتاج إلى دور مالك المؤسسة لإنشاء مشروع. يمكن للمؤسسات إنشاء ما يصل إلى 2,000 مشروع افتراضيًا.
إذا كانت مؤسستك تستخدم الفوترة الموحّدة، فستظهر المؤسسات الفرعية بشكل منفصل في قائمة اختيار المؤسسة. لا يمكنك إنشاء مشاريع داخل مؤسسة فرعية.
للتبديل بين المؤسسات، افتح قائمة اختيار المؤسسة واختر المؤسسة التي تريد استخدامها.
المشروع الافتراضي
تتضمن كل مؤسسة مشروعًا افتراضيًا لا يمكن حذفه. يرث هذا المشروع جميع إعدادات المؤسسة. يمكنك ضبط حدود الاستخدام وصلاحيات النماذج الافتراضية وحدود الإنفاق الخاصة به.
لا يمكنك إضافة أعضاء أو حسابات خدمة مباشرة إلى المشروع الافتراضي. يمكنك منح حق الوصول إلى المشروع الافتراضي عند دعوة شخص إلى المؤسسة، باتباع خطوات الدعوة إلى المؤسسة الواردة في هذه المقالة.
إنشاء مشروع
افتح قائمة اختيار المشروع واختر إنشاء مشروع.
أدخل اسمًا ووصفًا وموقعًا إلكترونيًا لمشروعك.
اختر إنشاء.
يُضاف مالكو المؤسسة تلقائيًا بصفتهم مالكين للمشاريع الجديدة.
فهم الأدوار والوصول
يلخّص الجدول دورَي المالك والقارئ في المؤسسة ودورَي المالك والعضو في المشروع، وهي الأدوار المستخدمة في هذه الخطوات. يتمتع أعضاء المشروع بصلاحيات مشابهة لصلاحيات القرّاء في المؤسسة.
| الدور | النطاق | الصلاحيات |
|---|---|---|
| مالك | المؤسسة | إنشاء جميع المشاريع والمستخدمين ومفاتيح API وعرضها. مراقبة المشاريع في صفحة المشاريع. تعيين حدود الإنفاق للمؤسسة والمشاريع. منح حق الوصول إلى معلومات الاستخدام الخاصة بالمستخدمين الآخرين. أرشفة المشاريع. |
| قارئ | المؤسسة | إمكانية إضافته إلى المشاريع، وإجراء الاستدلال، واستخدام الموارد، وإنشاء مفاتيح في تلك المشاريع. لا يمكنه إنشاء مشاريع أو إدارة المستخدمين. |
| مالك | المشروع | جميع صلاحيات العضو، إضافة إلى إضافة المستخدمين وإدارة أعضاء المشروع وإعداداته وإعادة تسميته وتعيين حدود إنفاقه وأرشفته. |
| عضو | المشروع | إجراء الاستدلال، واستخدام الموارد، وإنشاء مفاتيح على مستوى المشروع، وإرسال طلبات API لقراءة البيانات أو تعديلها. |
للاطلاع على تفاصيل أدوار المؤسسة، راجع: أدوار المؤسسة. للاطلاع على الأدوار الإضافية والأدوار المخصصة وجميع الصلاحيات، راجع دليل أدوار API وصلاحياتها.
إمكانية رؤية المشاريع
عند استخدام هذه الأدوار القياسية، لا يمكن للمستخدمين الذين ليسوا مالكين للمؤسسة رؤية سوى المشاريع التي ينتمون إليها. يمكن لمالكي المؤسسة رؤية جميع المشاريع والأعضاء ومفاتيح API على مستوى المشروع، والوصول إلى صفحة المشاريع.
يمكن لأعضاء المشروع رؤية الأعضاء الآخرين في مشروعهم ودور كل عضو. يمكن فقط لأعضاء المشروع ومالكي المؤسسة رؤية النماذج المضبوطة ضبطًا دقيقًا وسلاسل محادثات المساعدين والملفات التي أُنشئت أو أُضيفت داخل ذلك المشروع.
يمكنك الانضمام إلى أي عدد من المشاريع حسب حاجتك. يقتصر نطاق مفتاح API الشخصي المُنشأ داخل مشروع على ذلك المشروع وموارده.
حدود نطاق الموارد
يقتصر نطاق الملفات والمساعدين والتخزين وسلاسل المحادثات على المشروع الذي تتبع له. لا يمكن للأعضاء من خارج المشروع الذين لا يملكون صلاحيات مسؤول الوصول إلى موارده، ولا يمكن نقل الموارد بين المشاريع.
تُستثنى من ذلك النماذج المضبوطة ضبطًا دقيقًا في المشروع الافتراضي، إذ يمكن الوصول إليها من مشاريع أخرى.
إدارة أعضاء المشروع
دعوة شخص إلى مؤسستك
يجب أن يكون الشخص عضوًا في مؤسستك قبل أن تتمكن من إضافته إلى مشروع.
عند دعوة شخص إلى المؤسسة، يمكنك منحه حق الوصول إلى المشروع الافتراضي بتحديد هذا الخيار في نموذج الدعوة. اترك الخيار غير محدد إذا كنت لا تريد منحه حق الوصول إلى المشروع الافتراضي. لا يُضاف أعضاء المؤسسة الجدد تلقائيًا إلى المشروع الافتراضي.
لا تحتاج إلى إنشاء مشروع آخر قبل دعوة شخص. يمكنك أيضًا إضافة شخص إلى مشروع بعد قبوله دعوة الانضمام إلى المؤسسة.
تخضع الدعوات المرسلة عبر واجهة API للمسؤول للقواعد الخاصة بـنقطة النهاية /organization/invites.
إضافة عضو في المؤسسة إلى مشروع
يمكن لمالكي المؤسسة والمشروع إضافة أعضاء:
انتقل إلى إعدادات المؤسسة.
اختر المشروع، ثم افتح الأعضاء.
اختر + إضافة عضو.
اختر المستخدم وعيّن له دور عضو أو مالك.
تعرض قائمة المستخدمين مستخدمي المؤسسة الذين لديهم دور قارئ. ولا تشمل حسابات الخدمة.
إذا فشل إرسال دعوة عبر واجهة المستخدم أو واجهة API للمسؤول، فتأكد من وجود المشروع المستهدف ومن أنه غير مؤرشف قبل إعادة إرسال الدعوة.
تغيير دور أو إزالة عضو
يمكن لمالكي المؤسسة والمشروع تغيير دور المستخدم في المشروع أو إزالته منه.
انتقل إلى إعدادات المؤسسة.
اختر المشروع، ثم افتح الأعضاء.
عيّن دور المستخدم إلى عضو أو مالك، أو اختر إزالة لإزالته.
إنشاء حسابات الخدمة وإدارتها
يوفّر حساب الخدمة وصولًا للأنظمة بدلًا من أن يمثّل مستخدمًا فرديًا. يقتصر نطاق حسابات الخدمة على المشاريع.
يتطلب إنشاء حسابات الخدمة صلاحيات إدارة حسابات الخدمة. يمتلك مالكو المؤسسة والمشروع هذه الصلاحيات.
إنشاء حساب خدمة
اختر المشروع من قائمة اختيار المشروع.
انتقل إلى إعدادات المؤسسة واختر المشروع.
افتح الأعضاء واختر + حساب خدمة.
أدخل معرّفًا فريدًا لحساب الخدمة باستخدام الحروف والأرقام والشرطات.
اختر إنشاء.
حسابات الخدمة التي يتم إنشاؤها على مستوى المشروع تكون فريدة لهذا المشروع ولا يمكن استخدامها خارج المشروع الذي أُنشئت فيه.
ينطبق تنسيق المعرّف نفسه سواء أنشأت حساب الخدمة من إعدادات المؤسسة أو المشروع.
يكون حساب الخدمة المُنشأ لمشروع مخصصًا لذلك المشروع وحده، ولا يمكن استخدامه خارجه.
حفظ المفتاح السري
عند إنشاء حساب الخدمة، يُنشأ مفتاح API فورًا ويُعرض مفتاحه السري. احفظ المفتاح السري في مكان آمن. لن تتمكن من عرضه مرة أخرى عبر حسابك في OpenAI. إذا فقدته، فأنشئ مفتاحًا جديدًا.
يتيح مفتاح حساب الخدمة افتراضيًا قراءة جميع موارد API في مشروعه والكتابة إليها. يمكنك تغيير هذه الصلاحيات لاحقًا في إعدادات مفاتيح API الخاصة بالمشروع.
تحديث حساب خدمة أو إزالته
تظهر حسابات الخدمة إلى جانب المستخدمين في إعدادات الأعضاء الخاصة بالمشروع. يمكنك إدارة وصولها إلى المشروع باتباع خطوات تغيير الدور والإزالة نفسها المتّبعة مع أعضاء المشروع الآخرين.
تظهر جميع حسابات الخدمة أيضًا إلى جانب المستخدمين في صفحة أعضاء المؤسسة، بما فيها الحسابات التي أُنشئت من إعدادات المؤسسة أو المشروع.
من قائمة الأعضاء في المؤسسة، يمكنك تغيير دور حساب خدمة أو اختيار إزالة.
إنشاء مفاتيح API وإدارتها
لكل مشروع مفاتيح API خاصة به:
انتقل إلى إعدادات المؤسسة.
اختر المشروع، ثم افتح مفاتيح API.
اختر + إنشاء مفتاح سري جديد لإنشاء مفتاح، أو اختر أيقونة التعديل بجانب مفتاح موجود لتغيير صلاحياته.
اختيار صلاحيات المفتاح
بالنسبة إلى المفاتيح المملوكة للمستخدمين، يمكنك تعيين الصلاحيات عند إنشاء المفتاح أو تعديلها لاحقًا:
الكل: صلاحيات كاملة. هذا هو الخيار الافتراضي.
مقيّد: اختر نطاقات الصلاحيات لموارد أو نقاط نهاية محددة. تختلف الخيارات المتاحة بحسب المورد، وقد تشمل بلا صلاحيات أو قراءة أو كتابة أو صلاحيات خاصة بالطلبات.
قراءة فقط: صلاحيات قراءة لجميع نقاط النهاية.
على سبيل المثال، يمكن أن يستثني مفتاح مقيّد صلاحيات القراءة والكتابة لنقطة النهاية /v1/assistants.
يتطلب إنشاء مفاتيح حسابات الخدمة صلاحيات إدارة حسابات الخدمة. إذا لم يظهر لك هذا الخيار، فاطلب من أحد مالكي المؤسسة أو المشروع إنشاء مفتاح حساب الخدمة. لا يعرض مربع حوار إنشاء المفاتيح عناصر التحكم هذه في الصلاحيات لمفاتيح حسابات الخدمة؛ يمكنك تغيير صلاحياتها لاحقًا في إعدادات مفاتيح API الخاصة بالمشروع.
ضبط الوصول إلى النماذج وحدود الاستخدام
تتطلب إدارة حدود الاستخدام للمشروع صلاحيات إدارية. يمتلك مالكو المؤسسة هذه الصلاحيات، ويمكن لمالكي المشروع أيضًا إدارة حدود الاستخدام الخاصة بالمشروع عبر واجهة API للإدارة.
انتقل إلى إعدادات المؤسسة.
اختر المشروع، ثم افتح الحدود.
استخدم استخدام النماذج لاختيار النماذج التي يمكن للمشروع استخدامها.
عيّن حدّ الاستخدام لكل نموذج حسب الحاجة.
تعيين حدود الإنفاق والتنبيهات
تتوفر حدود شهرية للإنفاق على API على مستوى المؤسسة والمشروع. لتغيير أي حد، تحتاج إلى صلاحية إدارة إعدادات المؤسسة أو المشروع المعني.
يمكن استخدام حد الإنفاق لمراقبة الإنفاق دون إيقاف الطلبات. فعّل تطبيق حد أقصى صارم إذا أردت أن تفشل طلبات API بعد بلوغ الإنفاق المتتبَّع الحد المحدد. لا يُطبَّق الحد فورًا، لذا قد يتجاوز الإنفاق المسجّل المبلغ المحدد قليلًا.
تُخطرك تنبيهات الإنفاق عند بلوغ عتبة محددة، لكنها لا توقف الطلبات.
تعيين حد إنفاق للمؤسسة
انتقل إلى إعدادات المؤسسة.
افتح الحدود وابحث عن الإنفاق.
تعيين حد إنفاق للمشروع
انتقل إلى إعدادات المؤسسة.
اختر المشروع، ثم افتح الحدود.
عيّن قيمتَي حد الإنفاق الشهري والتنبيه عند بلوغ الإنفاق.
فعّل تطبيق حد أقصى صارم إذا أردت إيقاف طلبات API بعد بلوغ الإنفاق المتتبَّع الحد المحدد.
يمكنك أيضًا تغيير استخدام النماذج في هذه الصفحة.
إدارة تنبيهات الإنفاق
عند إنشاء حد إنفاق للمشروع، يُنشأ أيضًا تنبيه عند بلوغ 100% من الحد افتراضيًا. اختر إضافة تنبيه لإضافة تنبيهات عند عتبات أخرى.
يتلقى مالكو المؤسسة والمشروع تنبيهات الإنفاق الخاصة بالمشروع. يمكنك إضافة مستلمين آخرين عبر البريد الإلكتروني في إعدادات التنبيهات.
للاطلاع على أحدث خطوات الإعداد وكيفية تطبيق الحدود، راجع دليل حدود الإنفاق.
عرض الاستخدام والفوترة
يمكن عرض نشاط الاستخدام حسب المشروع، كما يمكنك الاطلاع على الفوترة وتعيين حدود الإنفاق لكل مشروع على حدة.
يعتمد الوصول إلى لوحة معلومات الاستخدام الخاصة بالمشروع على دورك في المؤسسة وإعدادات إظهار لوحة معلومات الاستخدام. كونك مالكًا للمشروع لا يمنحك حق الوصول بحد ذاته.
إذا لم تتمكن من رؤية لوحة معلومات الاستخدام الخاصة بالمشروع، فتحقق مما إذا كان إعداد الإظهار مضبوطًا على مرئية لمالكي المؤسسة.
إدارة تخزين الملفات
تبلغ الحصة المخصصة لكل مشروع لتخزين الملفات 100 غيغابايت. إذا تجاوزتها، فقد تظهر لك رسالة الخطأ التالية:
لقد تجاوزت حصتك المخصصة لتخزين الملفات. الحد الأقصى للملفات في كل مؤسسة هو 100 غيغابايت. يُرجى تقليل حجم الملف أو التواصل مع الدعم.
احذف الملفات غير المستخدمة لتوفير مساحة تخزين. يمكنك عرض قائمة الملفات المخزّنة عبر API لتحديد الملفات التي لم تعد بحاجة إليها.
أرشفة مشروع
يمكن لمالكي المؤسسة والمشروع أرشفة المشاريع من صفحة المشاريع أو من إعدادات كل مشروع على حدة. أدخل اسم المشروع عند مطالبتك بذلك للتأكيد.
الأرشفة دائمة: لا يمكن استعادة مشروع بعد أرشفته.
لعرض المشاريع المؤرشفة، افتح علامة التبويب المؤرشفة في صفحة المشاريع.
الاستثناء الوحيد هو أن عمليات الضبط الدقيق في «المشروع الافتراضي» يمكن الوصول إليها من مشاريع أخرى.
لقد تجاوزت حصة تخزين الملفات الخاصة بك. تقتصر المؤسسات على 100 جيجابايت من الملفات. يُرجى تقليل حجم الملفات أو التواصل مع الدعم.لا يمكن حذف المشاريع. تحتفظ OpenAI بسجلّها لتتبع الاستخدام والفوترة.