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

Шолу

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

Ұйым иелері барлық белсенді және мұрағатталған жобаларды «Жобалар» бетінде көре алады.

Бастамас бұрын

Жоба құру үшін ұйым иесі рөлі қажет. Әдепкіде ұйымдар 2 000-ға дейін жоба құра алады.

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

Басқа ұйымға ауысу үшін ұйымды таңдау мәзірін ашып, пайдаланғыңыз келетін ұйымды таңдаңыз.

Әдепкі жоба

Әр ұйымда жоюға болмайтын Әдепкі жоба болады. Оған ұйымның барлық баптаулары қолданылады. Оның сұраныс шектеулерін, виртуалды модель рұқсаттарын және шығын шектеулерін баптай аласыз.

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

Жоба құру

1. Жобаны таңдау мәзірін ашып, Жоба құру пәрменін таңдаңыз.

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

3. Құру пәрменін таңдаңыз.

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

Рөлдер мен кіру рұқсаттары туралы

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

Ұйым рөлдері туралы толық ақпаратты ұйым рөлдері мақаласынан қараңыз. Қосымша рөлдер, теңшелетін рөлдер және барлық рұқсаттар туралы API рөлдері мен рұқсаттары жөніндегі нұсқаулықтан қараңыз.

Жобалардың көрінуі

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

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

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

Ресурстардың қолданылу шекаралары

Файлдар, көмекшілер, сақтау орны және әңгіме тармақтары тек өз жобасының аясында қолданылады. Бұл жобаға кірмейтін және әкімші емес мүшелер оның ресурстарына қол жеткізе алмайды. Ресурстарды жобалар арасында көшіру де мүмкін емес.

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

Жоба мүшелерін басқару

Ұйымыңызға біреуді шақыру

Біреуді ұйымға шақырғанда, шақыру формасындағы тиісті опцияны таңдап, Әдепкі жобаға да кіруге рұқсат бере аласыз. Әдепкі жобаға кіруге рұқсат бергіңіз келмесе, бұл опцияны таңдамаңыз. Ұйымның жаңа мүшелері Әдепкі жобаға автоматты түрде қосылмайды.

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

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

Ұйым мүшесін жобаға қосу

Ұйым және жоба иелері мүшелерді қоса алады:

1. Ұйым параметрлеріне өтіңіз.

2. Жобаны таңдап, Мүшелер бөлімін ашыңыз.

3. + Мүше қосу пәрменін таңдаңыз.

4. Пайдаланушыны таңдап, оған Мүше немесе Иесі рөлін тағайындаңыз.

Пайдаланушылар тізімінде «Оқырман» рөлі бар ұйым пайдаланушылары көрсетіледі. Оған қызметтік аккаунттар кірмейді.

Интерфейс немесе Әкімші API арқылы шақыру жіберу сәтсіз аяқталса, оны қайта жібермес бұрын тиісті жобаның бар екенін және мұрағатталмағанын тексеріңіз.

Рөлді өзгерту немесе мүшені жою

Ұйым және жоба иелері пайдаланушының жобадағы рөлін өзгерте алады немесе оны жобадан шығара алады.

1. Ұйым параметрлеріне өтіңіз.

2. Жобаны таңдап, Мүшелер бөлімін ашыңыз.

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

Қызметтік аккаунттарды құру және басқару

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

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

Қызметтік аккаунт құру

1. Жобаны таңдау мәзірінен қажетті жобаны таңдаңыз.

2. Ұйым параметрлеріне өтіп, жобаны таңдаңыз.

3. Мүшелер бөлімін ашып, + Қызметтік аккаунт пәрменін таңдаңыз.

4. Әріптер, сандар және дефистер арқылы қызметтік аккаунттың бірегей ID идентификаторын енгізіңіз.

5. Құру пәрменін таңдаңыз.

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

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

Құпия кілтті сақтау

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

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

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

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

Ұйымның «Мүшелер» мәзірінде қызметтік аккаунттың рөлін өзгерте аласыз немесе Жою пәрменін таңдай аласыз.

API кілттерін жасау және басқару

Әр жобаның жеке API кілттері бар:

1. Ұйым параметрлеріне өтіңіз.

2. Жобаны таңдап, API кілттері бөлімін ашыңыз.

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

Кілт рұқсаттарын таңдау

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

• Барлығы: Толық рұқсаттар. Бұл — әдепкі параметр.

• Шектеулі: Нақты ресурстар немесе соңғы нүктелер үшін рұқсат аясын таңдаңыз. Қолжетімді опциялар ресурсқа байланысты және Рұқсат жоқ, Оқу, Жазу немесе нақты сұрауға арналған рұқсаттарды қамтуы мүмкін.

• Тек оқу: Барлық соңғы нүктелер үшін оқу рұқсаттары.

Мысалы, шектеулі кілтте /v1/assistants соңғы нүктесіне оқу және жазу рұқсаттары болмауы мүмкін.

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

Модельдерге қол жеткізуді және сұраныс шектеулерін баптау

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

1. Ұйым параметрлеріне өтіңіз.

2. Жобаны таңдап, Шектеулер бөлімін ашыңыз.

3. Жоба қай модельдерді пайдалана алатынын Модельдерді пайдалану бөлімінде таңдаңыз.

4. Қажет болса, әр модель үшін сұраныс шектеуін орнатыңыз.

Шығын шектеулері мен ескертулерді орнату

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

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

Шығын туралы ескертулер белгіленген шекке жеткенде хабарлайды, бірақ сұрауларды тоқтатпайды.

Ұйымның шығын шектеуін орнату

1. Ұйым параметрлеріне өтіңіз.

2. Шектеулер бөлімін ашып, Шығын тармағын табыңыз.

Жобаның шығын шектеуін орнату

1. Ұйым параметрлеріне өтіңіз.

2. Жобаны таңдап, Шектеулер бөлімін ашыңыз.

3. Айлық шығын шектеуі және Шығын мына шекке жеткенде ескерту мәндерін орнатыңыз.

4. Есепке алынған шығын шектеуге жеткенде API трафигін тоқтату үшін Қатаң шығын шектеуін қолдану опциясын қосыңыз.

Бұл бетте Модельдерді пайдалану параметрлерін де өзгерте аласыз.

Шығын туралы ескертулерді басқару

Жобаға шығын шектеуін орнатқанда, әдепкіде шектеудің 100%-ына жеткені туралы ескерту де жасалады. Басқа шектерге жеткенде хабарлау үшін Ескерту қосу пәрменін таңдаңыз.

Жобаның шығындары туралы ескертулер ұйым және жоба иелеріне жіберіледі. Ескерту параметрлерінде басқа алушылардың электрондық пошта мекенжайларын қоса аласыз.

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

Пайдалану және төлем ақпаратын көру

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

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

Жобаның пайдалану көрсеткіштері панелі көрінбесе, көріну параметрі Ұйым иелеріне көрінеді деп орнатылғанын тексеріңіз.

Файлдарды сақтау орнын басқару

Әр жобаға файлдарды сақтау үшін 100 ГБ квота беріледі. Квотадан асып кетсеңіз, мына қате көрсетілуі мүмкін:

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

Сақтау орнын босату үшін пайдаланылмайтын файлдарды жойыңыз. Енді қажет емес файлдарды анықтау үшін API арқылы сақталған файлдардың тізімін ала аласыз.

Жобаны мұрағаттау

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

Мұрағаттау қайтымсыз: мұрағатталған жобаны қалпына келтіру мүмкін емес.

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

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