تهدف المشاريع إلى منح العملاء القدرة على تنظيم عملهم. يمكن للمؤسسات إدارة الوصول والحدود، وتوفير حسابات الخدمة (عبر واجهة المستخدم)، وتتبع الاستخدام ضمن نطاق مقيّد داخل المشروع (مثل النماذج والقدرات وسلاسل الرسائل والمساعدين والضبط الدقيق والتخزين وما إلى ذلك). ويمكن تقسيم نشاط الاستخدام حسب المشروع، كما يمكن للمستخدمين عرض الفوترة وتعيين ميزانيات لكل مشروع.
يمكن لمالكي المؤسسة عرض جميع مشاريعهم النشطة والمؤرشفة في صفحة Projects. تعرّف على المزيد حول أدوار المستخدمين والأذونات في منصة API.
من يمكنه إنشاء مشروع؟
يمكن لمالكي المؤسسة فقط إنشاء مشروع. يُرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
للتبديل بين المؤسسات، مرّر مؤشر الماوس فوق اسم مؤسستك في أعلى يسار الصفحة وحدد المؤسسة من القائمة:
بالنسبة للمؤسسات التي تعمل بخطة فوترة موحدة، يتم تحديد المؤسسات الفرعية بشكل منفصل. لا يمكن إنشاء مشاريع داخل المؤسسات الفرعية.
كيف تعمل المشاريع؟
تتضمن كل مؤسسة «مشروعًا افتراضيًا» لا يمكن حذفه. يمكنك تكوين حدود المعدل، وأذونات النموذج الافتراضي، وميزانيات الإنفاق (اعتبارًا من نوفمبر 2024). وهو يرث التكوين الكامل للمؤسسة، لذا لا يمكنك إضافة أعضاء أو حسابات خدمة إليه مباشرةً.
كيف أنشئ مشروعًا؟
أولاً، مرّر مؤشر الماوس فوق اسم المشروع في الزاوية اليسرى من الصفحة وحدد Create project.
أدخل اسمًا ووصفًا وموقعًا إلكترونيًا لمشروعك ثم حدد Create.
كيف أضيف مستخدمين إلى مشروع؟
لا تتم إضافة أعضاء المؤسسة المضافين حديثًا تلقائيًا إلى «المشروع الافتراضي». يمكن دعوة الأعضاء الجدد إلى المشروع إما عند دعوتهم إلى المؤسسة (بتفعيل مربع الاختيار "Invite to default project") أو بعد أن يقبل العضو دعوة المؤسسة.
يتبع المستخدمون الذين تتم دعوتهم عبر Admin API القواعد الموضحة في نقطة النهاية /organization/invites.
إذا واجهت خطأ عند دعوة مستخدمين إلى مشروع عبر واجهة المستخدم أو Admin API، فتأكد أولاً من أن المشروع المستهدف موجود وليس مؤرشفًا قبل إعادة إرسال الدعوة.
يُضاف مالكو المؤسسة تلقائيًا بصفة مالكين إلى المشاريع الجديدة التي يتم إنشاؤها داخل المؤسسة.
ما أدوار المستخدمين المختلفة داخل المؤسسات والمشاريع، وما الأذونات التي تتضمنها؟
بينما تتضمن المؤسسات دوري «owner» و«reader»، تتضمن المشاريع دوري «owner» و«member». أعضاء المشروع مماثلون لقراء المؤسسة. يُرجى الرجوع إلى الجدول أدناه للحصول على وصف أكثر تفصيلاً للأذونات المصاحبة لكل دور مستخدم.
| الدور | النطاق | الوصف |
|---|---|---|
| Owner | المؤسسة | يمكنه إنشاء جميع المشاريع/عرضها، وجميع المستخدمين، وجميع مفاتيح API. لديه القدرة على المراقبة عبر جميع المشاريع داخل المؤسسة من خلال صفحة Projects. ويمكنه تعيين ميزانيات المؤسسة وميزانيات المشاريع. ويمكنه منح أذونات للآخرين في المؤسسة لعرض معلومات الاستخدام. ويمكنه أرشفة المشاريع. |
| Reader | المؤسسة | يمكنه إجراء الاستدلال، واستخدام الموارد، وإنشاء المفاتيح في مشاريعه. ويمكن إضافته إلى المشاريع. لا يمكنه إنشاء المشاريع وإدارة المستخدمين. |
| Owner | المشروع | يمكنه إضافة مستخدمين آخرين إلى المشروع وإعادة تسمية المشروع، بالإضافة إلى جميع قدرات العضو. ويمكنه ضبط ميزانيات المشروع. ويمكنه أرشفة المشروع. |
| Member | المشروع | يمكنه إجراء الاستدلال، واستخدام الموارد، وإنشاء المفاتيح على مستوى المشروع. |
إذا لم أكن مالكًا في المؤسسة، فما الذي يمكنني الوصول إليه؟
لا يمكن للمستخدمين الذين ليسوا مالكين في المؤسسة رؤية سوى المشاريع التي هم أعضاء فيها. ويمكن فقط لمالك المؤسسة رؤية جميع المشاريع والأعضاء ومفاتيح API على مستوى المشروع، والوصول إلى صفحة Projects.
يمكن فقط لأعضاء المشروع (ومالكي المؤسسة) رؤية النماذج المضبوطة بدقة التي تم إنشاؤها داخل ذلك المشروع، أو سلاسل الرسائل من أي مساعدين تم إنشاؤهم، أو أي ملفات تمت إضافتها.
يمكن لأعضاء المشروع رؤية جميع الأعضاء الآخرين في ذلك المشروع وأدوارهم (أي Owner أو Member).
كيف أحدّث دور مستخدم في المشروع أو أزيل مستخدمًا من مشروع؟
يمكن فقط لمالك المشروع تحديث دور مستخدم في المشروع أو إزالة مستخدم من مشروع. يُرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
لتحديث مستخدم في مشروع، انتقل إلى إعدادات المؤسسة، وحدد المشروع، ثم انقر على Members. لديك خيار تعيين دور كل عضو كـ Member أو Owner. يمكنك أيضًا تحديد Remove لإزالة المستخدم من المشروع.
ما حساب الخدمة، وكيف يختلف عن حساب المستخدم العادي؟
يعمل حساب الخدمة كمستخدم شبه افتراضي مُصمم لوصول الأنظمة، وهو يختلف عن حسابات المستخدمين الفردية. يمكن فقط لمالكي المؤسسة ومالكي المشاريع إنشاء حسابات خدمة.
حسابات الخدمة محصورة ضمن المشاريع فقط.
إضافة عضو إلى مشروع
إذا نقرت على زر + Add member فسترى قائمة بالمستخدمين في مؤسستك الذين لديهم دور Reader. إذا أردت إضافة مستخدم ليس ضمن مؤسستك حاليًا، فستحتاج أولاً إلى إضافته إلى المؤسسة (ويمكنك إبقاء مربع الاختيار 'Add to Default Project" دون تحديد إذا كنت لا تريد منح هؤلاء المستخدمين وصولاً أوسع). لن تتضمن هذه القائمة حسابات الخدمة. خلال هذه الخطوة يمكنك اختيار ما إذا كان دوره Owner أو Member:
عند إضافة عضو فريق، يجب أن تعيّن له دور Member أو Owner. يمكن لأعضاء المشروع تنفيذ طلبات API التي تقرأ البيانات أو تعدّلها، بينما يمكن لمالكي المشروع أيضًا تعديل إعدادات المشروع وميزانياته وإدارة أعضائه. يُرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
كيفية إنشاء حساب خدمة لمشروع
انتقل أولاً إلى المشروع الذي تريد إنشاء حساب خدمة له باختياره من القائمة المنسدلة الموجودة في شريط التنقل:
ثم انتقل إلى إعدادات المؤسسة -> Project -> Members -> وانقر على + Service account:
حسابات الخدمة التي يتم إنشاؤها على مستوى المشروع تكون فريدة لهذا المشروع ولا يمكن استخدامها خارج المشروع الذي أُنشئت فيه.
تسمية حساب الخدمة
بصرف النظر عما إذا كنت تنشئ حساب الخدمة على مستوى المؤسسة أو تنشئ حسابًا فريدًا لمشروع، فعند إنشاء حساب خدمة يمكنك إنشاء معرّف فريد لحساب الخدمة يتكون من أحرف وأرقام وواصلات لتسهيل التعرف على حساب الخدمة.
احفظ مفتاح API لحساب الخدمة
بعد تحديد زر Create، يتم إنشاء مفتاح API فورًا لحساب الخدمة وسيتم عرض المفتاح السري. احفظ هذا المفتاح السري في مكان آمن ومأمون. ولأسباب أمنية، لن تتمكن من عرضه مرة أخرى عبر حساب OpenAI الخاص بك. إذا فقدت هذا المفتاح السري، فستحتاج إلى إنشاء مفتاح جديد.
تُضبط أذونات مفتاح API لحساب الخدمة افتراضيًا على قراءة وكتابة جميع موارد API الخاصة بالمشروع. ويمكن تحديث هذه الأذونات في إعدادات API Keys الخاصة بمشروعك.
تُدرج حسابات الخدمة إلى جانب أعضاء المشروع في صفحة إعدادات أعضاء مشروعك. يُرجى الرجوع إلى هنا لمعرفة المزيد حول تحديث وصول حساب خدمة أو إزالته في صفحة إعدادات أعضاء مشروعك.
سيتم عرض جميع حسابات الخدمة عبر كلٍّ من المشاريع والمؤسسات إلى جانب المستخدمين البشريين لديك في صفحة الأعضاء على مستوى المؤسسة.
تُدار حسابات الخدمة مثل الحسابات العادية. من المؤسسة -> قائمة الأعضاء يمكنك إزالة حساب خدمة أو تحديث الدور:
كيف أدير مفاتيح API داخل مشاريع مؤسستي؟
يمكنك إنشاء مفاتيح API لكل مشروع وإدارتها من صفحة إعدادات ذلك المشروع. في إعدادات المؤسسة، حدّد المشروع، ثم انقر على API Keys.
لإنشاء مفتاح سري جديد، حدّد + Create new secret key. يمكنك أيضًا تحديد أيقونة التحرير بجانب مفتاح سري لتحرير أذوناته.
يمكنك تعيين الأذونات لكل مفتاح من مفاتيح API عند إنشاء مفتاح سري جديد أو بتحرير مفتاح موجود.
تتوفر ثلاثة مستويات من الأذونات: All وRestricted وRead Only.
All — يتم تعيين الأذونات الكاملة للمفتاح السري. وهذا هو الإعداد الافتراضي.
Restricted — يتيح للمستخدم تعيين أذونات None وRead وWrite لكل نقطة نهاية.
على سبيل المثال، يمكنك إنشاء مفتاح API لا يملك تحديدًا إذن Read أو Write على نقطة النهاية /v1/assistants:
Read Only — يتم تعيين أذونات القراءة لجميع نقاط النهاية.
كيف تُدار صلاحية الوصول للمستخدمين المنتمين إلى عدة مشاريع أو مؤسسات؟
يمكن أن يكون المستخدمون أعضاء في العدد الذي يلزم من المشاريع. وداخل المشروع، يمكن للمستخدمين إنشاء مفتاح API شخصي يكون مقيّدًا ومحصورًا في الوصول إلى ذلك المشروع وموارده.
كيف أضبط حدود المعدل لمشاريع مؤسستي وأديرها؟
يمكن فقط لمالك المؤسسة ضبط حدود المعدل على مستوى المشروع وإدارتها. يُرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات.
في إعدادات المؤسسة، انقر على المشروع الذي تريد تحديثه وحدد Limits في قسم Project من قائمة التنقل. يمكنك تحديث Model Usage في هذه الصفحة.
يتيح لك استخدام النموذج تكوين النماذج التي يمكن للمشروع استخدامها، ويمكن تعيين حدود المعدل لكل نموذج حسب الحاجة.
كيف أضبط الميزانيات لمشاريع مؤسستي وأديرها؟
يمكن فقط لمالكي المؤسسة ومالكي المشروع ضبط ميزانيات المشاريع وإدارتها. يُرجى الرجوع إلى الأدوار والأذونات لمزيد من المعلومات. لتغيير الحدود على مستوى المؤسسة، في إعدادات المؤسسة، انقر على Limits، ثم مرّر لأسفل إلى Usage limits.
لضبط حدود مشروعك، في إعدادات المؤسسة، انقر على المشروع الذي تريد تحديثه وحدد Limits. يمكنك تحديث Monthly budget وNotification threshold و Model Usage.
يتيح لك تعيين ميزانية شهرية وضع حدود إنفاق مرنة لمشروعك. عندما يتجاوز الاستخدام هذا الحد خلال شهر تقويمي معين (UTC)، ستستمر معالجة طلبات API دون انقطاع. صُممت هذه الميزة لمساعدتك على مراقبة الاستخدام عبر تنبيهات الميزانية، لكنها لا تفرض حدًا صارمًا على الإنفاق. عند إنشاء ميزانية مشروع، سيتم افتراضيًا إنشاء تنبيه عند حد 100%. ويمكن تعيين ميزانيات إضافية عند حدود مختلفة بالنقر على Add Alert.
يرجى ملاحظة أن مالك/مالكي المؤسسة ومالك/مالكي المشروع سيتلقون هذه الرسائل دائمًا، ولا يمكن تخصيص ذلك.
كيف أحذف مشروعًا أو أؤرشفه؟
يمكن أرشفة المشاريع إما من خلال صفحة قائمة المشاريع الجديدة أو من إعدادات مشروع فردي. بمجرد أرشفة المشروع لا يمكن استعادته. وعند متابعة الأرشفة، سيُطلب منك إدخال اسم المشروع للمتابعة.
يمكنك عرض قائمة بجميع المشاريع المؤرشفة عبر علامة التبويب «Archived» في صفحة قائمة المشاريع نفسها.
لا يمكن حذف المشاريع، إذ نحتفظ بسجل لجميع المشاريع لضمان الاستمرارية في تتبع الاستخدام والفوترة.
هل يوجد حد لعدد المشاريع التي يمكنني امتلاكها في مؤسستي؟
يمكن للمؤسسات إنشاء ما يصل إلى 2,000 مشروع افتراضيًا.
هل يمكن مشاركة الموارد عبر المشاريع؟
موارد المشروع (مثل الملفات أو المساعدين أو التخزين أو سلاسل الرسائل) تكون محصورة ضمن المشروع ولا يمكن الوصول إليها من قِبل الأعضاء غير الإداريين خارج المشروع. إضافة إلى ذلك، لا يمكن نقل الموارد بين المشاريع.
الاستثناء الوحيد هو أن عمليات الضبط الدقيق في «المشروع الافتراضي» يمكن الوصول إليها من مشاريع أخرى.
ما حصة تخزين الملفات لكل مشروع؟
تدعم OpenAI حاليًا حصة تخزين ملفات قدرها 100 جيجابايت من الملفات لكل مشروع.
إذا تم تجاوز هذه الحصة، فسترى الخطأ التالي:
لقد تجاوزت حصة تخزين الملفات الخاصة بك. تقتصر المؤسسات على 100 جيجابايت من الملفات. يُرجى تقليل حجم الملفات أو التواصل مع الدعم.نوصي بحذف الملفات غير المستخدمة المخزنة في حسابك. وللاطلاع، يمكنك عرض الملفات وسردها باستخدام الـ API.
أنا مالك مشروع، لماذا لا يمكنني رؤية لوحة معلومات الاستخدام لمشروعي؟
لا ترتبط إمكانية رؤية لوحة معلومات استخدام المشاريع بدور المستخدم داخل المشروع. بل يتم تحديدها بحسب دورك داخل المؤسسة والإعدادات الموجودة على https://platform.openai.com/settings/organization/data-controls/visibility
إذا لم تتمكن من رؤية لوحة معلومات الاستخدام، فمن المرجح أن يكون هذا الإعداد مضبوطًا على "Visible to organization owners".