Los proyectos tienen como objetivo brindar a los clientes la posibilidad de organizar su trabajo. Las organizaciones pueden administrar el acceso y los límites, aprovisionar cuentas de servicio (a través de la IU) y hacer seguimiento del uso dentro de un alcance limitado en un proyecto (por ejemplo, modelos, capacidades, hilos, asistentes, ajuste fino, almacenamiento, etc.). La actividad de uso se puede desglosar por proyecto, y los usuarios pueden ver la facturación y establecer 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. Obtén más información sobre roles de usuario y permisos 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 esquina superior izquierda de la página y selecciona otra en la lista:
En las organizaciones que tienen 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?
Cada organización incluye un “Proyecto predeterminado” que no se puede eliminar. Puedes configurar los límites de velocidad, 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 agregarle miembros ni cuentas de servicio directamente.
¿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.
Ingresa un nombre, una descripción y un sitio web para tu proyecto y, luego, selecciona Crear.
¿Cómo agrego usuarios a un proyecto?
Los miembros recién agregados a la organización no se incorporan automáticamente al “Proyecto predeterminado”. Puedes invitar a los nuevos miembros al proyecto cuando los invites a la organización (activando la casilla “Invitar al proyecto predeterminado”) o después de que hayan aceptado la invitación a la organización.
Los usuarios invitados mediante la API de administración siguen las reglas del punto de acceso /organization/invites.
Si encuentras un error al invitar usuarios a un proyecto mediante la interfaz o la API de administración, antes de reenviar la invitación confirma que el proyecto de destino exista y no esté archivado.
Los propietarios de la organización se agregan automáticamente como propietarios a los nuevos proyectos creados en ella.
¿Cuáles son los distintos roles de usuario en las organizaciones y los proyectos, y qué permisos tiene cada uno?
Mientras que las organizaciones tienen los roles de “propietario” y “lector”, los proyectos tienen los de “propietario” y “miembro”. Los miembros de un proyecto son equivalentes a los lectores de una organización. Consulta la siguiente tabla para obtener una descripción más detallada de los permisos asociados con cada rol de usuario.
| Rol | Ámbito | Descripción |
|---|---|---|
| Propietario | Organización | Puede crear y ver todos los proyectos, usuarios y claves de API. Puede supervisar todos los proyectos de la organización desde la página Proyectos . Puede configurar los límites de gasto de la organización y de los proyectos. Puede conceder a otras personas de la organización permisos para ver información de uso. Puede archivar proyectos. |
| Lector | Organización | Puede ejecutar inferencias, usar recursos y crear claves en sus proyectos. Puede agregarse a proyectos. No puede crear proyectos ni administrar usuarios. |
| Propietario | Proyecto | Puede agregar otros usuarios al proyecto y cambiarle el nombre, además de contar con todas las capacidades de un miembro. Puede configurar los límites de gasto del proyecto. Puede archivar el proyecto. |
| Miembro | Proyecto | Puede ejecutar inferencias, usar recursos y crear claves en el 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, miembros y claves de API de cada proyecto, y acceder a la página Proyectos.
Solo los miembros de un proyecto (y los propietarios de la organización) pueden ver los modelos con ajustes personalizados creados en ese proyecto, los hilos de los asistentes creados y los archivos agregados.
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 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 tu organización, selecciona el proyecto y haz clic en Miembros. Puedes asignar a cada miembro el rol de Miembro o Propietario. 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 funciona como un seudousuario diseñado para acceder al sistema y es distinta de las cuentas de usuarios 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.
Agregar un miembro a un proyecto
Si haces clic en el botón + Agregar miembro, verás una lista de los usuarios de tu organización que tienen el rol de Lector. Si quieres agregar a un usuario que aún no pertenece a tu organización, primero deberás agregarlo a ella (puedes dejar desmarcada la casilla “Agregar al proyecto predeterminado” si no quieres darle un acceso más amplio). Esta lista no incluirá las cuentas de servicio. En este paso, puedes asignarle el rol de Propietario o Miembro:
Cuando agregues a un integrante del equipo, debes asignarle el rol de Miembro o Propietario. Los miembros del proyecto pueden realizar solicitudes a la API para leer o modificar datos, mientras que los propietarios también pueden modificar la configuración y los límites de gasto del proyecto, además de administrar a sus miembros. Consulta roles y permisos para obtener más información.
Crear una cuenta de servicio para un proyecto
Primero, ve al proyecto para el que quieres crear una cuenta de servicio seleccionándolo en el menú desplegable de la barra de navegación:
Luego, ve a la configuración de tu organización -> Proyecto -> Miembros -> y haz clic en + Cuenta de servicio:
Las cuentas de servicio creadas a nivel de proyecto son exclusivas de ese proyecto y no pueden usarse fuera del proyecto en el que se crean.
Asignar un nombre a la cuenta de servicio
Ya sea que crees la cuenta de servicio para toda la organización o exclusivamente para un proyecto, puedes asignarle un ID único compuesto por letras, números y guiones para identificarla fácilmente.
Guardar la clave de API de la cuenta de servicio
Después de seleccionar el botón Crear, se genera de inmediato 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, deberás generar una nueva.
De forma predeterminada, la clave de API de la cuenta de servicio tiene permisos para leer y escribir en todos los recursos de API del proyecto. Puedes actualizar estos permisos en la configuración de Claves de API de tu proyecto.
Las cuentas de servicio aparecen junto con los miembros del proyecto en la página de configuración de miembros. Consulta esta información para obtener más detalles sobre cómo actualizar o eliminar el acceso de una cuenta de servicio en la página de configuración de miembros del proyecto.
Todas las cuentas de servicio de proyectos y organizaciones se mostrarán junto con tus usuarios humanos en la página de miembros a nivel de la organización.
Las cuentas de servicio se administran como cuentas normales. Desde Organización -> menú Miembros, puedes Eliminar una cuenta de servicio o actualizar el rol:
¿Cómo administro las claves de API en los proyectos de mi organización?
Puedes crear y administrar las claves de API de cada proyecto desde su página de configuración. En la configuración de tu organización, selecciona el proyecto y haz clic en Claves de API.
Para crear una nueva clave secreta, selecciona + Crear nueva clave secreta. También puedes seleccionar el ícono Editar junto a una clave secreta para modificar sus permisos.
Puedes configurar los permisos de cada clave de API al crear una clave secreta nueva o editar una existente.
Hay tres niveles de permisos disponibles: Todos, Restringido y Solo lectura.
Todos — La clave secreta tiene permisos completos. Esta es la configuración predeterminada.
Restringido — Permite configurar 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 configuran permisos de lectura para todos los puntos de acceso.
¿Cómo se administra el acceso de los usuarios que pertenecen a varios proyectos u organizaciones?
Los usuarios pueden pertenecer a tantos proyectos como sea necesario. En un proyecto, los usuarios pueden generar una clave de API personal cuyo alcance y acceso estén limitados a ese proyecto y sus recursos.
¿Cómo configuro y administro los límites de velocidad de los proyectos de mi organización?
Solo el propietario de una organización puede configurar y administrar los límites de velocidad de los proyectos. 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. En esta página puedes actualizar el Uso de modelos.
El uso de modelos te permite configurar qué modelos puede utilizar el proyecto, y puedes establecer límites de velocidad para cada modelo según sea necesario.
¿Cómo configuro y administro los límites de gasto de los proyectos de mi organización?
Solo los propietarios de una organización y los propietarios de un proyecto pueden configurar y administrar 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 tu organización, haz clic en Límites y desplázate hasta Límites de uso.
Para configurar los límites de tu proyecto, ve a la configuración de tu organización, haz clic en el proyecto que quieres actualizar y selecciona Límites. Puedes actualizar el Límite de gasto mensual, el Umbral de notificación y el Uso de modelos.
Configurar un límite de gasto mensual te permite establecer umbrales de gasto flexibles para tu proyecto. Cuando el uso supere este límite durante un mes calendario determinado (UTC), las solicitudes a la API seguirán procesándose sin interrupciones. Esta función te ayuda a supervisar el uso mediante alertas de límites de gasto, pero no impone un límite máximo estricto. Cuando se crea un límite de gasto para un proyecto, se genera de forma predeterminada una alerta con un umbral del 100 %. Puedes configurar alertas adicionales con diferentes umbrales haciendo clic en Agregar 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 en la API tanto para organizaciones como para proyectos. Un límite de gasto puede servir para supervisar el gasto sin imponer restricciones, o puedes aplicarlo como límite estricto para que las solicitudes a la API fallen cuando se alcance. Para conocer 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?
Puedes archivar proyectos desde la nueva página de lista de proyectos o desde la configuración de un proyecto específico. Una vez archivado un proyecto, no se puede restaurar. Para continuar con el archivado, se te pedirá que ingreses el nombre del proyecto.
Puedes ver 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 para la cantidad de proyectos que puedo tener en mi organización?
De forma predeterminada, las organizaciones pueden crear hasta 2000 proyectos.
¿Se pueden compartir recursos entre proyectos?
Los recursos de un proyecto (como archivos, asistentes, almacenamiento o hilos) están limitados a ese proyecto y los miembros sin permisos administrativos que no pertenezcan a él no pueden acceder a ellos. Además, los recursos no se pueden transferir entre proyectos.
La única excepción es que los ajustes finos en el “Proyecto predeterminado” pueden accederse 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 superas esta cuota, verás el siguiente error:
Has excedido tu cuota de almacenamiento de archivos. Las organizaciones están limitadas a 100 GB de archivos. Reduce el tamaño del archivo o contacta a 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 un usuario en ese proyecto. En cambio, depende de tu rol en la organización y de 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 opción esté configurada como “Visible para los propietarios de la organización”.