Projekty mają zapewnić klientom możliwość organizowania pracy. Organizacje mogą zarządzać dostępem i limitami, udostępniać konta usługi (przez interfejs użytkownika) oraz śledzić użycie w ograniczonym zakresie w ramach projektu (np. modele, funkcje, wątki, asystenci, dostrajanie, pamięć masowa itp.). Aktywność użycia można rozbić według projektu, a użytkownicy mogą wyświetlać rozliczenia i ustawiać budżety dla każdego projektu.
Właściciele organizacji mogą wyświetlać wszystkie swoje aktywne i zarchiwizowane projekty na stronie Projects. Dowiedz się więcej o rolach i uprawnieniach użytkowników na platformie API.
Kto może utworzyć projekt?
Tylko właściciele organizacji mogą utworzyć projekt. Więcej informacji znajdziesz w sekcji role i uprawnienia.
Aby przełączać się między organizacjami, najedź kursorem na nazwę organizacji w lewym górnym rogu strony i wybierz organizację z listy:
W przypadku organizacji korzystających ze skonsolidowanego planu rozliczeń podorganizacje są identyfikowane oddzielnie. Nie można tworzyć projektów w podorganizacjach.
Jak działają projekty?
Każda organizacja obejmuje „Projekt domyślny”, którego nie można usunąć. Możesz skonfigurować limity szybkości, uprawnienia wirtualnych modeli i budżety wydatków (stan na listopad 2024 r.). Dziedziczy on pełną konfigurację organizacji, więc nie możesz bezpośrednio dodawać do niego członków ani kont serwisowych.
Jak utworzyć projekt?
Najpierw najedź kursorem na nazwę projektu w lewym rogu strony i wybierz Create project.
Podaj nazwę, opis i witrynę internetową projektu, a następnie wybierz Create.
Jak dodać użytkowników do projektu?
Nowo dodani członkowie organizacji nie są automatycznie dodawani do „Projektu domyślnego”. Nowych członków można zaprosić do projektu podczas zapraszania ich do organizacji (zaznaczając pole wyboru „Zaproś do projektu domyślnego”) albo po zaakceptowaniu przez członka zaproszenia do organizacji.
Użytkownicy zaproszeni przez interfejs Admin API podlegają regułom opisanym przez punkt końcowy /organization/invites.
Jeśli podczas zapraszania użytkowników do projektu przez interfejs użytkownika lub Admin API wystąpi błąd, przed ponownym wysłaniem zaproszenia najpierw potwierdź, że projekt docelowy istnieje i nie jest zarchiwizowany.
Właściciele organizacji są automatycznie dodawani jako właściciele do nowych projektów tworzonych w organizacji.
Jakie są różne role użytkowników w organizacjach i projektach oraz jakie uprawnienia się z nimi wiążą?
Podczas gdy organizacje mają role „owner” i „reader”, projekty mają role „owner” i „member”. Członkowie projektu są odpowiednikami czytelników organizacji. Bardziej szczegółowy opis uprawnień powiązanych z każdą rolą użytkownika znajdziesz w poniższej tabeli.
| Rola | Zakres | Opis |
|---|---|---|
| Właściciel | Organizacja | Może tworzyć i wyświetlać wszystkie projekty, wszystkich użytkowników oraz wszystkie klucze API. Ma możliwość monitorowania wszystkich projektów w organizacji za pomocą strony Projects . Może ustawiać budżety organizacji i budżety projektów. Może przyznawać innym osobom w organizacji uprawnienia do wyświetlania informacji o użyciu. Może archiwizować projekty. |
| Czytelnik | Organizacja | Może wykonywać wnioskowanie, używać zasobów i tworzyć klucze w swoich projektach. Może zostać dodany do projektów. Nie może tworzyć projektów ani zarządzać użytkownikami. |
| Właściciel | Projekt | Może dodawać innych użytkowników do projektu i zmieniać nazwę projektu, a także ma wszystkie możliwości członka. Może ustawiać budżety projektu. Może zarchiwizować projekt. |
| Członek | Projekt | Może wykonywać wnioskowanie, używać zasobów i tworzyć klucze na poziomie projektu. |
Jeśli nie jestem właścicielem w organizacji, do czego mam dostęp?
Użytkownicy, którzy nie są właścicielami w organizacji, widzą tylko projekty, których są członkami. Tylko właściciel organizacji może widzieć wszystkie projekty, członków i klucze API na poziomie projektu oraz mieć dostęp do strony Projects.
Tylko członkowie projektu (oraz właściciele organizacji) mogą widzieć dostrojone modele utworzone w tym projekcie, wątki z utworzonych asystentów lub dodane pliki.
Członkowie projektu mogą zobaczyć, kim są wszyscy pozostali członkowie tego projektu oraz jakie mają role (tj. Owner lub Member).
Jak zaktualizować rolę użytkownika w projekcie lub usunąć użytkownika z projektu?
Tylko właściciel projektu może zaktualizować rolę użytkownika w projekcie lub usunąć użytkownika z projektu. Więcej informacji znajdziesz w sekcji role i uprawnienia.
Aby zaktualizować użytkownika w projekcie, przejdź do ustawień organizacji, wybierz projekt i kliknij Members. Możesz ustawić rolę każdego członka jako Member lub Owner. Możesz też wybrać Remove, aby usunąć użytkownika z projektu.
Czym jest konto serwisowe i czym różni się od zwykłego konta użytkownika?
Konto serwisowe działa jako pseudoużytkownik przeznaczony do dostępu systemowego, odrębny od indywidualnych kont użytkowników. Tylko właściciele organizacji i projektów mogą tworzyć konta serwisowe.
Konta serwisowe są ograniczone wyłącznie do projektów.
Dodawanie członka do projektu
Po kliknięciu przycisku + Add member zobaczysz listę użytkowników w organizacji z rolą Reader. Jeśli chcesz dodać użytkownika, który obecnie nie należy do Twojej organizacji, musisz najpierw dodać go do organizacji (możesz pozostawić pole wyboru „Add to Default Project” niezaznaczone, jeśli nie chcesz przyznawać tym użytkownikom szerszego dostępu). Ta lista nie będzie obejmować kont usługi. Na tym etapie możesz wybrać, czy ich rola to Owner czy Member:
Gdy dodajesz członka zespołu, musisz przypisać mu rolę Member albo Owner. Członkowie projektu mogą wykonywać żądania API, które odczytują lub modyfikują dane, natomiast właściciele projektu mogą także modyfikować ustawienia i budżety projektu oraz zarządzać członkami projektu. Więcej informacji znajdziesz w sekcji role i uprawnienia.
Jak utworzyć konto usługi dla projektu
Najpierw przejdź do projektu, dla którego chcesz utworzyć konto usługi, wybierając go z menu rozwijanego na pasku nawigacji:
Następnie przejdź do ustawień organizacji -> Project -> Members -> kliknij + Service account:
Konta serwisowe utworzone na poziomie projektu są unikalne dla projektu i nie mogą być używane poza projektem, w którym zostały utworzone.
Nadawanie nazwy kontu serwisowemu
Niezależnie od tego, czy tworzysz konto serwisowe na poziomie organizacji, czy unikalne dla projektu, podczas tworzenia konta serwisowego możesz utworzyć unikalny identyfikator konta serwisowego składający się z liter, cyfr i myślników, aby łatwo je zidentyfikować.
Zapisz klucz API konta usługi
Po wybraniu przycisku Create klucz API zostanie natychmiast utworzony dla konta usługi, a klucz tajny zostanie wyświetlony. Zapisz ten klucz tajny w bezpiecznym miejscu. Ze względów bezpieczeństwa nie będzie można ponownie wyświetlić go na koncie OpenAI. Jeśli utracisz ten klucz tajny, musisz wygenerować nowy.
Uprawnienia klucza API konta usługi domyślnie umożliwiają odczyt i zapis wszystkich zasobów API projektu. Te uprawnienia można zaktualizować w ustawieniach API Keys projektu.
Konta usługi są wymienione obok członków projektu na stronie ustawień członków projektu. Aby dowiedzieć się więcej o aktualizowaniu lub usuwaniu dostępu konta usługi na stronie ustawień członków projektu, zapoznaj się z informacjami tutaj.
Wszystkie konta usługi w projektach i organizacjach będą wyświetlane obok użytkowników-ludzi na stronie członków na poziomie organizacji.
Kontami usługi zarządza się tak jak zwykłymi kontami. Z poziomu Organizacja -> menu Członkowie możesz usunąć konto usługi lub zaktualizować rolę:
Jak zarządzać kluczami API w projektach mojej organizacji?
Klucze API dla każdego projektu możesz tworzyć i nimi zarządzać na stronie ustawień tego projektu. W ustawieniach organizacji wybierz projekt i kliknij API Keys.
Aby utworzyć nowy klucz tajny, wybierz + Create new secret key. Możesz także wybrać ikonę Edytuj obok klucza tajnego, aby edytować jego uprawnienia.
Możesz ustawić uprawnienia dla każdego klucza API podczas tworzenia nowego klucza tajnego lub edytując istniejący klucz.
Dostępne są trzy poziomy uprawnień: All, Restricted i Read Only.
All — Dla klucza tajnego ustawiane są pełne uprawnienia. To jest ustawienie domyślne.
Restricted — Umożliwia użytkownikowi ustawianie uprawnień None, Read i Write dla każdego punktu końcowego.
Na przykład tworzysz klucz API, który specjalnie nie ma uprawnień do odczytu ani zapisu w punkcie końcowym /v1/assistants:
Read Only — Uprawnienia do odczytu są ustawiane dla wszystkich punktów końcowych.
Jak zarządzany jest dostęp użytkowników należących do wielu projektów lub organizacji?
Użytkownicy mogą być członkami tylu projektów, ilu potrzebują. W ramach projektu użytkownicy mogą wygenerować osobisty klucz API o zakresie ograniczonym do dostępu do tego projektu i jego zasobów.
Jak ustawiać limity zapytań dla projektów mojej organizacji i nimi zarządzać?
Tylko właściciel organizacji może ustawiać limity zapytań na poziomie projektu i nimi zarządzać. Więcej informacji znajdziesz w sekcji role i uprawnienia.
W ustawieniach organizacji kliknij projekt, który chcesz zaktualizować, i wybierz Limits w sekcji Project listy nawigacyjnej. Na tej stronie możesz zaktualizować Model Usage.
Model usage pozwala skonfigurować, które modele mogą być używane przez projekt, a limity zapytań można ustawić dla każdego modelu według potrzeb.
Jak ustawiać budżety projektów mojej organizacji i nimi zarządzać?
Tylko właściciele organizacji i właściciele projektu mogą ustawiać budżety projektów i nimi zarządzać. Więcej informacji znajdziesz w sekcji role i uprawnienia. Aby zmienić limity na poziomie organizacji, w ustawieniach organizacji kliknij Limits, a następnie przewiń w dół do Usage limits.
Aby ustawić limity projektu, w ustawieniach organizacji kliknij projekt, który chcesz zaktualizować, i wybierz Limits. Możesz zaktualizować Monthly budget, Notification threshold i Model Usage.
Ustawienie budżetu miesięcznego pozwala określić miękkie progi wydatków dla projektu. Gdy użycie przekroczy ten limit w danym miesiącu kalendarzowym (UTC), żądania API będą nadal przetwarzane bez przerwy. Ta funkcja pomaga monitorować użycie za pomocą alertów budżetowych, ale nie wymusza sztywnego limitu wydatków. Po utworzeniu budżetu projektu domyślnie zostanie utworzony alert przy progu 100%. Dodatkowe budżety z różnymi progami można ustawić, klikając Add Alert.
Pamiętaj, że właściciele organizacji i właściciele projektu zawsze będą otrzymywać te wiadomości i nie można tego dostosować.
Jak usunąć lub zarchiwizować projekt?
Projekty można archiwizować na nowej stronie listy projektów albo w ustawieniach pojedynczego projektu. Po zarchiwizowaniu projektu nie można go przywrócić. Podczas archiwizacji pojawi się prośba o wpisanie nazwy projektu, aby kontynuować.
Listę wszystkich zarchiwizowanych projektów możesz wyświetlić na karcie „Archived” na tej samej stronie listy projektów.
Usuwanie projektów nie jest możliwe; przechowujemy historię wszystkich projektów, aby zapewnić ciągłość śledzenia użycia i rozliczeń.
Czy istnieje limit liczby projektów w mojej organizacji?
Organizacje mogą domyślnie tworzyć do 2000 projektów.
Czy zasoby mogą być współdzielone między projektami?
Zasoby projektu (takie jak pliki, asystenci, pamięć, czy wątki) są ograniczone do projektu i nie mogą być dostępne dla członków spoza projektu niebędących administratorami. Ponadto zasobów nie można przenosić między projektami.
Jedynym wyjątkiem jest to, że fine-tunes w „Projekcie domyślnym” są dostępne z innych projektów.
Jaki jest limit miejsca na pliki na projekt?
OpenAI obecnie obsługuje limit miejsca na pliki wynoszący 100 GB plików na projekt.
Jeśli ten limit zostanie przekroczony, zobaczysz następujący błąd:
Przekroczono limit miejsca na pliki. Organizacje są ograniczone do 100 GB plików. Zmniejsz rozmiar pliku lub skontaktuj się z pomocą techniczną.Zalecamy usunięcie nieużywanych plików przechowywanych na Twoim koncie. Dla informacji: za pomocą API możesz wyświetlać i listować pliki.
Jestem właścicielem projektu — dlaczego nie widzę panelu Usage Dashboard dla mojego projektu?
Widoczność panelu Usage Dashboard projektu nie jest związana z rolą użytkownika w projekcie. Zamiast tego zależy od Twojej roli w organizacji oraz ustawień pod adresem https://platform.openai.com/settings/organization/data-controls/visibility
Jeśli nie widzisz panelu Usage Dashboard, to ustawienie prawdopodobnie ma wartość „Visible to organization owners”.