OpenAI
Бұл бет машиналық аударма арқылы жасалған. Түпнұсқа ағылшын мақаласын қараңыз.

API платформасындағы жобаларды басқару

Жаңартылған: 7 days ago

Жобалар клиенттерге жұмыстарын ұйымдастыру мүмкіндігін беруге бағытталған. Ұйымдар қатынас пен шектеулерді басқара алады, қызметтік есептік жазбаларды (UI арқылы) дайындай алады және жоба ішіндегі шектеулі ауқым бойынша пайдалануды бақылай алады (мысалы, модельдер, мүмкіндіктер, тармақтар, көмекшілер, дәл баптау, сақтау орны және т.б.). Пайдалану белсенділігін жобалар бойынша бөлуге болады, ал пайдаланушылар әр жоба бойынша биллингті көріп, бюджеттерді орната алады.

Ұйым иелері өздерінің барлық Белсенді және Архивтелген жобаларын Жобалар бетінде көре алады. API платформасындағы пайдаланушы рөлдері мен рұқсаттары туралы толығырақ біліңіз.

Image

Жобаны кім жасай алады?

Жобаны тек ұйым иелері жасай алады. Қосымша ақпарат үшін рөлдер мен рұқсаттарды қараңыз.

Ұйымдар арасында ауысу үшін беттің жоғарғы сол жағындағы ұйым атауының үстіне меңзерді апарып, тізімнен ұйымды таңдаңыз:

Projects page with the organization switcher open, listing Personal and Staging organizations

Біріктірілген биллинг жоспары бар ұйымдарда қосалқы ұйымдар бөлек көрсетіледі. Қосалқы ұйымдар ішінде жобалар жасау мүмкін емес.

Image

Жобалар қалай жұмыс істейді?

Әр ұйымға жоюға болмайтын “Әдепкі жоба” кіреді. Rate limit шектерін, виртуалды модель рұқсаттарын және шығын бюджеттерін баптай аласыз (2024 жылғы қарашадан бастап). Ол ұйымның толық конфигурациясын мұра етеді, сондықтан оған мүшелерді немесе қызметтік тіркелгілерді тікелей қоса алмайсыз.

Жобаны қалай жасаймын?

Алдымен беттің сол жақ бұрышындағы жоба атауына меңзерді апарып, Create project тармағын таңдаңыз.

API platform project menu with Create project highlighted under Default project

Жобаңызға атау, сипаттама және веб-сайт енгізіп, содан кейін Create түймесін таңдаңыз.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Пайдаланушыларды жобаға қалай қосамын?

Жаңадан қосылған ұйым мүшелері «Әдепкі жобаға» автоматты түрде қосылмайды. Жаңа мүшелерді жобаға ұйымға шақырған кезде («Әдепкі жобаға шақыру» құсбелгісін қосу арқылы) немесе мүше ұйым шақыруын қабылдағаннан кейін шақыруға болады.

Admin API арқылы шақырылған пайдаланушылар /organization/invites соңғы нүктесінде сипатталған ережелерге бағынады.

UI немесе Admin API арқылы пайдаланушыларды жобаға шақырғанда қате шықса, шақыруды қайта жібермес бұрын мақсатты жобаның бар екенін және архивтелмегенін тексеріңіз.

Ұйым иелері ұйым ішінде жасалған жаңа жобаларға автоматты түрде ие ретінде қосылады.

Ұйымдар мен жобалардағы әртүрлі пайдаланушы рөлдері қандай және олар қандай рұқсаттарды қамтиды?

Ұйымдарда «ие» және «оқырман» рөлдері болса, жобаларда «ие» және «мүше» рөлдері бар. Жоба мүшелері ұйым оқырмандарына ұқсас. Әр пайдаланушы рөлімен бірге берілетін рұқсаттардың толығырақ сипаттамасын төмендегі кестеден қараңыз.

