Descripción general
Las plantillas de apps son una opción de configuración para los Espacios de trabajo administrados que necesitan una versión de una app o un conector de ChatGPT específica para su Espacio de trabajo. Los administradores y propietarios del Espacio de trabajo pueden buscar plantillas en la interfaz de administración de Apps o Complementos disponible, agregar la configuración específica de la organización y crear un borrador de la app para revisarlo. Las plantillas de apps administradas no aparecen en los Espacios de trabajo personales.
Las plantillas son útiles cuando OpenAI puede proporcionar las funciones comunes de la app, pero cada Espacio de trabajo debe proporcionar una configuración específica del proveedor. Según la plantilla, esa configuración puede incluir un nombre de inquilino o de host, credenciales de cliente OAuth, URL de devolución de llamada, alcances, 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 app publicada del Espacio de trabajo que se creó a partir de ella. Luego, los administradores pueden gestionar esa app como las demás apps de ChatGPT. En ChatGPT Business, los propietarios y administradores habilitan o deshabilitan la app para el Espacio de trabajo. En ChatGPT Enterprise/Edu, los propietarios y administradores pueden usar el acceso a apps basado en roles cuando esté disponible. Los administradores también pueden gestionar los controles de acciones, los permisos de las apps y la autorización del proveedor.
Los complementos pueden incluir plantillas de apps o apps creadas a partir de plantillas. Si un complemento incluye una plantilla de app, un administrador o propietario del Espacio de trabajo debe crear y publicar la app específica de ese Espacio de trabajo antes de que los miembros puedan conectarla en ChatGPT o usarla a través del complemento. El complemento usa la instancia de la app disponible en ese Espacio de trabajo; los miembros no configuran la plantilla original.
Consulta este artículo para conocer el proceso general de uso 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 un inquilino, una cuenta, una organización o un nombre de host del espacio de trabajo de la empresa.
La organización necesita proporcionar su propio cliente OAuth o sus propias credenciales del proveedor.
El proveedor requiere una configuración de URL de devolución de llamada específica para cada cliente.
La app debe usar el mismo patrón de implementación, pero cada Espacio de trabajo controla por separado el acceso, las acciones y la configuración de seguridad.
En qué se diferencian las plantillas de las apps comunes
Por lo general, una app común puede habilitarse 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 interfaz de administración de Apps o Complementos del Espacio de trabajo, según la interfaz disponible.
El administrador ingresa la configuración específica que requiere el Espacio de trabajo.
ChatGPT crea un borrador de la app para el Espacio de trabajo.
El administrador revisa y publica el borrador.
El administrador configura los ajustes de acceso y acciones de la app publicada.
Los miembros usan la app publicada del Espacio de trabajo, no la plantilla original.
Buscar y configurar una plantilla de app
Los procedimientos que se indican a continuación describen la interfaz de administración de Apps. Si tu Espacio de trabajo usa Administración > Complementos, abre el complemento o la plantilla correspondiente y sigue su proceso de configuración. Para obtener información sobre cómo navegar por el Espacio de trabajo y los controles de administración específicos de cada plan, consulta: controles de administración, seguridad y cumplimiento para complementos y apps.
Ve a Configuración del Espacio de trabajo > Apps.
Selecciona Directorio.
Busca el nombre del proveedor o de la app.
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 app específica del Espacio de trabajo. Los campos concretos dependen de la plantilla.
Por ejemplo, una plantilla de GitHub Enterprise puede solicitar datos como los siguientes:
Nombre y descripción de la app.
Nombre de host de GitHub Enterprise.
Configuración de la URL de devolución de llamada.
ID y secreto del cliente OAuth.
Clave privada de la app de GitHub.
Alcances solicitados.
Detalles de configuración del webhook.
Revisa cada campo con atención antes de crear el borrador. Si tu organización gestiona las credenciales de OAuth o del proveedor de forma centralizada, coordina con el equipo responsable de esas credenciales.
Para conocer la configuración específica de cada proveedor, consulta: GitHub Enterprise, Snowflake y Databricks.
Configuración del cliente OAuth
Algunas plantillas requieren que tu organización proporcione su propio cliente OAuth. Cuando sea necesario, crea o configura la app OAuth en la consola de administración del proveedor externo y luego copia la URL de devolución de llamada de ChatGPT en los ajustes de URL de redireccionamiento o de devolución de llamada del proveedor.
Ingresa el ID y el secreto del cliente 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 alcances predeterminados, mantenlos 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 requerida, selecciona Crear borrador.
Crear un borrador no hace que la app esté disponible automáticamente para los miembros. Revisa el borrador, publícalo y configura los ajustes de acceso y acciones antes de pedirles a los miembros que lo usen.
Publicar y gestionar la app resultante
Después de publicarla, gestiona la app específica del Espacio de trabajo desde la sección Apps o Complementos de la configuración del Espacio de trabajo, según cuál esté disponible.
Verificaciones recomendadas después de publicar:
Confirma que la app aparezca en Apps habilitadas.
En ChatGPT Business, habilita o deshabilita la app para el Espacio de trabajo. En ChatGPT Enterprise/Edu, configura el Acceso por rol para los roles que deban usar la app, cuando se admita el acceso a apps basado en roles.
Revisa las acciones de lectura y escritura en Acciones.
Revisa Permisos de la app para elegir cuándo ChatGPT debe pedirles permiso a los miembros antes de usar la app.
Pídele a un usuario de prueba autorizado que vaya a Apps o Complementos, según cuál esté disponible, y confirme que la app publicada aparezca.
Si la app requiere autenticación con el proveedor, pídele al usuario de prueba que conecte su cuenta del proveedor.
Ejecuta un prompt de prueba de bajo riesgo para confirmar que la app funcione como se espera.
Estos permisos se aplican a las conversaciones de ChatGPT. Los agentes del Espacio de trabajo usan controles independientes definidos por el creador de cada agente. Para obtener más información, consulta: agentes del Espacio de trabajo de ChatGPT para Enterprise y Business.
Si una plantilla solo puede usarse una vez
Es posible que algunas plantillas solo permitan crear una app por Espacio de trabajo. Si una plantilla ya se usó, es posible que el botón Habilitar no esté disponible. En ese caso, gestiona el borrador o la app publicada que ya existe en lugar de crear otra a partir de la misma plantilla.
Qué ven los miembros
Los miembros ven la app 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 app está incluida en un complemento, los miembros pueden encontrarla a través de ese complemento, pero se siguen aplicando los mismos requisitos de acceso al Espacio de trabajo y de autorización del proveedor.
Si un complemento requiere una app creada a partir de una plantilla, puede indicar que hace falta configurarla hasta que un administrador cree y publique la app específica del Espacio de trabajo, la habilite para el Espacio de trabajo en ChatGPT Business o para el rol correspondiente en ChatGPT Enterprise/Edu cuando se admita el acceso a apps basado en roles, y se complete toda autorización del proveedor que deba realizar el usuario o el administrador.
Verifica lo siguiente:
La app está publicada.
La app está habilitada para el Espacio de trabajo.
En ChatGPT Enterprise/Edu, el rol del miembro en el Espacio de trabajo tiene acceso cuando se admite el acceso a apps basado en roles.
El miembro está en el Espacio de trabajo correcto.
El miembro tiene los permisos necesarios en el proveedor externo.
Las apps publicadas aparecen en la sección Apps o Complementos de la configuración del Espacio de trabajo, según cuál esté disponible. Si la app forma parte de un complemento, también puede aparecer como app obligatoria u opcional en la página de detalles del complemento.
Solucionar problemas con las plantillas de apps
Si la configuración falla o la app no aparece, confirma lo siguiente:
El nombre de host del inquilino, de la cuenta o del 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 OAuth son correctos.
Los alcances solicitados coinciden con lo que permite la app OAuth del proveedor.
Se creó un borrador.
El borrador se publicó.
En ChatGPT Business, la app está habilitada para el Espacio de trabajo. En ChatGPT Enterprise/Edu, el acceso por rol permite que el usuario de prueba vea la app cuando se admite el acceso a apps basado en roles.
Los permisos del proveedor permiten acceder a los datos o ejecutar la acción que se está probando.
Revisar los requisitos de seguridad
Trata los secretos del cliente OAuth y las credenciales del proveedor como información confidencial.
Revisa los alcances solicitados antes de crear el borrador.
Usa Acciones después de publicar la app para limitar lo que puede hacer.
Usa Permisos de la app para decidir cuándo ChatGPT debe pedirles permiso a los miembros antes de usar la app.
Ten en cuenta que los permisos del proveedor siguen aplicándose después de habilitar la app en ChatGPT.