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 creo un projecte?
Primer, passeu el cursor per sobre del nom del projecte a la cantonada esquerra de la pàgina i seleccioneu Create project.
Proporcioneu un nom, una descripció i un lloc web per al projecte i, després, seleccioneu Create.
Com afegeixo usuaris a un projecte?
Els membres nous afegits a l'organització no s'afegeixen automàticament al «projecte predeterminat». Es pot convidar els membres nous al projecte quan se'ls convida a l'organització (activant la casella «Convida al projecte predeterminat») o després que el membre hagi acceptat la invitació a l'organització.
Els usuaris convidats mitjançant l'API d'administració segueixen les regles descrites a el punt final /organization/invites.
Si trobeu un error en convidar usuaris a un projecte a través de la IU o l'API d'administració, confirmeu primer que el projecte de destinació existeix i no està arxivat abans de tornar a enviar la invitació.
Els propietaris de l'organització s'afegeixen automàticament com a propietaris als nous projectes creats dins d'una organització.
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, membres i claus d'API al nivell del 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'han creat dins d'aquest projecte, els fils de qualsevol Assistants creat o qualsevol fitxer que s'hi hagi afegit.
Els membres d'un projecte poden veure qui són tots els altres membres d'aquest projecte i els seus rols (és a dir, propietari o membre).
Com actualitzo el rol d'un usuari en un projecte o elimino un usuari d'un projecte?
Només el propietari d'un projecte pot actualitzar el rol d'un usuari en el projecte o eliminar un usuari d'un projecte. Consulteu rols i permisos per obtenir més informació.
Per actualitzar un usuari en un projecte, aneu a la vostra configuració de l'organització, seleccioneu el projecte i feu clic a Membres. Teniu l'opció d'establir el rol de cada membre com a Membre o Propietari. També podeu seleccionar Eliminar 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.
Afegeix un membre a un projecte
Si feu clic al botó + Add member, veureu una llista dels usuaris de la vostra organització amb el rol Reader. Si voleu afegir un usuari que actualment no forma part de la vostra organització, primer l’haureu d’afegir a l’organització (podeu deixar desmarcada la casella «Afegeix al projecte predeterminat» si no voleu donar a aquests usuaris un accés més ampli). Aquesta llista no inclourà comptes de servei. En aquest pas podeu triar si el seu rol és Owner o Member:
Quan afegiu un membre de l’equip, li heu d’assignar el rol de Member o de Owner. Els membres del projecte poden fer sol·licituds d’API que llegeixin o modifiquin dades, mentre que els propietaris del projecte també poden modificar la configuració del projecte i els límits de despesa del projecte, i gestionar-ne els membres. Consulteu rols i permisos per obtenir més informació.
Com crear un compte de servei per a un projecte
Primer aneu al projecte per al qual voleu crear un compte de servei triant-lo al menú desplegable de la barra de navegació:
Després, aneu a la vostra configuració de l'organització -> Projecte -> Membres -> feu clic a + Service account:
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.
Deseu 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 mostrarà la clau secreta. Deseu aquesta clau secreta en un lloc segur i protegit. Per motius de seguretat, no podreu tornar-la a veure a través del vostre compte d'OpenAI. Si perdeu aquesta clau secreta, haureu de generar-ne una de nova.
Els permisos de la clau d'API del compte de servei estan configurats per defecte per llegir i escriure tots els recursos d'API del projecte. Aquests permisos es poden actualitzar a la configuració de claus d'API del vostre projecte.
Els comptes de servei es llisten juntament amb els membres del projecte a la pàgina de configuració de membres del vostre projecte. 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ó de membres del vostre 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 gestiono les claus d'API dins dels projectes de la meva organització?
Podeu crear i gestionar claus d'API per a cada projecte a la pàgina de configuració d'aquest projecte. A la vostra configuració de l'organització, seleccioneu el projecte i feu clic a Claus d'API.
Per crear una clau secreta nova, seleccioneu + Create new secret key. També podeu seleccionar la icona d'edició al costat d'una clau secreta per editar-ne els permisos.
Podeu definir permisos per a cadascuna de les vostres claus 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 — S'estableixen permisos complets per a la clau secreta. Aquesta és la configuració predeterminada.
Restringit — Permet a l'usuari establir permisos de Cap, Lectura i Escriptura per a cada punt final.
Per exemple, creeu una clau d'API que específicament no tingui 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 d’una organització i els propietaris d’un projecte poden definir i gestionar els límits de despesa del projecte. Consulteu rols i permisos per obtenir més informació. Per canviar els límits a escala d’organització, a la vostra configuració de l’organització, feu clic a Límits, i desplaceu-vos cap avall fins a Límits d’ús.
Per definir els límits del projecte, a la vostra configuració de l’organització, feu clic al projecte que voleu 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 vostre projecte. Quan l’ús superi aquest límit dins d’un mes natural determinat (UTC), les sol·licituds d’API es continuaran processant sense interrupcions. Aquesta funció està pensada per ajudar-vos a supervisar l’ús mitjançant alertes de límit de despesa, però no aplica cap límit estricte a la despesa. Quan es crea un límit de despesa de projecte, per defecte es crea una alerta al 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 els propietaris del projecte sempre rebran aquests missatges, i 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 elimino o arxivo un projecte?
Els projectes es poden arxivar a través de la nova pàgina de llista de projectes o des de la configuració d'un projecte individual. Un cop arxivat un projecte, no es pot restaurar. Quan continueu amb l'arxivament, se us demanarà que introduïu el nom del projecte per poder continuar.
Podeu veure una llista de tots els projectes arxivats a través de la pestanya «Arxivats» a la mateixa pàgina de llista de projectes.
No és possible eliminar projectes; mantenim un 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.
Sóc propietari d'un projecte; per què no puc veure el tauler d'ús del meu projecte?
La visibilitat del tauler d'ús d'un projecte no està relacionada amb el rol d'un usuari dins d'un projecte. En canvi, la determina el vostre rol dins de l'organització i la configuració a https://platform.openai.com/settings/organization/data-controls/visibility
Si no podeu veure un tauler d'ús, és probable que aquesta opció estigui definida com a «Visible per als propietaris de l'organització».