OpenAI
Această pagină a fost tradusă automat. Vezi articolul original în limba engleză.

Gestionarea proiectelor în platforma API

Actualizat: 22 days ago

Proiectele urmăresc să le ofere clienților posibilitatea de a-și organiza munca. Organizațiile pot gestiona accesul și limitele, pot furniza conturi de serviciu (prin UI) și pot urmări utilizarea într-un domeniu restrâns din cadrul unui proiect (de ex. modele, capacități, fire, asistenți, fine tuning, stocare etc.). Activitatea de utilizare poate fi defalcată pe proiect, iar utilizatorii pot vedea facturarea și pot seta bugete per proiect.

Proprietarii organizației pot vedea toate proiectele lor Active și Arhivate în pagina Proiecte. Aflați mai multe despre rolurile și permisiunile utilizatorilor în Platforma API.

Image

Cine poate crea un proiect?

Numai proprietarii organizației pot crea un proiect. Consultați rolurile și permisiunile pentru mai multe informații.

Pentru a comuta între organizații, treceți cursorul peste numele organizației din partea stângă sus a paginii și selectați organizația din listă:

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

Pentru organizațiile care au un plan de facturare consolidată, suborganizațiile sunt identificate separat. Proiectele nu pot fi create în cadrul suborganizațiilor.

Image

Cum funcționează proiectele?

Fiecare organizație include un „Proiect implicit” care nu poate fi șters. Puteți configura limitele de rată, permisiunile pentru modelele virtuale și bugetele de cheltuieli (din noiembrie 2024). Acesta moștenește configurația completă a organizației, astfel încât nu puteți adăuga direct membri sau conturi de serviciu la el.

Cum creez un proiect?

Mai întâi, treceți cu cursorul peste numele proiectului din colțul stâng al paginii și selectați Create project.

API platform project menu with Create project highlighted under Default project

Introduceți un nume, o descriere și un site web pentru proiectul dvs., apoi selectați Create.

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

Cum adaug utilizatori la un proiect?

Membrii adăugați recent în organizație nu sunt adăugați automat la „Proiectul implicit”. Membrii noi pot fi invitați în proiect fie când sunt invitați în organizație (activând caseta „Invită în proiectul implicit”), fie după ce membrul a acceptat invitația în organizație.

Utilizatorii invitați prin Admin API urmează regulile descrise de punctul final /organization/invites.

Dacă întâmpinați o eroare când invitați utilizatori într-un proiect prin UI sau Admin API, confirmați mai întâi că proiectul țintă există și nu este arhivat înainte de a retrimite invitația.

Proprietarii organizației sunt adăugați automat ca proprietari la proiectele noi create în cadrul unei organizații.

Care sunt diferitele roluri de utilizator în organizații și proiecte și ce permisiuni implică acestea?

În timp ce organizațiile au roluri de „proprietar” și „cititor”, proiectele au roluri de „proprietar” și „membru”. Membrii proiectului sunt analogi cititorilor organizației. Consultați tabelul de mai jos pentru o descriere mai detaliată a permisiunilor asociate fiecărui rol de utilizator.

RolDomeniuDescriere
ProprietarOrganizațiePoate crea/vizualiza toate proiectele, toți utilizatorii, toate cheile API. Are capacitatea de a monitoriza toate proiectele din cadrul organizației cu

pagina Proiecte
. Poate seta bugete pentru organizație și pentru proiecte. Poate acorda permisiuni altor persoane din organizație pentru a vedea informații despre utilizare. Poate arhiva proiecte.
CititorOrganizațiePoate efectua inferență, utiliza resurse și crea chei în proiectele sale. Poate fi adăugat la proiecte.
Nu poate crea proiecte și gestiona utilizatori.
ProprietarProiectPoate adăuga alți utilizatori la proiect și redenumi proiectul, precum și toate capacitățile unui Membru. Poate seta bugete de proiect. Poate arhiva proiectul.
MembruProiectPoate efectua inferență, utiliza resurse și crea chei la nivel de proiect.

Dacă nu sunt Proprietar în organizație, la ce am acces?

Utilizatorii care nu sunt Proprietari în organizație pot vedea doar proiectele din care fac parte ca membri. Numai proprietarul organizației poate vedea toate proiectele, membrii și cheile API la nivel de proiect și poate avea acces la pagina Proiecte.

  • Numai membrii unui proiect (și proprietarii organizației) pot vedea modelele fine-tuned care au fost create în cadrul acelui proiect, firele de la orice Asistenți creați sau orice fișiere care au fost adăugate.

  • Membrii unui proiect pot vedea cine sunt ceilalți membri ai proiectului și rolurile acestora (adică Proprietar sau Membru).

