OpenAI
ეს გვერდი მანქანური თარგმანის მეშვეობით ითარგმნა. სტატიის ინგლისური დედნის ნახვა.

პროექტების მართვა API პლატფორმაში

განახლებულია: 8 days ago

პროექტების მიზანია მომხმარებლებს მისცეს თავიანთი სამუშაოს ორგანიზების შესაძლებლობა. ორგანიზაციებს შეუძლიათ წვდომისა და ლიმიტების მართვა, სერვისის ანგარიშების შექმნა (UI-ის მეშვეობით) და პროექტში შეზღუდული ფარგლების მიხედვით გამოყენების თვალყურის დევნება (მაგ., მოდელები, შესაძლებლობები, თემები, ასისტენტები, fine-tuning, საცავი და ა.შ.). გამოყენების აქტივობა შეიძლება დაიყოს პროექტების მიხედვით, ხოლო მომხმარებლებს შეუძლიათ ბილინგის ნახვა და ბიუჯეტების დაყენება თითოეული პროექტისთვის.

ორგანიზაციის მფლობელებს შეუძლიათ თავიანთი ყველა აქტიური და დაარქივებული პროექტის ნახვა Projects გვერდზე. შეიტყვეთ მეტი API Platform-ში მომხმარებლის როლებისა და ნებართვების შესახებ.

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

როგორ დავამატო მომხმარებლები პროექტში?

ახლად დამატებული ორგანიზაციის წევრები ავტომატურად არ ემატებიან „ნაგულისხმევ პროექტს“. ახალი წევრების პროექტში მოწვევა შესაძლებელია ან მათი ორგანიზაციაში მოწვევისას („Invite to default project“ ველის მონიშვნით), ან მას შემდეგ, რაც წევრი ორგანიზაციის მოწვევას მიიღებს.

Admin API-ს მეშვეობით მოწვეული მომხმარებლები მიჰყვებიან წესებს, რომლებიც აღწერილია /organization/invites საბოლოო წერტილში.

თუ UI-ის ან Admin API-ის მეშვეობით მომხმარებლების პროექტში მოწვევისას შეცდომას წააწყდებით, მოწვევის ხელახლა გაგზავნამდე ჯერ დაადასტურეთ, რომ სამიზნე პროექტი არსებობს და დაარქივებული არ არის.

ორგანიზაციის მფლობელები ავტომატურად ემატებიან მფლობელებად ორგანიზაციაში შექმნილ ახალ პროექტებს.

რა არის მომხმარებელთა სხვადასხვა როლი ორგანიზაციებსა და პროექტებში და რა ნებართვებს მოიცავს ისინი?

მაშინ როცა ორგანიზაციებს აქვთ „მფლობელის“ და „მკითხველის“ როლები, პროექტებს აქვთ „მფლობელის“ და „წევრის“ როლები. პროექტის წევრები ორგანიზაციის მკითხველების ანალოგიურია. თითოეული მომხმარებლის როლთან დაკავშირებული ნებართვების უფრო დეტალური აღწერისთვის იხილეთ ქვემოთ მოცემული ცხრილი.

როლიფარგლებიაღწერა
მფლობელიორგანიზაციაშეუძლია ყველა პროექტის, ყველა მომხმარებლისა და ყველა API გასაღების შექმნა/ნახვა. შეუძლია ორგანიზაციაში ყველა პროექტის მონიტორინგი

Projects გვერდის
მეშვეობით. შეუძლია ორგანიზაციის ბიუჯეტებისა და პროექტის ბიუჯეტების დაყენება. შეუძლია სხვებისთვის ორგანიზაციაში გამოყენების ინფორმაციის ნახვის ნებართვების მინიჭება. შეუძლია პროექტების დაარქივება.
მკითხველიორგანიზაციაშეუძლია თავის პროექტებში ინფერენსის შესრულება, რესურსების გამოყენება და გასაღებების შექმნა. შესაძლებელია მისი პროექტებში დამატება.
არ შეუძლია პროექტების შექმნა და მომხმარებლების მართვა.
მფლობელიპროექტიშეუძლია პროექტში სხვა მომხმარებლების დამატება და პროექტის სახელის შეცვლა, ასევე აქვს წევრის ყველა შესაძლებლობა. შეუძლია პროექტის ბიუჯეტების დაყენება. შეუძლია პროექტის დაარქივება.
წევრიპროექტიშეუძლია პროექტის დონეზე ინფერენსის შესრულება, რესურსების გამოყენება და გასაღებების შექმნა.

თუ ორგანიზაციაში მფლობელი არ ვარ, რაზე მაქვს წვდომა?

