Els projectes tenen com a objectiu oferir als clients la possibilitat d’organitzar la feina. Les organitzacions poden gestionar l’accés i els límits, aprovisionar comptes de servei (a través de la interfície d’usuari) i fer el seguiment de l’ús dins d’un àmbit restringit d’un projecte (p. ex., models, capacitats, fils, assistents, ajust fi, emmagatzematge, etc.). L’activitat d’ús es pot desglossar per projecte, i els usuaris poden veure la facturació i definir límits de despesa per projecte.
Els propietaris de l’organització poden veure tots els seus projectes actius i arxivats a la pàgina Projectes. Obteniu més informació sobre els rols d’usuari i permisos a la Plataforma d’API.
Qui pot crear un projecte?
Només els propietaris de l'organització poden crear un projecte. Consulteu rols i permisos per obtenir més informació.
Per canviar d'organització, passeu el cursor per sobre del nom de la vostra organització a la part superior esquerra de la pàgina i seleccioneu l'organització de la llista:
Per a les organitzacions que tenen un pla de facturació consolidada, les suborganitzacions s'identifiquen per separat. No es poden crear projectes dins de suborganitzacions.
Com funcionen els projectes?
Cada organització inclou un «projecte predeterminat» que no es pot suprimir. Podeu configurar els límits de taxa, els permisos de models virtuals i els límits de despesa (des de novembre de 2024). Hereta tota la configuració de l’organització, de manera que no hi podeu afegir directament membres ni comptes de servei.
Com puc crear un projecte?
Primer, passeu el cursor per sobre del nom del projecte, a l'extrem esquerre de la pàgina, i seleccioneu Crea un projecte.
Introduïu un nom, una descripció i un lloc web per al projecte i, a continuació, seleccioneu Crea.
Com puc afegir usuaris a un projecte?
Els membres nous de l'organització no s'afegeixen automàticament al "Projecte predeterminat". Els membres nous es poden convidar al projecte quan se'ls convida a l'organització (marcant la casella "Convida al projecte predeterminat") o després que hagin acceptat la invitació a l'organització.
Els usuaris convidats mitjançant l'API d'administració segueixen les regles descrites pel punt final /organization/invites.
Si es produeix un error en convidar usuaris a un projecte mitjançant la interfície d'usuari o l'API d'administració, abans de tornar a enviar la invitació, comproveu que el projecte de destinació existeix i no està arxivat.
Els propietaris de l'organització s'afegeixen automàticament com a propietaris als projectes nous que s'hi creen.
Quins són els diferents rols d’usuari dins de les organitzacions i els projectes, i quins permisos comporten?
Mentre que les organitzacions tenen rols de «propietari» i «lector», els projectes tenen rols de «propietari» i «membre». Els membres del projecte són anàlegs als lectors de l’organització. Consulteu la taula següent per obtenir una descripció més detallada dels permisos associats a cada rol d’usuari.
| Rol | Àmbit | Descripció |
|---|---|---|
| Propietari | Organització | Pot crear i veure tots els projectes, tots els usuaris i totes les claus d’API. Té la capacitat de supervisar tots els projectes de l’organització amb la pàgina Projectes . Pot definir límits de despesa de l’organització i límits de despesa dels projectes. Pot concedir permisos per veure la informació d’ús d’altres persones de l’organització. Pot arxivar projectes. |
| Lector | Organització | Pot fer inferència, utilitzar recursos i crear claus als seus projectes. Es pot afegir a projectes. No pot crear projectes ni gestionar usuaris. |
| Propietari | Projecte | Pot afegir altres usuaris al projecte i canviar-ne el nom, a més de tenir totes les capacitats d’un membre. Pot definir límits de despesa del projecte. Pot arxivar el projecte. |
| Membre | Projecte | Pot fer inferència, utilitzar recursos i crear claus a escala de projecte. |
Si no soc propietari de l'organització, a què tinc accés?
Els usuaris que no són propietaris de l'organització només poden veure els projectes dels quals són membres. Només el propietari de l'organització pot veure tots els projectes, els membres i les claus d'API de cada projecte, i té accés a la pàgina Projectes.
Només els membres d'un projecte (i els propietaris de l'organització) poden veure els models ajustats que s'hi han creat, els fils dels Assistants creats o els fitxers que s'hi han afegit.
Els membres d'un projecte poden veure la resta de membres del projecte i els seus rols (és a dir, Propietari o Membre).
Com puc actualitzar el rol d'un usuari en un projecte o eliminar-lo del projecte?
Només el propietari d'un projecte pot actualitzar el rol d'un usuari o eliminar-lo del projecte. Per obtenir més informació, consulteu rols i permisos.
Per actualitzar un usuari d'un projecte, aneu a la configuració de l'organització, seleccioneu el projecte i feu clic a Membres. Podeu definir el rol de cada membre com a Membre o Propietari. També podeu seleccionar Elimina per eliminar l'usuari del projecte.
Què és un compte de servei i en què es diferencia d'un compte d'usuari normal?
Un compte de servei actua com un pseudousuari dissenyat per a l'accés del sistema, diferent dels comptes d'usuari individuals. Només els propietaris de l'organització i del projecte poden crear comptes de servei.
Els comptes de servei només tenen abast dins dels projectes.
Afegir un membre a un projecte
Si feu clic al botó + Afegeix un membre, veureu una llista dels usuaris de la vostra organització que tenen el rol de Lector. Si voleu afegir un usuari que encara no forma part de l'organització, primer l'hi haureu d'afegir (podeu deixar desmarcada la casella "Afegeix al projecte predeterminat" si no voleu donar-li un accés més ampli). Aquesta llista no inclou els comptes de servei. En aquest pas podeu triar si el seu rol serà Propietari o Membre:
Quan afegiu un membre de l'equip, li heu d'assignar el rol de Membre o de Propietari. Els membres del projecte poden fer sol·licituds a l'API que llegeixin o modifiquin dades, mentre que els propietaris també poden modificar la configuració i els límits de despesa del projecte, i gestionar-ne els membres. Per obtenir més informació, consulteu rols i permisos.
Com crear un compte de servei per a un projecte
Primer, trieu al menú desplegable de la barra de navegació el projecte per al qual voleu crear un compte de servei:
A continuació, aneu a la configuració de l'organització -> Projecte -> Membres -> i feu clic a + Compte de servei:
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.
Assignació de nom al compte de servei
Tant si creeu el compte de servei a escala d'organització com si en creeu un d'únic per a un projecte, quan creeu un compte de servei podeu crear un ID de compte de servei únic format per lletres, números i guionets per identificar-lo fàcilment.
Desar la clau d'API del compte de servei
Després de seleccionar el botó Crea, es crea immediatament una clau d'API per al compte de servei i es mostra la clau secreta. Deseu aquesta clau secreta en un lloc segur. Per motius de seguretat, no la podreu tornar a veure des del vostre compte d'OpenAI. Si perdeu aquesta clau secreta, n'haureu de generar una de nova.
Per defecte, la clau d'API del compte de servei té permisos de lectura i escriptura per a tots els recursos de l'API del projecte. Aquests permisos es poden actualitzar a la configuració de Claus d'API del projecte.
Els comptes de servei apareixen al costat dels membres del projecte a la pàgina de configuració dels membres. Consulteu aquí per obtenir més informació sobre com actualitzar o eliminar l'accés d'un compte de servei a la pàgina de configuració dels membres del projecte.
Tots els comptes de servei de projectes i organitzacions es mostraran juntament amb els vostres usuaris humans a la pàgina de membres al nivell de l'organització.
Els comptes de servei es gestionen com comptes normals. Des del menú Organització -> Membres, podeu Eliminar un compte de servei o actualitzar-ne el rol:
Com puc gestionar les claus d'API dels projectes de la meva organització?
Podeu crear i gestionar les claus d'API de cada projecte des de la pàgina de configuració del projecte. A la configuració de l'organització, seleccioneu el projecte i feu clic a Claus d'API.
Per crear una clau secreta nova, seleccioneu + Crea una clau secreta. També podeu seleccionar la icona Edita al costat d'una clau secreta per modificar-ne els permisos.
Podeu definir els permisos de cada clau d'API quan creeu una clau secreta nova o editant una clau existent.
Hi ha tres nivells de permisos disponibles: Tots, Restringit i Només lectura.
Tots — La clau secreta té tots els permisos. Aquesta és la configuració predeterminada.
Restringit — Permet definir els permisos Cap, Lectura i Escriptura per a cada punt final.
Per exemple, podeu crear una clau d'API que no tingui específicament permís de lectura ni d'escriptura al punt final /v1/assistants:
Només lectura — S'estableixen permisos de lectura per a tots els punts finals.
Com es gestiona l'accés per als usuaris que pertanyen a diversos projectes o organitzacions?
Els usuaris poden ser membres de tants projectes com calgui. Dins d'un projecte, els usuaris poden generar una clau d'API personal amb abast i limitada a l'accés a aquell projecte i als seus recursos.
Com configuro i gestiono els límits de peticions dels projectes de la meva organització?
Només el propietari d'una organització pot establir i gestionar límits de peticions a nivell de projecte. Consulteu rols i permisos per obtenir més informació.
A la vostra configuració de l'organització, feu clic al projecte que voleu actualitzar i seleccioneu Límits a la secció Projecte de la llista de navegació. Podeu actualitzar l'ús de models en aquesta pàgina.
L'ús de models us permet configurar quins models pot utilitzar el projecte, i es poden definir límits de peticions per a cada model segons calgui.
Com puc definir i gestionar els límits de despesa dels projectes de la meva organització?
Només els propietaris de l'organització i els propietaris del projecte poden definir i gestionar els límits de despesa del projecte. Per obtenir més informació, consulteu rols i permisos. Per canviar els límits de l'organització, aneu a la configuració de l'organització, feu clic a Límits i desplaceu-vos fins a Límits d'ús.
Per definir els límits del projecte, aneu a la configuració de l'organització, feu clic al projecte que vulgueu actualitzar i seleccioneu Límits. Podeu actualitzar el Límit de despesa mensual, el Llindar de notificació i l'Ús de models.
Definir un límit de despesa mensual us permet establir llindars de despesa flexibles per al projecte. Si l'ús supera aquest límit durant un mes natural determinat (UTC), les sol·licituds a l'API es continuaran processant sense interrupcions. Aquesta funció està dissenyada per ajudar-vos a supervisar l'ús mitjançant alertes de límit de despesa, però no imposa un límit màxim estricte a la despesa. Quan es crea un límit de despesa per a un projecte, es crea per defecte una alerta amb el llindar del 100 %. Podeu definir alertes addicionals amb llindars diferents fent clic a Afegeix una alerta.
Tingueu en compte que els propietaris de l'organització i del projecte sempre rebran aquests missatges i que això no es pot personalitzar.
Com puc definir límits de despesa per a la meva organització o projecte?
OpenAI ara admet límits mensuals de despesa d’API tant a escala d’organització com de projecte. Un límit de despesa pot supervisar la despesa sense aplicar-se, o bé podeu aplicar-lo com a límit estricte perquè les sol·licituds d’API fallin un cop la despesa arribi al límit. Per conèixer els passos de configuració i el comportament més recents, consulteu Límits de despesa a la documentació per a desenvolupadors.
Com puc suprimir o arxivar un projecte?
Els projectes es poden arxivar des de la nova pàgina de llista de projectes o des de la configuració de cada projecte. Un cop arxivat, un projecte no es pot restaurar. Quan arxiveu un projecte, se us demanarà que n'introduïu el nom per continuar.
Podeu consultar una llista de tots els projectes arxivats a la pestanya "Arxivats" de la mateixa pàgina de llista de projectes.
No es poden suprimir projectes. Conservem l'historial de tots els projectes per garantir la continuïtat del seguiment de l'ús i la facturació.
Hi ha un límit en el nombre de projectes que puc tenir a la meva organització?
Per defecte, les organitzacions poden crear fins a 2.000 projectes.
Es poden compartir recursos entre projectes?
Els recursos del projecte, com ara fitxers, assistants, emmagatzematge o fils, tenen l'abast limitat al projecte i no poden ser accessibles per membres no administradors de fora del projecte. A més, els recursos no es poden moure entre projectes.
L'única excepció és que els ajustos fins del «Projecte predeterminat» es poden accedir des d'altres projectes.
Quina és la quota d'emmagatzematge de fitxers per projecte?
Actualment, OpenAI admet una quota d'emmagatzematge de 100 GB de fitxers per projecte.
Si se supera aquesta quota, veureu l'error següent:
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.Us recomanem que suprimiu els fitxers no utilitzats emmagatzemats al vostre compte. Com a referència, podeu veure i llistar fitxers amb l'API.
Soc propietari d'un projecte. Per què no puc veure'n el Tauler d'ús?
La visibilitat del Tauler d'ús d'un projecte no està relacionada amb el rol d'un usuari dins del projecte. La determinen el vostre rol dins de l'organització i la configuració de https://platform.openai.com/settings/organization/data-controls/visibility.
Si no podeu veure un Tauler d'ús, és probable que aquesta opció estigui configurada com a "Visible per als propietaris de l'organització".