РөлАуқымСипаттама
ИеҰйымБарлық жобаларды, барлық пайдаланушыларды және барлық API кілттерін жасай/көре алады. Ұйым ішіндегі барлық жобалар бойынша Жобалар беті арқылы бақылау мүмкіндігі бар. Ұйым бюджеттері мен жоба бюджеттерін орната алады. Ұйымдағы басқалардың пайдалану ақпаратын көруіне рұқсат бере алады. Жобаларды архивтей алады.
ОқырманҰйымӨз жобаларында инференс орындай, ресурстарды пайдалана және кілттер жасай алады. Жобаларға қосыла алады.
Жобалар жасай және пайдаланушыларды басқара алмайды.
ИеЖобаЖобаға басқа пайдаланушыларды қоса және жобаның атауын өзгерте алады, сондай-ақ Мүшенің барлық мүмкіндіктеріне ие. Жоба бюджеттерін орната алады. Жобаны архивтей алады.
МүшеЖобаЖоба деңгейінде инференс орындай, ресурстарды пайдалана және кілттер жасай алады.

Егер мен ұйымдағы Ие болмасам, неге қатынасым бар?

Ұйымда Ие емес пайдаланушылар тек өздері мүше болып табылатын жобаларды ғана көре алады. Тек ұйым иесі барлық жобаларды, мүшелерді және жоба деңгейіндегі API кілттерін көре алады әрі Жобалар бетіне қатынаса алады.

  • Тек жоба мүшелері (және ұйым иелері) сол жобада жасалған дәл бапталған модельдерді, жасалған кез келген Assistants тармақтарын немесе қосылған кез келген файлдарды көре алады.

  • Жоба мүшелері сол жобаның басқа барлық мүшелерін және олардың рөлдерін (яғни Ие немесе Мүше) көре алады.

Пайдаланушының жобадағы рөлін қалай жаңартамын немесе пайдаланушыны жобадан қалай алып тастаймын?

Пайдаланушының жобадағы рөлін жаңартуға немесе пайдаланушыны жобадан алып тастауға тек жоба иесі құқылы. Қосымша ақпарат үшін рөлдер мен рұқсаттарды қараңыз.

Жобадағы пайдаланушыны жаңарту үшін ұйым параметрлеріне өтіп, жобаны таңдаңыз да, Мүшелер түймесін басыңыз. Әр мүшенің рөлін Мүше немесе Ие ретінде орнатуға болады. Пайдаланушыны жобадан алып тастау үшін Жою опциясын да таңдай аласыз.

Қызметтік тіркелгі деген не және оның кәдімгі пайдаланушы тіркелгісінен айырмашылығы қандай?

Қызметтік тіркелгі — жеке пайдаланушы тіркелгілерінен бөлек, жүйелік қатынасқа арналған жалған пайдаланушы. Қызметтік тіркелгілерді тек ұйым және жоба иелері жасай алады.

Қызметтік тіркелгілер тек жобалар аясымен шектеледі.

Жобаға мүше қосу

+ Add member түймесін бассаңыз, ұйымыңыздағы Reader рөлі бар пайдаланушылар тізімін көресіз. Қазір ұйымыңызда жоқ пайдаланушыны қосқыңыз келсе, алдымен оны ұйымға қосуыңыз керек (бұл пайдаланушыларға кеңірек қатынас бергіңіз келмесе, «Әдепкі жобаға қосу» құсбелгісін белгілемей қалдыруға болады). Бұл тізімге қызметтік есептік жазбалар кірмейді. Осы қадамда олардың рөлі Owner немесе Member болатынын таңдай аласыз:

Project members with Add team members dialog assigning a user the Member role

Топ мүшесін қосқанда, оған Мүше немесе Ие рөлін тағайындауыңыз керек. Жоба мүшелері деректерді оқитын немесе өзгертетін API сұрауларын жасай алады, ал жоба иелері жоба параметрлері мен бюджеттерін өзгертіп, жоба мүшелерін де басқара алады. Қосымша ақпарат үшін рөлдер мен рұқсаттарды қараңыз.

Жоба үшін қызметтік есептік жазбаны қалай жасауға болады

Алдымен навигация жолағындағы ашылмалы тізімнен таңдап, қызметтік есептік жазба жасағыңыз келетін жобаға өтіңіз:

API platform project switcher open with options to create a project or manage projects

Содан кейін ұйым параметрлеріне өтіңіз -> Жоба -> Мүшелер -> + Service account түймесін басыңыз:

Жоба деңгейінде жасалған қызметтік тіркелгілер жобаға ғана тән және оларды жасалған жобадан тыс жерде пайдалану мүмкін емес.

Project Members page with Create a service account dialog after selecting the Service account option

Қызметтік тіркелгіні атау

