Los proyectos buscan brindar a los clientes la capacidad de organizar su trabajo. Las organizaciones pueden administrar el acceso y los límites, aprovisionar cuentas de servicio (mediante la IU) y hacer seguimiento del uso dentro de un alcance restringido en un proyecto (por ejemplo, modelos, capacidades, hilos, asistentes, fine-tuning, almacenamiento, etc.). La actividad de uso se puede desglosar por proyecto, y los usuarios pueden ver la facturación y configurar presupuestos 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 de 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 entre organizaciones, 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:
Para 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?
Toda organización incluye un “Proyecto predeterminado” que no se puede eliminar. Puedes configurar los límites de tasa, los permisos de modelos virtuales y los presupuestos de gasto (a partir de noviembre de 2024). Hereda la configuración completa de la organización, por lo que no puedes agregarle 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.
Proporciona un nombre, una descripción y un sitio web para tu proyecto, y luego selecciona Create.
¿Cómo agrego usuarios a un proyecto?
Los miembros agregados recientemente a la organización no se agregan automáticamente al “Proyecto predeterminado”. Los miembros nuevos pueden ser invitados al proyecto cuando se les invita a la organización (habilitando 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 punto de acceso /organization/invites.
Si encuentras un error al invitar usuarios a un proyecto mediante la IU o la API de administración, primero confirma que el proyecto de destino exista y no esté archivado antes de volver a enviar la invitación.
Los propietarios de la organización se agregan automáticamente como propietarios a los proyectos nuevos creados dentro de una organización.
¿Cuáles son los diferentes roles de usuario dentro de organizaciones y proyectos, y qué permisos implican?
Mientras que las organizaciones tienen roles de “propietario” y “lector”, los proyectos tienen roles de “propietario” y “miembro”. Los miembros de proyecto son análogos a los lectores de la organización. Consulta la tabla a continuación para obtener una descripción más detallada de los permisos que acompañan a cada rol de usuario.
| Rol | Alcance | Descripción |
|---|---|---|
| Propietario | Organización | Puede crear y ver todos los proyectos, todos los usuarios y todas las claves de API. Tiene la capacidad de monitorear todos los proyectos dentro de la organización con la página Proyectos . Puede configurar presupuestos de la organización y presupuestos de proyecto. Puede otorgar permisos para ver información de uso de otras personas en la organización. Puede archivar proyectos. |
| Lector | Organización | Puede realizar 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 cambiar el nombre del proyecto, además de tener todas las capacidades de un Miembro. Puede configurar presupuestos de proyecto. Puede archivar el proyecto. |
| Miembro | Proyecto | Puede realizar inferencias, usar recursos y crear claves a nivel de proyecto. |
Si no soy propietario en la organización, ¿a qué tengo acceso?
Los usuarios que no son propietarios 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 de 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 fine-tuned que se crearon dentro de ese proyecto, los hilos de cualquier asistente creado o cualquier archivo que se haya agregado.
Los miembros de un proyecto pueden ver quiénes son los demás miembros de ese proyecto y sus roles (es decir, Propietario o Miembro).
¿Cómo actualizo el rol de proyecto de un usuario o elimino a un usuario de un proyecto?
Solo el propietario de un proyecto puede actualizar el rol de proyecto de un usuario 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 Miembro o Propietario. También puedes seleccionar Eliminar para eliminar 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 seudousuario 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.
Agregar 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 agregar a un usuario que actualmente no está en tu organización, primero debes agregarlo a la organización (puedes dejar desmarcada la casilla “Agregar al proyecto predeterminado” si no quieres darles 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 agregas un miembro del equipo, debes asignarle el rol Member u Owner. Los miembros del proyecto pueden hacer solicitudes a la API que lean o modifiquen datos, mientras que los propietarios del proyecto también pueden modificar la configuración y los presupuestos del proyecto, y administrar sus miembros. Consulta roles y permisos para obtener más información.
Crear una cuenta de servicio para un proyecto
Primero, navega al proyecto para el que quieres crear una cuenta de servicio eligiéndolo en el menú desplegable de la barra de navegación:
Luego, 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 de ese proyecto y no pueden usarse 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 única para un proyecto, al crear una cuenta de servicio puedes crear un ID único de cuenta de servicio 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 crea de inmediato una clave de API para la cuenta de servicio y se mostrará la clave secreta. Guarda esta clave secreta en un lugar seguro. 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 de API de la cuenta de servicio se establecen de forma predeterminada para leer y escribir todos los recursos de API del proyecto. Estos permisos se pueden actualizar en la configuración de Claves de API de tu proyecto.
Las cuentas de servicio se muestran junto con 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 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 dentro de los proyectos de mi organización?
Puedes crear y administrar claves de 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 Claves de API.
Para crear una nueva clave secreta, selecciona + Create new secret key. También puedes seleccionar el ícono Editar junto a una clave secreta para editar sus permisos.
Puedes configurar permisos para cada una de tus claves de API al crear una nueva clave secreta o al editar una clave existente.
Hay tres niveles de permisos disponibles: todos, restringidos y solo lectura.
Todos — Se configuran permisos completos para la clave secreta. Esta es la configuración predeterminada.
Restringido — Permite al usuario configurar permisos de Ninguno, Lectura y Escritura para cada punto de acceso.
Por ejemplo, creas una clave de API que específicamente no tiene permiso para leer ni escribir en 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 para 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 definida para acceder a ese proyecto y sus recursos.
¿Cómo configuro y administro los límites de solicitudes para los proyectos de mi organización?
Solo el propietario de una organización puede configurar y administrar límites de solicitudes 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 tu Uso de modelos en esta página.
Uso de modelos te permite configurar qué modelos puede usar el proyecto, y los límites de solicitudes se pueden establecer para cada modelo según sea necesario.
¿Cómo configuro y administro los presupuestos para los proyectos de mi organización?
Solo los propietarios de una organización y los propietarios de un proyecto pueden configurar y administrar los presupuestos del proyecto. Consulta roles y permisos para obtener más información. Para cambiar los límites a nivel de la 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 configurar 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, Umbral de notificación y Uso de modelos.
Configurar un presupuesto mensual te permite establecer umbrales flexibles de gasto para tu proyecto. Cuando el uso supera este límite dentro de un mes calendario determinado (UTC), las solicitudes a la API seguirán procesándose sin interrupción. Esta función está diseñada para ayudarte a monitorear el uso mediante alertas de presupuesto, pero no impone un límite estricto al gasto. Cuando se crea un presupuesto de proyecto, de forma predeterminada, se creará una alerta en el umbral del 100 %. Se pueden configurar presupuestos adicionales con distintos 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 elimino o archivo un proyecto?
Los proyectos se pueden archivar desde la nueva página de listado de proyectos o desde la configuración de un proyecto individual. Una vez archivado un proyecto, no se puede restaurar. Al continuar con el archivado, se te pedirá que ingreses el nombre del proyecto para seguir adelante.
Puedes ver una lista de todos los proyectos archivados en la pestaña “Archivados” de la misma página de listado de proyectos.
No es posible eliminar proyectos; mantenemos un historial de todos los proyectos para garantizar la continuidad del seguimiento de uso y facturación.
¿Hay un límite en la cantidad de proyectos que puedo tener en mi organización?
Las organizaciones pueden crear hasta 2,000 proyectos de forma predeterminada.
¿Se pueden compartir recursos entre proyectos?
Los recursos del proyecto (como archivos, asistentes, almacenamiento o hilos) están limitados al proyecto y no pueden ser accedidos por miembros no administradores fuera del proyecto. Además, los recursos no pueden moverse 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?
OpenAI actualmente admite una cuota de almacenamiento de archivos de 100 GB por proyecto.
Si se supera 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 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, está determinada por 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é establecida en “Visible para propietarios de la organización”.