تهدف المشاريع إلى تزويد العملاء بالقدرة على تنظيم عملهم. يمكن للمؤسسات إدارة الوصول والحدود، وتوفير حسابات الخدمة (من خلال واجهة المستخدم)، وتتبع الاستخدام ضمن نطاق مقيّد داخل مشروع (مثل النماذج، والقدرات، والسلاسل، والمساعدين، والضبط الدقيق، والتخزين، وما إلى ذلك). يمكن تقسيم نشاط الاستخدام حسب المشروع، ويمكن للمستخدمين عرض الفوترة وتعيين الميزانيات لكل مشروع.
يمكن لمالكي المؤسسة عرض جميع مشاريعهم النشطة والمؤرشفة في صفحة المشاريع. تعرّف على المزيد حول أدوار المستخدمين والأذونات في منصة API.
من يمكنه إنشاء مشروع؟
يمكن لمالكي المؤسسة فقط إنشاء مشروع. يرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
للتبديل بين المؤسسات، مرّر المؤشر فوق اسم مؤسستك في أعلى يسار الصفحة وحدد المؤسسة من القائمة:
بالنسبة إلى المؤسسات التي تستخدم خطة فوترة موحدة، يتم تحديد المؤسسات الفرعية بشكل منفصل. لا يمكن إنشاء مشاريع داخل المؤسسات الفرعية.
كيف تعمل المشاريع؟
تتضمن كل مؤسسة «مشروعًا افتراضيًا» لا يمكن حذفه. يمكنك تكوين حدود المعدل، وأذونات النموذج الافتراضي، وميزانيات الإنفاق (اعتبارًا من نوفمبر 2024). وهو يرث التكوين الكامل للمؤسسة، لذا لا يمكنك إضافة أعضاء أو حسابات خدمة إليه مباشرةً.
كيف أنشئ مشروعًا؟
أولاً، مرّر مؤشر الماوس فوق اسم المشروع في الزاوية اليسرى من الصفحة وحدد Create project.
أدخل اسمًا ووصفًا وموقعًا إلكترونيًا لمشروعك ثم حدد Create.
كيف أضيف مستخدمين إلى مشروع؟
لا تتم إضافة أعضاء المؤسسة المضافين حديثًا تلقائيًا إلى «المشروع الافتراضي». يمكن دعوة الأعضاء الجدد إلى المشروع إما عند دعوتهم إلى المؤسسة (بتفعيل خانة الاختيار "Invite to default project") أو بعد قبول العضو دعوة المؤسسة.
يتبع المستخدمون المدعوون عبر Admin API القواعد الموضحة في نقطة النهاية /organization/invites.
إذا واجهت خطأ عند دعوة مستخدمين إلى مشروع عبر واجهة المستخدم أو Admin API، فتأكد أولًا من أن المشروع المستهدف موجود وغير مؤرشف قبل إعادة إرسال الدعوة.
تتم إضافة مالكي المؤسسة تلقائيًا كمالكين إلى المشاريع الجديدة التي تُنشأ داخل المؤسسة.
ما أدوار المستخدمين المختلفة داخل المؤسسات والمشاريع، وما الأذونات التي تتضمنها؟
بينما لدى المؤسسات دورا «مالك» و«قارئ»، لدى المشاريع دورا «مالك» و«عضو». أعضاء المشروع يماثلون قرّاء المؤسسة. يرجى الرجوع إلى الجدول أدناه للحصول على وصف أكثر تفصيلًا للأذونات المصاحبة لكل دور مستخدم.
| الدور | النطاق | الوصف |
|---|---|---|
| مالك | المؤسسة | يمكنه إنشاء/عرض جميع المشاريع وجميع المستخدمين وجميع مفاتيح API. لديه القدرة على المراقبة عبر جميع المشاريع داخل المؤسسة من خلال صفحة المشاريع . يمكنه تعيين ميزانيات المؤسسة وميزانيات المشاريع. يمكنه منح أذونات لعرض معلومات الاستخدام للآخرين في المؤسسة. يمكنه أرشفة المشاريع. |
| قارئ | المؤسسة | يمكنه إجراء الاستدلال واستخدام الموارد وإنشاء مفاتيح في مشاريعه. يمكن إضافته إلى المشاريع. لا يمكنه إنشاء مشاريع وإدارة المستخدمين. |
| مالك | المشروع | يمكنه إضافة مستخدمين آخرين إلى المشروع وإعادة تسمية المشروع، بالإضافة إلى جميع قدرات العضو. يمكنه تعيين ميزانيات المشروع. يمكنه أرشفة المشروع. |
| عضو | المشروع | يمكنه إجراء الاستدلال واستخدام الموارد وإنشاء مفاتيح على مستوى المشروع. |
إذا لم أكن مالكًا في المؤسسة، فما الذي يمكنني الوصول إليه؟
يمكن للمستخدمين الذين ليسوا مالكين في المؤسسة رؤية المشاريع التي هم أعضاء فيها فقط. يمكن لمالك المؤسسة فقط رؤية جميع المشاريع والأعضاء ومفاتيح API على مستوى المشروع، والوصول إلى صفحة المشاريع.
يمكن لأعضاء المشروع فقط (ومالكي المؤسسة) رؤية النماذج المضبوطة بدقة التي أُنشئت داخل ذلك المشروع، أو السلاسل من أي مساعدين تم إنشاؤهم، أو أي ملفات تمت إضافتها.
يمكن لأعضاء المشروع رؤية جميع الأعضاء الآخرين في ذلك المشروع وأدوارهم (أي مالك أو عضو).
كيف أُحدّث دور مستخدم في المشروع أو أزيل مستخدمًا من مشروع؟
يمكن لمالك المشروع فقط تحديث دور مستخدم في المشروع أو إزالة مستخدم من مشروع. يرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
لتحديث مستخدم في مشروع، انتقل إلى إعدادات المؤسسة، وحدد المشروع، ثم انقر على الأعضاء. لديك خيار تعيين دور كل عضو كـ عضو أو مالك. يمكنك أيضًا تحديد إزالة لإزالة المستخدم من المشروع.
ما حساب الخدمة، وكيف يختلف عن حساب المستخدم العادي؟
يعمل حساب الخدمة كمستخدم شبه افتراضي مُصمم لوصول الأنظمة، وهو يختلف عن حسابات المستخدمين الفردية. يمكن فقط لمالكي المؤسسة ومالكي المشاريع إنشاء حسابات خدمة.
حسابات الخدمة محصورة ضمن المشاريع فقط.
إضافة عضو إلى مشروع
إذا نقرت زر + Add member فسترى قائمة بالمستخدمين في مؤسستك الذين لديهم دور Reader. إذا أردت إضافة مستخدم ليس ضمن مؤسستك حاليًا، فستحتاج إلى إضافته إلى المؤسسة أولًا (يمكنك إبقاء خانة الاختيار 'Add to Default Project" غير محددة إذا كنت لا تريد منح هؤلاء المستخدمين وصولًا أوسع). لن تتضمن هذه القائمة حسابات الخدمة. خلال هذه الخطوة يمكنك اختيار ما إذا كان دوره Owner أو Member:
عند إضافة عضو فريق، يجب أن تسند إليه إما دور Member أو Owner. يمكن لأعضاء المشروع إجراء طلبات API تقرأ البيانات أو تعدّلها، بينما يمكن لمالكي المشروع أيضًا تعديل إعدادات المشروع وميزانياته وإدارة أعضاء المشروع. يرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
كيفية إنشاء حساب خدمة لمشروع
انتقل أولًا إلى المشروع الذي تريد إنشاء حساب خدمة له من خلال الاختيار من القائمة المنسدلة الموجودة في شريط التنقل:
ثم انتقل إلى إعدادات المؤسسة -> المشروع -> الأعضاء -> وانقر على + Service account:
حسابات الخدمة التي يتم إنشاؤها على مستوى المشروع تكون فريدة لهذا المشروع ولا يمكن استخدامها خارج المشروع الذي أُنشئت فيه.
تسمية حساب الخدمة
بصرف النظر عما إذا كنت تنشئ حساب الخدمة على مستوى المؤسسة أو تنشئ حسابًا فريدًا لمشروع، فعند إنشاء حساب خدمة يمكنك إنشاء معرّف فريد لحساب الخدمة يتكون من أحرف وأرقام وواصلات لتسهيل التعرف على حساب الخدمة.
احفظ مفتاح API لحساب الخدمة
بعد تحديد زر إنشاء، يتم إنشاء مفتاح API فورًا لحساب الخدمة وسيُعرض المفتاح السري. احفظ هذا المفتاح السري في مكان آمن ومحمي. لأسباب أمنية، لن تتمكن من عرضه مرة أخرى من خلال حسابك في OpenAI. إذا فقدت هذا المفتاح السري، فستحتاج إلى إنشاء مفتاح جديد.
يتم تعيين أذونات مفتاح API لحساب الخدمة افتراضيًا إلى قراءة جميع موارد API الخاصة بالمشروع وكتابتها. يمكن تحديث هذه الأذونات في إعدادات مفاتيح API لمشروعك.
تُدرج حسابات الخدمة إلى جانب أعضاء المشروع في صفحة إعدادات أعضاء مشروعك. يرجى الرجوع إلى هنا لمعرفة المزيد حول تحديث وصول حساب خدمة أو إزالته في صفحة إعدادات أعضاء مشروعك.
ستُعرض جميع حسابات الخدمة عبر المشاريع والمؤسسات إلى جانب المستخدمين البشريين في صفحة الأعضاء على مستوى المؤسسة.
تُدار حسابات الخدمة مثل الحسابات العادية. من المؤسسة -> قائمة الأعضاء يمكنك إزالة حساب خدمة أو تحديث الدور:
كيف أدير مفاتيح API داخل مشاريع مؤسستي؟
يمكنك إنشاء مفاتيح API وإدارتها لكل مشروع في صفحة إعدادات ذلك المشروع. في إعدادات المؤسسة، حدد المشروع، وانقر على مفاتيح API.
لإنشاء مفتاح سري جديد، حدد + Create new secret key. يمكنك أيضًا تحديد أيقونة التعديل بجوار مفتاح سري لتعديل أذوناته.
يمكنك تعيين الأذونات لكل من مفاتيح API عند إنشاء مفتاح سري جديد أو بتعديل مفتاح موجود.
تتوفر ثلاثة مستويات من الأذونات: الكل، مقيّد، وقراءة فقط.
الكل — يتم تعيين أذونات كاملة للمفتاح السري. هذا هو الإعداد الافتراضي.
مقيّد — يتيح للمستخدم تعيين أذونات لا شيء وقراءة وكتابة لكل نقطة نهاية.
على سبيل المثال، تنشئ مفتاح API لا يملك تحديدًا إذن القراءة أو الكتابة إلى نقطة النهاية /v1/assistants:
قراءة فقط — يتم تعيين أذونات القراءة لجميع نقاط النهاية.
كيف تُدار صلاحية الوصول للمستخدمين المنتمين إلى عدة مشاريع أو مؤسسات؟
يمكن أن يكون المستخدمون أعضاء في العدد الذي يلزم من المشاريع. وداخل المشروع، يمكن للمستخدمين إنشاء مفتاح API شخصي يكون مقيّدًا ومحصورًا في الوصول إلى ذلك المشروع وموارده.
كيف أعيّن حدود الاستخدام لمشاريع مؤسستي وأديرها؟
يمكن لمالك المؤسسة فقط تعيين حدود الاستخدام على مستوى المشروع وإدارتها. يرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
في إعدادات المؤسسة، انقر على المشروع الذي تريد تحديثه وحدد الحدود في قسم المشروع من قائمة التنقل. يمكنك تحديث استخدام النموذج في هذه الصفحة.
يتيح لك استخدام النموذج تكوين النماذج التي يمكن للمشروع استخدامها، ويمكن تعيين حدود الاستخدام لكل نموذج حسب الحاجة.
كيف أعيّن ميزانيات مشاريع مؤسستي وأديرها؟
لا يمكن تعيين ميزانيات المشاريع وإدارتها إلا لمالكي المؤسسة ومالكي المشروع. يرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات. لتغيير الحدود على مستوى المؤسسة، انتقل إلى إعدادات المؤسسة، وانقر على الحدود، ثم مرّر إلى حدود الاستخدام.
لتعيين حدود مشروعك، انتقل إلى إعدادات المؤسسة، وانقر على المشروع الذي تريد تحديثه وحدد الحدود. يمكنك تحديث الميزانية الشهرية وحد الإشعار واستخدام النموذج.
يتيح لك تعيين ميزانية شهرية إنشاء حدود إنفاق مرنة لمشروعك. عندما يتجاوز الاستخدام هذا الحد خلال شهر تقويمي معين (UTC)، ستستمر معالجة طلبات API دون انقطاع. صُممت هذه الميزة لمساعدتك على مراقبة الاستخدام من خلال تنبيهات الميزانية، لكنها لا تفرض سقفًا صارمًا على الإنفاق. عند إنشاء ميزانية مشروع، سيتم افتراضيًا إنشاء تنبيه عند عتبة 100%. يمكن تعيين ميزانيات إضافية عند عتبات مختلفة بالنقر على إضافة تنبيه.
يرجى ملاحظة أن مالك/مالكي المؤسسة ومالك/مالكي المشروع سيتلقون هذه الرسائل دائمًا ولا يمكن تخصيص ذلك.
كيف أحذف مشروعًا أو أؤرشفه؟
يمكن أرشفة المشاريع إما عبر صفحة قائمة المشاريع الجديدة أو من إعدادات مشروع فردي. بمجرد أرشفة مشروع لا يمكن استعادته. عند متابعة الأرشفة، سيُطلب منك إدخال اسم المشروع للمتابعة.
يمكنك عرض قائمة بجميع المشاريع المؤرشفة من خلال علامة تبويب «مؤرشف» في صفحة قائمة المشاريع نفسها.
لا يمكن حذف المشاريع؛ فنحن نحتفظ بسجل لجميع المشاريع لضمان الاستمرارية في تتبع الاستخدام والفوترة.
هل يوجد حد لعدد المشاريع التي يمكنني امتلاكها في مؤسستي؟
يمكن للمؤسسات إنشاء ما يصل إلى 2,000 مشروع افتراضيًا.
هل يمكن مشاركة الموارد عبر المشاريع؟
موارد المشروع (مثل الملفات أو المساعدين أو التخزين أو سلاسل الرسائل) تكون محصورة ضمن المشروع ولا يمكن الوصول إليها من قِبل الأعضاء غير الإداريين خارج المشروع. إضافة إلى ذلك، لا يمكن نقل الموارد بين المشاريع.
الاستثناء الوحيد هو أن عمليات الضبط الدقيق في «المشروع الافتراضي» يمكن الوصول إليها من مشاريع أخرى.
ما حصة تخزين الملفات لكل مشروع؟
تدعم OpenAI حاليًا حصة تخزين ملفات قدرها 100 جيجابايت من الملفات لكل مشروع.
إذا تم تجاوز هذه الحصة، فسترى الخطأ التالي:
لقد تجاوزت حصة تخزين الملفات الخاصة بك. تقتصر المؤسسات على 100 جيجابايت من الملفات. يُرجى تقليل حجم الملفات أو التواصل مع الدعم.نوصي بحذف الملفات غير المستخدمة المخزنة في حسابك. للمرجع، يمكنك عرض الملفات وسردها باستخدام API.
أنا مالك مشروع، فلماذا لا أستطيع رؤية لوحة معلومات الاستخدام لمشروعي؟
لا ترتبط إمكانية رؤية لوحة معلومات الاستخدام للمشروع بدور المستخدم داخل المشروع. بدلًا من ذلك، يتم تحديدها حسب دورك داخل المؤسسة و الإعدادات في https://platform.openai.com/settings/organization/data-controls/visibility
إذا لم تتمكن من رؤية لوحة معلومات الاستخدام، فمن المرجح أن هذا الإعداد مضبوط على "مرئي لمالكي المؤسسة".