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 en un ámbito restringido dentro de un proyecto (por ejemplo, modelos, capacidades, hilos, asistentes, ajuste fino, almacenamiento, etc.). La actividad de uso puede desglosarse por proyecto, y los usuarios pueden ver la facturación y configurar límites de gasto 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 los roles de usuario y permisos en la Plataforma API 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, pasa el cursor sobre el nombre de tu organización en la parte superior izquierda de la página y selecciona la organización en la lista:
En el caso de las organizaciones que tienen un plan de facturación consolidada, las suborganizaciones se identifican por separado. No se pueden crear proyectos dentro de suborganizaciones.
¿Cómo funcionan los proyectos?
Todas las organizaciones incluyen un «Proyecto predeterminado» que no se puede eliminar. Puedes configurar los límites de frecuencia, los permisos de modelos virtuales y los límites de gasto (desde 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 Crear proyecto.
Indica un nombre, una descripción y un sitio web para el proyecto y, después, selecciona Crear.
¿Cómo añado usuarios a un proyecto?
Los miembros recién añadidos a la organización no se incorporan automáticamente al «Proyecto predeterminado». Los nuevos miembros pueden ser invitados al proyecto al invitarlos a la organización, marcando la casilla «Invitar al proyecto predeterminado», o después de que acepten la invitación a la organización.
Los usuarios invitados mediante la API de administración siguen las reglas descritas en el punto de acceso /organization/invites.
Si se produce un error al invitar a usuarios a un proyecto mediante la interfaz de usuario o la API de administración, antes de reenviar la invitación confirma que el proyecto de destino existe y no está archivado.
Los propietarios de la organización se añaden automáticamente como propietarios de los nuevos proyectos que se crean en ella.
¿Cuáles son los distintos roles de usuario en organizaciones y proyectos, y qué permisos conllevan?
Mientras que las organizaciones tienen los roles de «propietario» y «lector», los proyectos tienen roles de «propietario» y «miembro». Los miembros de proyecto son equivalentes a los lectores de organización. Consulta la tabla siguiente para ver una descripción más detallada de los permisos asociados a cada rol de usuario.
| Rol | Ámbito | Descripción |
|---|---|---|
| Propietario | Organización | Puede crear y ver todos los proyectos, todos los usuarios y todas las claves de API. Puede supervisar todos los proyectos de la organización desde la página Proyectos . Puede configurar límites de gasto de la organización y límites de gasto de proyectos. Puede conceder permisos para ver la información de uso de otros usuarios de la organización. Puede archivar proyectos. |
| Lector | 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. |
| Propietario | Proyecto | Puede añadir otros usuarios al proyecto y cambiar el nombre del proyecto, además de contar con todas las capacidades de un miembro. Puede configurar límites de gasto del proyecto. Puede archivar el proyecto. |
| Miembro | Proyecto | Puede realizar inferencias, usar recursos y crear claves a nivel de proyecto. |
Si no soy propietario de la organización, ¿a qué tengo acceso?
Los usuarios que no son propietarios de la organización solo pueden ver los proyectos a los que pertenecen. Solo el propietario de la organización puede ver todos los proyectos, sus miembros y sus claves de API, y acceder a la página Proyectos.
Solo los miembros de un proyecto y los propietarios de la organización pueden ver los modelos ajustados creados en ese proyecto, los hilos de los asistentes creados o los archivos añadidos.
Los miembros de un proyecto pueden ver quiénes son los demás miembros y sus roles, es decir, Propietario o Miembro.
¿Cómo actualizo el rol de un usuario en un proyecto o lo elimino del proyecto?
Solo el propietario de un proyecto puede actualizar el rol de un usuario en él o eliminarlo del proyecto. Consulta roles y permisos para obtener más información.
Para actualizar un usuario de un proyecto, ve a la configuración de la organización, selecciona el proyecto y haz clic en Miembros. Puedes asignar a cada miembro el rol de Miembro o de Propietario. También puedes seleccionar Eliminar para retirar 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
Al hacer clic en el botón + Añadir miembro, verás una lista de los usuarios de tu organización que tienen el rol de Lector. Si quieres añadir a un usuario que aún no pertenece a tu organización, primero tendrás que incorporarlo a ella. Puedes dejar desmarcada la casilla «Añadir al proyecto predeterminado» si no quieres concederle un acceso más amplio. Esta lista no incluirá las cuentas de servicio. En este paso puedes asignarle el rol de Propietario o Miembro:
Al añadir a un integrante del equipo, debes asignarle el rol de Miembro o de Propietario. Los miembros del proyecto pueden realizar solicitudes a la API para leer o modificar datos. Los propietarios también pueden modificar la configuración y los límites de gasto del proyecto, así como gestionar sus miembros. Consulta roles y permisos para obtener más información.
Crear una cuenta de servicio para un proyecto
Primero, selecciona en el menú desplegable de la barra de navegación el proyecto para el que quieras crear una cuenta de servicio:
Después, ve a la configuración de la organización -> Proyecto -> Miembros -> y haz clic en + Cuenta de servicio:
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.
Guardar la clave de API de la cuenta de servicio
Tras seleccionar el botón Crear, se crea inmediatamente una clave de API para la cuenta de servicio y se muestra la clave secreta. Guarda esta clave secreta en un lugar seguro. Por motivos de seguridad, no podrás volver a verla desde tu cuenta de OpenAI. Si pierdes esta clave secreta, tendrás que generar otra.
De forma predeterminada, la clave de API de la cuenta de servicio tiene permisos de lectura y escritura para todos los recursos de API del proyecto. Estos permisos se pueden actualizar en la configuración de Claves de API del proyecto.
Las cuentas de servicio aparecen junto a los miembros del proyecto en la página de configuración de miembros. Consulta esta sección para obtener más información sobre cómo actualizar o retirar el acceso de una cuenta de servicio desde la página de configuración de miembros del proyecto.
Todas las cuentas de servicio de proyectos y 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 cuentas normales. Desde Organización -> menú Miembros, puedes Eliminar una cuenta de servicio o actualizar el rol:
¿Cómo gestiono las claves de API en los proyectos de mi organización?
Puedes crear y gestionar las claves de API de cada proyecto desde la página de configuración de ese proyecto. En la configuración de la organización, selecciona el proyecto y haz clic en Claves de API.
Para crear una clave secreta, selecciona + Crear nueva clave secreta. También puedes seleccionar el icono Editar situado junto a una clave secreta para modificar sus permisos.
Puedes establecer los permisos de cada clave de API al crear una nueva clave secreta o al editar una existente.
Hay tres niveles de permisos disponibles: Todos, Restringido y Solo lectura.
Todos — Se conceden todos los permisos a la clave secreta. Esta es la configuración predeterminada.
Restringido — Permite al usuario establecer los permisos Ninguno, Lectura y Escritura para cada punto de acceso.
Por ejemplo, puedes crear una clave de API que no tenga específicamente permisos de lectura ni escritura para el punto de acceso /v1/assistants:
Solo lectura — Se conceden permisos de lectura para todos los puntos de acceso.
¿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 los límites de solicitudes para los proyectos de mi organización?
Solo el propietario de una organización puede configurar y gestionar límites de solicitudes a nivel de proyecto. Consulta roles y permisos para obtener más información.
En la configuración de la organización, haz clic en el proyecto que quieras actualizar y selecciona Límites en la sección Proyecto de la lista de navegación. Puedes actualizar tu Uso de modelos en esta página.
Uso de modelos te permite configurar qué modelos puede usar el proyecto, y se pueden establecer límites de solicitudes para cada modelo según sea necesario.
¿Cómo configuro y gestiono los límites de gasto de los proyectos de mi organización?
Solo los propietarios de una organización y los de un proyecto pueden configurar y gestionar los límites de gasto del proyecto. Consulta roles y permisos para obtener más información. Para cambiar los límites de la organización, ve a la configuración de la organización, haz clic en Límites y desplázate hasta Límites de uso.
Para establecer los límites de un proyecto, ve a la configuración de la organización, haz clic en el proyecto que quieras actualizar y selecciona Límites. Puedes actualizar el Límite de gasto mensual, el Umbral de notificación y el Uso de modelos.
Establecer un límite de gasto mensual te permite definir umbrales de gasto flexibles para el proyecto. Si el uso supera este límite durante un mes natural determinado (UTC), las solicitudes a la API se seguirán procesando sin interrupciones. Esta función ayuda a supervisar el uso mediante alertas sobre el límite de gasto, pero no impone un límite de gasto estricto. Al crear un límite de gasto para un proyecto, se genera de forma predeterminada una alerta para el umbral del 100 %. Puedes configurar alertas adicionales para otros umbrales haciendo clic en Añadir alerta.
Ten en cuenta que los propietarios de la organización y del proyecto siempre recibirán estos mensajes, y esto no se puede personalizar.
¿Cómo configuro límites de gasto para mi organización o proyecto?
OpenAI ahora admite límites mensuales de gasto de API tanto a nivel de organización como de proyecto. Un límite de gasto puede supervisar el gasto sin aplicarlo, o puedes aplicarlo como límite estricto para que las solicitudes de API fallen cuando el gasto alcance el límite. Para ver los pasos de configuración y el comportamiento más recientes, consulta Límites de gasto en la documentación para desarrolladores.
¿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 cada proyecto. Una vez archivado un proyecto, no se puede restaurar. Al archivar un proyecto, se te pedirá que introduzcas su nombre para continuar.
Puedes consultar una lista de todos los proyectos archivados en la pestaña «Archivados» de la misma página de lista de proyectos.
No es posible eliminar proyectos. Conservamos 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?
Actualmente, OpenAI admite una cuota de almacenamiento de archivos de 100 GB por proyecto.
Si se supera esta cuota, aparecerá 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 eliminar los archivos sin usar almacenados en tu cuenta. Como referencia, puedes ver y listar archivos con la API.
Soy propietario de un proyecto. ¿Por qué no puedo ver su panel de uso?
La visibilidad del panel de uso de un proyecto no depende del rol que tenga el usuario en ese proyecto. Depende de tu rol en la organización y de la configuración disponible en https://platform.openai.com/settings/organization/data-controls/visibility
Si no puedes ver un panel de uso, es probable que esta opción esté configurada como «Visible para los propietarios de la organización».