Қызметтік тіркелгіні ұйым деңгейінде жасасаңыз да, жобаға бірегей етіп жасасаңыз да, оны жасағанда қызметтік тіркелгіні оңай тану үшін әріптерден, сандардан және сызықшалардан тұратын бірегей қызметтік тіркелгі ID-сін жасай аласыз.

Қызметтік есептік жазбаның API кілтін сақтаңыз

Жасау түймесін таңдағаннан кейін, қызметтік есептік жазба үшін API кілті бірден жасалып, құпия кілт көрсетіледі. Бұл құпия кілтті қауіпсіз әрі қорғалған жерде сақтаңыз. Қауіпсіздік себептерімен оны OpenAI есептік жазбаңыз арқылы қайта көре алмайсыз. Бұл құпия кілтті жоғалтсаңыз, жаңасын жасауыңыз керек болады.

Members page with Save your key modal after creating a service account

Қызметтік есептік жазбаның API кілті рұқсаттары әдепкі бойынша жобаның барлық API ресурстарын оқуға және жазуға орнатылады. Бұл рұқсаттарды жобаңыздың API кілттері параметрлерінде жаңартуға болады.

Қызметтік есептік жазбалар жобаңыздың мүше параметрлері бетінде жоба мүшелерімен бірге тізімделеді. Жобаңыздың мүше параметрлері бетінде қызметтік есептік жазбаның қатынасын жаңарту немесе алып тастау туралы көбірек білу үшін осы жерді қараңыз.

Жобалар мен ұйымдардағы барлық қызметтік есептік жазбалар адам пайдаланушыларыңызбен бірге ұйым деңгейіндегі мүшелер бетінде көрсетіледі.

Қызметтік есептік жазбалар әдеттегі есептік жазбалар сияқты басқарылады. Ұйым -> Мүшелер мәзірінен қызметтік есептік жазбаны Жоюға немесе рөлін жаңартуға болады:

OpenAI API Members settings with a service account role menu open for Reader or Owner

Ұйымымның жобаларында API кілттерін қалай басқарамын?

Әр жоба үшін API кілттерін сол жобаның параметрлер бетінде жасап, басқара аласыз. Ұйым параметрлерінде жобаны таңдап, API кілттері түймесін басыңыз.

Жаңа құпия кілт жасау үшін + Create new secret key таңдаңыз. Құпия кілттің жанындағы Өңдеу белгішесін таңдап, оның рұқсаттарын өңдей аласыз.

API keys page for a project with the Create new secret key button highlighted

Жаңа құпия кілт жасағанда немесе бар кілтті өңдегенде, әр API кілтіңіз үшін рұқсаттарды орната аласыз.

Рұқсаттардың үш деңгейі бар: Барлығы, Шектеулі және Тек оқу.

  • Барлығы — Құпия кілт үшін толық рұқсаттар орнатылады. Бұл — әдепкі параметр.

  • Шектеулі — Пайдаланушыға әр соңғы нүкте үшін Ешқайсысы, Оқу және Жазу рұқсаттарын орнатуға мүмкіндік береді.

    • Мысалы, /v1/assistants соңғы нүктесіне Оқу немесе Жазу рұқсаты арнайы жоқ API кілтін жасайсыз:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Тек оқу — Барлық соңғы нүктелер үшін оқу рұқсаттары орнатылады.

Бірнеше жобаға немесе ұйымға тиесілі пайдаланушылар үшін қатынас қалай басқарылады?

Пайдаланушылар қажет болғанша көп жобаның мүшесі бола алады. Жоба ішінде пайдаланушылар сол жобаға және оның ресурстарына ғана қатынас беретін, ауқымы шектелген жеке API кілтін жасай алады.

Ұйымымның жобалары үшін сұраныс шектеулерін қалай орнатып, басқарамын?

Жоба деңгейіндегі сұраныс шектеулерін тек ұйым иесі орнатып, басқара алады. Қосымша ақпарат үшін рөлдер мен рұқсаттарды қараңыз.


Ұйым параметрлерінде жаңартқыңыз келетін жобаны басып, навигация тізімінің Жоба бөлімінде Шектеулер таңдаңыз. Бұл бетте Модельді пайдалануды жаңарта аласыз.

Модельді пайдалану жобада қандай модельдерді қолдануға болатынын баптауға мүмкіндік береді, ал сұраныс шектеулерін қажетіне қарай әр модель үшін орнатуға болады.

