OpenAI
Ta strona została przetłumaczona maszynowo. Wyświetl oryginalny artykuł w języku angielskim.

Zarządzanie projektami na platformie API

Zaktualizowano: 13 days ago

Projekty mają na celu umożliwienie klientom organizowania swojej pracy. Organizacje mogą zarządzać dostępem i limitami, udostępniać konta serwisowe (przez interfejs użytkownika) oraz śledzić użycie w ograniczonym zakresie w ramach projektu (np. modele, możliwości, wątki, asystenci, dostrajanie, pamięć itd.). Aktywność użycia można podzielić według projektów, a użytkownicy mogą przeglądać rozliczenia i ustawiać budżety dla każdego projektu.

Właściciele organizacji mogą przeglądać wszystkie swoje aktywne i zarchiwizowane projekty na stronie Projects. Dowiedz się więcej o rolach użytkowników i uprawnieniach na platformie API.

Image

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ź na nazwę organizacji w lewym górnym rogu strony i wybierz organizację z listy:

Projects page with the organization switcher open, listing Personal and Staging organizations

W organizacjach korzystających ze skonsolidowanego planu rozliczeń podorganizacje są identyfikowane osobno. W podorganizacjach nie można tworzyć projektów.

Image

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.

API platform project menu with Create project highlighted under Default project

Podaj nazwę, opis i witrynę internetową projektu, a następnie wybierz Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

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 albo podczas zapraszania ich do organizacji (włączając pole wyboru "Zaproś do projektu domyślnego"), albo po zaakceptowaniu przez członka zaproszenia do organizacji.

Użytkownicy zaproszeni za pośrednictwem Admin API podlegają zasadom 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, najpierw potwierdź, że docelowy projekt istnieje i nie jest zarchiwizowany, a następnie wyślij zaproszenie ponownie.

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 obejmują?

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ń przypisanych do każdej roli użytkownika znajdziesz w tabeli poniżej.

RolaZakresOpis
OwnerOrganizacjaMoże tworzyć/wyświetlać wszystkie projekty, wszystkich użytkowników i 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 nadawać innym osobom w organizacji uprawnienia do wyświetlania informacji o użyciu. Może archiwizować projekty.
ReaderOrganizacjaMoże wykonywać inferencję, korzystać z zasobów i tworzyć klucze w swoich projektach. Może być dodawany do projektów.
Nie może tworzyć projektów ani zarządzać użytkownikami.
OwnerProjektMoże dodawać innych użytkowników do projektu i zmieniać nazwę projektu, a także ma wszystkie możliwości roli Member. Może ustawiać budżety projektu. Może archiwizować projekt.
MemberProjektMoże wykonywać inferencję, korzystać z 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, mogą widzieć tylko projekty, których są członkami. Tylko właściciel organizacji może zobaczyć wszystkie projekty, członków i klucze API na poziomie projektu oraz ma dostęp do strony Projects.

  • Tylko członkowie projektu (i właściciele organizacji) mogą widzieć modele fine-tuned utworzone w tym projekcie, wątki z utworzonych asystentów oraz wszelkie dodane pliki.

  • Członkowie projektu mogą zobaczyć wszystkich innych członków tego projektu i ich 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. Masz możliwość ustawienia roli każdego członka jako Member lub Owner. Możesz także 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 nie należy jeszcze 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 serwisowych. Na tym etapie możesz wybrać, czy ich rolą będzie Owner, czy Member:

Project members with Add team members dialog assigning a user the Member role

Gdy dodajesz członka zespołu, musisz przypisać mu rolę Member lub Owner. Członkowie projektu mogą wykonywać żądania API odczytujące lub modyfikujące dane, natomiast właściciele projektu mogą także modyfikować ustawienia projektu i budżety projektu oraz zarządzać członkami projektu. Więcej informacji znajdziesz w sekcji role i uprawnienia.

Jak utworzyć konto serwisowe dla projektu

Najpierw przejdź do projektu, dla którego chcesz utworzyć konto serwisowe, wybierając go z listy rozwijanej znajdującej się na pasku nawigacyjnym:

API platform project switcher open with options to create a project or manage projects

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.

