Los proyectos tienen como objetivo ofrecer a los clientes la capacidad de organizar su trabajo. Las organizaciones pueden gestionar el acceso y los límites, aprovisionar cuentas de servicio (a través de la interfaz de usuario) y hacer un seguimiento del uso dentro de un ámbito restringido en un proyecto (por ejemplo, modelos, capacidades, hilos, assistants, ajuste fino, almacenamiento, etc.). La actividad de uso puede desglosarse por proyecto, y los usuarios pueden ver la facturación y establecer presupuestos por proyecto.
Los propietarios de la organización pueden ver todos sus proyectos activos y archivados en la página Proyectos. Más información sobre roles y permisos de usuario en la plataforma API.
¿Quién puede crear un proyecto?
Solo los propietarios de la organización pueden crear un proyecto. Consulta roles y permisos para obtener más información.
Para cambiar de organización, coloca el cursor sobre el nombre de tu organización en la parte superior izquierda de la página y selecciona la organización de la lista:
En las organizaciones que están en un plan de facturación consolidada, las suborganizaciones se identifican por separado. No se pueden crear proyectos dentro de las suborganizaciones.
¿Cómo funcionan los proyectos?
Toda organización incluye un «proyecto predeterminado» que no se puede eliminar. Puedes configurar los límites de tasa, los permisos del modelo virtual y los presupuestos de gasto (a partir de noviembre de 2024). Hereda toda la configuración de la organización, por lo que no puedes añadirle directamente miembros ni cuentas de servicio.
¿Cómo creo un proyecto?
Primero, coloca el cursor sobre el nombre del proyecto en la esquina izquierda de la página y selecciona Create project.
Indica un nombre, una descripción y un sitio web para tu proyecto, y luego selecciona Create.
¿Cómo añado usuarios a un proyecto?
Los miembros de la organización añadidos recientemente no se añaden automáticamente al «proyecto predeterminado». Se puede invitar a los nuevos miembros al proyecto cuando se les invite a la organización (activando la casilla «Invitar al proyecto predeterminado») o después de que el miembro haya aceptado la invitación a la organización.
Los usuarios invitados mediante la API de administración siguen las reglas descritas por el endpoint /organization/invites.
Si se produce un error al invitar usuarios a un proyecto a través de la interfaz de usuario o de la API de administración, primero confirma que el proyecto de destino existe y no está archivado antes de volver a enviar la invitación.
Los propietarios de la organización se añaden automáticamente como propietarios a los nuevos proyectos creados dentro de una organización.
¿Cuáles son los distintos roles de usuario dentro de las organizaciones y los proyectos, y qué permisos implican?
Mientras que las organizaciones tienen los roles «owner» y «reader», los proyectos tienen los roles «owner» y «member». Los miembros del proyecto son análogos a los lectores de la organización. Consulta la tabla siguiente para ver una descripción más detallada de los permisos que acompañan a cada rol de usuario.
| Rol | Ámbito | Descripción |
|---|---|---|
| Owner | Organización | Puede crear/ver todos los proyectos, todos los usuarios y todas las claves API. Tiene la capacidad de supervisar todos los proyectos de la organización con la página Proyectos . Puede establecer presupuestos de la organización y presupuestos de proyectos. Puede conceder permisos para que otras personas de la organización vean la información de uso. Puede archivar proyectos. |
| Reader | Organización | Puede realizar inferencias, usar recursos y crear claves en sus proyectos. Puede añadirse a proyectos. No puede crear proyectos ni gestionar usuarios. |
| Owner | Proyecto | Puede añadir otros usuarios al proyecto y cambiar el nombre del proyecto, además de todas las capacidades de un Member. Puede establecer presupuestos del proyecto. Puede archivar el proyecto. |
| Member | Proyecto | Puede realizar inferencias, usar recursos y crear claves a nivel de proyecto. |
Si no soy Owner en la organización, ¿a qué tengo acceso?
Los usuarios que no son Owner en la organización solo pueden ver los proyectos de los que son miembros. Solo el propietario de la organización puede ver todos los proyectos, miembros y claves API a nivel de proyecto, y tener acceso a la página Proyectos.
Solo los miembros de un proyecto (y los propietarios de la organización) pueden ver los modelos ajustados con fine-tuning que se han creado dentro de ese proyecto, los hilos de cualquier Assistants creado o cualquier archivo que se haya añadido.
Los miembros de un proyecto pueden ver quiénes son todos los demás miembros de ese proyecto y sus roles (es decir, Owner o Member).
¿Cómo actualizo el rol de un usuario en un proyecto o elimino a un usuario de un proyecto?
Solo el propietario de un proyecto puede actualizar el rol de un usuario en el proyecto o eliminar a un usuario de un proyecto. Consulta roles y permisos para obtener más información.
Para actualizar un usuario en un proyecto, ve a la configuración de tu organización, selecciona el proyecto y haz clic en Miembros. Tienes la opción de establecer el rol de cada miembro como Member o Owner. También puedes seleccionar Eliminar para quitar al usuario del proyecto.
¿Qué es una cuenta de servicio y en qué se diferencia de una cuenta de usuario normal?
Una cuenta de servicio actúa como un pseudousuario diseñado para el acceso al sistema, distinto de las cuentas de usuario individuales. Solo los propietarios de la organización y del proyecto pueden crear cuentas de servicio.
Las cuentas de servicio solo están limitadas a proyectos.
Añadir un miembro a un proyecto
Si haces clic en el botón + Add member, verás una lista de usuarios de tu organización con el rol Reader. Si quieres añadir a un usuario que actualmente no pertenece a tu organización, primero tendrás que añadirlo a la organización (puedes dejar desmarcada la casilla «Añadir al proyecto predeterminado» si no quieres dar a estos usuarios un acceso más amplio). Esta lista no incluirá cuentas de servicio. Durante este paso puedes elegir si su rol será Owner o Member:
Cuando añades a un miembro del equipo, debes asignarle el rol de Member o Owner. Los miembros del proyecto pueden hacer solicitudes a la API que leen o modifican datos, mientras que los propietarios del proyecto también pueden modificar la configuración y los presupuestos del proyecto, y gestionar a los miembros del proyecto. Consulta roles y permisos para obtener más información.
Cómo crear una cuenta de servicio para un proyecto
Primero navega hasta el proyecto para el que quieres crear una cuenta de servicio eligiéndolo en el menú desplegable de la barra de navegación:
Después, ve a la configuración de tu organización -> Proyecto -> Miembros -> haz clic en + Service account:
Las cuentas de servicio creadas a nivel de proyecto son exclusivas del proyecto y no pueden utilizarse fuera del proyecto en el que se crean.
Asignar nombre a la cuenta de servicio
Independientemente de si creas la cuenta de servicio a nivel de organización o una exclusiva para un proyecto, al crear una cuenta de servicio puedes crear un ID de cuenta de servicio único compuesto por letras, números y guiones para identificarla fácilmente.
Guarda la clave API de la cuenta de servicio
Después de seleccionar el botón Create, se crea inmediatamente una clave API para la cuenta de servicio y se mostrará la clave secreta. Guarda esta clave secreta en un lugar seguro y protegido. Por motivos de seguridad, no podrás volver a verla a través de tu cuenta de OpenAI. Si pierdes esta clave secreta, tendrás que generar una nueva.
Los permisos de la clave API de la cuenta de servicio se configuran por defecto para leer y escribir en todos los recursos API del proyecto. Estos permisos pueden actualizarse en la configuración de API Keys de tu proyecto.
Las cuentas de servicio aparecen junto a los miembros del proyecto en la página de configuración de miembros de tu proyecto. Consulta aquí para obtener más información sobre cómo actualizar o eliminar el acceso de una cuenta de servicio en la página de configuración de miembros de tu proyecto.
Todas las cuentas de servicio, tanto de proyectos como de organizaciones, se mostrarán junto a tus usuarios humanos en la página de miembros a nivel de organización.
Las cuentas de servicio se gestionan como las cuentas normales. Desde el menú Organización -> Miembros puedes Eliminar una cuenta de servicio o actualizar el rol:
¿Cómo gestiono las claves API dentro de los proyectos de mi organización?
Puedes crear y gestionar claves API para cada proyecto en la página de configuración de ese proyecto. En la configuración de tu organización, selecciona el proyecto y haz clic en API Keys.
Para crear una nueva clave secreta, selecciona + Create new secret key. También puedes seleccionar el icono Edit situado junto a una clave secreta para editar sus permisos.
Puedes establecer permisos para cada una de tus claves API cuando creas una nueva clave secreta o editando una clave existente.
Hay tres niveles de permisos disponibles: All, Restricted y Read Only.
All — Se establecen permisos completos para la clave secreta. Esta es la configuración predeterminada.
Restricted — Permite al usuario establecer permisos None, Read y Write para cada punto de acceso.
Por ejemplo, creas una clave API que específicamente no tiene permiso para Read o Write en el endpoint /v1/assistants:
Read Only — Se establecen permisos de lectura para todos los endpoints.
¿Cómo se gestiona el acceso de los usuarios que pertenecen a varios proyectos u organizaciones?
Los usuarios pueden ser miembros de tantos proyectos como sea necesario. Dentro de un proyecto, los usuarios pueden generar una clave API personal que está limitada y restringida al acceso a ese proyecto y sus recursos.
¿Cómo configuro y gestiono límites de tasa para los proyectos de mi organización?
Solo el propietario de una organización puede configurar y gestionar límites de tasa a nivel de proyecto. Consulta roles y permisos para obtener más información.
En la configuración de tu organización, haz clic en el proyecto que quieres actualizar y selecciona Límites en la sección Proyecto de la lista de navegación. Puedes actualizar el uso del modelo en esta página.
El uso del modelo te permite configurar qué modelos puede usar el proyecto, y los límites de tasa se pueden establecer para cada modelo según sea necesario.
¿Cómo configuro y gestiono los presupuestos de los proyectos de mi organización?
Solo los propietarios de una organización y los propietarios de un proyecto pueden configurar y gestionar los presupuestos del proyecto. Consulta roles y permisos para obtener más información. Para cambiar los límites a nivel de organización, en la configuración de tu organización, haz clic en Límites, y desplázate hacia abajo hasta Límites de uso.
Para establecer los límites de tu proyecto, en la configuración de tu organización, haz clic en el proyecto que quieres actualizar y selecciona Límites. Puedes actualizar tu presupuesto mensual, el umbral de notificación y el uso del modelo.
Configurar un presupuesto mensual te permite establecer umbrales de gasto flexibles para tu proyecto. Cuando el uso supera este límite dentro de un mes natural determinado (UTC), las solicitudes a la API seguirán procesándose sin interrupción. Esta función está diseñada para ayudarte a supervisar el uso mediante alertas de presupuesto, pero no aplica un límite estricto al gasto. Cuando se crea un presupuesto de proyecto, se crea por defecto una alerta en el umbral del 100 %. Se pueden establecer presupuestos adicionales en distintos umbrales haciendo clic en Añadir alerta.
Ten en cuenta que los propietarios de la organización y los propietarios del proyecto siempre recibirán estos mensajes, y esto no se puede personalizar.
¿Cómo elimino o archivo un proyecto?
Los proyectos se pueden archivar desde la nueva página de lista de proyectos o desde la configuración de un proyecto individual. Una vez que un proyecto se archiva, no se puede restaurar. Al archivar un proyecto, se te pedirá que introduzcas el nombre del proyecto para continuar.
Puedes ver una lista de todos los proyectos archivados en la pestaña «Archived» de la misma página de lista de proyectos.
No es posible eliminar proyectos; mantenemos un historial de todos los proyectos para garantizar la continuidad del seguimiento del uso y la facturación.
¿Hay un límite en el número de proyectos que puedo tener en mi organización?
Las organizaciones pueden crear hasta 2000 proyectos de forma predeterminada.
¿Se pueden compartir recursos entre proyectos?
Los recursos del proyecto (como archivos, assistants, almacenamiento o hilos) están limitados al proyecto y los miembros no administradores de fuera del proyecto no pueden acceder a ellos. Además, los recursos no se pueden mover entre proyectos.
La única excepción es que los ajustes finos del «proyecto predeterminado» pueden consultarse desde otros proyectos.
¿Cuál es la cuota de almacenamiento de archivos por proyecto?
OpenAI admite actualmente una cuota de almacenamiento de 100 GB de archivos por proyecto.
Si se supera esta cuota, verás el siguiente error:
Has superado tu cuota de almacenamiento de archivos. Las organizaciones están limitadas a 100 GB de archivos. Reduce el tamaño de los archivos o ponte en contacto con soporte.Te recomendamos que elimines los archivos no utilizados almacenados en tu cuenta. Como referencia, puedes ver y listar archivos con la API.
Soy propietario de un proyecto, ¿por qué no puedo ver el panel de uso de mi proyecto?
La visibilidad del panel de uso de un proyecto no está relacionada con el rol de un usuario dentro de un proyecto. En cambio, la determinan tu rol dentro de la organización y la configuración en https://platform.openai.com/settings/organization/data-controls/visibility
Si no puedes ver un panel de uso, es probable que esta configuración esté definida como «Visible para los propietarios de la organización».