نمای کلی
پروژه‌ها فعالیت‌ها را درون یک سازمان API سامان‌دهی می‌کنند. از پروژه‌ها برای مدیریت دسترسی، تنظیم محدودیت‌های مدل و محدودیت تعداد درخواست، ایجاد حساب‌های سرویس و پیگیری میزان استفاده، صورت‌حساب و سقف هزینه برای مجموعه‌ای مشخص از منابع مانند مدل‌ها، قابلیت‌ها، رشته‌های گفتگو، دستیارها، ریزتنظیم و فضای ذخیره‌سازی استفاده کنید.
مالکان سازمان می‌توانند همه پروژه‌های فعال و بایگانی‌شده را در صفحه پروژه‌ها مشاهده کنند.
پیش از شروع
برای ایجاد پروژه باید نقش مالک سازمان را داشته باشید. سازمان‌ها به‌طور پیش‌فرض می‌توانند تا ۲٬۰۰۰ پروژه ایجاد کنند.
اگر سازمان شما از صورت‌حساب یکپارچه استفاده می‌کند، سازمان‌های زیرمجموعه به‌صورت جداگانه در انتخابگر سازمان نمایش داده می‌شوند. نمی‌توانید در سازمان زیرمجموعه پروژه ایجاد کنید.
برای تغییر سازمان، انتخابگر سازمان را باز کنید و سازمان موردنظر را انتخاب کنید.
پروژه پیش‌فرض
هر سازمان یک پروژه پیش‌فرض دارد که نمی‌توان آن را حذف کرد. این پروژه تمام تنظیمات سازمان را به ارث می‌برد. می‌توانید محدودیت تعداد درخواست، مجوزهای مدل مجازی و سقف هزینه آن را تنظیم کنید.
نمی‌توانید اعضا یا حساب‌های سرویس را مستقیماً به پروژه پیش‌فرض اضافه کنید. می‌توانید هنگام دعوت از فردی به سازمان، با دنبال کردن مراحل دعوت به سازمان در این مقاله، دسترسی به پروژه پیش‌فرض را نیز به او بدهید.
ایجاد پروژه
انتخابگر پروژه را باز کنید و ایجاد پروژه را انتخاب کنید.
نام، توضیحات و وب‌سایت پروژه خود را وارد کنید.
ایجاد را انتخاب کنید.
مالکان سازمان به‌طور خودکار به‌عنوان مالک به پروژه‌های جدید اضافه می‌شوند.
آشنایی با نقش‌ها و دسترسی
این جدول خلاصه‌ای از نقش‌های مالک و خواننده در سازمان و نقش‌های مالک و عضو در پروژه را ارائه می‌دهد که در این مراحل به آن‌ها اشاره شده است. مجوزهای اعضای پروژه مشابه مجوزهای خوانندگان سازمان است.
| نقش | دامنه | مجوزها |
|---|---|---|
| مالک | سازمان | ایجاد و مشاهده همه پروژه‌ها، کاربران و کلیدهای API. پایش پروژه‌ها در صفحه پروژه‌ها. تعیین سقف هزینه سازمان و پروژه. اعطای دسترسی به اطلاعات میزان استفاده سایر کاربران. بایگانی پروژه‌ها. |
| خواننده | سازمان | اضافه شدن به پروژه‌ها، انجام استنتاج، استفاده از منابع و ایجاد کلید در آن پروژه‌ها. امکان ایجاد پروژه یا مدیریت کاربران را ندارد. |
| مالک | پروژه | همه مجوزهای عضو، به‌علاوه افزودن کاربران، مدیریت اعضا و تنظیمات پروژه، تغییر نام پروژه، تعیین سقف هزینه و بایگانی آن. |
| عضو | پروژه | انجام استنتاج، استفاده از منابع، ایجاد کلیدهای سطح پروژه و ارسال درخواست‌های API برای خواندن یا تغییر داده‌ها. |
برای جزئیات نقش‌های سازمان، به نقش‌های سازمان مراجعه کنید. برای آشنایی با نقش‌های دیگر، نقش‌های سفارشی و فهرست کامل مجوزها، به راهنمای نقش‌ها و مجوزهای API مراجعه کنید.
قابلیت مشاهده پروژه‌ها
با این نقش‌های استاندارد، کاربرانی که مالک سازمان نیستند فقط می‌توانند پروژه‌هایی را ببینند که عضو آن‌ها هستند. مالکان سازمان می‌توانند همه پروژه‌ها، اعضا و کلیدهای API در سطح پروژه را ببینند و به صفحه پروژه‌ها دسترسی داشته باشند.
اعضای پروژه می‌توانند سایر اعضای پروژه خود و نقش هر عضو را ببینند. فقط اعضای پروژه و مالکان سازمان می‌توانند مدل‌های ریزتنظیم‌شده، رشته‌های گفتگوی دستیار و فایل‌هایی را ببینند که در آن پروژه ایجاد یا به آن اضافه شده‌اند.
می‌توانید به هر تعداد پروژه که نیاز دارید، عضو شوید. کلید API شخصی که در یک پروژه ایجاد می‌شود، به همان پروژه و منابع آن محدود است.
محدوده دسترسی به منابع
فایل‌ها، دستیارها، فضای ذخیره‌سازی و رشته‌های گفتگو به پروژه خود محدود هستند. اعضای غیرمدیر خارج از آن پروژه نمی‌توانند به منابع آن دسترسی داشته باشند و منابع را نمی‌توان بین پروژه‌ها جابه‌جا کرد.
مدل‌های ریزتنظیم‌شده در پروژه پیش‌فرض استثنا هستند: از پروژه‌های دیگر نیز می‌توان به آن‌ها دسترسی داشت.
مدیریت اعضای پروژه
دعوت از افراد به سازمان
پیش از آنکه بتوانید فردی را به پروژه اضافه کنید، او باید عضو سازمان شما باشد.
هنگام دعوت از فردی به سازمان، می‌توانید با انتخاب گزینه مربوطه در فرم دعوت، دسترسی به پروژه پیش‌فرض را نیز به او بدهید. اگر نمی‌خواهید دسترسی به پروژه پیش‌فرض را بدهید، این گزینه را انتخاب نکنید. اعضای جدید سازمان به‌طور خودکار به پروژه پیش‌فرض اضافه نمی‌شوند.
لازم نیست پیش از دعوت از فردی، پروژه دیگری ایجاد کنید. همچنین می‌توانید پس از پذیرش دعوت سازمان، فرد را به یک پروژه اضافه کنید.
دعوت‌نامه‌هایی که از طریق API مدیریت ارسال می‌شوند، از قواعد نقطه پایان /organization/invites پیروی می‌کنند.
افزودن عضو سازمان به پروژه
مالکان سازمان و پروژه می‌توانند اعضا را اضافه کنند:
به تنظیمات سازمان بروید.
پروژه را انتخاب کنید، سپس اعضا را باز کنید.
+ افزودن عضو را انتخاب کنید.
کاربر را انتخاب کنید و نقش عضو یا مالک را به او اختصاص دهید.
فهرست کاربران، کاربران سازمان با نقش خواننده را نشان می‌دهد. این فهرست شامل حساب‌های سرویس نیست.
اگر ارسال دعوت‌نامه در رابط کاربری یا API مدیریت ناموفق بود، پیش از ارسال دوباره، مطمئن شوید که پروژه مقصد وجود دارد و بایگانی نشده است.
تغییر نقش یا حذف عضو
مالکان سازمان و پروژه می‌توانند نقش کاربر در پروژه را تغییر دهند یا او را از آن پروژه حذف کنند.
به تنظیمات سازمان بروید.
پروژه را انتخاب کنید، سپس اعضا را باز کنید.
نقش کاربر را روی عضو یا مالک تنظیم کنید، یا برای حذف او، حذف را انتخاب کنید.
ایجاد و مدیریت حساب‌های سرویس
حساب سرویس به‌جای آنکه نماینده یک کاربر باشد، دسترسی سیستم‌ها را فراهم می‌کند. حساب‌های سرویس به پروژه‌ها محدود هستند.
ایجاد حساب‌های سرویس به مجوزهای مدیریت حساب سرویس نیاز دارد. مالکان سازمان و پروژه این مجوزها را دارند.
ایجاد حساب سرویس
پروژه را در انتخابگر پروژه انتخاب کنید.
به تنظیمات سازمان بروید و پروژه را انتخاب کنید.
اعضا را باز کنید و + حساب سرویس را انتخاب کنید.
با استفاده از حروف، اعداد و خط تیره، یک شناسه یکتا برای حساب سرویس وارد کنید.
ایجاد را انتخاب کنید.
حساب‌های سرویسی که در سطح پروژه ایجاد می‌شوند، مختص همان پروژه هستند و بیرون از پروژه‌ای که در آن ایجاد شده‌اند قابل استفاده نیستند.
چه حساب سرویس را از تنظیمات سطح سازمان ایجاد کنید و چه از تنظیمات سطح پروژه، قالب شناسه یکسان است.
حساب سرویسی که برای یک پروژه ایجاد می‌شود، مختص همان پروژه است و نمی‌توان از آن خارج از پروژه استفاده کرد.
ذخیره کلید محرمانه
با ایجاد حساب سرویس، بلافاصله یک کلید API ایجاد و کلید محرمانه آن نمایش داده می‌شود. کلید محرمانه را در جای امنی ذخیره کنید. نمی‌توانید دوباره آن را از طریق حساب OpenAI خود مشاهده کنید. اگر آن را گم کردید، کلید جدیدی ایجاد کنید.
کلید حساب سرویس به‌طور پیش‌فرض مجوز خواندن و نوشتن همه منابع API در پروژه خود را دارد. می‌توانید بعداً این مجوزها را در تنظیمات کلیدهای API پروژه تغییر دهید.
به‌روزرسانی یا حذف حساب سرویس
حساب‌های سرویس در کنار کاربران در تنظیمات اعضای پروژه نمایش داده می‌شوند. دسترسی آن‌ها به پروژه را با همان مراحل تغییر نقش و حذف سایر اعضای پروژه مدیریت کنید.
همه حساب‌های سرویس، از جمله حساب‌هایی که از تنظیمات سطح سازمان و سطح پروژه ایجاد شده‌اند، در کنار کاربران در صفحه اعضای سازمان نیز نمایش داده می‌شوند.
از منوی اعضای سازمان، می‌توانید نقش حساب سرویس را تغییر دهید یا حذف را انتخاب کنید.
ایجاد و مدیریت کلیدهای API
هر پروژه کلیدهای API مخصوص خود را دارد:
به تنظیمات سازمان بروید.
پروژه را انتخاب کنید، سپس کلیدهای API را باز کنید.
برای ایجاد کلید، + ایجاد کلید محرمانه جدید را انتخاب کنید؛ یا برای تغییر مجوزهای یک کلید موجود، نماد ویرایش کنار آن را انتخاب کنید.
انتخاب مجوزهای کلید
برای کلیدهای متعلق به کاربران، می‌توانید مجوزها را هنگام ایجاد کلید تنظیم کنید یا بعداً آن‌ها را ویرایش کنید:
همه: مجوزهای کامل. این گزینه پیش‌فرض است.
محدود: دامنه دسترسی به منابع یا نقاط پایان مشخص را انتخاب کنید. گزینه‌های موجود به منبع بستگی دارند و می‌توانند شامل هیچ‌کدام، خواندن، نوشتن یا مجوزهای مختص هر درخواست باشند.
فقط خواندنی: مجوز خواندن برای همه نقاط پایان.
برای مثال، یک کلید محدود می‌تواند فاقد دسترسی خواندن و نوشتن به نقطه پایان /v1/assistants باشد.
ایجاد کلیدهای حساب سرویس به مجوزهای مدیریت حساب سرویس نیاز دارد. اگر این گزینه را نمی‌بینید، از مالک سازمان یا پروژه بخواهید کلید حساب سرویس را ایجاد کند. پنجره ایجاد کلید، این تنظیمات مجوز را برای کلیدهای حساب سرویس نشان نمی‌دهد؛ مجوزهای آن‌ها را بعداً در تنظیمات کلیدهای API پروژه تغییر دهید.
تنظیم دسترسی به مدل و محدودیت تعداد درخواست
مدیریت محدودیت تعداد درخواست پروژه به مجوزهای مدیریتی نیاز دارد. مالکان سازمان این مجوزها را دارند و مالکان پروژه نیز می‌توانند محدودیت تعداد درخواست پروژه را از طریق API مدیریت تنظیم کنند.
به تنظیمات سازمان بروید.
پروژه را انتخاب کنید، سپس محدودیت‌ها را باز کنید.
در بخش استفاده از مدل مشخص کنید که پروژه می‌تواند از کدام مدل‌ها استفاده کند.
در صورت نیاز، برای هر مدل محدودیت تعداد درخواست تعیین کنید.
تنظیم سقف هزینه و هشدارها
سقف هزینه ماهانه API را می‌توان هم در سطح سازمان و هم در سطح پروژه تعیین کرد. برای تغییر سقف هزینه، باید مجوز مدیریت تنظیمات سازمان یا پروژه مربوطه را داشته باشید.
با تعیین سقف هزینه می‌توانید بدون متوقف کردن درخواست‌ها، هزینه‌ها را پایش کنید. اگر می‌خواهید پس از رسیدن هزینه ثبت‌شده به سقف تعیین‌شده، درخواست‌های API ناموفق شوند، اعمال سقف قطعی را روشن کنید. اعمال این سقف آنی نیست؛ بنابراین هزینه ثبت‌شده ممکن است اندکی از مبلغ تعیین‌شده بیشتر شود.
هشدارهای هزینه، رسیدن به آستانه تعیین‌شده را به شما اطلاع می‌دهند؛ اما درخواست‌ها را متوقف نمی‌کنند.
تعیین سقف هزینه سازمان
به تنظیمات سازمان بروید.
محدودیت‌ها را باز کنید و بخش هزینه را پیدا کنید.
تعیین سقف هزینه پروژه
به تنظیمات سازمان بروید.
پروژه را انتخاب کنید، سپس محدودیت‌ها را باز کنید.
مقادیر سقف هزینه ماهانه و هشدار هنگام رسیدن هزینه به را تنظیم کنید.
اگر می‌خواهید پس از رسیدن هزینه ثبت‌شده به سقف تعیین‌شده، ترافیک API متوقف شود، اعمال یک سقف قطعی را روشن کنید.
همچنین می‌توانید استفاده از مدل را در این صفحه تغییر دهید.
مدیریت هشدارهای هزینه
با تعیین سقف هزینه پروژه، به‌طور پیش‌فرض هشداری برای رسیدن هزینه به ۱۰۰٪ این سقف نیز ایجاد می‌شود. برای افزودن هشدار در آستانه‌های دیگر، افزودن هشدار را انتخاب کنید.
مالکان سازمان و پروژه، هشدارهای هزینه پروژه را دریافت می‌کنند. می‌توانید در تنظیمات هشدار، گیرندگان ایمیل دیگری اضافه کنید.
برای اطلاع از مراحل فعلی پیکربندی و نحوه اعمال سقف هزینه، به راهنمای سقف هزینه مراجعه کنید.
مشاهده میزان استفاده و صورت‌حساب
میزان استفاده را می‌توان به تفکیک پروژه بررسی کرد. همچنین می‌توانید صورت‌حساب هر پروژه را ببینید و سقف هزینه آن را تعیین کنید.
دسترسی به داشبورد میزان استفاده پروژه، به نقش شما در سازمان و تنظیمات نمایش داشبورد میزان استفاده بستگی دارد. مالک پروژه بودن به‌تنهایی این دسترسی را به شما نمی‌دهد.
اگر نمی‌توانید داشبورد میزان استفاده پروژه را ببینید، بررسی کنید که آیا تنظیم نمایش روی قابل مشاهده برای مالکان سازمان قرار دارد یا نه.
مدیریت فضای ذخیره‌سازی فایل
سهمیه فضای ذخیره‌سازی فایل هر پروژه ۱۰۰ گیگابایت است. اگر از این سهمیه فراتر بروید، ممکن است این خطا را ببینید:
از سهمیه فضای ذخیره‌سازی فایل خود فراتر رفته‌اید. سازمان‌ها می‌توانند حداکثر ۱۰۰ گیگابایت فایل ذخیره کنند. لطفاً حجم فایل را کاهش دهید یا با پشتیبانی تماس بگیرید.
برای آزاد کردن فضای ذخیره‌سازی، فایل‌های بلااستفاده را حذف کنید. برای شناسایی فایل‌هایی که دیگر به آن‌ها نیاز ندارید، می‌توانید فهرست فایل‌های ذخیره‌شده را از طریق API دریافت کنید.
بایگانی پروژه
مالکان سازمان و پروژه می‌توانند پروژه‌ها را از صفحه پروژه‌ها یا از تنظیمات هر پروژه بایگانی کنند. وقتی از شما خواسته شد، نام پروژه را برای تأیید وارد کنید.
بایگانی دائمی است: پروژه بایگانی‌شده را نمی‌توان بازیابی کرد.
برای مشاهده پروژه‌های بایگانی‌شده، زبانه بایگانی‌شده را در صفحه پروژه‌ها باز کنید.
تنها استثنا این است که فاین‌تیون‌های موجود در «پروژه پیش‌فرض» از پروژه‌های دیگر قابل دسترسی هستند.
از سهمیه فضای ذخیره‌سازی فایل خود فراتر رفته‌اید. سازمان‌ها به 100 گیگابایت فایل محدود هستند. لطفاً اندازه فایل را کاهش دهید یا با پشتیبانی تماس بگیرید.پروژه‌ها را نمی‌توان حذف کرد. OpenAI سابقه آن‌ها را برای پیگیری میزان استفاده و صورت‌حساب نگه می‌دارد.