Project Members page with Create a service account dialog after selecting the Service account option

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 serwisowego

Po wybraniu przycisku Create klucz API dla konta serwisowego jest tworzony natychmiast, a tajny klucz zostanie wyświetlony. Zapisz ten tajny klucz w bezpiecznym miejscu. Ze względów bezpieczeństwa nie będzie można go ponownie wyświetlić za pośrednictwem konta OpenAI. Jeśli utracisz ten tajny klucz, konieczne będzie wygenerowanie nowego.

Members page with Save your key modal after creating a service account

Uprawnienia klucza API konta serwisowego są domyślnie ustawione na odczyt i zapis wszystkich zasobów API projektu. Uprawnienia te można zaktualizować w ustawieniach API Keys projektu.

Konta serwisowe są wyświetlane obok członków projektu na stronie ustawień członków projektu. Więcej informacji o aktualizowaniu lub usuwaniu dostępu konta serwisowego na stronie ustawień członków projektu znajdziesz tutaj.

Wszystkie konta serwisowe zarówno w projektach, jak i organizacjach będą wyświetlane obok użytkowników ludzkich na stronie członków na poziomie organizacji.

Kontami serwisowymi zarządza się tak samo jak zwykłymi kontami. W menu Organization -> Members możesz usunąć konto serwisowe lub zaktualizować jego rolę:

OpenAI API Members settings with a service account role menu open for Reader or Owner

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 tajny klucz, wybierz + Create new secret key. Możesz też wybrać ikonę edycji obok tajnego klucza, aby edytować jego uprawnienia.

API keys page for a project with the Create new secret key button highlighted

Możesz ustawić uprawnienia dla każdego klucza API podczas tworzenia nowego tajnego klucza lub przez edycję istniejącego klucza.

Dostępne są trzy poziomy uprawnień: All, Restricted i Read Only.

  • All — dla tajnego klucza ustawiane są pełne uprawnienia. To ustawienie domyślne.

  • Restricted — pozwala użytkownikowi ustawić uprawnienia None, Read i Write dla każdego punktu końcowego.

    • Na przykład tworzysz klucz API, który celowo nie ma uprawnień Read ani Write do punktu końcowego /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Read Only — uprawnienia odczytu są ustawione 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 szybkości dla projektów w mojej organizacji i nimi zarządzać?

Tylko właściciel organizacji może ustawiać limity szybkości 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 na liście nawigacyjnej. Na tej stronie możesz zaktualizować Model Usage.


Model usage pozwala skonfigurować, które modele mogą być używane przez projekt, a limity szybkości można ustawić dla każdego modelu według potrzeb.

Jak ustawiać budżety projektów w mojej organizacji i nimi zarządzać?

Tylko właściciele organizacji i właściciele projektu mogą ustawiać budżety projektu 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.

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

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 miesięcznego budżetu 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 ma pomóc w monitorowaniu użycia za pomocą alertów budżetowych, ale nie wymusza twardego limitu wydatków. Po utworzeniu budżetu projektu domyślnie tworzony jest alert przy progu 100%. Dodatkowe budżety z innymi progami można ustawić, klikając Add Alert.

Pamiętaj, że właściciel(e) organizacji i właściciel(e) projektu zawsze będą otrzymywać te wiadomości i nie można tego dostosować.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Jak usunąć lub zarchiwizować projekt?

Projekty można archiwizować zarówno na nowej stronie listy projektów, jak i w ustawieniach pojedynczego projektu. Po zarchiwizowaniu projektu nie można go przywrócić. Przy archiwizacji pojawi się prośba o wpisanie nazwy projektu, aby kontynuować.

Listę wszystkich zarchiwizowanych projektów możesz zobaczyć na karcie „Archived” na tej samej stronie listy projektów.

API platform Projects page with the Archived tab selected to view archived projects

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 koncie. Dla odniesienia możesz wyświetlać i listować pliki za pomocą API.

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 i ustawień pod adresem https://platform.openai.com/settings/organization/data-controls/visibility

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

Jeśli nie możesz zobaczyć panelu Usage Dashboard, to ustawienie prawdopodobnie jest ustawione na "Visible to organization owners".

Czy ten artykuł był pomocny?