API հարթակում նախագծերի կառավարում

Նախագծերը նպատակ ունեն հաճախորդներին հնարավորություն տալ կազմակերպել իրենց աշխատանքը։ Կազմակերպությունները կարող են կառավարել հասանելիությունն ու սահմանաչափերը, տրամադրել ծառայողական հաշիվներ (UI-ի միջոցով) և հետևել օգտագործմանը նախագծի ներսում սահմանափակ շրջանակի նկատմամբ (օր.՝ մոդելներ, հնարավորություններ, թելեր, օգնականներ, fine tuning, պահեստավորում և այլն)։ Օգտագործման ակտիվությունը կարելի է բաժանել ըստ նախագծերի, իսկ օգտատերերը կարող են դիտել վճարումները և յուրաքանչյուր նախագծի համար բյուջեներ սահմանել։

Կազմակերպության սեփականատերերը կարող են դիտել իրենց բոլոր Ակտիվ և Արխիվացված նախագծերը Նախագծեր էջում։ Իմացեք ավելին API հարթակում օգտատերերի դերերի և թույլտվությունների մասին։

Ո՞վ կարող է ստեղծել նախագիծ։

Միայն կազմակերպության սեփականատերերը կարող են ստեղծել նախագիծ։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Կազմակերպությունների միջև փոխարկվելու համար մկնիկի ցուցիչը պահեք էջի վերևի ձախ մասում գտնվող ձեր կազմակերպության անվան վրա և ցանկից ընտրեք կազմակերպությունը։

Այն կազմակերպությունների համար, որոնք համախմբված վճարումների պլանում են, ենթակազմակերպությունները նույնականացվում են առանձին։ Ենթակազմակերպություններում նախագծեր ստեղծել հնարավոր չէ։

Ինչպե՞ս են աշխատում նախագծերը։

Յուրաքանչյուր կազմակերպություն ներառում է «Լռելյայն նախագիծ», որը չի կարող ջնջվել։ Կարող եք կարգավորել արագության սահմանաչափերը, virtual model permissions-ը և ծախսերի բյուջեները (2024 թվականի նոյեմբերից)։ Այն ժառանգում է կազմակերպության ամբողջական կազմաձևը, ուստի չեք կարող ուղղակիորեն դրան ավելացնել անդամներ կամ ծառայողական հաշիվներ։

Ինչպե՞ս ստեղծել նախագիծ։

Նախ էջի ձախ անկյունում սավառեցրեք նախագծի անվան վրա և ընտրեք Create project։

Նշեք ձեր նախագծի անունը, նկարագրությունը և կայքը, ապա ընտրեք Create։

Ինչպե՞ս օգտատերեր ավելացնել նախագծում։

Նոր ավելացված կազմակերպության անդամները ավտոմատ չեն ավելացվում «Լռելյայն նախագիծ»։ Նոր անդամներին կարելի է հրավիրել նախագիծ՝ կա՛մ կազմակերպություն հրավիրելիս (միացնելով «Հրավիրել լռելյայն նախագիծ» նշատուփը), կա՛մ այն բանից հետո, երբ անդամն ընդունել է կազմակերպության հրավերը։

Admin API-ի միջոցով հրավիրված օգտատերերը հետևում են /organization/invites վերջնակետի սահմանած կանոններին։

Եթե UI-ի կամ Admin API-ի միջոցով օգտատերերին նախագիծ հրավիրելիս սխալ եք ստանում, նախքան հրավերը կրկին ուղարկելը նախ հաստատեք, որ նպատակային նախագիծը գոյություն ունի և արխիվացված չէ։

Կազմակերպության սեփականատերերը ավտոմատ ավելացվում են որպես սեփականատերեր կազմակերպության ներսում ստեղծված նոր նախագծերին։

Որո՞նք են կազմակերպություններում և նախագծերում օգտատերերի տարբեր դերերը, և ի՞նչ թույլտվություններ են դրանք ներառում։

Մինչ կազմակերպություններն ունեն «սեփականատեր» և «ընթերցող» դերեր, նախագծերն ունեն «սեփականատեր» և «անդամ» դերեր։ Նախագծի անդամները համարժեք են կազմակերպության ընթերցողներին։ Յուրաքանչյուր օգտատիրոջ դերին ուղեկցող թույլտվությունների ավելի մանրամասն նկարագրության համար տես ստորև բերված աղյուսակը։

Եթե ես կազմակերպության Սեփականատեր չեմ, ինչի՞ն ունեմ հասանելիություն։