Cum actualizez rolul de proiect al unui utilizator sau elimin un utilizator dintr-un proiect?

Numai proprietarul unui proiect poate actualiza rolul de proiect al unui utilizator sau poate elimina un utilizator dintr-un proiect. Consultați rolurile și permisiunile pentru mai multe informații.

Pentru a actualiza un utilizator într-un proiect, accesați setările organizației, selectați proiectul și faceți clic pe Membri. Aveți opțiunea de a seta rolul fiecărui membru ca Membru sau Proprietar. De asemenea, puteți selecta Eliminare pentru a elimina utilizatorul din proiect.

Ce este un cont de serviciu și prin ce diferă de un cont de utilizator obișnuit?

Un cont de serviciu acționează ca un pseudo-utilizator conceput pentru acces la sistem, distinct de conturile individuale de utilizator. Doar proprietarii organizației și ai proiectului pot crea conturi de serviciu.

Conturile de serviciu sunt limitate doar la proiecte.

Adăugați un membru la un proiect

Dacă faceți clic pe butonul + Add member, veți vedea o listă de utilizatori din organizația dvs. cu rolul Reader. Dacă doriți să adăugați un utilizator care nu se află în prezent în organizația dvs., trebuie mai întâi să îl adăugați în organizație (puteți lăsa nebifată caseta „Adaugă la proiectul implicit” dacă nu doriți să le oferiți acestor utilizatori acces mai larg). Această listă nu va include conturile de serviciu. În acest pas puteți alege dacă rolul lor este Owner sau Member:

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

Când adăugați un membru al echipei, trebuie să îi atribuiți fie rolul de Membru , fie rolul de Proprietar. Membrii proiectului pot face solicitări API care citesc sau modifică date, în timp ce proprietarii proiectului pot modifica și setările și bugetele proiectului și pot gestiona membrii proiectului. Consultați rolurile și permisiunile pentru mai multe informații.

Cum să creați un cont de serviciu pentru un proiect

Mai întâi, navigați la proiectul pentru care doriți să creați un cont de serviciu, alegând din meniul derulant aflat în bara de navigare:

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

Apoi, accesați setările organizației -> Proiect -> Membri -> faceți clic pe + Service account:

Conturile de serviciu create la nivel de proiect sunt unice pentru proiect și nu pot fi utilizate în afara proiectului în care sunt create.

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

Denumirea contului de serviciu

Indiferent dacă creați contul de serviciu la nivel de organizație sau creați unul unic pentru un proiect, atunci când creați un cont de serviciu puteți crea un ID unic de cont de serviciu format din litere, cifre și cratime, pentru a identifica ușor contul de serviciu.

Salvați cheia API a contului de serviciu

După selectarea butonului Creare, este creată imediat o cheie API pentru contul de serviciu, iar cheia secretă va fi afișată. Salvați această cheie secretă într-un loc sigur și securizat. Din motive de securitate, nu o veți mai putea vedea din nou prin contul dvs. OpenAI. Dacă pierdeți această cheie secretă, va trebui să generați una nouă.

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

Permisiunile cheii API a contului de serviciu sunt setate implicit să citească și să scrie toate resursele API ale proiectului. Aceste permisiuni pot fi actualizate în setările Chei API ale proiectului.

Conturile de serviciu sunt listate alături de membrii proiectului pe pagina de setări ale membrilor proiectului. Consultați aici pentru a afla mai multe despre actualizarea sau eliminarea accesului unui cont de serviciu în pagina de setări ale membrilor proiectului.

Toate conturile de serviciu din proiecte și organizații vor fi afișate alături de utilizatorii umani pe pagina membrilor la nivel de organizație.

Conturile de serviciu sunt gestionate la fel ca cele obișnuite. Din Organizație -> meniul Membri puteți Elimina un cont de serviciu sau actualiza rolul:

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

Cum gestionez cheile API în proiectele organizației mele?

Puteți crea și gestiona chei API pentru fiecare proiect pe pagina de setări a proiectului respectiv. În setările organizației, selectați proiectul și faceți clic pe Chei API.

Pentru a crea o cheie secretă nouă, selectați + Create new secret key. De asemenea, puteți selecta pictograma Editare de lângă o cheie secretă pentru a-i edita permisiunile.

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

Puteți seta permisiuni pentru fiecare dintre cheile dvs. API când creați o cheie secretă nouă sau editând o cheie existentă.

Sunt disponibile trei niveluri de permisiuni: Toate, Restricționat și Doar citire.

  • Toate — Permisiunile complete sunt setate pentru cheia secretă. Aceasta este setarea implicită.

  • Restricționat — Permite utilizatorului să seteze permisiuni Niciuna, Citire și Scriere pentru fiecare punct final.

    • De exemplu, creați o cheie API care în mod specific nu are permisiunea de a citi sau scrie în punctul final /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Doar citire — Permisiunile de citire sunt setate pentru toate punctele finale.