Ұйымымның жобалары үшін бюджеттерді қалай орнатып, басқарамын?

Жоба бюджеттерін тек ұйым иелері және жоба иелері орнатып, басқара алады. Қосымша ақпарат үшін рөлдер мен рұқсаттарды қараңыз. Ұйым деңгейіндегі шектеулерді өзгерту үшін ұйым параметрлерінде Шектеулер түймесін басып, Пайдалану шектеулері бөліміне төмен жылжыңыз.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Жоба шектеулерін орнату үшін ұйым параметрлерінде жаңартқыңыз келетін жобаны басып, Шектеулер таңдаңыз. Айлық бюджет, Хабарландыру шегі және Модельді пайдалану параметрлерін жаңарта аласыз.


Айлық бюджет орнату жобаңыз үшін жұмсаудың жұмсақ шектерін белгілеуге мүмкіндік береді. Берілген күнтізбелік айда (UTC) пайдалану осы шектен асқанда, API сұраулары үзіліссіз өңделе береді. Бұл мүмкіндік бюджет ескертулері арқылы пайдалануды бақылауға көмектесуге арналған, бірақ шығынға қатаң шек қоймайды. Жоба бюджеті жасалғанда, әдепкі бойынша 100% шегінде ескерту жасалады. Әртүрлі шектердегі қосымша бюджеттерді Ескерту қосу түймесін басу арқылы орнатуға болады.

Ұйым иелері мен жоба иелері бұл хабарларды әрқашан алатынын және мұны баптау мүмкін емес екенін ескеріңіз.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Жобаны қалай жоямын немесе архивтеймін?

Жобаларды жаңа жобалар тізімі беті арқылы немесе жеке жобаның параметрлерінде архивтеуге болады. Жоба архивтелгеннен кейін оны қалпына келтіру мүмкін емес. Архивтеуді жалғастырғанда, алға өту үшін жобаның атауын енгізу сұралады.

Барлық архивтелген жобалар тізімін сол жобалар тізімі бетіндегі «Архивтелген» қойындысынан көре аласыз.

API platform Projects page with the Archived tab selected to view archived projects

Жобаларды жою мүмкін емес; пайдалану мен биллингті қадағалауда сабақтастықты қамтамасыз ету үшін барлық жобалардың тарихын сақтаймыз.

Ұйымымда қанша жоба болатынына шек бар ма?

Ұйымдар әдепкі бойынша 2 000 жобаға дейін жасай алады.

Ресурстарды жобалар арасында бөлісуге бола ма?

Жоба ресурстары (мысалы, файлдар, ассистенттер, сақтау орны немесе ағындар) жоба аясымен шектеледі және жоба сыртындағы әкімші емес мүшелерге қолжетімсіз. Бұдан бөлек, ресурстарды жобалар арасында көшіру мүмкін емес.

Жалғыз ерекшелік — “Әдепкі жобадағы” fine-tune үлгілеріне басқа жобалардан қол жеткізуге болады.

Бір жобаға берілетін файл сақтау квотасы қандай?

OpenAI қазір әр жобаға 100 ГБ файл сақтау квотасын қолдайды.

Егер бұл квота асса, келесі қатені көресіз:

Файл сақтау квотаңыздан астыңыз. Ұйымдар 100 ГБ файлмен шектеледі. Файл өлшемін азайтыңыз немесе қолдау қызметіне хабарласыңыз.

Есептік жазбаңызда сақталған пайдаланылмайтын файлдарды жоюды ұсынамыз. Анықтама үшін API арқылы файлдарды қарап, тізімдей аласыз.

Мен жоба иесімін, неге жобамның Пайдалану бақылау тақтасын көре алмаймын?

Жобаның Пайдалану бақылау тақтасының көрінуі пайдаланушының жоба ішіндегі рөліне байланысты емес. Оның орнына, ол ұйым ішіндегі рөліңізбен және https://platform.openai.com/settings/organization/data-controls/visibility мекенжайындағы параметрлермен анықталады.

Project setting for Usage dashboard visibility with Visible to organization owners selected

Пайдалану бақылау тақтасын көре алмасаңыз, бұл параметр «Ұйым иелеріне көрінеді» деп орнатылған болуы мүмкін.

Бұл мақала пайдалы болды ма?