Կազմակերպության Սեփականատեր չհանդիսացող օգտատերերը կարող են տեսնել միայն այն նախագծերը, որոնց անդամ են։ Միայն կազմակերպության սեփականատերը կարող է տեսնել բոլոր նախագծերը, անդամները և API բանալիները նախագծի մակարդակով և հասանելիություն ունենալ Նախագծեր էջին։

• Միայն նախագծի անդամները (և կազմակերպության սեփականատերերը) կարող են տեսնել այդ նախագծի ներսում ստեղծված fine-tuned մոդելները, ստեղծված Assistants-ի թելերը կամ ավելացված ցանկացած ֆայլ։

• Նախագծի անդամները կարող են տեսնել, թե ովքեր են այդ նախագծի մյուս բոլոր անդամները և նրանց դերերը (այսինքն՝ Սեփականատեր կամ Անդամ)։

Ինչպե՞ս թարմացնել օգտատիրոջ նախագծային դերը կամ հեռացնել օգտատիրոջը նախագծից։

Միայն նախագծի Սեփականատերը կարող է թարմացնել օգտատիրոջ նախագծային դերը կամ հեռացնել օգտատիրոջը նախագծից։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Նախագծում օգտատիրոջը թարմացնելու համար անցեք ձեր կազմակերպության կարգավորումներ, ընտրեք նախագիծը և սեղմեք Անդամներ։ Կարող եք յուրաքանչյուր անդամի դերը սահմանել որպես Անդամ կամ Սեփականատեր։ Կարող եք նաև ընտրել Հեռացնել՝ օգտատիրոջը նախագծից հեռացնելու համար։

Ի՞նչ է ծառայողական հաշիվը, և ինչո՞վ է այն տարբերվում սովորական օգտատիրոջ հաշվից։

Ծառայողական հաշիվը հանդես է գալիս որպես համակարգային հասանելիության համար նախատեսված կեղծ-օգտատեր՝ տարբերվելով անհատական օգտատիրոջ հաշիվներից։ Միայն կազմակերպության և նախագծի սեփականատերերը կարող են ստեղծել ծառայողական հաշիվներ։

Անդամ ավելացնել նախագծում

Եթե սեղմեք + Add member կոճակը, կտեսնեք ձեր կազմակերպության այն օգտատերերի ցանկը, որոնց դերը Reader է։ Եթե ցանկանում եք ավելացնել օգտատիրոջ, որը ներկայում ձեր կազմակերպության կազմում չէ, նախ պետք է նրան ավելացնեք կազմակերպությունում (կարող եք «Ավելացնել լռելյայն նախագծում» նշատուփը թողնել չնշված, եթե չեք ուզում այս օգտատերերին ավելի լայն հասանելիություն տալ)։ Այս ցանկը չի ներառի ծառայողական հաշիվներ։ Այս քայլի ընթացքում կարող եք ընտրել՝ նրանց դերը կլինի Owner, թե Member։

Երբ թիմի անդամ եք ավելացնում, պետք է նրան նշանակեք կա՛մ Անդամ կա՛մ Սեփականատեր դեր։ Նախագծի անդամները կարող են կատարել API հարցումներ, որոնք կարդում կամ փոփոխում են տվյալներ, մինչդեռ նախագծի սեփականատերերը կարող են նաև փոփոխել նախագծի կարգավորումները և բյուջեները և կառավարել նախագծի անդամներին։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Ինչպես ստեղծել ծառայողական հաշիվ նախագծի համար

Նախ անցեք այն նախագիծը, որի համար ցանկանում եք ստեղծել ծառայողական հաշիվ՝ ընտրելով նավիգացիոն տողում գտնվող բացվող ցանկից։

Այնուհետև անցեք ձեր կազմակերպության կարգավորումներ -> Project -> Members -> սեղմեք + Service account։

Ծառայողական հաշվի անվանումը

Անկախ նրանից՝ ստեղծում եք ծառայողական հաշիվ կազմակերպության մակարդակում, թե նախագծին հատուկ հաշիվ, ծառայողական հաշիվ ստեղծելիս կարող եք կազմել եզակի ծառայողական հաշվի ID՝ բաղկացած տառերից, թվերից և գծիկներից, որպեսզի հեշտ լինի նույնականացնել ծառայողական հաշիվը։

Պահպանեք ծառայողական հաշվի API բանալին

