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

Gestionarea proiectelor în platforma API

Actualizat: 19 days ago

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

Proprietarii organizației își pot vedea toate proiectele active și arhivate în pagina Projects. Aflați mai multe despre rolurile și permisiunile utilizatorilor în platforma API.

Image

Cine poate crea un proiect?

Doar 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 cu cursorul peste numele organizației în partea din stânga 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 folosesc un plan de facturare consolidată, sub-organizațiile sunt identificate separat. Proiectele nu pot fi create în sub-organizații.

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 organizației adăugați recent nu sunt adăugați automat la „Proiectul implicit”. Membrii noi pot fi invitați în proiect fie atunci când sunt invitați în organizație (prin bifarea casetei „Invite to default project”), 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 la un proiect prin interfață sau prin Admin API, confirmați mai întâi că proiectul vizat 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 într-o organizație.

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

În timp ce organizațiile au rolurile „owner” și „reader”, proiectele au rolurile „owner” și „member”. Membrii proiectului sunt analogi cititorilor din organizație. Consultați tabelul de mai jos pentru o descriere mai detaliată a permisiunilor care însoțesc fiecare rol de utilizator.

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

pagina Projects
. Poate seta bugete pentru organizație și proiecte. Poate acorda altora din organizație permisiuni de a vedea informațiile de utilizare. Poate arhiva proiecte.
ReaderOrganizațiePoate efectua inferență, folosi resurse și crea chei în proiectele sale. Poate fi adăugat la proiecte.
Nu poate crea proiecte și gestiona utilizatori.
OwnerProiectPoate adăuga alți utilizatori la proiect și redenumi proiectul, precum și toate capacitățile unui membru. Poate seta bugetele proiectului. Poate arhiva proiectul.
MemberProiectPoate efectua inferență, folosi 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. Doar proprietarul organizației poate vedea toate proiectele, membrii și cheile API la nivel de proiect și are acces la pagina Projects.

  • Doar membrii unui proiect (și proprietarii organizației) pot vedea modelele ajustate fin care au fost create în acel proiect, firele din orice Assistants create sau orice fișiere care au fost adăugate.

  • Membrii unui proiect pot vedea cine sunt toți ceilalți membri ai acelui proiect și rolurile lor (adică Owner sau Member).

Cum actualizez rolul unui utilizator în proiect sau cum elimin un utilizator dintr-un proiect?

Doar proprietarul unui proiect poate actualiza rolul unui utilizator în proiect 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 Members. Aveți opțiunea de a seta rolul fiecărui membru ca Member sau Owner. De asemenea, puteți selecta Remove 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., va trebui mai întâi să îl adăugați în organizație (puteți lăsa nebifată caseta „Add to Default Project” dacă nu doriți să oferiți acestor utilizatori un acces mai larg). Această listă nu va include conturi 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 pe cel de Proprietar. Membrii proiectului pot face cereri API care citesc sau modifică date, în timp ce proprietarii proiectului pot modifica și setările proiectului, 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 lista 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 -> Project -> Members -> 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 Create, se creează 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 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 la citire și scriere pentru toate resursele API ale proiectului. Aceste permisiuni pot fi actualizate în setările API Keys ale proiectului.

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

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

Conturile de serviciu sunt gestionate la fel ca conturile obișnuite. Din meniul Organization -> Members puteți Remove un cont de serviciu sau îi puteți actualiza rolul:

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

Cum gestionez cheile API în cadrul proiectelor organizației mele?

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

Pentru a crea o nouă cheie secretă, selectați + Create new secret key. De asemenea, puteți selecta pictograma Edit 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 API atunci când creați o nouă cheie secretă sau editând o cheie existentă.

Sunt disponibile trei niveluri de permisiuni: All, Restricted și Read Only.

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

  • Restricted — Permite utilizatorului să seteze permisiuni None, Read și Write 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
  • Read Only — 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 stabilesc și gestionez limitele de rată pentru proiectele organizației mele?

Doar proprietarul unei organizații poate stabili ș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 Limits în secțiunea Project din lista de navigare. Puteți actualiza Model Usage în 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 stabilesc și gestionez bugetele pentru proiectele organizației mele?

Doar proprietarii unei organizații și proprietarii unui proiect pot stabili ș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 stabili 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 Monthly budget, Notification threshold și Model Usage.

Setarea unui buget lunar vă permite să stabiliți praguri flexibile de cheltuire pentru proiectul dvs. Când utilizarea depășește această limită într-o anumită lună calendaristică (UTC), cererile 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 o limită strictă de cheltuieli. Când se creează un buget de proiect, în mod implicit se creează o alertă la pragul de 100%. Bugete suplimentare la praguri diferite pot fi setate făcând clic pe Add 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 din noua pagină listă de proiecte, fie din setările unui proiect individual. Odată ce un proiect este arhivat, nu mai 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 în fila „Archived” din aceeași pagină listă de proiecte.

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

Ștergerea proiectelor nu este posibilă; menținem 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. Pentru referință, puteți vedea și lista fișierele 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 că această setare este definită ca „Visible to organization owners”.

A fost util acest articol?