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