Ստեղծել կոճակը ընտրելուց հետո ծառայողական հաշվի համար անմիջապես ստեղծվում է API բանալի, և գաղտնի բանալին կցուցադրվի։ Պահեք այս գաղտնի բանալին անվտանգ և ապահով վայրում։ Անվտանգության նկատառումներով այն կրկին չեք կարողանա դիտել ձեր OpenAI հաշվի միջոցով։ Եթե կորցնեք այս գաղտնի բանալին, պետք է ստեղծեք նորը։

Ծառայողական հաշվի API բանալու թույլտվությունները լռելյայն սահմանված են՝ կարդալ և գրել նախագծի բոլոր API ռեսուրսները։ Այս թույլտվությունները կարող են թարմացվել ձեր նախագծի API բանալիների կարգավորումներում։

Ծառայողական հաշիվները ցուցակագրվում են նախագծի անդամների կողքին ձեր նախագծի անդամների կարգավորումների էջում։ Խնդրում ենք տեսնել այստեղ՝ ավելին իմանալու ձեր նախագծի անդամների կարգավորումների էջում ծառայողական հաշվի հասանելիությունը թարմացնելու կամ հեռացնելու մասին։

Ծառայողական հաշիվները կառավարվում են սովորական հաշիվների նման։ Organization -> Members menu-ից կարող եք հեռացնել ծառայողական հաշիվը կամ թարմացնել դերը։

Ինչպե՞ս կառավարել API բանալիները իմ կազմակերպության նախագծերում։

Յուրաքանչյուր նախագծի համար կարող եք ստեղծել և կառավարել API բանալիներ այդ նախագծի կարգավորումների էջում։ Ձեր կազմակերպության կարգավորումներում ընտրեք նախագիծը և սեղմեք API բանալիներ։

Նոր գաղտնի բանալի ստեղծելու համար ընտրեք + Create new secret key։ Կարող եք նաև ընտրել գաղտնի բանալու կողքի Խմբագրել պատկերակը՝ դրա թույլտվությունները խմբագրելու համար։

Ձեր յուրաքանչյուր API բանալու համար կարող եք թույլտվություններ սահմանել նոր գաղտնի բանալի ստեղծելիս կամ գոյություն ունեցող բանալին խմբագրելով։

Հասանելի է թույլտվությունների երեք մակարդակ՝ Բոլորը, Սահմանափակ և Միայն կարդալ։

• Բոլորը — Գաղտնի բանալու համար սահմանվում են լիարժեք թույլտվություններ։ Սա լռելյայն կարգավորումն է։

• Սահմանափակ — Թույլ է տալիս օգտատիրոջը յուրաքանչյուր վերջնակետի համար սահմանել None, Read և Write թույլտվություններ։

  • Օրինակ՝ դուք ստեղծում եք API բանալի, որը հատուկ չունի /v1/assistants վերջնակետում կարդալու կամ գրելու թույլտվություն։

    

• Միայն կարդալ — Կարդալու թույլտվություններ են սահմանվում բոլոր վերջնակետերի համար։

Ինչպե՞ս է կառավարվում հասանելիությունը այն օգտատերերի համար, որոնք պատկանում են մի քանի նախագծերի կամ կազմակերպությունների։

Օգտատերերը կարող են լինել այնքան նախագծերի անդամ, որքան անհրաժեշտ է։ Նախագծի ներսում օգտատերերը կարող են ստեղծել անձնական API բանալի, որը սահմանափակված է այդ նախագծով և նրա ռեսուրսներով։

Ինչպե՞ս սահմանել և կառավարել իմ կազմակերպության նախագծերի սահմանաչափերը։

Միայն կազմակերպության Սեփականատերը կարող է սահմանել և կառավարել նախագծի մակարդակի սահմանաչափերը։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։

Ձեր կազմակերպության կարգավորումներում սեղմեք այն նախագծի վրա, որը ցանկանում եք թարմացնել, և նավիգացիոն ցանկի Նախագիծ բաժնում ընտրեք Սահմանաչափեր։ Այս էջում կարող եք թարմացնել ձեր Մոդելի օգտագործումը։

Մոդելի օգտագործումը թույլ է տալիս կարգավորել, թե որ մոդելները կարող են օգտագործվել նախագծի կողմից, իսկ սահմանաչափերը կարող են ըստ անհրաժեշտության սահմանվել յուրաքանչյուր մոդելի համար։

Ինչպե՞ս սահմանել և կառավարել իմ կազմակերպության նախագծերի բյուջեները։

Միայն կազմակերպության Սեփականատերերը և նախագծի Սեփականատերերը կարող են սահմանել և կառավարել նախագծի բյուջեները։ Լրացուցիչ տեղեկությունների համար տես դերերն ու թույլտվությունները։ Կազմակերպության մակարդակով սահմանաչափերը փոխելու համար ձեր կազմակերպության կարգավորումներում սեղմեք Սահմանաչափեր, ապա ոլորեք ներքև մինչև Օգտագործման սահմանաչափեր։

