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 projectes. Per obtenir més informació, consulteu els rols i permisos.
Per canviar d'organització, passeu el cursor per sobre del nom de l'organització, a la part superior esquerra de la pàgina, i seleccioneu una organització de la llista:
En les organitzacions amb un pla de facturació consolidada, les suborganitzacions s'identifiquen per separat. No es poden crear projectes dins de les suborganitzacions.
Com funcionen els projectes?
Cada organització inclou un "Projecte predeterminat" que no es pot suprimir. Podeu configurar els límits de velocitat, els permisos virtuals dels models i els límits de despesa (des del 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 especificades pel punt final /organization/invites.
Si es produeix un error en convidar usuaris a un projecte mitjançant la interfície o l'API d'administració, abans de tornar a enviar la invitació, comproveu que el projecte de destinació existeixi i no estigui arxivat.
Els propietaris de l'organització s'afegeixen automàticament com a propietaris als projectes nous que s'hi creen.
Quins rols d'usuari hi ha a les organitzacions i als projectes, i quins permisos comporten?
Mentre que les organitzacions tenen els rols de "propietari" i "lector", els projectes tenen els de "propietari" i "membre". Els membres d'un projecte són equivalents als lectors d'una organització. Consulteu la taula següent per veure 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, usuaris i claus d'API. Pot supervisar tots els projectes de l'organització mitjançant la pàgina Projectes . Pot definir els límits de despesa de l'organització i dels projectes. Pot concedir a altres membres de l'organització permís per veure informació d'ús. Pot arxivar projectes. |
| Lector | Organització | Pot executar inferències, utilitzar recursos i crear claus als projectes dels quals forma part. 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 els límits de despesa del projecte. Pot arxivar el projecte. |
| Membre | Projecte | Pot executar inferències, utilitzar recursos i crear claus en el 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 dels projectes, 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 assistents creats o els fitxers que s'hi han afegit.
Els membres d'un projecte poden veure tots els altres 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 els 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 pseudo-usuari dissenyat per a l'accés dels sistemes i és 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 l'organització amb el rol de Lector. Si voleu afegir un usuari que encara no pertany a l'organització, primer l'heu d'afegir a l'organització (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 assignar-li el rol de Propietari o de 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 per llegir o modificar dades, mentre que els propietaris també poden modificar la configuració i els límits de despesa del projecte, així com gestionar-ne els membres. Per obtenir més informació, consulteu els rols i permisos.
Com crear un compte de servei per a un projecte
Primer, seleccioneu a la llista 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.
Assignar un nom al compte de servei
Tant si creeu el compte de servei per a tota l'organització com si en creeu un d'exclusiu per a un projecte, podeu assignar-li un identificador ú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 se'n mostra la clau secreta. Deseu aquesta clau secreta en un lloc segur. Per motius de seguretat, no podreu tornar a veure-la 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. Podeu actualitzar aquests permisos a la configuració de les claus d'API del projecte.
Els comptes de servei apareixen juntament amb els membres del projecte a la pàgina de configuració dels membres. Consulteu aquí com podeu actualitzar o eliminar l'accés d'un compte de servei des de 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ó corresponent. A la configuració de l'organització, seleccioneu el projecte i feu clic a Claus d'API.
Per crear una clau secreta, seleccioneu + Crea una clau secreta. També podeu seleccionar la icona Edita situada 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 o quan n'editeu una d'existent.
Hi ha tres nivells de permisos disponibles: Tots, Restringit i Només lectura.
Tots — La clau secreta té permisos complets. 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 per 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 dels 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 restringida i limitada a l'accés a aquell projecte i als seus recursos.
Com puc definir i gestionar els límits de velocitat dels projectes de la meva organització?
Només el propietari d'una organització pot definir i gestionar els límits de velocitat dels projectes. Per obtenir més informació, consulteu els rols i permisos.
A la configuració de l'organització, feu clic al projecte que vulgueu actualitzar i seleccioneu Límits a la secció Projecte de la llista de navegació. En aquesta pàgina podeu actualitzar l'Ús dels models.
L'ús dels models permet configurar quins models pot utilitzar el projecte, i podeu definir límits de velocitat 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 d'un projecte poden definir i gestionar els límits de despesa del projecte. Per obtenir més informació, consulteu els 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 dels models.
Definir un límit de despesa mensual us permet establir llindars flexibles de despesa per al projecte. Quan l'ús superi aquest límit durant un mes natural determinat (UTC), les sol·licituds a l'API es continuaran processant sense interrupcions. Aquesta funció ajuda 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 del projecte, es genera per defecte 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 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 de l'API tant per a les organitzacions com per als projectes. Un límit de despesa pot servir per supervisar-la sense imposar restriccions, o bé es pot aplicar com a límit estricte perquè les sol·licituds a l'API fallin un cop assolit. Per consultar els passos de configuració i el comportament més recents, vegeu 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 la 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 veure una llista de tots els projectes arxivats a la pestanya "Arxivats" de la mateixa pàgina de la llista de projectes.
No es poden suprimir projectes. Conservem un historial de tots els projectes per garantir la continuïtat del seguiment de l'ús i la facturació.
Hi ha cap 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 d'un projecte (com ara fitxers, assistents, emmagatzematge o fils) estan restringits al projecte i els membres no administradors que no hi pertanyen no hi poden accedir. 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 de 100 GB de fitxers emmagatzemats 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 en puc veure el tauler d'ús?
La visibilitat del tauler d'ús d'un projecte no depèn del rol que tingui 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 definida com a "Visible per als propietaris de l'organització".