მომხმარებლებს, რომლებიც ორგანიზაციაში მფლობელები არ არიან, შეუძლიათ მხოლოდ იმ პროექტების ნახვა, რომელთა წევრებიც არიან. მხოლოდ ორგანიზაციის მფლობელს შეუძლია ყველა პროექტის, წევრისა და API გასაღების ნახვა პროექტის დონეზე და აქვს წვდომა Projects გვერდზე.

  • მხოლოდ პროექტის წევრებს (და ორგანიზაციის მფლობელებს) შეუძლიათ დაინახონ ამ პროექტში შექმნილი fine-tuned მოდელები, შექმნილი ნებისმიერი ასისტენტის თემები ან დამატებული ნებისმიერი ფაილი.

  • პროექტის წევრებს შეუძლიათ ნახონ, ვინ არიან ამ პროექტის სხვა წევრები და რა როლები აქვთ მათ (ანუ მფლობელი თუ წევრი).

როგორ განვაახლო მომხმარებლის პროექტის როლი ან წავშალო მომხმარებელი პროექტიდან?

მომხმარებლის პროექტის როლის განახლება ან მომხმარებლის პროექტიდან წაშლა მხოლოდ პროექტის მფლობელს შეუძლია. დამატებითი ინფორმაციისთვის იხილეთ როლები და ნებართვები.

პროექტში მომხმარებლის განახლებისთვის გადადით თქვენს ორგანიზაციის პარამეტრებში, აირჩიეთ პროექტი და დააწკაპუნეთ წევრებზე. შეგიძლიათ თითოეული წევრის როლი დააყენოთ როგორც წევრი ან მფლობელი. მომხმარებლის პროექტიდან წასაშლელად ასევე შეგიძლიათ აირჩიოთ წაშლა.

რა არის სერვისის ანგარიში და რით განსხვავდება ის ჩვეულებრივი მომხმარებლის ანგარიშისგან?

სერვისის ანგარიში მოქმედებს როგორც სისტემური წვდომისთვის შექმნილი ფსევდო-მომხმარებელი და განსხვავდება ინდივიდუალური მომხმარებლის ანგარიშებისგან. სერვისის ანგარიშების შექმნა შეუძლიათ მხოლოდ ორგანიზაციისა და პროექტის მფლობელებს.

სერვისის ანგარიშები მხოლოდ პროექტებზეა მიბმული.

წევრის დამატება პროექტში

თუ დააწკაპუნებთ + Add member ღილაკს, დაინახავთ თქვენი ორგანიზაციის მომხმარებლების სიას, რომლებსაც აქვთ როლი Reader. თუ გსურთ ისეთი მომხმარებლის დამატება, რომელიც ამჟამად თქვენს ორგანიზაციაში არ არის, ჯერ ის ორგანიზაციაში უნდა დაამატოთ (შეგიძლიათ „Add to Default Project“ ველი მოუნიშნავი დატოვოთ, თუ ამ მომხმარებლებისთვის უფრო ფართო წვდომის მიცემა არ გსურთ). ამ სიაში არ იქნება სერვისის ანგარიშები. ამ ნაბიჯზე შეგიძლიათ აირჩიოთ, მათი როლი იქნება 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

შემდეგ გადადით თქვენს ორგანიზაციის პარამეტრებში -> Project -> Members -> დააწკაპუნეთ + 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 გასაღებების პარამეტრებში.

სერვისის ანგარიშები ჩამოთვლილია პროექტის წევრებთან ერთად თქვენი პროექტის წევრების პარამეტრების გვერდზე. თქვენი პროექტის წევრების პარამეტრების გვერდზე სერვისის ანგარიშის წვდომის განახლების ან წაშლის შესახებ მეტის გასაგებად იხილეთ აქ.

პროექტებისა და ორგანიზაციების ყველა სერვისის ანგარიში თქვენს ადამიან მომხმარებლებთან ერთად გამოჩნდება ორგანიზაციის დონის წევრების გვერდზე.

სერვისის ანგარიშები იმართება ჩვეულებრივი ანგარიშების მსგავსად. Organization -> Members მენიუდან შეგიძლიათ სერვისის ანგარიშის წაშლა ან როლის განახლება:

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 გასაღებისთვის ნებართვების დაყენება შეგიძლიათ ახალი საიდუმლო გასაღების შექმნისას ან არსებული გასაღების რედაქტირებით.

ხელმისაწვდომია ნებართვების სამი დონე: ყველა, შეზღუდული და მხოლოდ წაკითხვა.

  • ყველა — საიდუმლო გასაღებისთვის დაყენებულია სრული ნებართვები. ეს ნაგულისხმევი პარამეტრია.

  • შეზღუდული — მომხმარებელს საშუალებას აძლევს თითოეული საბოლოო წერტილისთვის დააყენოს ნებართვები: None, Read და Write.

    • მაგალითად, ქმნით API გასაღებს, რომელსაც კონკრეტულად არ აქვს /v1/assistants საბოლოო წერტილზე Read ან Write ნებართვა:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • მხოლოდ წაკითხვა — წაკითხვის ნებართვები დაყენებულია ყველა საბოლოო წერტილისთვის.

როგორ იმართება წვდომა იმ მომხმარებლებისთვის, რომლებიც რამდენიმე პროექტს ან ორგანიზაციას ეკუთვნიან?