Նախագծի սահմանաչափերը սահմանելու համար ձեր կազմակերպության կարգավորումներում սեղմեք այն նախագծի վրա, որը ցանկանում եք թարմացնել, և ընտրեք Սահմանաչափեր։ Կարող եք թարմացնել ձեր Ամսական բյուջեն, Ծանուցման շեմը և Մոդելի օգտագործումը։


Ամսական բյուջե սահմանելը թույլ է տալիս ձեր նախագծի համար սահմանել ծախսերի փափուկ շեմեր։ Երբ օգտագործումը տվյալ օրացուցային ամսվա ընթացքում (UTC) գերազանցում է այս սահմանաչափը, API հարցումները կշարունակեն մշակվել առանց ընդհատման։ Այս գործառույթը նախատեսված է օգնելու ձեզ հետևել օգտագործմանը բյուջեի ծանուցումների միջոցով, բայց այն չի կիրառում ծախսերի կոշտ սահմանափակում։ Երբ ստեղծվում է նախագծի բյուջե, լռելյայն ստեղծվում է ծանուցում 100% շեմի համար։ Տարբեր շեմերով լրացուցիչ բյուջեներ կարելի է սահմանել՝ սեղմելով Ավելացնել ծանուցում։

Խնդրում ենք նկատի ունենալ, որ կազմակերպության սեփականատեր(եր)ը և նախագծի սեփականատեր(եր)ը միշտ կստանան այս հաղորդագրությունները, և դա հնարավոր չէ անհատականացնել։

Ինչպե՞ս ջնջել կամ արխիվացնել նախագիծը։

Նախագծերը կարելի է արխիվացնել թե՛ նոր նախագծերի ցանկի էջի միջոցով, թե՛ առանձին նախագծի կարգավորումներում։ Արխիվացնելուց հետո նախագիծը հնարավոր չէ վերականգնել։ Արխիվացմանը անցնելիս ձեզ կառաջարկվի մուտքագրել նախագծի անունը՝ շարունակելու համար։

Բոլոր արխիվացված նախագծերի ցանկը կարող եք դիտել նույն նախագծերի ցանկի էջի «Արխիվացված» ներդիրում։

Նախագծերը ջնջել հնարավոր չէ․ մենք պահպանում ենք բոլոր նախագծերի պատմությունը՝ օգտագործման և վճարումների հետևման շարունակականությունն ապահովելու համար։

Կա՞ սահմանափակում իմ կազմակերպությունում նախագծերի քանակի վրա։

Կազմակերպությունները լռելյայն կարող են ստեղծել մինչև 2,000 նախագիծ։

Հնարավո՞ր է ռեսուրսներ համօգտագործել նախագծերի միջև։

Նախագծի ռեսուրսները (օրինակ՝ ֆայլեր, assistants, պահեստ, կամ threads) սահմանափակված են տվյալ նախագծով և հասանելի չեն նախագծից դուրս գտնվող ոչ-ադմին անդամներին։ Ավելին, ռեսուրսները չեն կարող տեղափոխվել նախագծերի միջև։

Որքա՞ն է մեկ նախագծի համար ֆայլային պահեստի քվոտան։

OpenAI-ը ներկայումս աջակցում է մեկ նախագծի համար 100 ԳԲ ֆայլային պահեստի քվոտա։

Եթե այս քվոտան գերազանցվի, կտեսնեք հետևյալ սխալը.

Խորհուրդ ենք տալիս ջնջել ձեր հաշվում պահված չօգտագործվող ֆայլերը։ Որպես տեղեկանք՝ կարող եք API-ի միջոցով դիտել և ցուցակագրել ֆայլերը։

Ես նախագծի սեփականատեր եմ․ ինչո՞ւ չեմ տեսնում իմ նախագծի Օգտագործման վահանակը։

Նախագծի Օգտագործման վահանակի տեսանելիությունը կապված չէ նախագծում օգտատիրոջ դերի հետ։ Փոխարենը, այն որոշվում է կազմակերպության ներսում ձեր դերով և https://platform.openai.com/settings/organization/data-controls/visibility-ում նշված կարգավորումներով։

Եթե չեք կարողանում տեսնել Օգտագործման վահանակը, հավանաբար այս կարգավորումը դրված է «Տեսանելի է կազմակերպության սեփականատերերին»։