Prezentare generală
Folosește acest ghid dacă ești administrator al unui spațiu de lucru ChatGPT și configurezi șablonul de aplicație GitHub Enterprise pentru organizația ta. Șablonul nu este aplicația finală pe care o folosesc membrii. Acesta oferă un proces de configurare care creează o aplicație în versiune preliminară, specifică spațiului de lucru, după ce furnizezi configurația GitHub Enterprise necesară.
În cazul GitHub Enterprise, configurarea conectează ChatGPT la gazda GitHub Enterprise a organizației tale. Creezi o aplicație GitHub, înregistrezi URL-ul de callback ChatGPT, generezi datele de autentificare, apoi lipești aceste valori în procesul de configurare a șablonului din ChatGPT. După ce ChatGPT creează aplicația în versiune preliminară, o poți publica și gestiona la fel ca pe celelalte aplicații din spațiul de lucru.
Pentru navigarea în spațiul de lucru și accesul la aplicații, consultă: Controale de administrare, securitate și conformitate pentru pluginuri și aplicații.
Ce configurezi
Creezi în ChatGPT o aplicație GitHub Enterprise specifică spațiului de lucru. Aplicația folosește:
O aplicație GitHub înregistrată pe gazda ta GitHub Enterprise.
ID-ul de client și secretul de client ale aplicației GitHub pentru autorizarea utilizatorilor prin OAuth.
Cheia privată a aplicației GitHub, pentru ca ChatGPT să poată genera tokenuri de instalare pentru operațiuni asupra depozitelor.
Un secret de webhook și un URL de webhook, pentru ca GitHub Enterprise să poată trimite către ChatGPT evenimente legate de instalare și de depozite.
Numele gazdei tale GitHub Enterprise, de exemplu
github.example.com.
Creează o aplicație GitHub, nu o aplicație GitHub OAuth de sine stătătoare. Configurarea șablonului ChatGPT necesită datele de autentificare ale aplicației GitHub, o cheie privată și setări de webhook.
Înainte să începi
Ai nevoie de:
Acces de administrator sau proprietar al spațiului de lucru ChatGPT.
Acces de administrator GitHub Enterprise sau de proprietar al organizației, cu dreptul de a crea și instala aplicații GitHub.
Doar numele gazdei GitHub Enterprise, fără
https://sau o cale.O decizie privind acțiunile asupra depozitelor pe care ChatGPT ar trebui să le permită, cum ar fi căutarea în depozite cu acces doar pentru citire, fluxuri de lucru cu pull request-uri, fluxuri de lucru cu tichete, editări de fișiere, GitHub Actions sau fluxuri de lucru Codex mai ample.
Un mediu securizat pentru gestionarea cheii private și a secretului de client ale aplicației GitHub.
Păstrează ChatGPT și GitHub Enterprise deschise în file separate. Nu inventa URL-ul de callback. Copiază exact URL-ul de callback afișat în ChatGPT.
Valori de pregătit
Numele gazdei GitHub Enterprise: de exemplu,
github.example.com.URL de callback: copiază-l din procesul de configurare a șablonului ChatGPT.
ID-ul de client al aplicației GitHub.
Secretul de client al aplicației GitHub.
Cheia privată a aplicației GitHub în format PEM.
Secretul de webhook generat de ChatGPT.
URL-ul de webhook generat după crearea aplicației în versiune preliminară în ChatGPT.
Începe configurarea șablonului în ChatGPT
În ChatGPT, comută la spațiul de lucru în care vrei să fie disponibilă aplicația.
Deschide Setările spațiului de lucru > Aplicații. Poți și să accesezi Consola de administrare, să selectezi spațiul de lucru ChatGPT dorit și să deschizi Pluginuri. Selectează Gestionează aplicațiile vechi pentru a deschide pagina Aplicații păstrată din versiunea anterioară.
Selectează Catalog.
Caută GitHub Enterprise.
Selectează șablonul de aplicație GitHub Enterprise și începe configurarea.
Introdu un nume și o descriere clare pentru aplicație, cum ar fi GitHub Enterprise sau GitHub Enterprise - Inginerie.
Introdu numele gazdei GitHub Enterprise, de exemplu
github.example.com.Copiază URL-ul de callback afișat în ChatGPT. Păstrează această filă deschisă.
Copiază secretul de webhook generat, dacă este afișat în timpul configurării.
Exemplu de URL de callback: https://chatgpt.com/connector/oauth/<callback_id>
Nu elimina ID-ul de callback, nu adăuga o bară oblică la final și nu înlocui adresa cu un URL ChatGPT generic.
Creează aplicația GitHub în GitHub Enterprise
Accesează serverul tău GitHub Enterprise, de exemplu
https://github.example.com.Accesează organizația sau contul care ar trebui să dețină aplicația.
Deschide Setări > Setări pentru dezvoltatori > Aplicații GitHub.
Selectează Aplicație GitHub nouă.
Introdu un nume clar pentru aplicație, de exemplu ChatGPT GitHub Enterprise.
Introdu adresa URL a paginii de pornire. Dacă nu există o pagină internă dedicată, folosește adresa URL a organizației GitHub Enterprise.
În câmpul URL de callback, lipește exact adresa URL de callback copiată din ChatGPT.
Păstrează activată opțiunea Expirarea tokenurilor de autorizare a utilizatorilor, cu excepția cazului în care echipa ta de securitate are un motiv concret să o modifice.
Activează opțiunea Solicită autorizarea utilizatorului în timpul instalării, astfel încât utilizatorii să poată autoriza aplicația în timpul procesului de instalare sau conectare.
În secțiunea „Unde poate fi instalată această aplicație GitHub?”, alege opțiunea cea mai restrictivă care corespunde planului tău de implementare.
Creează aplicația GitHub.
Configurează permisiunile și evenimentele
Alege permisiunile minime necesare pentru acțiunile ChatGPT pe care intenționezi să le activezi.
Pentru descoperirea depozitelor și întrebări și răspunsuri cu acces doar pentru citire, începe cu permisiuni de citire precum:
Metadate: doar citire. GitHub impune accesul la metadate pentru aplicațiile GitHub.
Conținut: doar citire, pentru acces la fișiere și la conținutul depozitelor.
Tichete: doar citire, dacă este necesară căutarea sau citirea tichetelor.
Pull requests: doar citire, dacă este necesară căutarea de pull request-uri sau accesul la context pentru revizuire.
Acțiuni: doar citire, dacă sunt necesare starea rulărilor fluxurilor de lucru, sarcinile, jurnalele sau artefactele.
Pentru fluxurile de lucru cu operațiuni de scriere, adaugă permisiuni de scriere doar acolo unde este necesar, de exemplu pentru Conținut, Pull requests, Tichete, Acțiuni sau Fluxuri de lucru. Folosește cele mai restrictive permisiuni care permit acțiunile ChatGPT dorite.
Evenimentele webhook trebuie să corespundă fluxurilor de lucru pe care le pui la dispoziție. Printre evenimentele uzuale se numără Instalare, Depozitele instalării, Push, Pull request, Tichete, Comentariu la tichet, Rulare a fluxului de lucru și Sarcină a fluxului de lucru.
Generează și copiază datele de autentificare ale aplicației GitHub
În setările aplicației GitHub, copiază ID-ul de client.
Generează un Secret de client și copiază-l imediat.
În secțiunea Chei private, generează o cheie privată.
Descarcă fișierul .pem și păstrează-l în siguranță.
Deschide local fișierul .pem și copiază întregul text PEM, inclusiv liniile de început și de sfârșit.
Cheia privată este o informație sensibilă. Protejeaz-o la fel ca pe orice date de autentificare. Dacă este expusă, generează o cheie privată nouă, actualizează configurația aplicației din ChatGPT și șterge cheia compromisă din GitHub Enterprise.
Finalizează configurarea în ChatGPT
Revino la fila de configurare a șablonului din ChatGPT.
Lipește ID-ul de client al aplicației GitHub în ID de client OAuth.
Lipește secretul de client al aplicației GitHub în Secret de client OAuth.
Lasă Domenii de acces neschimbate, cu excepția cazului în care organizația ta are un motiv explicit pentru a înlocui valorile implicite ale șablonului.
Verifică dacă numele gazdei GitHub Enterprise conține doar numele gazdei, de exemplu
github.example.com.Lipește sau încarcă cheia privată a aplicației GitHub în format PEM în câmpul Cheie privată a aplicației GitHub.
Verifică dacă secretul de webhook generat este prezent.
Creează aplicația în versiune preliminară.
Deschide în ChatGPT detaliile aplicației create în versiune preliminară și copiază URL-ul de webhook generat.
URL-ul de webhook ar trebui să aibă forma: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Finalizează configurarea webhookului în GitHub Enterprise
Revino la setările aplicației GitHub din GitHub Enterprise.
Deschide setările generale ale aplicației GitHub.
Activează opțiunea Webhookuri active, dacă nu este deja activată.
Lipește URL-ul de webhook din ChatGPT în câmpul URL de webhook.
Lipește secretul de webhook din ChatGPT în câmpul Secret de webhook.
Păstrează verificarea SSL activată.
Verifică dacă evenimentele webhook la care te-ai abonat corespund permisiunilor și acțiunilor pe care le-ai activat.
Salvează modificările.
Publică și gestionează aplicația în ChatGPT
Crearea versiunii preliminare a aplicației nu o face automat disponibilă membrilor. După verificarea versiunii preliminare:
Publică versiunea preliminară a aplicației.
În setările spațiului de lucru, deschide pagina Aplicații, apoi secțiunea Activate și verifică dacă aplicația apare. Poți deschide pagina Aplicații și folosind opțiunea Gestionarea aplicațiilor vechi din Consola de administrare > Pluginuri.
În Enterprise și Edu, folosește Accesul utilizatorilor pentru a alege ce roluri pot utiliza aplicația. În Business, gestionează disponibilitatea aplicației la nivelul întregului spațiu de lucru.
Verifică Controlul acțiunilor pentru acțiunile de citire și scriere.
Verifică Permisiunile aplicației pentru a alege când le cere ChatGPT acordul membrilor înainte de a utiliza aplicația.
Roagă un utilizator de test cu acces autorizat să deschidă Aplicații în ChatGPT și să confirme că aplicația apare.
Aceste permisiuni ale aplicației se aplică în conversațiile ChatGPT. Agenții spațiului de lucru folosesc setări de control stabilite individual de creatorul fiecărui agent pentru a determina ce acțiuni ale aplicației sunt disponibile și când li se cere utilizatorilor finali să le aprobe. Pentru detalii despre comportamentul agenților, consultă: Agenții spațiului de lucru ChatGPT pentru Enterprise și Business.
Instalează și testează aplicația GitHub
În GitHub Enterprise, instalează aplicația GitHub pentru organizație sau cont.
Alege toate depozitele sau doar anumite depozite, conform politicii spațiului de lucru.
Începe procesul de conectare din ChatGPT folosind un cont de utilizator cu acces permis.
Autorizează aplicația GitHub când ți se solicită.
Execută mai întâi o acțiune simplă de citire, cum ar fi listarea depozitelor accesibile sau preluarea unui pull request cunoscut.
Dacă acțiunile de scriere sunt activate, testează-le pe un depozit cu risc redus înainte de a extinde utilizarea.
Numele gazdei și comportamentul OAuth
ChatGPT folosește numele gazdei pentru a determina endpointurile GitHub Enterprise. Introdu doar numele gazdei, de exemplu github.example.com sau octocorp.ghe.com.
Nu introduce o cale API, o cale către un depozit sau github.com, cu excepția cazului în care aceasta este exact gazda GitHub Enterprise pentru această aplicație.
Depanare
URI-ul de redirecționare nu corespunde: verifică dacă URL-ul de callback al aplicației GitHub este identic cu cel afișat în ChatGPT.
ChatGPT nu poate crea sau salva aplicația în versiune preliminară: verifică dacă toate câmpurile obligatorii sunt completate, inclusiv numele gazdei, ID de client OAuth, Secret de client OAuth, cheia privată și secretul de webhook.
Autentificarea reușește, dar apelurile către depozit eșuează: verifică dacă aplicația GitHub este instalată și are acces la depozit.
API-ul returnează codul 403 sau o eroare de permisiuni insuficiente: adaugă permisiunea lipsă pentru aplicația GitHub și cere proprietarului instalării să aprobe permisiunile actualizate, dacă i se solicită.
Nu apare niciun depozit: verifică dacă instalarea aplicației include depozitele dorite și dacă utilizatorul care acordă autorizarea în ChatGPT are acces la ele.
Livrările prin webhook eșuează: verifică dacă URL-ul și secretul de webhook corespund valorilor din ChatGPT, păstrează verificarea SSL activată și asigură-te că gazda GitHub Enterprise poate accesa
connectors.api.openai.org.Erori legate de cheia privată: verifică dacă ai copiat întregul conținut PEM, inclusiv liniile de început și de sfârșit.