Cum este gestionat accesul pentru utilizatorii care aparțin mai multor proiecte sau organizații?

Utilizatorii pot fi membri ai oricâtor proiecte este nevoie. În cadrul unui proiect, utilizatorii pot genera o cheie API personală, limitată și destinată accesului la acel proiect și la resursele sale.

Cum setez și gestionez limitele de rată pentru proiectele organizației mele?

Numai proprietarul unei organizații poate seta și gestiona limitele de rată la nivel de proiect. Consultați rolurile și permisiunile pentru mai multe informații.

În setările organizației, faceți clic pe proiectul pe care doriți să îl actualizați și selectați Limite în secțiunea Proiect a listei de navigare. Puteți actualiza Utilizarea modelului pe această pagină.

Utilizarea modelului vă permite să configurați ce modele pot fi folosite de proiect, iar limitele de rată pot fi setate pentru fiecare model după cum este necesar.

Cum setez și gestionez bugetele pentru proiectele organizației mele?

Numai proprietarii unei organizații și proprietarii unui proiect pot seta și gestiona bugetele proiectelor. Consultați rolurile și permisiunile pentru mai multe informații. Pentru a modifica limitele la nivel de organizație, în setările organizației, faceți clic pe Limits, apoi derulați în jos la Usage limits.

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

Pentru a seta limitele proiectului, în setările organizației, faceți clic pe proiectul pe care doriți să îl actualizați și selectați Limits. Puteți actualiza Bugetul lunar, Pragul de notificare și Utilizarea modelului.

Setarea unui buget lunar vă permite să stabiliți praguri flexibile de cheltuieli pentru proiect. Când utilizarea depășește această limită într-o anumită lună calendaristică (UTC), solicitările API vor continua să fie procesate fără întrerupere. Această funcție este concepută pentru a vă ajuta să monitorizați utilizarea prin alerte de buget, dar nu impune un plafon strict al cheltuielilor. Când este creat un buget de proiect, în mod implicit va fi creată o alertă la pragul de 100%. Bugete suplimentare la praguri diferite pot fi setate făcând clic pe Adaugă alertă.

Rețineți că proprietarul/proprietarii organizației și proprietarul/proprietarii proiectului vor primi întotdeauna aceste mesaje, iar acest lucru nu poate fi personalizat.

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

Cum șterg sau arhivez un proiect?

Proiectele pot fi arhivate fie prin noua pagină de listare a proiectelor, fie din setările unui proiect individual. După ce un proiect este arhivat, acesta nu poate fi restaurat. Când continuați cu arhivarea, vi se va solicita să introduceți numele proiectului pentru a merge mai departe.

Puteți vedea o listă a tuturor proiectelor arhivate prin fila „Arhivate” de pe aceeași pagină de listare a proiectelor.

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

Ștergerea proiectelor nu este posibilă; păstrăm un istoric al tuturor proiectelor pentru a asigura continuitatea urmăririi utilizării și facturării.

Există o limită pentru numărul de proiecte pe care le pot avea în organizația mea?

În mod implicit, organizațiile pot crea până la 2.000 de proiecte.

Pot fi partajate resurse între proiecte?

Resursele proiectului (cum ar fi fișierele, asistenții, stocarea sau firele) sunt limitate la proiect și nu pot fi accesate de membri non-admin din afara proiectului. În plus, resursele nu pot fi mutate între proiecte.

Singura excepție este că ajustările fine din „Proiectul implicit” pot fi accesate din alte proiecte.

Care este cota de stocare a fișierelor per proiect?

OpenAI acceptă în prezent o cotă de stocare de 100 GB de fișiere per proiect.

Dacă această cotă este depășită, veți vedea următoarea eroare:

Ați depășit cota de stocare a fișierelor. Organizațiile sunt limitate la 100 GB de fișiere. Vă rugăm să reduceți dimensiunea fișierelor sau să contactați asistența.

Vă recomandăm să ștergeți fișierele neutilizate stocate în contul dvs. Ca referință, puteți vizualiza și lista fișiere cu API-ul.

Sunt proprietar de proiect; de ce nu pot vedea Tabloul de bord de utilizare pentru proiectul meu?

Vizibilitatea Tabloului de bord de utilizare al unui proiect nu este legată de rolul unui utilizator în cadrul unui proiect. În schimb, este determinată de rolul dvs. în cadrul organizației și de setările de la https://platform.openai.com/settings/organization/data-controls/visibility

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

Dacă nu puteți vedea un Tablou de bord de utilizare, probabil această setare este configurată la „Vizibil pentru proprietarii organizației”.

A fost util acest articol?