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