Visió general
Els projectes organitzen la feina dins d'una organització de l'API. Utilitza'ls per gestionar l'accés, configurar els límits dels models i els límits de peticions, crear comptes de servei i fer un seguiment de l'ús, la facturació i els límits de despesa d'un conjunt definit de recursos, com ara models, capacitats, fils, assistents, ajust fi i emmagatzematge.
Els propietaris de l'organització poden veure tots els projectes actius i arxivats a la pàgina Projectes.
Abans de començar
Necessites el rol de propietari de l'organització per crear un projecte. Per defecte, les organitzacions poden crear fins a 2.000 projectes.
Si la teva organització utilitza la facturació consolidada, les suborganitzacions apareixen per separat al selector d'organitzacions. No pots crear projectes dins d'una suborganització.
Per canviar d'organització, obre el selector d'organitzacions i selecciona la que vulguis utilitzar.
Projecte predeterminat
Cada organització inclou un projecte predeterminat, que no es pot eliminar. Hereta tota la configuració de l'organització. Pots configurar-ne els límits de peticions, els permisos dels models virtuals i els límits de despesa.
No pots afegir membres ni comptes de servei directament al projecte predeterminat. Pots incloure l'accés al projecte predeterminat quan convidis algú a l'organització, seguint els passos per convidar algú a l'organització que s'indiquen en aquest article.
Crea un projecte
Obre el selector de projectes i selecciona Crea un projecte.
Introdueix un nom, una descripció i un lloc web per al teu projecte.
Selecciona Crea.
Els propietaris de l'organització s'afegeixen automàticament com a propietaris als projectes nous.
Entén els rols i l'accés
La taula resumeix els rols de propietari i lector de l'organització i els rols de propietari i membre del projecte utilitzats en aquests passos. Els membres del projecte tenen permisos semblants als dels lectors de l'organització.
| Rol | Àmbit | Permisos |
|---|---|---|
| Propietari | Organització | Crear i veure tots els projectes, usuaris i claus d'API. Supervisar els projectes a la pàgina Projectes. Establir límits de despesa per a l'organització i els projectes. Concedir accés a la informació d'ús d'altres usuaris. Arxivar projectes. |
| Lector | Organització | Ser afegit a projectes, executar inferències, utilitzar recursos i crear claus en aquests projectes. No pot crear projectes ni gestionar usuaris. |
| Propietari | Projecte | Tots els permisos de membre, a més d'afegir usuaris, gestionar els membres i la configuració del projecte, canviar-ne el nom, establir-ne els límits de despesa i arxivar-lo. |
| Membre | Projecte | Executar inferències, utilitzar recursos, crear claus del projecte i fer peticions a l'API per llegir o modificar dades. |
Per obtenir més informació sobre els rols de l'organització, consulta rols de l'organització. Per consultar els rols addicionals, els rols personalitzats i tots els permisos, consulta la guia de rols i permisos de l'API.
Visibilitat dels projectes
Amb aquests rols estàndard, els usuaris que no són propietaris de l'organització només poden veure els projectes als quals pertanyen. Els propietaris de l'organització poden veure tots els projectes, els membres i les claus d'API dels projectes, i poden accedir a la pàgina Projectes.
Els membres del projecte poden veure els altres membres del seu projecte i el rol de cadascun. Només els membres del projecte i els propietaris de l'organització poden veure els models amb ajust fi, els fils dels assistents i els fitxers creats o afegits dins d'aquell projecte.
Pots pertànyer a tants projectes com necessitis. Una clau d'API personal creada dins d'un projecte està limitada a aquell projecte i als seus recursos.
Límits d'accés als recursos
Els fitxers, els assistents, l'emmagatzematge i els fils estan limitats a l'àmbit del projecte al qual pertanyen. Els membres que no pertanyen al projecte i no són administradors no poden accedir als seus recursos, i els recursos no es poden moure entre projectes.
Els models amb ajust fi del projecte predeterminat en són una excepció: s'hi pot accedir des d'altres projectes.
Gestiona els membres del projecte
Convida algú a la teva organització
Una persona ha de pertànyer a la teva organització abans que la puguis afegir a un projecte.
Quan convides algú a l'organització, pots incloure l'accés al projecte predeterminat seleccionant aquesta opció al formulari d'invitació. Deixa-la sense seleccionar si no vols concedir accés al projecte predeterminat. Els membres nous de l'organització no s'afegeixen automàticament al projecte predeterminat.
No cal que creïs un altre projecte abans de convidar algú. També pots afegir algú a un projecte un cop hagi acceptat la invitació a l'organització.
Les invitacions enviades mitjançant l'API d'administració segueixen les regles del punt final /organization/invites.
Afegeix un membre de l'organització a un projecte
Els propietaris de l'organització i del projecte poden afegir membres:
Ves a la configuració de l'organització.
Selecciona el projecte i obre Membres.
Selecciona + Afegeix un membre.
Selecciona l'usuari i assigna-li el rol de Membre o Propietari.
La llista d'usuaris mostra els usuaris de l'organització amb el rol de Lector. No inclou els comptes de servei.
Si una invitació falla a la interfície d'usuari o a l'API d'administració, comprova que el projecte de destinació existeix i no està arxivat abans de tornar-la a enviar.
Canvia un rol o elimina un membre
Els propietaris de l'organització i del projecte poden canviar el rol d'un usuari al projecte o eliminar-lo del projecte.
Ves a la configuració de l'organització.
Selecciona el projecte i obre Membres.
Assigna a l'usuari el rol de Membre o Propietari, o selecciona Elimina per eliminar-lo.
Crea i gestiona comptes de servei
Un compte de servei proporciona accés al sistema en lloc de representar un usuari individual. Els comptes de servei estan limitats a l'àmbit dels projectes.
Per crear comptes de servei, calen permisos de gestió de comptes de servei. Els propietaris de l'organització i del projecte tenen aquests permisos.
Crea un compte de servei
Tria el projecte al selector de projectes.
Ves a la configuració de l'organització i selecciona el projecte.
Obre Membres i selecciona + Compte de servei.
Introdueix un identificador únic per al compte de servei amb lletres, números i guionets.
Selecciona Crea.
Els comptes de servei creats a escala de projecte són únics per al projecte i no es poden utilitzar fora del projecte en què s'han creat.
S'aplica el mateix format d'identificador tant si crees el compte de servei des de la configuració de l'organització com des de la del projecte.
Un compte de servei creat per a un projecte és exclusiu d'aquell projecte i no es pot utilitzar fora d'aquest.
Desa la clau secreta
En crear el compte de servei, es crea immediatament una clau d'API i se'n mostra la clau secreta. Desa la clau secreta de manera segura. No la podràs tornar a veure a través del teu compte d'OpenAI. Si la perds, genera una clau nova.
Per defecte, la clau del compte de servei té permisos de lectura i escriptura per a tots els recursos de l'API del seu projecte. Pots canviar aquests permisos després a la configuració de Claus d'API del projecte.
Actualitza o elimina un compte de servei
Els comptes de servei apareixen al costat dels usuaris a la configuració de Membres del projecte. Gestiona'n l'accés al projecte seguint els mateixos passos per canviar el rol o eliminar-los que per a la resta de membres del projecte.
Tots els comptes de servei també apareixen al costat dels usuaris a la pàgina Membres de l'organització, inclosos els comptes creats des de la configuració de l'organització i del projecte.
Des del menú Membres de l'organització, pots canviar el rol d'un compte de servei o seleccionar Elimina.
Crea i gestiona claus d'API
Cada projecte té les seves pròpies claus d'API:
Ves a la configuració de l'organització.
Selecciona el projecte i obre Claus d'API.
Selecciona + Crea una clau secreta nova per crear una clau, o selecciona la icona d'edició al costat d'una clau existent per canviar-ne els permisos.
Tria els permisos de la clau
Per a les claus propietat d'usuaris, pots establir els permisos en crear la clau o editar-los més endavant:
Tots: Permisos complets. Aquesta és l'opció predeterminada.
Restringits: Tria els àmbits d'accés per a recursos o punts finals específics. Les opcions disponibles depenen del recurs i poden incloure Cap, Lectura, Escriptura o permisos específics de la petició.
Només lectura: Permisos de lectura per a tots els punts finals.
Per exemple, una clau restringida pot excloure l'accés de lectura i escriptura al punt final /v1/assistants.
Per crear claus de comptes de servei, calen permisos de gestió de comptes de servei. Si no veus aquesta opció, demana a un propietari de l'organització o del projecte que creï la clau del compte de servei. El diàleg de creació de claus no mostra aquests controls de permisos per a les claus de comptes de servei; canvia'n els permisos després a la configuració de Claus d'API del projecte.
Configura l'accés als models i els límits de peticions
Per gestionar els límits de peticions d'un projecte, calen permisos d'administració. Els propietaris de l'organització tenen aquests permisos, i els propietaris del projecte també poden gestionar els límits de peticions del projecte mitjançant l'API de gestió.
Ves a la configuració de l'organització.
Selecciona el projecte i obre Límits.
Utilitza Ús dels models per triar quins models pot utilitzar el projecte.
Estableix un límit de peticions per a cada model segons calgui.
Estableix límits i alertes de despesa
Els límits de despesa mensual de l'API estan disponibles tant per a l'organització com per als projectes. Per canviar un límit, necessites permís per gestionar la configuració de l'organització o del projecte corresponent.
Un límit de despesa permet supervisar la despesa sense aturar les peticions. Activa Aplica un límit estricte si vols que les peticions a l'API fallin quan la despesa registrada arribi al límit. L'aplicació del límit no és instantània, de manera que la despesa registrada pot superar lleugerament l'import configurat.
Les alertes de despesa t'avisen quan s'arriba a un llindar; no aturen les peticions.
Estableix un límit de despesa per a l'organització
Ves a la configuració de l'organització.
Obre Límits i cerca Despesa.
Estableix un límit de despesa per al projecte
Ves a la configuració de l'organització.
Selecciona el projecte i obre Límits.
Estableix els valors de Límit de despesa mensual i Avisa quan la despesa arribi a.
Activa Aplica un límit estricte si vols aturar el trànsit de l'API quan la despesa registrada arribi al límit.
També pots canviar l'Ús dels models en aquesta pàgina.
Gestiona les alertes de despesa
Quan crees un límit de despesa per a un projecte, també es crea per defecte una alerta al 100 % del límit. Selecciona Afegeix una alerta per afegir alertes en altres llindars.
Els propietaris de l'organització i del projecte reben les alertes de despesa del projecte. Pots afegir altres destinataris de correu electrònic a la configuració de les alertes.
Per consultar els passos de configuració actuals i com s'apliquen els límits, consulta la guia de límits de despesa.
Consulta l'ús i la facturació
L'activitat d'ús es pot desglossar per projecte, i pots consultar la facturació i establir límits de despesa per a cada projecte.
L'accés al tauler d'ús d'un projecte depèn del teu rol a l'organització i de la configuració de visibilitat del tauler d'ús. Ser propietari d'un projecte no et dona accés per si sol.
Si no pots veure el tauler d'ús d'un projecte, comprova si la visibilitat està configurada com a Visible per als propietaris de l'organització.
Gestiona l'emmagatzematge de fitxers
Cada projecte té una quota d'emmagatzematge de fitxers de 100 GB. Si la superes, pot aparèixer aquest error:
Has superat la quota d'emmagatzematge de fitxers. Les organitzacions tenen un límit de 100 GB de fitxers. Redueix la mida del fitxer o contacta amb el servei d'assistència.
Elimina els fitxers que no utilitzes per alliberar espai d'emmagatzematge. Pots llistar els fitxers emmagatzemats mitjançant l'API per identificar els que ja no necessites.
Arxiva un projecte
Els propietaris de l'organització i del projecte poden arxivar projectes des de la pàgina Projectes o des de la configuració de cada projecte. Introdueix el nom del projecte quan se't demani per confirmar l'acció.
L'arxivament és permanent: un projecte arxivat no es pot restaurar.
Per veure els projectes arxivats, obre la pestanya Arxivats a la pàgina Projectes.
L'única excepció és que els ajustos fins del «Projecte predeterminat» es poden accedir des d'altres projectes.
Heu superat la quota d'emmagatzematge de fitxers. Les organitzacions estan limitades a 100 GB de fitxers. Reduïu la mida del fitxer o contacteu amb suport.Els projectes no es poden eliminar. OpenAI en conserva l'historial per fer un seguiment de l'ús i la facturació.