Descripción general
Usa esta guía si eres administrador de un área de trabajo de ChatGPT y estás configurando la plantilla de aplicación Enterprise de GitHub para tu organización. Una plantilla no es la aplicación final que usan los miembros. Es un flujo de configuración que crea una aplicación en borrador específica del área de trabajo después de que proporciones la configuración necesaria de GitHub Enterprise.
Para GitHub Enterprise, la configuración conecta ChatGPT al host de GitHub Enterprise de tu organización. Creas una GitHub App, registras la URL de devolución de llamada de ChatGPT, generas credenciales y luego pegas esos valores en el flujo de configuración de la plantilla de ChatGPT. Después de que ChatGPT cree la aplicación en borrador, puedes publicarla y gestionarla como otras aplicaciones del área de trabajo.
Qué estás configurando
Estás creando una aplicación de GitHub Enterprise específica del área de trabajo en ChatGPT. La aplicación usa:
Una GitHub App registrada en tu host de GitHub Enterprise.
El ID de cliente y el secreto de cliente de la GitHub App para la autorización de usuario mediante OAuth.
La clave privada de la GitHub App para que ChatGPT pueda emitir tokens de instalación para operaciones de repositorio.
Un secreto de webhook y una URL de webhook para que GitHub Enterprise pueda enviar eventos de instalación y repositorio de vuelta a ChatGPT.
Tu nombre de host de GitHub Enterprise, como
github.example.com.
Crea una GitHub App, no una GitHub OAuth App independiente. La configuración de la plantilla de ChatGPT requiere credenciales de GitHub App, una clave privada y configuración de webhook.
Antes de empezar
Necesitas:
Acceso de administrador o propietario del área de trabajo de ChatGPT.
Acceso de administrador u propietario de la organización de GitHub Enterprise que pueda crear e instalar GitHub Apps.
Solo el nombre de host de GitHub Enterprise, sin
https://ni ruta.Una decisión sobre qué acciones de repositorio debe admitir ChatGPT, como búsqueda de repositorios de solo lectura, flujos de trabajo de pull requests, flujos de trabajo de incidencias, ediciones de archivos, GitHub Actions o flujos de trabajo más amplios de Codex.
Un lugar seguro para gestionar la clave privada y el secreto de cliente de la GitHub App.
Mantén ChatGPT y GitHub Enterprise abiertos en pestañas independientes. No inventes la URL de devolución de llamada. Copia la URL de devolución de llamada exacta que se muestra en ChatGPT.
Valores que preparar
Nombre de host de GitHub Enterprise: por ejemplo,
github.example.com.URL de devolución de llamada: cópiala del flujo de configuración de la plantilla de ChatGPT.
ID de cliente de GitHub App.
Secreto de cliente de GitHub App.
Clave privada PEM de GitHub App.
Secreto de webhook generado por ChatGPT.
URL de webhook generada después de crear la aplicación en borrador en ChatGPT.
Iniciar la configuración de la plantilla en ChatGPT
En ChatGPT, cambia al área de trabajo donde la aplicación debe estar disponible.
Abre Configuración del área de trabajo > Aplicaciones.
Selecciona Directorio.
Busca GitHub Enterprise.
Selecciona la plantilla de aplicación de GitHub Enterprise e inicia la configuración.
Introduce un nombre y una descripción claros para la aplicación, como GitHub Enterprise o GitHub Enterprise - Engineering.
Introduce el nombre de host de GitHub Enterprise, como
github.example.com.Copia la URL de devolución de llamada que se muestra en ChatGPT. Mantén esta pestaña abierta.
Copia el secreto de webhook generado si se muestra durante la configuración.
Ejemplo de URL de devolución de llamada: https://chatgpt.com/connector/oauth/<callback_id>
No elimines el ID de devolución de llamada, no añadas una barra final ni lo sustituyas por una URL genérica de ChatGPT.
Crear la GitHub App en GitHub Enterprise
Abre tu host de GitHub Enterprise, como
https://github.example.com.Ve a la organización o cuenta que debe ser propietaria de la aplicación.
Abre Configuración > Configuración de desarrollador > GitHub Apps.
Selecciona Nueva GitHub App.
Introduce un nombre claro para la aplicación, como ChatGPT GitHub Enterprise Connector.
Introduce una URL de página de inicio. Si no hay una página interna específica, usa la URL de la organización de GitHub Enterprise.
En URL de devolución de llamada, pega la URL exacta copiada de ChatGPT.
Mantén activado Caducar tokens de autorización de usuario, salvo que tu equipo de seguridad tenga un motivo específico para cambiarlo.
Activa Solicitar autorización de usuario durante la instalación para que los usuarios puedan autorizar la aplicación durante el flujo de instalación o conexión.
En Dónde se puede instalar esta GitHub App, elige la opción más restringida que encaje con tu despliegue.
Crea la GitHub App.
Configurar permisos y eventos
Elige los permisos mínimos necesarios para las acciones de ChatGPT que tienes previsto activar.
Para la detección de repositorios y preguntas y respuestas de solo lectura, empieza con permisos de lectura como:
Metadatos: solo lectura. GitHub requiere metadatos para las GitHub Apps.
Contenido: solo lectura, para acceder a archivos y contenido de repositorios.
Incidencias: solo lectura, si se necesita buscar o leer incidencias.
Pull requests: solo lectura, si se necesita buscar pull requests o contexto de revisión.
Acciones: solo lectura, si se necesitan el estado de ejecuciones de flujos de trabajo, trabajos, registros o artefactos.
Para flujos de trabajo de escritura, añade permisos de escritura solo donde sea necesario, como Contenido, Pull requests, Incidencias, Acciones o Flujos de trabajo. Usa los permisos más restringidos que admitan las acciones previstas de ChatGPT.
Los eventos de webhook deben coincidir con los flujos de trabajo que admites. Entre los eventos habituales se incluyen Instalación, Repositorios de instalación, Push, Pull request, Incidencias, Comentario de incidencia, Ejecución de flujo de trabajo y Trabajo de flujo de trabajo.
Generar y copiar credenciales de GitHub App
En la configuración de la GitHub App, copia el ID de cliente.
Genera un secreto de cliente y cópialo de inmediato.
En Claves privadas, genera una clave privada.
Descarga el archivo .pem y guárdalo de forma segura.
Abre el archivo .pem localmente y copia el texto PEM completo, incluidas las líneas de inicio y fin.
La clave privada es confidencial. Trátala como una credencial. Si queda expuesta, genera una clave privada nueva, actualiza la configuración de la aplicación de ChatGPT y elimina la clave comprometida en GitHub Enterprise.
Finalizar la configuración en ChatGPT
Vuelve a la pestaña de configuración de la plantilla de ChatGPT.
Pega el ID de cliente de la GitHub App en ID de cliente de OAuth.
Pega el secreto de cliente de la GitHub App en Secreto de cliente de OAuth.
Deja Ámbitos sin cambios, salvo que tu organización necesite anular intencionadamente los valores predeterminados de la plantilla.
Confirma que el nombre de host de GitHub Enterprise sea solo el nombre de host, como
github.example.com.Pega o sube la clave privada PEM de la GitHub App en Clave privada de GitHub App.
Confirma que el secreto de webhook generado esté presente.
Crea la aplicación en borrador.
Abre los detalles de la aplicación en borrador creada en ChatGPT y copia la URL de webhook generada.
La URL de webhook debe tener este aspecto: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Finalizar la configuración del webhook en GitHub Enterprise
Vuelve a la configuración de la GitHub App en GitHub Enterprise.
Abre la configuración general de la GitHub App.
Activa Webhooks activos si aún no están activados.
Pega la URL de webhook de ChatGPT en URL de webhook.
Pega el secreto de webhook de ChatGPT en Secreto de webhook.
Mantén activada la verificación SSL.
Confirma que los eventos de webhook suscritos coincidan con los permisos y acciones que has activado.
Guarda los cambios.
Publicar y gestionar la aplicación en ChatGPT
Crear la aplicación en borrador no la pone automáticamente a disposición de los miembros. Después de revisar el borrador:
Publica la aplicación en borrador.
Confirma que la aplicación aparece en Configuración del área de trabajo > Aplicaciones > Habilitadas.
Configura Acceso de usuario para los roles que deben usarla.
Revisa Control de acciones para las acciones de lectura y escritura.
Revisa Permisos de la aplicación para elegir cuándo ChatGPT debe preguntar a los miembros antes de usar la aplicación.
Pide a un usuario de prueba autorizado que abra Aplicaciones en ChatGPT y confirme que la aplicación aparece.
Estos permisos de aplicación se aplican a las conversaciones de ChatGPT. Los agentes del área de trabajo usan controles por agente definidos por el creador del agente para determinar qué acciones de aplicación están disponibles y cuándo se pide a los usuarios finales que las aprueben. Para el comportamiento de los agentes, consulta: Agentes del área de trabajo de ChatGPT para Enterprise y Business.
Instalar y probar la GitHub App
En GitHub Enterprise, instala la aplicación de GitHub en la organización o cuenta.
Elige todos los repositorios o repositorios seleccionados según la política del área de trabajo.
Inicia el flujo de conexión desde ChatGPT como usuario autorizado.
Autoriza la aplicación de GitHub cuando se te solicite.
Ejecuta primero una acción de lectura pequeña, como enumerar repositorios accesibles u obtener un pull request conocido.
Si las acciones de escritura están activadas, haz una prueba con un repositorio de bajo riesgo antes de un despliegue más amplio.
Nombre de host y comportamiento de OAuth
ChatGPT usa el nombre de host para derivar los puntos de acceso de GitHub Enterprise. Introduce solo el host, como github.example.com u octocorp.ghe.com.
No introduzcas una ruta de API, una ruta de repositorio ni github.com, salvo que sea el host exacto de GitHub Enterprise para esta aplicación.
Solución de problemas
No coincide el URI de redirección: confirma que la URL de devolución de llamada de la GitHub App coincida exactamente con la URL de devolución de llamada que se muestra en ChatGPT.
ChatGPT no puede crear ni guardar la aplicación en borrador: confirma que estén presentes todos los campos obligatorios, incluidos el nombre de host, ID de cliente de OAuth, Secreto de cliente de OAuth, la clave privada y el secreto de webhook.
La autenticación se realiza correctamente, pero las llamadas al repositorio fallan: confirma que la GitHub App esté instalada y tenga acceso al repositorio.
La API devuelve 403 o permisos insuficientes: añade el permiso que falta de la GitHub App y haz que el propietario de la instalación apruebe los permisos actualizados si se le solicita.
No aparece ningún repositorio: confirma que la instalación de la aplicación incluya los repositorios esperados y que el usuario que autoriza en ChatGPT tenga acceso a ellos.
Las entregas de webhook fallan: confirma que la URL de webhook y el secreto de webhook coincidan con los valores de ChatGPT, mantén activada la verificación SSL y asegúrate de que el host de GitHub Enterprise pueda acceder a
connectors.api.openai.org.Errores de clave privada: confirma que se haya copiado el contenido PEM completo, incluidas las líneas de inicio y fin.