Visió general
Utilitzeu aquesta guia si sou administrador d'un espai de treball de ChatGPT i configureu la plantilla d'aplicació Enterprise de GitHub per a la vostra organització. Una plantilla no és l'aplicació final que utilitzen els membres. És un flux de configuració que crea una aplicació en esborrany específica de l'espai de treball després que proporcioneu la configuració necessària de GitHub Enterprise.
Per a GitHub Enterprise, la configuració connecta ChatGPT amb l'amfitrió de GitHub Enterprise de la vostra organització. Creeu una GitHub App, registreu l'URL de retorn de trucada de ChatGPT, genereu credencials i després enganxeu aquests valors al flux de configuració de la plantilla de ChatGPT. Després que ChatGPT creï l'aplicació en esborrany, la podeu publicar i gestionar com altres aplicacions de l'espai de treball.
Què esteu configurant
Esteu creant una aplicació GitHub Enterprise específica de l'espai de treball a ChatGPT. L'aplicació utilitza:
Una GitHub App registrada al vostre amfitrió de GitHub Enterprise.
L'ID de client i el secret de client de la GitHub App per a l'autorització d'usuari OAuth.
La clau privada de la GitHub App perquè ChatGPT pugui generar segments d'instal·lació per a operacions de repositori.
Un secret de webhook i un URL de webhook perquè GitHub Enterprise pugui enviar esdeveniments d'instal·lació i de repositori a ChatGPT.
El vostre nom d'amfitrió de GitHub Enterprise, com ara
github.example.com.
Creeu una GitHub App, no una GitHub OAuth App independent. La configuració de la plantilla de ChatGPT requereix credencials de GitHub App, una clau privada i configuració de webhook.
Abans de començar
Necessiteu:
Accés d'administrador o propietari de l'espai de treball de ChatGPT.
Accés d'administrador o propietari d'organització de GitHub Enterprise que pugui crear i instal·lar GitHub Apps.
Només el nom d'amfitrió de GitHub Enterprise, sense
https://ni cap camí.Una decisió sobre quines accions de repositori ha d'admetre ChatGPT, com ara cerca de repositoris només de lectura, fluxos de treball de sol·licituds d'extracció, fluxos de treball d'incidències, edicions de fitxers, GitHub Actions o fluxos de treball de Codex més amplis.
Un lloc segur per gestionar la clau privada i el secret de client de la GitHub App.
Manteniu ChatGPT i GitHub Enterprise oberts en pestanyes separades. No inventeu l'URL de retorn de trucada. Copieu l'URL de retorn de trucada exacte que es mostra a ChatGPT.
Valors que cal preparar
Nom d'amfitrió de GitHub Enterprise: per exemple,
github.example.com.URL de retorn de trucada: copieu-lo del flux de configuració de la plantilla de ChatGPT.
ID de client de la GitHub App.
Secret de client de la GitHub App.
PEM de clau privada de la GitHub App.
Secret de webhook generat per ChatGPT.
URL de webhook generat després de crear l'aplicació en esborrany a ChatGPT.
Inicieu la configuració de la plantilla a ChatGPT
A ChatGPT, canvieu a l'espai de treball on l'aplicació ha d'estar disponible.
Obriu Configuració de l'espai de treball > Aplicacions.
Seleccioneu Directori.
Cerqueu GitHub Enterprise.
Seleccioneu la plantilla de l'aplicació GitHub Enterprise i inicieu la configuració.
Introduïu un nom i una descripció clars per a l'aplicació, com ara GitHub Enterprise o GitHub Enterprise - Engineering.
Introduïu el nom d'amfitrió de GitHub Enterprise, com ara
github.example.com.Copieu l'URL de retorn de trucada que es mostra a ChatGPT. Manteniu aquesta pestanya oberta.
Copieu el secret de webhook generat si es mostra durant la configuració.
Exemple d'URL de retorn de trucada: https://chatgpt.com/connector/oauth/<callback_id>
No elimineu l'ID de retorn de trucada, no afegiu una barra final ni el substituïu per un URL genèric de ChatGPT.
Creeu la GitHub App a GitHub Enterprise
Obriu el vostre amfitrió de GitHub Enterprise, com ara
https://github.example.com.Aneu a l'organització o al compte que ha de ser propietari de l'aplicació.
Obriu Configuració > Configuració de desenvolupador > GitHub Apps.
Seleccioneu Nova GitHub App.
Introduïu un nom clar per a l'aplicació, com ara ChatGPT GitHub Enterprise Connector.
Introduïu un URL de pàgina d'inici. Si no hi ha cap pàgina interna dedicada, utilitzeu l'URL de l'organització de GitHub Enterprise.
A URL de retorn de trucada, enganxeu l'URL de retorn de trucada exacte copiat de ChatGPT.
Manteniu activat Expira els segments d'autorització d'usuari tret que el vostre equip de seguretat tingui un motiu concret per canviar-ho.
Activeu Sol·licita autorització d'usuari durant la instal·lació perquè els usuaris puguin autoritzar l'aplicació durant el flux d'instal·lació o connexió.
A l'apartat On es pot instal·lar aquesta GitHub App, trieu l'opció més restrictiva que s'ajusti al vostre desplegament.
Creeu la GitHub App.
Configureu permisos i esdeveniments
Trieu els permisos mínims necessaris per a les accions de ChatGPT que teniu previst activar.
Per a la descoberta de repositoris i les preguntes i respostes només de lectura, comenceu amb permisos de lectura com ara:
Metadades: només lectura. GitHub requereix metadades per a GitHub Apps.
Continguts: només lectura, per accedir al contingut de fitxers i repositoris.
Incidències: només lectura, si cal cercar o llegir incidències.
Sol·licituds d'extracció: només lectura, si cal cercar sol·licituds d'extracció o context de revisió.
Accions: només lectura, si calen l'estat d'execució de fluxos de treball, tasques, registres o artefactes.
Per als fluxos de treball d'escriptura, afegiu permisos d'escriptura només on calgui, com ara Continguts, Sol·licituds d'extracció, Incidències, Accions o Fluxos de treball. Utilitzeu els permisos més restrictius que admetin les accions de ChatGPT previstes.
Els esdeveniments de webhook han de coincidir amb els fluxos de treball que admeteu. Els esdeveniments habituals inclouen Instal·lació, Repositoris d'instal·lació, Inserció, Sol·licitud d'extracció, Incidències, Comentari d'incidència, Execució de flux de treball i Tasca de flux de treball.
Genereu i copieu les credencials de la GitHub App
A la configuració de la GitHub App, copieu l'ID de client.
Genereu un secret de client i copieu-lo immediatament.
A Claus privades, genereu una clau privada.
Baixeu el fitxer .pem i deseu-lo de manera segura.
Obriu el fitxer .pem localment i copieu el text PEM complet, incloses les línies d'inici i final.
La clau privada és sensible. Tracteu-la com una credencial. Si queda exposada, genereu una clau privada nova, actualitzeu la configuració de l'aplicació a ChatGPT i suprimiu la clau compromesa a GitHub Enterprise.
Finalitzeu la configuració a ChatGPT
Torneu a la pestanya de configuració de la plantilla de ChatGPT.
Enganxeu l'ID de client de la GitHub App a ID de client OAuth.
Enganxeu el secret de client de la GitHub App a secret de client OAuth.
Deixeu Àmbits sense canvis tret que la vostra organització necessiti substituir intencionadament els valors per defecte de la plantilla.
Confirmeu que el nom d'amfitrió de GitHub Enterprise només és el nom d'amfitrió, com ara
github.example.com.Enganxeu o carregueu el PEM de la clau privada de la GitHub App a Clau privada de la GitHub App.
Confirmeu que el secret de webhook generat hi és present.
Creeu l'aplicació en esborrany.
Obriu els detalls de l'aplicació en esborrany creada a ChatGPT i copieu l'URL de webhook generat.
L'URL de webhook hauria de tenir aquest aspecte: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Finalitzeu la configuració del webhook a GitHub Enterprise
Torneu a la configuració de la GitHub App a GitHub Enterprise.
Obriu la configuració general de la GitHub App.
Activeu els webhooks actius si encara no estan activats.
Enganxeu l'URL de webhook de ChatGPT a URL de webhook.
Enganxeu el secret de webhook de ChatGPT a Secret de webhook.
Manteniu activada la verificació SSL.
Confirmeu que els esdeveniments de webhook subscrits coincideixen amb els permisos i les accions que heu activat.
Deseu els canvis.
Publiqueu i gestioneu l'aplicació a ChatGPT
Crear l'aplicació en esborrany no la posa automàticament a disposició dels membres. Després de revisar l'esborrany:
Publiqueu l'aplicació en esborrany.
Confirmeu que l'aplicació apareix a Configuració de l'espai de treball > Aplicacions > Activades.
Configureu Accés d'usuari per als rols que l'han d'utilitzar.
Reviseu Control d'accions per a les accions de lectura i escriptura.
Reviseu Permisos de l'aplicació per triar quan ChatGPT demana als membres abans d'utilitzar l'aplicació.
Demaneu a un usuari de prova autoritzat que obri Aplicacions a ChatGPT i confirmi que l'aplicació apareix.
Aquests permisos d'aplicació s'apliquen a les converses de ChatGPT. Els agents d'espai de treball utilitzen controls per agent definits pel creador de l'agent per determinar quines accions de l'aplicació estan disponibles i quan es demana als usuaris finals que les aprovin. Per al comportament dels agents, consulteu: Agents d'espai de treball de ChatGPT per a Enterprise i Business.
Instal·leu i proveu la GitHub App
A GitHub Enterprise, instal·leu l'aplicació de GitHub a l'organització o al compte.
Trieu tots els repositoris o els repositoris seleccionats segons la política de l'espai de treball.
Inicieu el flux de connexió des de ChatGPT com a usuari autoritzat.
Autoritzeu l'aplicació de GitHub quan se us demani.
Executeu primer una petita acció de lectura, com ara llistar repositoris accessibles o obtenir una sol·licitud d'extracció coneguda.
Si les accions d'escriptura estan activades, proveu-les amb un repositori de baix risc abans d'un desplegament més ampli.
Nom d'amfitrió i comportament d'OAuth
ChatGPT utilitza el nom d'amfitrió per derivar els punts finals de GitHub Enterprise. Introduïu només l'amfitrió, com ara github.example.com o octocorp.ghe.com.
No introduïu cap camí d'API, cap camí de repositori ni github.com tret que sigui l'amfitrió exacte de GitHub Enterprise per a aquesta aplicació.
Resolució de problemes
No coincideix l'URI de redirecció: confirmeu que l'URL de retorn de trucada de la GitHub App coincideix exactament amb l'URL de retorn de trucada que es mostra a ChatGPT.
ChatGPT no pot crear ni desar l'aplicació en esborrany: confirmeu que tots els camps obligatoris hi són, inclosos el nom d'amfitrió, l'ID de client OAuth, el secret de client OAuth, la clau privada i el secret de webhook.
L'autenticació es completa correctament però les trucades al repositori fallen: confirmeu que la GitHub App està instal·lada i té accés al repositori.
L'API retorna 403 o permisos insuficients: afegiu el permís de GitHub App que falta i feu que el propietari de la instal·lació aprovi els permisos actualitzats si se li demana.
No apareix cap repositori: confirmeu que la instal·lació de l'aplicació inclou els repositoris esperats i que l'usuari que autoritza a ChatGPT hi té accés.
Les entregues de webhook fallen: confirmeu que l'URL de webhook i el secret de webhook coincideixen amb els valors de ChatGPT, manteniu activada la verificació SSL i assegureu-vos que l'amfitrió de GitHub Enterprise pot arribar a
connectors.api.openai.org.Errors de clau privada: confirmeu que s'ha copiat tot el contingut PEM, incloses les línies d'inici i final.