მომხმარებლები შეიძლება იყვნენ იმდენი პროექტის წევრი, რამდენიც საჭიროა. პროექტის ფარგლებში მომხმარებლებს შეუძლიათ შექმნან პერსონალური API გასაღები, რომელიც მიბმულია და შეზღუდულია მხოლოდ ამ პროექტსა და მის რესურსებზე წვდომისთვის.

როგორ დავაყენო და ვმართო მოთხოვნების ლიმიტები ჩემი ორგანიზაციის პროექტებისთვის?

პროექტის დონის მოთხოვნების ლიმიტების დაყენება და მართვა მხოლოდ ორგანიზაციის მფლობელს შეუძლია. დამატებითი ინფორმაციისთვის იხილეთ როლები და ნებართვები.

თქვენს ორგანიზაციის პარამეტრებში დააწკაპუნეთ პროექტზე, რომლის განახლებაც გსურთ, და ნავიგაციის სიის Project სექციაში აირჩიეთ Limits. ამ გვერდზე შეგიძლიათ განაახლოთ თქვენი მოდელის გამოყენება.

მოდელის გამოყენება საშუალებას გაძლევთ დააკონფიგურიროთ, რომელი მოდელები შეიძლება გამოიყენოს პროექტმა, ხოლო მოთხოვნების ლიმიტები საჭიროებისამებრ შეიძლება დაყენდეს თითოეული მოდელისთვის.

როგორ დავაყენო და ვმართო ბიუჯეტები ჩემი ორგანიზაციის პროექტებისთვის?

პროექტის ბიუჯეტების დაყენება და მართვა მხოლოდ ორგანიზაციის მფლობელებსა და პროექტის მფლობელებს შეუძლიათ. დამატებითი ინფორმაციისთვის იხილეთ როლები და ნებართვები. ორგანიზაციის დონეზე ლიმიტების შესაცვლელად, თქვენს ორგანიზაციის პარამეტრებში დააწკაპუნეთ Limits, შემდეგ გადადით ქვემოთ Usage limits-მდე.

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

პროექტის ლიმიტების დასაყენებლად, თქვენს ორგანიზაციის პარამეტრებში დააწკაპუნეთ პროექტზე, რომლის განახლებაც გსურთ, და აირჩიეთ Limits. შეგიძლიათ განაახლოთ თვიური ბიუჯეტი, შეტყობინების ზღვარი და მოდელის გამოყენება.


თვიური ბიუჯეტის დაყენება საშუალებას გაძლევთ თქვენი პროექტისთვის ხარჯვის რბილი ზღვრები დაადგინოთ. როდესაც გამოყენება მოცემულ კალენდარულ თვეში (UTC) ამ ლიმიტს გადააჭარბებს, API მოთხოვნები შეფერხების გარეშე გაგრძელდება დამუშავება. ეს ფუნქცია შექმნილია, რათა ბიუჯეტის გაფრთხილებების მეშვეობით გამოყენების მონიტორინგში დაგეხმაროთ, მაგრამ ის ხარჯვაზე მკაცრ ზღვარს არ აწესებს. პროექტის ბიუჯეტის შექმნისას ნაგულისხმევად შეიქმნება გაფრთხილება 100%-იან ზღვარზე. სხვადასხვა ზღვარზე დამატებითი ბიუჯეტების დაყენება შესაძლებელია Add Alert-ზე დაწკაპუნებით.

გაითვალისწინეთ, რომ ორგანიზაციის მფლობელი/მფლობელები და პროექტის მფლობელი/მფლობელები ყოველთვის მიიღებენ ამ შეტყობინებებს და ამის მორგება შეუძლებელია.

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 GB ფაილების შენახვის კვოტას.

თუ ეს კვოტა გადაილახება, დაინახავთ შემდეგ შეცდომას:

თქვენ გადააჭარბეთ ფაილების შენახვის კვოტას. ორგანიზაციები შეზღუდულია 100 GB ფაილით. გთხოვთ, შეამციროთ ფაილის ზომა ან დაუკავშირდეთ მხარდაჭერას.

გირჩევთ, წაშალოთ თქვენს ანგარიშზე შენახული გამოუყენებელი ფაილები. ცნობისთვის, API-ის მეშვეობით შეგიძლიათ ფაილების ნახვა და ჩამოთვლა.

მე პროექტის მფლობელი ვარ; რატომ ვერ ვხედავ ჩემი პროექტის გამოყენების დაფას?

პროექტის გამოყენების დაფის ხილვადობა არ უკავშირდება მომხმარებლის როლს პროექტში. ამის ნაცვლად, ის განისაზღვრება თქვენი როლით ორგანიზაციაში და პარამეტრებით მისამართზე https://platform.openai.com/settings/organization/data-controls/visibility

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

თუ გამოყენების დაფას ვერ ხედავთ, ეს პარამეტრი, სავარაუდოდ, დაყენებულია „ხილულია ორგანიზაციის მფლობელებისთვის“ მნიშვნელობაზე.

სასარგებლო იყო ეს სტატია?