هدف پروژهها این است که به مشتریان امکان دهند کارشان را سازماندهی کنند. سازمانها میتوانند دسترسی و محدودیتها را مدیریت کنند، حسابهای سرویس را (از طریق رابط کاربری) فراهم کنند و استفاده را در محدودهای محدودشده در یک پروژه پیگیری کنند (مانند مدلها، قابلیتها، رشتهها، دستیارها، تنظیم دقیق، فضای ذخیرهسازی و غیره). فعالیت استفاده را میتوان بر اساس پروژه تفکیک کرد، و کاربران میتوانند صورتحساب را مشاهده کنند و برای هر پروژه محدودیت هزینه تعیین کنند.
مالکان سازمان میتوانند همه پروژههای فعال و بایگانیشده خود را در صفحه پروژهها مشاهده کنند. درباره نقشها و مجوزهای کاربران در پلتفرم API بیشتر بدانید.
چه کسی میتواند پروژه ایجاد کند؟
فقط مالکان سازمان میتوانند پروژه ایجاد کنند. برای اطلاعات بیشتر، لطفاً به نقشها و مجوزها مراجعه کنید.
برای جابهجایی بین سازمانها، نشانگر را روی نام سازمان خود در گوشهٔ بالای چپ صفحه ببرید و سازمان را از فهرست انتخاب کنید:
برای سازمانهایی که در یک طرح صورتحساب یکپارچه هستند، زیرسازمانها بهصورت جداگانه شناسایی میشوند. پروژهها را نمیتوان درون زیرسازمانها ایجاد کرد.
پروژهها چگونه کار میکنند؟
هر سازمان شامل یک «پروژه پیشفرض» است که قابل حذف نیست. میتوانید محدودیتهای نرخ، مجوزهای مدل مجازی و محدودیتهای هزینه را پیکربندی کنید (از نوامبر ۲۰۲۴). این پروژه پیکربندی کامل سازمان را به ارث میبرد، بنابراین نمیتوانید مستقیماً عضو یا حساب سرویس به آن اضافه کنید.
چطور یک پروژه ایجاد کنم؟
ابتدا نشانگر را روی نام پروژه در گوشه چپ صفحه ببرید و Create project را انتخاب کنید.
برای پروژه خود یک نام، توضیح و وبسایت وارد کنید و سپس Create را انتخاب کنید.
چگونه کاربران را به یک پروژه اضافه کنم؟
اعضای تازهافزودهشدهٔ سازمان بهطور خودکار به «پروژه پیشفرض» اضافه نمیشوند. اعضای جدید را میتوان یا هنگام دعوت به سازمان (با فعال کردن کادر انتخاب «دعوت به پروژه پیشفرض») یا پس از پذیرش دعوت سازمان توسط عضو، به پروژه دعوت کرد.
کاربرانی که از طریق Admin API دعوت میشوند، از قواعد شرحدادهشده در نقطه پایان /organization/invites پیروی میکنند.
اگر هنگام دعوت کاربران به یک پروژه از طریق رابط کاربری یا Admin API با خطا روبهرو شدید، پیش از ارسال دوبارهٔ دعوت، ابتدا تأیید کنید که پروژهٔ مقصد وجود دارد و بایگانی نشده است.
مالکان سازمان بهطور خودکار بهعنوان مالک به پروژههای جدیدی که درون یک سازمان ایجاد میشوند اضافه میشوند.
نقشهای مختلف کاربر در سازمانها و پروژهها چیست و چه مجوزهایی دارند؟
در حالی که سازمانها نقشهای «مالک» و «خواننده» دارند، پروژهها نقشهای «مالک» و «عضو» دارند. اعضای پروژه مشابه خوانندگان سازمان هستند. برای توضیح دقیقتر درباره مجوزهای مربوط به هر نقش کاربری، به جدول زیر مراجعه کنید.
| نقش | دامنه | شرح |
|---|---|---|
| مالک | سازمان | میتواند همه پروژهها، همه کاربران و همه کلیدهای API را ایجاد/مشاهده کند. میتواند با استفاده از صفحه پروژهها همه پروژههای سازمان را پایش کند. میتواند محدودیتهای هزینه سازمان و محدودیتهای هزینه پروژه را تنظیم کند. میتواند برای دیگران در سازمان مجوز مشاهده اطلاعات استفاده را اعطا کند. میتواند پروژهها را بایگانی کند. |
| خواننده | سازمان | میتواند در پروژههای خود استنتاج انجام دهد، از منابع استفاده کند و کلید ایجاد کند. میتواند به پروژهها اضافه شود. نمیتواند پروژه ایجاد کند یا کاربران را مدیریت کند. |
| مالک | پروژه | میتواند کاربران دیگر را به پروژه اضافه کند و نام پروژه را تغییر دهد، و همچنین همه تواناییهای یک عضو را دارد. میتواند محدودیتهای هزینه پروژه را تنظیم کند. میتواند پروژه را بایگانی کند. |
| عضو | پروژه | میتواند در سطح پروژه استنتاج انجام دهد، از منابع استفاده کند و کلید ایجاد کند. |
اگر در سازمان مالک نباشم، به چه چیزهایی دسترسی دارم؟
کاربرانی که در سازمان مالک نیستند فقط میتوانند پروژههایی را ببینند که عضو آنها هستند. فقط مالک سازمان میتواند همهٔ پروژهها، اعضا و کلیدهای API را در سطح پروژه ببیند و به صفحهٔ پروژهها دسترسی داشته باشد.
فقط اعضای یک پروژه (و مالکان سازمان) میتوانند مدلهای تنظیم دقیقشدهای را که درون آن پروژه ایجاد شدهاند، رشتههای مربوط به هر دستیار ایجادشده، یا هر فایل اضافهشده را ببینند.
اعضای یک پروژه میتوانند ببینند سایر اعضای آن پروژه چه کسانی هستند و نقشهایشان چیست (یعنی مالک یا عضو).
چگونه نقش پروژهای یک کاربر را بهروزرسانی کنم یا کاربری را از پروژه حذف کنم؟
فقط مالک یک پروژه میتواند نقش پروژهای کاربر را بهروزرسانی کند یا کاربری را از پروژه حذف کند. برای اطلاعات بیشتر، لطفاً به نقشها و مجوزها مراجعه کنید.
برای بهروزرسانی یک کاربر در پروژه، به تنظیمات سازمان خود بروید، پروژه را انتخاب کنید و روی Members کلیک کنید. میتوانید نقش هر عضو را بهعنوان عضو یا مالک تنظیم کنید. همچنین میتوانید برای حذف کاربر از پروژه، Remove را انتخاب کنید.
حساب سرویس چیست و چه تفاوتی با حساب کاربری عادی دارد؟
حساب سرویس مانند یک شبهکاربر برای دسترسی سیستمی عمل میکند و با حسابهای کاربری افراد تفاوت دارد. فقط مالکان سازمان و پروژه میتوانند حسابهای سرویس ایجاد کنند.
حسابهای سرویس فقط در محدوده پروژهها هستند.
افزودن عضو به پروژه
اگر روی دکمه + Add member کلیک کنید، فهرستی از کاربران سازمانتان را میبینید که نقش Reader دارند. اگر میخواهید کاربری را اضافه کنید که در حال حاضر در سازمان شما نیست، ابتدا باید او را به سازمان اضافه کنید (اگر نمیخواهید به این کاربران دسترسی گستردهتری بدهید، میتوانید کادر «افزودن به پروژه پیشفرض» را بدون انتخاب بگذارید). این فهرست شامل حسابهای سرویس نمیشود. در این مرحله میتوانید انتخاب کنید که نقش آنها Owner باشد یا Member:
وقتی عضوی از تیم را اضافه میکنید، باید نقش عضو یا مالک را به او اختصاص دهید. اعضای پروژه میتوانند درخواستهای API برای خواندن یا تغییر دادهها ارسال کنند، در حالی که مالکان پروژه علاوه بر این میتوانند تنظیمات پروژه و محدودیتهای هزینه پروژه را تغییر دهند و اعضای پروژه را مدیریت کنند. برای اطلاعات بیشتر، به نقشها و مجوزها مراجعه کنید.
نحوهٔ ایجاد حساب سرویس برای یک پروژه
ابتدا با انتخاب از منوی کشویی موجود در نوار پیمایش، به پروژهای بروید که میخواهید برای آن حساب سرویس ایجاد کنید:
سپس به تنظیمات سازمان خود بروید -> Project -> Members -> روی + Service account کلیک کنید:
حسابهای سرویسی که در سطح پروژه ایجاد میشوند، مختص همان پروژه هستند و بیرون از پروژهای که در آن ایجاد شدهاند قابل استفاده نیستند.
نامگذاری حساب سرویس
فرقی نمیکند حساب سرویس را در سطح سازمان ایجاد کنید یا حسابی منحصربهفرد برای یک پروژه بسازید؛ هنگام ایجاد حساب سرویس میتوانید یک شناسه منحصربهفرد برای حساب سرویس بسازید که از حروف، اعداد و خط تیره تشکیل شده باشد تا شناسایی آن آسانتر شود.
کلید API حساب سرویس را ذخیره کنید
پس از انتخاب دکمهٔ Create، یک کلید API بلافاصله برای حساب سرویس ایجاد میشود و کلید مخفی نمایش داده خواهد شد. این کلید مخفی را در جایی امن و مطمئن ذخیره کنید. به دلایل امنیتی، نمیتوانید دوباره آن را از طریق حساب OpenAI خود مشاهده کنید. اگر این کلید مخفی را از دست بدهید، باید یک کلید جدید تولید کنید.
مجوزهای کلید API حساب سرویس بهطور پیشفرض روی خواندن و نوشتن همهٔ منابع API پروژه تنظیم شدهاند. این مجوزها را میتوان در تنظیمات API Keys پروژهٔ شما بهروزرسانی کرد.
حسابهای سرویس در صفحهٔ تنظیمات اعضای پروژهٔ شما، در کنار اعضای پروژه فهرست میشوند. برای کسب اطلاعات بیشتر دربارهٔ بهروزرسانی یا حذف دسترسی یک حساب سرویس در صفحهٔ تنظیمات اعضای پروژهٔ خود، لطفاً به اینجا مراجعه کنید.
همهٔ حسابهای سرویس در سراسر پروژهها و سازمانها، در کنار کاربران انسانی شما در صفحهٔ اعضای سطح سازمان نمایش داده خواهند شد.
حسابهای سرویس مانند حسابهای عادی مدیریت میشوند. از منوی Organization -> Members میتوانید یک حساب سرویس را حذف کنید یا نقش را بهروزرسانی کنید:
چگونه کلیدهای API را در پروژههای سازمانم مدیریت کنم؟
میتوانید کلیدهای API هر پروژه را در صفحهٔ تنظیمات همان پروژه ایجاد و مدیریت کنید. در تنظیمات سازمان خود، پروژه را انتخاب کنید و روی API Keys کلیک کنید.
برای ایجاد یک کلید مخفی جدید، + Create new secret key را انتخاب کنید. همچنین میتوانید برای ویرایش مجوزهای یک کلید مخفی، نماد ویرایش کنار آن را انتخاب کنید.
میتوانید هنگام ایجاد یک کلید مخفی جدید یا با ویرایش یک کلید موجود، برای هر یک از کلیدهای API خود مجوز تنظیم کنید.
سه سطح مجوز در دسترس است: همه، محدود، و فقط خواندنی.
همه — مجوزهای کامل برای کلید مخفی تنظیم میشود. این تنظیم پیشفرض است.
محدود — به کاربر امکان میدهد برای هر نقطه پایان، مجوزهای هیچکدام، خواندن و نوشتن را تنظیم کند.
برای مثال، یک کلید API ایجاد میکنید که مشخصاً مجوز خواندن یا نوشتن در نقطه پایان /v1/assistants را ندارد:
فقط خواندنی — مجوزهای خواندن برای همهٔ نقاط پایان تنظیم میشود.
دسترسی برای کاربرانی که به چند پروژه یا سازمان تعلق دارند چگونه مدیریت میشود؟
کاربران میتوانند عضو هر تعداد پروژه که لازم باشد باشند. درون یک پروژه، کاربران میتوانند یک کلید API شخصی ایجاد کنند که دامنه آن محدود به دسترسی به همان پروژه و منابع آن باشد.
چگونه محدودیتهای تعداد درخواست را برای پروژههای سازمانم تنظیم و مدیریت کنم؟
فقط مالک یک سازمان میتواند محدودیتهای تعداد درخواست در سطح پروژه را تنظیم و مدیریت کند. برای اطلاعات بیشتر، لطفاً به نقشها و مجوزها مراجعه کنید.
در تنظیمات سازمان خود، روی پروژهای که میخواهید بهروزرسانی کنید کلیک کنید و در بخش Project از فهرست پیمایش، Limits را انتخاب کنید. میتوانید استفاده از مدل خود را در این صفحه بهروزرسانی کنید.
استفاده از مدل به شما امکان میدهد پیکربندی کنید که کدام مدلها میتوانند توسط پروژه استفاده شوند، و محدودیتهای تعداد درخواست را میتوان در صورت نیاز برای هر مدل تنظیم کرد.
چگونه محدودیتهای هزینه را برای پروژههای سازمانم تنظیم و مدیریت کنم؟
فقط مالکان سازمان و مالکان پروژه میتوانند محدودیتهای هزینه پروژه را تنظیم و مدیریت کنند. برای اطلاعات بیشتر، به نقشها و مجوزها مراجعه کنید. برای تغییر محدودیتها در سطح سازمان، در تنظیمات سازمان خود، روی محدودیتها، کلیک کنید و تا محدودیتهای استفاده. به پایین پیمایش کنید.
برای تنظیم محدودیتهای پروژه، در تنظیمات سازمان خود، روی پروژهای که میخواهید بهروزرسانی کنید کلیک کنید و محدودیتها. را انتخاب کنید. میتوانید محدودیت هزینه ماهانه، آستانه اعلان و استفاده از مدل را بهروزرسانی کنید.
تنظیم محدودیت هزینه ماهانه به شما امکان میدهد آستانههای نرم هزینه را برای پروژهتان تعیین کنید. وقتی میزان استفاده در یک ماه تقویمی مشخص (UTC) از این محدودیت فراتر برود، درخواستهای API بدون وقفه همچنان پردازش میشوند. این قابلیت برای کمک به پایش میزان استفاده از طریق هشدارهای محدودیت هزینه طراحی شده است، اما سقف سختی برای هزینهها اعمال نمیکند. وقتی محدودیت هزینه پروژه ایجاد میشود، بهطور پیشفرض هشداری در آستانه ۱۰۰٪ ایجاد خواهد شد. با کلیک روی افزودن هشدار میتوان هشدارهای بیشتری را در آستانههای مختلف تنظیم کرد.
توجه داشته باشید که مالک(ان) سازمان و مالک(ان) پروژه همیشه این پیامها را دریافت خواهند کرد و این مورد قابل سفارشیسازی نیست.
چگونه برای سازمان یا پروژهام محدودیت هزینه تنظیم کنم؟
OpenAI اکنون از محدودیتهای ماهانه هزینه API هم در سطح سازمان و هم در سطح پروژه پشتیبانی میکند. محدودیت هزینه میتواند بدون اعمال محدودیت، هزینه را پایش کند، یا میتوانید آن را بهصورت یک محدودیت سخت اعمال کنید تا پس از رسیدن هزینه به حد تعیینشده، درخواستهای API ناموفق شوند. برای آخرین مراحل پیکربندی و رفتار، در مستندات توسعهدهندگان به محدودیتهای هزینه مراجعه کنید.
چگونه یک پروژه را حذف یا بایگانی کنم؟
پروژهها را میتوان از طریق صفحهٔ جدید فهرست پروژهها یا در تنظیمات یک پروژهٔ جداگانه بایگانی کرد. پس از بایگانی شدن یک پروژه، امکان بازیابی آن وجود ندارد. هنگام ادامه دادن فرایند بایگانی، از شما خواسته میشود برای ادامه نام پروژه را وارد کنید.
میتوانید فهرست همهٔ پروژههای بایگانیشده را از طریق برگهٔ «بایگانیشده» در همان صفحهٔ فهرست پروژهها مشاهده کنید.
حذف پروژهها ممکن نیست؛ ما تاریخچهٔ همهٔ پروژهها را نگه میداریم تا تداوم در ردیابی استفاده و صورتحساب تضمین شود.
آیا برای تعداد پروژههایی که میتوانم در سازمانم داشته باشم محدودیتی وجود دارد؟
سازمانها بهطور پیشفرض میتوانند تا 2,000 پروژه ایجاد کنند.
آیا منابع را میتوان بین پروژهها به اشتراک گذاشت؟
منابع پروژه (مانند فایلها، دستیارها، فضای ذخیرهسازی یا threadها) در محدوده همان پروژه هستند و اعضای غیرادمین خارج از پروژه نمیتوانند به آنها دسترسی داشته باشند. همچنین منابع را نمیتوان بین پروژهها جابهجا کرد.
تنها استثنا این است که فاینتیونهای موجود در «پروژه پیشفرض» از پروژههای دیگر قابل دسترسی هستند.
سهمیه ذخیرهسازی فایل برای هر پروژه چقدر است؟
OpenAI در حال حاضر از سهمیه ذخیرهسازی 100 گیگابایت فایل برای هر پروژه پشتیبانی میکند.
اگر این سهمیه نقض شود، خطای زیر را خواهید دید:
از سهمیه فضای ذخیرهسازی فایل خود فراتر رفتهاید. سازمانها به 100 گیگابایت فایل محدود هستند. لطفاً اندازه فایل را کاهش دهید یا با پشتیبانی تماس بگیرید.توصیه میکنیم فایلهای استفادهنشدهٔ ذخیرهشده در حساب خود را حذف کنید. برای مرجع، میتوانید با API فایلها را مشاهده و فهرست کنید.
من مالک پروژه هستم؛ چرا نمیتوانم داشبورد استفادهٔ پروژهام را ببینم؟
قابلیت مشاهدهٔ داشبورد استفادهٔ یک پروژه به نقش کاربر درون پروژه مربوط نیست. در عوض، این مورد بر اساس نقش شما درون سازمان و تنظیمات موجود در https://platform.openai.com/settings/organization/data-controls/visibility تعیین میشود.
اگر نمیتوانید داشبورد استفاده را ببینید، احتمالاً این تنظیم روی «قابل مشاهده برای مالکان سازمان» قرار دارد.