Omówienie
Projekty pozwalają organizować pracę w organizacji korzystającej z API. Służą do zarządzania dostępem, konfigurowania limitów modeli i limitów zapytań, tworzenia kont usługowych oraz śledzenia wykorzystania, rozliczeń i limitów wydatków dla określonego zestawu zasobów, takich jak modele, funkcje, wątki, asystenci, dostrajanie i przestrzeń dyskowa.
Właściciele organizacji mogą przeglądać wszystkie aktywne i zarchiwizowane projekty na stronie Projekty.
Zanim zaczniesz
Aby utworzyć projekt, musisz mieć rolę właściciela organizacji. Domyślnie organizacje mogą utworzyć do 2000 projektów.
Jeśli Twoja organizacja korzysta ze skonsolidowanych rozliczeń, organizacje podrzędne są widoczne jako osobne pozycje na liście wyboru organizacji. Nie można tworzyć projektów w organizacji podrzędnej.
Aby przełączyć organizację, otwórz listę wyboru organizacji i wybierz tę, z której chcesz korzystać.
Projekt domyślny
Każda organizacja ma projekt domyślny, którego nie można usunąć. Dziedziczy on pełną konfigurację organizacji. Możesz skonfigurować jego limity zapytań, uprawnienia do modeli wirtualnych i limity wydatków.
Nie można dodawać członków ani kont usługowych bezpośrednio do projektu domyślnego. Możesz przyznać dostęp do projektu domyślnego podczas zapraszania kogoś do organizacji, postępując zgodnie z instrukcjami zapraszania do organizacji opisanymi w tym artykule.
Tworzenie projektu
Otwórz listę wyboru projektów i wybierz Utwórz projekt.
Wpisz nazwę, opis i adres witryny projektu.
Wybierz Utwórz.
Właściciele organizacji są automatycznie dodawani do nowych projektów jako właściciele.
Role i dostęp
Tabela podsumowuje opisane w tych instrukcjach role właściciela i czytelnika organizacji oraz właściciela i członka projektu. Członkowie projektu mają uprawnienia podobne do uprawnień czytelników organizacji.
| Rola | Zakres | Uprawnienia |
|---|---|---|
| Właściciel | Organizacja | Tworzenie i przeglądanie wszystkich projektów, użytkowników i kluczy API. Monitorowanie projektów na stronie Projekty. Ustawianie limitów wydatków organizacji i projektów. Przyznawanie dostępu do informacji o wykorzystaniu przez innych użytkowników. Archiwizowanie projektów. |
| Czytelnik | Organizacja | Może być dodawany do projektów, uruchamiać wnioskowanie, korzystać z zasobów i tworzyć klucze w tych projektach. Nie może tworzyć projektów ani zarządzać użytkownikami. |
| Właściciel | Projekt | Wszystkie uprawnienia członka, a ponadto dodawanie użytkowników, zarządzanie członkami i ustawieniami projektu, zmiana jego nazwy, ustawianie limitów wydatków i archiwizowanie projektu. |
| Członek | Projekt | Uruchamianie wnioskowania, korzystanie z zasobów, tworzenie kluczy na poziomie projektu i wysyłanie żądań API odczytujących lub modyfikujących dane. |
Szczegóły dotyczące ról w organizacji znajdziesz w artykule Role w organizacji. Informacje o dodatkowych i niestandardowych rolach oraz pełną listę uprawnień znajdziesz w przewodniku po rolach i uprawnieniach API.
Widoczność projektów
Przy tych standardowych rolach użytkownicy, którzy nie są właścicielami organizacji, widzą tylko projekty, do których należą. Właściciele organizacji widzą wszystkie projekty, członków i klucze API na poziomie projektów oraz mają dostęp do strony Projekty.
Członkowie projektu widzą pozostałych członków swojego projektu oraz ich role. Tylko członkowie projektu i właściciele organizacji widzą dostrojone modele, wątki asystentów i pliki utworzone lub dodane w tym projekcie.
Możesz należeć do tylu projektów, ilu potrzebujesz. Osobisty klucz API utworzony w projekcie jest ograniczony do tego projektu i jego zasobów.
Ograniczenia dostępu do zasobów
Pliki, asystenci, przestrzeń dyskowa i wątki są przypisane do konkretnego projektu. Członkowie spoza tego projektu, którzy nie są administratorami, nie mają dostępu do jego zasobów. Zasobów nie można przenosić między projektami.
Wyjątkiem są dostrojone modele w projekcie domyślnym: można uzyskać do nich dostęp z innych projektów.
Zarządzanie członkami projektu
Zapraszanie osób do organizacji
Aby dodać kogoś do projektu, ta osoba musi najpierw należeć do Twojej organizacji.
Zapraszając kogoś do organizacji, możesz przyznać tej osobie dostęp do projektu domyślnego, zaznaczając odpowiednią opcję w formularzu zaproszenia. Pozostaw tę opcję niezaznaczoną, jeśli nie chcesz przyznawać dostępu do projektu domyślnego. Nowi członkowie organizacji nie są automatycznie dodawani do projektu domyślnego.
Nie musisz tworzyć kolejnego projektu, aby kogoś zaprosić. Możesz też dodać daną osobę do projektu, gdy zaakceptuje zaproszenie do organizacji.
Zaproszenia wysyłane przez API administracyjne podlegają zasadom dotyczącym punktu końcowego /organization/invites.
Dodawanie członka organizacji do projektu
Właściciele organizacji i projektów mogą dodawać członków:
Przejdź do ustawień organizacji.
Wybierz projekt, a następnie otwórz sekcję Członkowie.
Wybierz + Dodaj członka.
Wybierz użytkownika i przypisz mu rolę Członek lub Właściciel.
Na liście użytkowników widoczni są użytkownicy organizacji z rolą Czytelnik. Lista nie obejmuje kont usługowych.
Jeśli wysłanie zaproszenia w interfejsie użytkownika lub przez API administracyjne się nie powiedzie, przed ponowną próbą sprawdź, czy docelowy projekt istnieje i nie został zarchiwizowany.
Zmiana roli lub usuwanie członka
Właściciele organizacji i projektów mogą zmieniać rolę użytkownika w projekcie lub usuwać go z projektu.
Przejdź do ustawień organizacji.
Wybierz projekt, a następnie otwórz sekcję Członkowie.
Ustaw rolę użytkownika na Członek lub Właściciel albo wybierz Usuń, aby go usunąć.
Tworzenie kont usługowych i zarządzanie nimi
Konto usługowe zapewnia dostęp systemom, zamiast reprezentować konkretnego użytkownika. Konta usługowe są ograniczone do poszczególnych projektów.
Tworzenie kont usługowych wymaga uprawnień do zarządzania kontami usługowymi. Właściciele organizacji i projektów mają te uprawnienia.
Tworzenie konta usługowego
Wybierz projekt z listy wyboru projektów.
Przejdź do ustawień organizacji i wybierz projekt.
Otwórz sekcję Członkowie i wybierz + Konto usługowe.
Wpisz unikalny identyfikator konta usługowego, używając liter, cyfr i łączników.
Wybierz Utwórz.
Konta serwisowe utworzone na poziomie projektu są unikalne dla projektu i nie mogą być używane poza projektem, w którym zostały utworzone.
Ten sam format identyfikatora obowiązuje niezależnie od tego, czy tworzysz konto usługowe w ustawieniach na poziomie organizacji, czy projektu.
Konto usługowe utworzone dla projektu jest przypisane wyłącznie do tego projektu i nie można go używać poza nim.
Zapisywanie tajnego klucza
Utworzenie konta usługowego powoduje natychmiastowe utworzenie klucza API i wyświetlenie jego tajnej wartości. Zapisz tajny klucz w bezpiecznym miejscu. Nie będzie można go ponownie wyświetlić na koncie OpenAI. Jeśli go zgubisz, wygeneruj nowy klucz.
Domyślnie klucz konta usługowego ma uprawnienia do odczytu i zapisu wszystkich zasobów API w swoim projekcie. Możesz później zmienić te uprawnienia w sekcji Klucze API w ustawieniach projektu.
Aktualizowanie lub usuwanie konta usługowego
Konta usługowe są widoczne obok użytkowników w sekcji Członkowie w ustawieniach projektu. Aby zarządzać ich dostępem do projektu, zmieniaj ich role lub usuwaj je tak samo jak innych członków projektu.
Wszystkie konta usługowe są też widoczne obok użytkowników na stronie Członkowie organizacji, w tym konta utworzone w ustawieniach na poziomie organizacji i projektu.
W menu Członkowie organizacji możesz zmienić rolę konta usługowego lub wybrać opcję Usuń.
Tworzenie kluczy API i zarządzanie nimi
Każdy projekt ma własne klucze API:
Przejdź do ustawień organizacji.
Wybierz projekt, a następnie otwórz sekcję Klucze API.
Wybierz + Utwórz nowy tajny klucz, aby utworzyć klucz, lub wybierz ikonę edycji obok istniejącego klucza, aby zmienić jego uprawnienia.
Wybór uprawnień klucza
W przypadku kluczy należących do użytkowników możesz ustawić uprawnienia podczas tworzenia klucza lub zmienić je później:
Wszystkie: pełne uprawnienia. To ustawienie domyślne.
Ograniczone: wybierz zakresy uprawnień dla konkretnych zasobów lub punktów końcowych. Dostępne opcje zależą od zasobu i mogą obejmować Brak, Odczyt, Zapis lub uprawnienia do określonych żądań.
Tylko do odczytu: uprawnienia do odczytu dla wszystkich punktów końcowych.
Na przykład klucz z ograniczonymi uprawnieniami może nie zezwalać na odczyt ani zapis w punkcie końcowym /v1/assistants.
Tworzenie kluczy kont usługowych wymaga uprawnień do zarządzania kontami usługowymi. Jeśli nie widzisz tej opcji, poproś właściciela organizacji lub projektu o utworzenie klucza konta usługowego. Okno tworzenia klucza nie wyświetla tych opcji uprawnień dla kluczy kont usługowych. Zmień je później w sekcji Klucze API w ustawieniach projektu.
Konfigurowanie dostępu do modeli i limitów zapytań
Zarządzanie limitami zapytań projektu wymaga uprawnień administracyjnych. Właściciele organizacji mają te uprawnienia, a właściciele projektów mogą również zarządzać limitami zapytań projektu przez API do zarządzania.
Przejdź do ustawień organizacji.
Wybierz projekt, a następnie otwórz sekcję Limity.
W sekcji Korzystanie z modeli wybierz modele, z których można korzystać w projekcie.
W razie potrzeby ustaw limit zapytań dla każdego modelu.
Ustawianie limitów wydatków i alertów
Miesięczne limity wydatków na API są dostępne zarówno na poziomie organizacji, jak i projektu. Aby zmienić limit, musisz mieć uprawnienia do zarządzania ustawieniami danej organizacji lub projektu.
Limit wydatków może służyć do monitorowania kosztów bez blokowania żądań. Włącz opcję Wymuszaj nieprzekraczalny limit wydatków, jeśli chcesz, aby żądania API kończyły się błędem, gdy zarejestrowane wydatki osiągną limit. Egzekwowanie limitu nie jest natychmiastowe, więc zarejestrowane wydatki mogą nieznacznie przekroczyć ustawioną kwotę.
Alerty dotyczące wydatków powiadamiają o osiągnięciu progu, ale nie blokują żądań.
Ustawianie limitu wydatków organizacji
Przejdź do ustawień organizacji.
Otwórz sekcję Limity i znajdź pozycję Wydatki.
Ustawianie limitu wydatków projektu
Przejdź do ustawień organizacji.
Wybierz projekt, a następnie otwórz sekcję Limity.
Ustaw wartości w polach Limit miesięcznych wydatków i Powiadom, gdy wydatki osiągną.
Włącz opcję Wymuszaj nieprzekraczalny limit wydatków, jeśli chcesz zablokować ruch API, gdy zarejestrowane wydatki osiągną limit.
Na tej stronie możesz też zmienić ustawienia w sekcji Korzystanie z modeli.
Zarządzanie alertami dotyczącymi wydatków
Ustawienie limitu wydatków projektu domyślnie tworzy też alert przy osiągnięciu 100% limitu. Wybierz Dodaj alert, aby dodać alerty dla innych progów.
Właściciele organizacji i projektów otrzymują alerty dotyczące wydatków projektu. W ustawieniach alertów możesz dodać adresy e-mail innych odbiorców.
Aktualne instrukcje konfiguracji i informacje o egzekwowaniu limitów znajdziesz w przewodniku po limitach wydatków.
Przeglądanie wykorzystania i rozliczeń
Dane o wykorzystaniu można analizować w podziale na projekty. Możesz też przeglądać rozliczenia i ustawiać limity wydatków dla poszczególnych projektów.
Dostęp do panelu wykorzystania projektu zależy od Twojej roli w organizacji oraz ustawień widoczności panelu wykorzystania. Sama rola właściciela projektu nie zapewnia dostępu.
Jeśli nie widzisz panelu wykorzystania projektu, sprawdź, czy widoczność jest ustawiona na Widoczny dla właścicieli organizacji.
Zarządzanie przestrzenią na pliki
Każdy projekt ma limit 100 GB przestrzeni na pliki. Po jego przekroczeniu może pojawić się następujący błąd:
Przekroczono limit przestrzeni na pliki. Organizacje mogą przechowywać do 100 GB plików. Zmniejsz rozmiar pliku lub skontaktuj się z pomocą techniczną.
Usuń nieużywane pliki, aby zwolnić miejsce. Możesz pobrać listę przechowywanych plików przez API, aby znaleźć te, których już nie potrzebujesz.
Archiwizowanie projektu
Właściciele organizacji i projektów mogą archiwizować projekty na stronie Projekty lub w ustawieniach danego projektu. Gdy pojawi się prośba o potwierdzenie, wpisz nazwę projektu.
Archiwizacja jest nieodwracalna: zarchiwizowanego projektu nie można przywrócić.
Aby wyświetlić zarchiwizowane projekty, otwórz kartę Zarchiwizowane na stronie Projekty.
Jedynym wyjątkiem jest to, że fine-tunes w „Projekcie domyślnym” są dostępne z innych projektów.
Przekroczono limit miejsca na pliki. Organizacje są ograniczone do 100 GB plików. Zmniejsz rozmiar pliku lub skontaktuj się z pomocą techniczną.Projektów nie można usuwać. OpenAI zachowuje ich historię na potrzeby śledzenia wykorzystania i rozliczeń.