هدف پروژهها این است که به مشتریان امکان دهند کارشان را سازماندهی کنند. سازمانها میتوانند دسترسی و محدودیتها را مدیریت کنند، حسابهای سرویس را (از طریق رابط کاربری) فراهم کنند و استفاده را در محدودهای محدودشده در یک پروژه پیگیری کنند (مانند مدلها، قابلیتها، رشتهها، دستیارها، تنظیم دقیق، فضای ذخیرهسازی و غیره). فعالیت استفاده را میتوان بر اساس پروژه تفکیک کرد، و کاربران میتوانند صورتحساب را مشاهده کنند و برای هر پروژه محدودیت هزینه تعیین کنند.
مالکان سازمان میتوانند همه پروژههای فعال و بایگانیشده خود را در صفحه پروژهها مشاهده کنند. درباره نقشها و مجوزهای کاربران در پلتفرم API بیشتر بدانید.
چه کسی میتواند پروژه ایجاد کند؟
فقط مالکان سازمان میتوانند پروژه ایجاد کنند. برای اطلاعات بیشتر به نقشها و مجوزها مراجعه کنید.
برای جابهجایی بین سازمانها، نشانگر را روی نام سازمان در بالای سمت چپ صفحه نگه دارید و سازمان موردنظر را از فهرست انتخاب کنید:
در سازمانهایی که از طرح صورتحساب تجمیعی استفاده میکنند، زیرسازمانها بهطور جداگانه مشخص میشوند. در زیرسازمانها نمیتوان پروژه ایجاد کرد.
پروژهها چگونه کار میکنند؟
هر سازمان یک «پروژه پیشفرض» دارد که قابل حذف نیست. میتوانید محدودیتهای نرخ، مجوزهای مدل مجازی و محدودیتهای هزینه را پیکربندی کنید (از نوامبر ۲۰۲۴). این پروژه همه تنظیمات سازمان را به ارث میبرد؛ بنابراین نمیتوانید اعضا یا حسابهای سرویس را مستقیماً به آن اضافه کنید.
چگونه پروژه ایجاد کنم؟
ابتدا نشانگر را روی نام پروژه در گوشه سمت چپ صفحه نگه دارید و ایجاد پروژه را انتخاب کنید.
نام، توضیحات و وبسایت پروژه را وارد کنید و سپس ایجاد را انتخاب کنید.
چگونه کاربران را به یک پروژه اضافه کنم؟
اعضایی که بهتازگی به سازمان اضافه شدهاند، بهطور خودکار به «پروژه پیشفرض» افزوده نمیشوند. اعضای جدید را میتوان هنگام دعوت به سازمان، با فعالکردن کادر «دعوت به پروژه پیشفرض»، یا پس از پذیرفتن دعوتنامه سازمان به پروژه دعوت کرد.
کاربرانی که از طریق Admin API دعوت میشوند، از قواعد ذکرشده در نقطه پایان /organization/invites پیروی میکنند.
اگر هنگام دعوت کاربران به پروژه از طریق رابط کاربری یا Admin API با خطا روبهرو شدید، پیش از ارسال دوباره دعوتنامه مطمئن شوید پروژه مقصد وجود دارد و بایگانی نشده است.
مالکان سازمان بهطور خودکار بهعنوان مالک به پروژههای جدیدی که در سازمان ایجاد میشوند، افزوده خواهند شد.
نقشهای مختلف کاربران در سازمانها و پروژهها چیست و هرکدام چه مجوزهایی دارند؟
درحالیکه سازمانها نقشهای «مالک» و «خواننده» دارند، نقشهای پروژه شامل «مالک» و «عضو» است. اعضای پروژه مشابه خوانندگان سازمان هستند. برای توضیح دقیقتر مجوزهای مربوط به هر نقش کاربری، به جدول زیر مراجعه کنید.
| نقش | دامنه | شرح |
|---|---|---|
| مالک | سازمان | میتواند همه پروژهها، کاربران و کلیدهای API را ایجاد یا مشاهده کند. میتواند با استفاده از صفحه پروژهها بر همه پروژههای سازمان نظارت کند. میتواند محدودیت هزینه سازمان و پروژهها را تعیین کند. میتواند مجوز مشاهده اطلاعات مصرف را به دیگران در سازمان بدهد. میتواند پروژهها را بایگانی کند. |
| خواننده | سازمان | میتواند در پروژههای خود استنتاج انجام دهد، از منابع استفاده کند و کلید بسازد. میتوان او را به پروژهها افزود. نمیتواند پروژه ایجاد یا کاربران را مدیریت کند. |
| مالک | پروژه | میتواند کاربران دیگر را به پروژه اضافه کند، نام پروژه را تغییر دهد و همه قابلیتهای یک عضو را نیز دارد. میتواند محدودیت هزینه پروژه را تعیین کند. میتواند پروژه را بایگانی کند. |
| عضو | پروژه | میتواند در سطح پروژه استنتاج انجام دهد، از منابع استفاده کند و کلید بسازد. |
اگر در سازمان مالک نباشم، به چه چیزهایی دسترسی دارم؟
کاربرانی که در سازمان مالک نیستند، فقط پروژههایی را میبینند که عضو آنها هستند. فقط مالک سازمان میتواند همه پروژهها، اعضا و کلیدهای API را در سطح پروژه ببیند و به صفحه پروژهها دسترسی داشته باشد.
فقط اعضای پروژه و مالکان سازمان میتوانند مدلهای تنظیم دقیقشده ایجادشده در آن پروژه، رشتههای مربوط به دستیارهای ایجادشده و فایلهای افزودهشده را ببینند.
اعضای پروژه میتوانند سایر اعضای همان پروژه و نقش آنها، یعنی مالک یا عضو، را ببینند.
چگونه نقش پروژهای یک کاربر را تغییر دهم یا او را از پروژه حذف کنم؟
فقط مالک پروژه میتواند نقش پروژهای کاربر را تغییر دهد یا او را از پروژه حذف کند. برای اطلاعات بیشتر به نقشها و مجوزها مراجعه کنید.
برای بهروزرسانی یک کاربر در پروژه، به تنظیمات سازمان بروید، پروژه را انتخاب کنید و روی اعضا کلیک کنید. میتوانید نقش هر شخص را روی عضو یا مالک تنظیم کنید. همچنین میتوانید برای حذف کاربر از پروژه، حذف را انتخاب کنید.
حساب سرویس چیست و چه تفاوتی با حساب کاربری عادی دارد؟
حساب سرویس مانند یک کاربر مجازی برای دسترسی سیستمی عمل میکند و از حساب کاربران واقعی متمایز است. فقط مالکان سازمان و پروژه میتوانند حساب سرویس ایجاد کنند.
حسابهای سرویس فقط در محدوده پروژهها هستند.
افزودن عضو به پروژه
با کلیک روی دکمه + افزودن عضو، فهرست کاربران سازمان با نقش خواننده نمایش داده میشود. اگر کاربر موردنظر هنوز عضو سازمانتان نیست، ابتدا باید او را به سازمان اضافه کنید. اگر نمیخواهید این کاربران دسترسی گستردهتری داشته باشند، میتوانید کادر «افزودن به پروژه پیشفرض» را علامت نزنید. حسابهای سرویس در این فهرست نمایش داده نمیشوند. در این مرحله میتوانید نقش آنها را مالک یا عضو تعیین کنید:
هنگام افزودن یکی از اعضای تیم، باید نقش عضو یا مالک را به او اختصاص دهید. اعضای پروژه میتوانند درخواستهای API برای خواندن یا تغییر دادهها ارسال کنند؛ مالکان پروژه علاوه بر این، میتوانند تنظیمات و محدودیت هزینه پروژه را تغییر دهند و اعضای پروژه را مدیریت کنند. برای اطلاعات بیشتر به نقشها و مجوزها مراجعه کنید.
نحوه ایجاد حساب سرویس برای پروژه
ابتدا از فهرست کشویی نوار پیمایش، پروژهای را انتخاب کنید که میخواهید برای آن حساب سرویس بسازید:
سپس به تنظیمات سازمان -> پروژه -> اعضا بروید و روی + حساب سرویس کلیک کنید:
حسابهای سرویسی که در سطح پروژه ایجاد میشوند، مختص همان پروژه هستند و بیرون از پروژهای که در آن ایجاد شدهاند قابل استفاده نیستند.
نامگذاری حساب سرویس
چه حساب سرویس را در سطح سازمان ایجاد کنید و چه حسابی مختص یک پروژه بسازید، هنگام ایجاد آن میتوانید شناسهای یکتا شامل حروف، اعداد و خط تیره تعیین کنید تا حساب سرویس بهآسانی قابل شناسایی باشد.
ذخیره کلید API حساب سرویس
پس از انتخاب دکمه ایجاد، بلافاصله یک کلید API برای حساب سرویس ساخته و کلید محرمانه نمایش داده میشود. این کلید محرمانه را در محلی امن ذخیره کنید. به دلایل امنیتی، دیگر نمیتوانید آن را از طریق حساب OpenAI خود مشاهده کنید. اگر این کلید محرمانه را گم کنید، باید کلید جدیدی بسازید.
مجوزهای پیشفرض کلید API حساب سرویس شامل خواندن و نوشتن در همه منابع API پروژه است. این مجوزها را میتوان در تنظیمات کلیدهای API پروژه بهروزرسانی کرد.
حسابهای سرویس همراه با اعضای پروژه در صفحه تنظیمات اعضای پروژه فهرست میشوند. برای آشنایی بیشتر با نحوه بهروزرسانی یا حذف دسترسی حساب سرویس در صفحه تنظیمات اعضای پروژه، به اینجا مراجعه کنید.
همهٔ حسابهای سرویس در سراسر پروژهها و سازمانها، در کنار کاربران انسانی شما در صفحهٔ اعضای سطح سازمان نمایش داده خواهند شد.
حسابهای سرویس مانند حسابهای عادی مدیریت میشوند. از منوی Organization -> Members میتوانید یک حساب سرویس را حذف کنید یا نقش را بهروزرسانی کنید:
چگونه کلیدهای API را در پروژههای سازمانم مدیریت کنم؟
میتوانید کلیدهای API هر پروژه را در صفحه تنظیمات همان پروژه ایجاد و مدیریت کنید. در تنظیمات سازمان، پروژه را انتخاب کنید و روی کلیدهای API کلیک کنید.
برای ایجاد کلید محرمانه جدید، + ایجاد کلید محرمانه جدید را انتخاب کنید. همچنین میتوانید برای ویرایش مجوزهای یک کلید محرمانه، نماد ویرایش کنار آن را انتخاب کنید.
میتوانید هنگام ایجاد کلید محرمانه جدید یا با ویرایش کلید موجود، مجوزهای هر کلید API را تعیین کنید.
سه سطح مجوز در دسترس است: کامل، محدودشده و فقط خواندنی.
کامل — همه مجوزها برای کلید محرمانه فعال میشوند. این تنظیم پیشفرض است.
محدودشده — به کاربر امکان میدهد مجوزهای «هیچکدام»، «خواندن» و «نوشتن» را برای هر نقطه پایان تعیین کند.
برای مثال، میتوانید کلیدی برای API ایجاد کنید که مشخصاً مجوز خواندن یا نوشتن در نقطه پایان /v1/assistants را نداشته باشد:
فقط خواندنی — مجوز خواندن برای همه نقاط پایان فعال میشود.
دسترسی کاربرانی که عضو چند پروژه یا سازمان هستند چگونه مدیریت میشود؟
کاربران میتوانند عضو هر تعداد پروژه موردنیاز باشند. کاربران میتوانند در هر پروژه یک کلید API شخصی ایجاد کنند که دامنه و دسترسی آن به همان پروژه و منابعش محدود است.
چگونه محدودیت نرخ پروژههای سازمانم را تنظیم و مدیریت کنم؟
فقط مالک سازمان میتواند محدودیتهای نرخ در سطح پروژه را تنظیم و مدیریت کند. برای اطلاعات بیشتر به نقشها و مجوزها مراجعه کنید.
در تنظیمات سازمان روی پروژه موردنظر کلیک کنید و در بخش پروژه از فهرست پیمایش، محدودیتها را انتخاب کنید. در این صفحه میتوانید استفاده از مدل را بهروزرسانی کنید.
بخش استفاده از مدل به شما امکان میدهد مدلهای قابل استفاده در پروژه را مشخص کنید و در صورت نیاز برای هر مدل محدودیت نرخ تعیین کنید.
چگونه محدودیت هزینه پروژههای سازمانم را تنظیم و مدیریت کنم؟
فقط مالکان سازمان و مالکان پروژه میتوانند محدودیت هزینه پروژه را تنظیم و مدیریت کنند. برای اطلاعات بیشتر به نقشها و مجوزها مراجعه کنید. برای تغییر محدودیتها در سطح سازمان، در تنظیمات سازمان روی محدودیتها، کلیک کنید و به بخش محدودیتهای استفاده بروید.
برای تنظیم محدودیتهای پروژه، در تنظیمات سازمان روی پروژه موردنظر کلیک و محدودیتها را انتخاب کنید. میتوانید محدودیت هزینه ماهانه، آستانه اعلان و استفاده از مدل را بهروزرسانی کنید.
با تنظیم محدودیت هزینه ماهانه میتوانید برای هزینه پروژه آستانههای نرم تعیین کنید. اگر میزان استفاده در یک ماه تقویمی مشخص (UTC) از این محدودیت فراتر رود، پردازش درخواستهای API بدون وقفه ادامه خواهد یافت. این قابلیت با هشدارهای محدودیت هزینه به نظارت بر مصرف کمک میکند، اما سقف قطعی برای هزینهها اعمال نمیکند. هنگام ایجاد محدودیت هزینه پروژه، بهطور پیشفرض هشداری در آستانه ۱۰۰٪ ایجاد میشود. برای تعیین هشدارهای بیشتر در آستانههای متفاوت، روی افزودن هشدار کلیک کنید.
توجه داشته باشید که مالکان سازمان و مالکان پروژه همیشه این پیامها را دریافت میکنند و این مورد قابل سفارشیسازی نیست.
چگونه برای سازمان یا پروژهام محدودیت هزینه تعیین کنم؟
OpenAI اکنون از محدودیت ماهانه هزینه API در سطح سازمان و پروژه پشتیبانی میکند. محدودیت هزینه میتواند فقط هزینهها را بدون اعمال محدودیت پایش کند، یا میتوانید آن را بهصورت سقف قطعی اعمال کنید تا پس از رسیدن هزینه به حد تعیینشده، درخواستهای API ناموفق شوند. برای مشاهده جدیدترین مراحل پیکربندی و نحوه عملکرد، بخش محدودیتهای هزینه را در مستندات توسعهدهندگان ببینید.
چگونه یک پروژه را حذف یا بایگانی کنم؟
پروژهها را میتوان از صفحه جدید فهرست پروژهها یا تنظیمات هر پروژه بایگانی کرد. پروژه پس از بایگانیشدن قابل بازیابی نیست. برای ادامه فرایند بایگانی، از شما خواسته میشود نام پروژه را وارد کنید.
میتوانید فهرست همه پروژههای بایگانیشده را در زبانه «بایگانیشده» همان صفحه فهرست پروژهها مشاهده کنید.
حذف پروژهها امکانپذیر نیست. برای حفظ تداوم ردیابی مصرف و صورتحساب، سابقه همه پروژهها را نگه میداریم.
آیا تعداد پروژههایی که میتوانم در سازمان داشته باشم محدود است؟
سازمانها بهطور پیشفرض میتوانند حداکثر ۲٬۰۰۰ پروژه ایجاد کنند.
آیا میتوان منابع را میان پروژهها به اشتراک گذاشت؟
منابع پروژه، مانند فایلها، دستیارها، فضای ذخیرهسازی یا رشتهها، به همان پروژه محدودند و اعضای غیرمدیر خارج از پروژه نمیتوانند به آنها دسترسی داشته باشند. همچنین منابع را نمیتوان بین پروژهها جابهجا کرد.
تنها استثنا این است که فاینتیونهای موجود در «پروژه پیشفرض» از پروژههای دیگر قابل دسترسی هستند.
سهمیه ذخیرهسازی فایل برای هر پروژه چقدر است؟
OpenAI در حال حاضر برای هر پروژه سهمیه ذخیرهسازی ۱۰۰ گیگابایت فایل ارائه میکند.
اگر از این سهمیه فراتر بروید، خطای زیر را مشاهده خواهید کرد:
از سهمیه فضای ذخیرهسازی فایل خود فراتر رفتهاید. سازمانها به 100 گیگابایت فایل محدود هستند. لطفاً اندازه فایل را کاهش دهید یا با پشتیبانی تماس بگیرید.توصیه میکنیم فایلهای استفادهنشدهٔ ذخیرهشده در حساب خود را حذف کنید. برای مرجع، میتوانید با API فایلها را مشاهده و فهرست کنید.
من مالک پروژه هستم؛ چرا نمیتوانم داشبورد استفاده پروژهام را ببینم؟
نمایش داشبورد استفاده یک پروژه به نقش کاربر در آن پروژه ارتباطی ندارد. این دسترسی بر اساس نقش شما در سازمان و تنظیمات موجود در https://platform.openai.com/settings/organization/data-controls/visibility تعیین میشود.
اگر نمیتوانید داشبورد استفاده را ببینید، احتمالاً این گزینه روی «قابل مشاهده برای مالکان سازمان» تنظیم شده است.