Descripción general
Las plantillas de aplicaciones ofrecen un proceso de configuración para espacios de trabajo administrados que necesitan una versión específica de una aplicación o un conector de ChatGPT. Los administradores y propietarios del espacio de trabajo pueden buscar plantillas en la experiencia de administración disponible de Aplicaciones o Plugins, agregar la configuración específica de la organización y crear un borrador de la aplicación para revisarlo. Las plantillas de aplicaciones administradas no aparecen en los espacios de trabajo personales.
Las plantillas son útiles cuando OpenAI puede proporcionar el comportamiento común de la aplicación, pero cada espacio de trabajo debe aportar la configuración específica del proveedor. Según la plantilla, esa configuración puede incluir un nombre de inquilino o host, credenciales de cliente de OAuth, URL de devolución de llamada, ámbitos, detalles de webhooks, URL de servidores MCP administrados u otros ajustes del proveedor. Por ejemplo, una plantilla de GitHub Enterprise puede crear el conector específico del espacio de trabajo que Codex usa para acceder al host de GitHub Enterprise de esa organización.
Después de la configuración, los miembros no usan la plantilla original. Usan la aplicación publicada del espacio de trabajo que se creó a partir de ella. Luego, los administradores pueden gestionar esa aplicación como cualquier otra aplicación de ChatGPT, incluido el acceso por rol, los controles de acciones, los permisos de la aplicación y la autorización del proveedor.
Los plugins pueden incluir plantillas de aplicaciones o aplicaciones creadas a partir de plantillas. Si un plugin incluye una plantilla de aplicación, un administrador o propietario del espacio de trabajo debe crear y publicar la aplicación específica de ese espacio antes de que los miembros puedan conectarla en ChatGPT o usarla mediante el plugin. El plugin usa la instancia de la aplicación disponible en ese espacio de trabajo; los miembros no configuran la plantilla original.
Consulta este artículo para conocer el proceso general de las plantillas. Para conocer la configuración específica de cada proveedor, consulta:
Estos son algunos motivos habituales para usar una plantilla:
La URL del proveedor incluye el nombre de host de un inquilino, una cuenta, una organización o un espacio de trabajo de la empresa.
La organización necesita aportar su propio cliente de OAuth o sus propias credenciales del proveedor.
El proveedor requiere configurar una URL de devolución de llamada específica para el cliente.
La aplicación debe usar el mismo patrón de implementación, mientras cada espacio de trabajo controla por separado el acceso, las acciones y la configuración de seguridad.
Diferencias entre las plantillas y las aplicaciones normales
Por lo general, una aplicación normal se puede habilitar directamente. En cambio, una plantilla inicia un proceso de configuración a cargo del administrador del espacio de trabajo.
El proceso habitual es el siguiente:
Un administrador busca la plantilla en la experiencia de administración de Aplicaciones o Plugins del espacio de trabajo, según la interfaz disponible.
El administrador ingresa la configuración necesaria específica del espacio de trabajo.
ChatGPT crea un borrador de la aplicación para el espacio de trabajo.
El administrador revisa y publica el borrador.
El administrador configura el acceso y las acciones de la aplicación publicada.
Los miembros usan la aplicación publicada del espacio de trabajo, no la plantilla original.
Buscar y configurar una plantilla de aplicación
Los siguientes procedimientos describen la interfaz de administración de Aplicaciones. Si tu espacio de trabajo usa Administración > Plugins, abre el plugin o la plantilla correspondiente y sigue su proceso de configuración. Para navegar por el espacio de trabajo, consulta: Controles de administración, seguridad y cumplimiento para plugins y aplicaciones.
Ve a Configuración del espacio de trabajo > Aplicaciones.
Selecciona Directorio.
Busca el nombre del proveedor o de la aplicación.
Busca las entradas marcadas como plantillas.
Selecciona Habilitar para iniciar el proceso de configuración.
El proceso de configuración solicita los datos necesarios para crear la aplicación específica del espacio de trabajo. Los campos exactos dependen de la plantilla.
Por ejemplo, una plantilla de GitHub Enterprise puede solicitar datos como los siguientes:
Nombre y descripción de la aplicación.
Nombre de host de GitHub Enterprise.
Configuración de la URL de devolución de llamada.
ID y secreto del cliente de OAuth.
Clave privada de la aplicación de GitHub.
Ámbitos solicitados.
Detalles de configuración del webhook.
Revisa cuidadosamente cada campo antes de crear el borrador. Si tu organización administra de forma centralizada las credenciales de OAuth o del proveedor, coordina el proceso con el equipo responsable de esas credenciales.
Para conocer la configuración específica de cada proveedor, consulta: GitHub Enterprise, Snowflake y Databricks.
Configurar el cliente de OAuth
Algunas plantillas requieren que tu organización aporte su propio cliente de OAuth. Cuando sea necesario, crea o configura la aplicación de OAuth en la consola de administración del proveedor externo. Luego, copia la URL de devolución de llamada de ChatGPT en la configuración de URL de redireccionamiento o devolución de llamada del proveedor.
Ingresa el ID y el secreto del cliente de OAuth en ChatGPT solo después de confirmar que la configuración del proveedor coincide con las instrucciones de configuración de la plantilla.
Si la plantilla incluye ámbitos predeterminados, consérvalos a menos que tu organización haya revisado los permisos del proveedor y tenga un motivo claro para cambiarlos.
Crear un borrador
Después de ingresar la información necesaria, selecciona Crear borrador.
Crear un borrador no hace que la aplicación esté disponible automáticamente para los miembros. Revisa y publica el borrador, y configura el acceso y las acciones antes de pedirles a los miembros que usen la aplicación.
Publicar y administrar la aplicación resultante
Después de publicarla, administra la aplicación específica del espacio de trabajo desde la configuración disponible de Aplicaciones o Plugins del espacio de trabajo.
Comprobaciones recomendadas después de la publicación:
Confirma que la aplicación aparezca en Aplicaciones habilitadas.
Configura el Acceso por rol para los roles que deban usar la aplicación.
Revisa Acciones para las acciones de lectura y escritura.
Revisa Permisos de la aplicación para elegir cuándo ChatGPT debe consultar a los miembros antes de usar la aplicación.
Pide a un usuario de prueba autorizado que vaya a Aplicaciones o Plugins, según la opción disponible, y confirme que aparezca la aplicación publicada.
Si la aplicación requiere autenticación con el proveedor, pide al usuario de prueba que conecte su cuenta del proveedor.
Ejecuta un prompt de prueba de bajo riesgo para confirmar que la aplicación funcione como se espera.
Estos permisos se aplican a las conversaciones de ChatGPT. Los Agentes del espacio de trabajo usan controles independientes definidos por quien creó el agente. Para obtener más información, consulta: Agentes del espacio de trabajo de ChatGPT para Enterprise y Business.
Si una plantilla solo se puede usar una vez
Algunas plantillas solo pueden crear una aplicación por espacio de trabajo. Si ya se usó una plantilla, es posible que el botón Habilitar no esté disponible. En ese caso, administra el borrador o la aplicación publicada existente en lugar de crear otra a partir de la misma plantilla.
Qué ven los miembros
Los miembros ven la aplicación publicada que se creó a partir de la plantilla. Que un miembro pueda verla o usarla depende de la configuración del espacio de trabajo y de la autorización del proveedor. Si la aplicación está incluida en un plugin, los miembros pueden encontrarla a través de ese plugin, pero siguen vigentes los mismos requisitos de acceso al espacio de trabajo y autorización del proveedor.
Si un plugin requiere una aplicación creada a partir de una plantilla, puede indicar que se necesita configurarla hasta que un administrador cree y publique la aplicación específica del espacio de trabajo, la habilite para el rol correspondiente y se complete cualquier autorización necesaria del proveedor por parte del usuario o administrador.
Verifica lo siguiente:
La aplicación está publicada.
La aplicación está habilitada para el espacio de trabajo.
El rol del miembro en el espacio de trabajo tiene acceso.
El miembro está en el espacio de trabajo correcto.
El miembro tiene los permisos necesarios en el proveedor externo.
Las aplicaciones publicadas aparecen en la configuración disponible de Aplicaciones o Plugins del espacio de trabajo. Si la aplicación forma parte de un plugin, también puede aparecer como obligatoria u opcional en la página de detalles del plugin.
Solucionar problemas con las plantillas de aplicaciones
Si la configuración falla o la aplicación no aparece, confirma lo siguiente:
El nombre de host del inquilino, la cuenta o el espacio de trabajo es correcto.
La URL de devolución de llamada se copió exactamente en la configuración del proveedor.
El ID y el secreto del cliente de OAuth son correctos.
Los ámbitos solicitados coinciden con los que permite la aplicación de OAuth del proveedor.
Se creó un borrador.
Se publicó el borrador.
El acceso por rol permite que el usuario de prueba vea la aplicación.
Los permisos del proveedor permiten los datos o la acción que se están probando.
Revisar los requisitos de seguridad
Trata los secretos de cliente de OAuth y las credenciales del proveedor como información confidencial.
Revisa los ámbitos solicitados antes de crear el borrador.
Después de publicar, usa Acciones para limitar lo que puede hacer la aplicación.
Usa Permisos de la aplicación para decidir cuándo ChatGPT debe consultar a los miembros antes de usar la aplicación.
Ten en cuenta que los permisos del proveedor siguen vigentes después de habilitar la aplicación en ChatGPT.