OpenAI
Ta stran je bila strojno prevedena. Oglejte si izvirni članek v angleščini.

Nastavitev predloge aplikacije GitHub Enterprise v ChatGPT

Preberite, kako lahko skrbniki delovnega prostora konfigurirajo predlogo aplikacije GitHub Enterprise v ChatGPT z lastno GitHub App svoje organizacije.

Posodobljeno: 7 days ago

Pregled

Ta vodnik uporabite, če ste skrbnik delovnega prostora ChatGPT in nastavljate predlogo aplikacije GitHub Enterprise za svojo organizacijo. Predloga ni končna aplikacija, ki jo uporabljajo člani. Gre za postopek nastavitve, ki ustvari osnutek aplikacije za posamezni delovni prostor, ko vnesete zahtevane konfiguracijske podatke za GitHub Enterprise.

Pri nastavitvi za GitHub Enterprise se ChatGPT poveže z gostiteljem GitHub Enterprise vaše organizacije. Ustvarite aplikacijo GitHub, registrirate URL povratnega klica za ChatGPT in ustvarite poverilnice, nato pa te vrednosti prilepite v postopek nastavitve predloge v ChatGPT. Ko ChatGPT ustvari osnutek aplikacije, ga lahko objavite in upravljate kot druge aplikacije delovnega prostora.

Za informacije o krmarjenju po delovnem prostoru in dostopu do aplikacij glejte: Skrbniški nadzor, varnost in skladnost za vtičnike in aplikacije.

Kaj nastavljate

V ChatGPT ustvarjate aplikacijo GitHub Enterprise za posamezni delovni prostor. Aplikacija uporablja:

  • Aplikacijo GitHub, registrirano na vašem gostitelju GitHub Enterprise.

  • ID in skrivnost odjemalca aplikacije GitHub za avtorizacijo uporabnikov prek OAuth.

  • Zasebni ključ aplikacije GitHub, s katerim lahko ChatGPT ustvarja namestitvene žetone za operacije v repozitorijih.

  • Skrivnost in URL spletnega kavlja, da lahko GitHub Enterprise pošilja dogodke o namestitvah in repozitorijih nazaj v ChatGPT.

  • Ime vašega gostitelja GitHub Enterprise, na primer github.example.com.

Ustvarite aplikacijo GitHub, ne samostojne aplikacije GitHub OAuth. Za nastavitev predloge v ChatGPT potrebujete poverilnice aplikacije GitHub, zasebni ključ in nastavitve spletnega kavlja.

Preden začnete

Potrebujete:

  • Dostop skrbnika ali lastnika delovnega prostora ChatGPT.

  • Dostop skrbnika GitHub Enterprise ali lastnika organizacije, ki omogoča ustvarjanje in nameščanje aplikacij GitHub.

  • Samo ime gostitelja GitHub Enterprise, brez https:// ali poti.

  • Odločitev o tem, katera dejanja v repozitorijih naj ChatGPT podpira, na primer iskanje po repozitorijih samo za branje, delovne tokove za zahteve pull request, delovne tokove za težave, urejanje datotek, GitHub Actions ali širše delovne tokove Codex.

  • Varno mesto za ravnanje z zasebnim ključem in skrivnostjo odjemalca aplikacije GitHub.

ChatGPT in GitHub Enterprise pustite odprta v ločenih zavihkih. URL-ja povratnega klica si ne izmišljajte. Kopirajte natančen URL povratnega klica, prikazan v ChatGPT.

Vrednosti, ki jih morate pripraviti

  • Ime gostitelja GitHub Enterprise: na primer github.example.com.

  • URL povratnega klica: kopirajte ga iz postopka nastavitve predloge v ChatGPT.

  • ID odjemalca aplikacije GitHub.

  • Skrivnost odjemalca aplikacije GitHub.

  • Zasebni ključ aplikacije GitHub v obliki PEM.

  • Skrivnost spletnega kavlja, ki jo ustvari ChatGPT.

  • URL spletnega kavlja, ustvarjen po tem, ko v ChatGPT ustvarite osnutek aplikacije.

Začnite nastavljati predlogo v ChatGPT

  1. V ChatGPT preklopite v delovni prostor, v katerem naj bo aplikacija na voljo.

  2. Odprite Nastavitve delovnega prostora > Aplikacije. Lahko tudi odprete Skrbniško konzolo, izberete želeni delovni prostor ChatGPT in odprete Vtičnike. Izberite Upravljanje starejših aplikacij, da odprete ohranjeno stran Aplikacije.

  3. Izberite Imenik.

  4. Poiščite GitHub Enterprise.

  5. Izberite predlogo aplikacije GitHub Enterprise in začnite nastavitev.

  6. Vnesite jasno ime in opis aplikacije, na primer GitHub Enterprise ali GitHub Enterprise – Razvoj.

  7. Vnesite ime gostitelja GitHub Enterprise, na primer github.example.com.

  8. Kopirajte URL povratnega klica, prikazan v ChatGPT. Ta zavihek pustite odprt.

  9. Kopirajte ustvarjeno skrivnost spletnega kavlja, če se prikaže med nastavitvijo.

Primer URL-ja povratnega klica: https://chatgpt.com/connector/oauth/<callback_id>

Ne odstranite ID-ja povratnega klica, ne dodajajte poševnice na koncu in URL-ja ne zamenjajte s splošnim URL-jem za ChatGPT.

Ustvarite aplikacijo GitHub v GitHub Enterprise

  1. Odprite svojega gostitelja GitHub Enterprise, na primer https://github.example.com.

  2. Pojdite v organizacijo ali račun, ki naj bo lastnik aplikacije.

  3. Odprite Nastavitve > Nastavitve za razvijalce > Aplikacije GitHub.

  4. Izberite Nova aplikacija GitHub.

  5. Vnesite jasno ime aplikacije, na primer Povezovalnik ChatGPT za GitHub Enterprise.

  6. Vnesite URL domače strani. Če ni namenske interne strani, uporabite URL organizacije v GitHub Enterprise.

  7. V polje URL povratnega klica prilepite natančen URL povratnega klica, ki ste ga kopirali iz ChatGPT.

  8. Možnost Potek veljavnosti žetonov za avtorizacijo uporabnikov pustite omogočeno, razen če ima vaša varnostna ekipa poseben razlog za spremembo.

  9. Omogočite možnost Zahtevaj avtorizacijo uporabnika med namestitvijo, da lahko uporabniki odobrijo dostop aplikaciji med postopkom namestitve ali povezovanja.

  10. V razdelku Kje je mogoče namestiti to aplikacijo GitHub?, izberite najožjo možnost, ki ustreza vaši uvedbi.

  11. Ustvarite aplikacijo GitHub.

Nastavite dovoljenja in dogodke

Izberite najmanjši nabor dovoljenj, potrebnih za dejanja v ChatGPT, ki jih nameravate omogočiti.

Za iskanje repozitorijev in odgovarjanje na vprašanja z dostopom samo za branje začnite z dovoljenji za branje, kot so:

  • Metapodatki: samo za branje. GitHub za aplikacije GitHub zahteva dostop do metapodatkov.

  • Vsebina: samo za branje, za dostop do datotek in vsebine repozitorija.

  • Težave: samo za branje, če je potrebno iskanje ali branje težav.

  • Zahteve pull request: samo za branje, če je potrebno iskanje zahtev pull request ali kontekst za njihov pregled.

  • Dejanja: samo za branje, če potrebujete stanje izvajanja delovnih tokov, opravila, dnevnike ali artefakte.

Za delovne tokove s pisanjem dodajte dovoljenja za pisanje samo tam, kjer so potrebna, na primer za Vsebino, Zahteve pull request, Težave, Dejanja ali Delovne tokove. Uporabite najožji obseg dovoljenj, ki podpira predvidena dejanja v ChatGPT.

Dogodki spletnega kavlja naj ustrezajo delovnim tokovom, ki jih podpirate. Pogosti dogodki vključujejo Namestitev, Repozitorije namestitve, Potiskanje, Zahtevo pull request, Težave, Komentar težave, Izvajanje delovnega toka in Opravilo delovnega toka.

Ustvarite in kopirajte poverilnice aplikacije GitHub

  1. V nastavitvah aplikacije GitHub kopirajte ID odjemalca.

  2. Ustvarite Skrivnost odjemalca in jo takoj kopirajte.

  3. V razdelku Zasebni ključi ustvarite zasebni ključ.

  4. Prenesite datoteko .pem in jo varno shranite.

  5. Datoteko .pem odprite v svoji napravi in kopirajte celotno besedilo PEM, vključno z začetno in končno vrstico.

Zasebni ključ je občutljiv podatek. Z njim ravnajte kot s poverilnico. Če je razkrit, ustvarite nov zasebni ključ, posodobite nastavitev aplikacije v ChatGPT in izbrišite kompromitirani ključ v GitHub Enterprise.

Dokončajte nastavitev v ChatGPT

  1. Vrnite se na zavihek za nastavitev predloge v ChatGPT.

  2. ID odjemalca aplikacije GitHub prilepite v polje ID odjemalca OAuth.

  3. Skrivnost odjemalca aplikacije GitHub prilepite v polje Skrivnost odjemalca OAuth.

  4. Polje Obsegi pustite nespremenjeno, razen če mora vaša organizacija namenoma preglasiti privzete nastavitve predloge.

  5. Preverite, ali je v polju za ime gostitelja GitHub Enterprise navedeno samo ime gostitelja, na primer github.example.com.

  6. Zasebni ključ aplikacije GitHub v obliki PEM prilepite ali naložite v polje Zasebni ključ aplikacije GitHub.

  7. Preverite, ali je ustvarjena skrivnost spletnega kavlja vnesena.

  8. Ustvarite osnutek aplikacije.

  9. V ChatGPT odprite podrobnosti ustvarjenega osnutka aplikacije in kopirajte ustvarjeni URL spletnega kavlja.

URL spletnega kavlja mora biti v tej obliki: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Dokončajte nastavitev spletnega kavlja v GitHub Enterprise

  1. Vrnite se v nastavitve aplikacije GitHub v GitHub Enterprise.

  2. Odprite Splošne nastavitve aplikacije GitHub.

  3. Omogočite Aktivne spletne kavlje, če še niso omogočeni.

  4. URL spletnega kavlja iz ChatGPT prilepite v polje URL spletnega kavlja.

  5. Skrivnost spletnega kavlja iz ChatGPT prilepite v polje Skrivnost spletnega kavlja.

  6. Preverjanje SSL pustite omogočeno.

  7. Preverite, ali dogodki spletnega kavlja, na katere ste naročeni, ustrezajo dovoljenjem in dejanjem, ki ste jih omogočili.

  8. Shranite spremembe.

Objavite in upravljajte aplikacijo v ChatGPT

Ko ustvarite osnutek aplikacije, ta še ni samodejno na voljo članom. Po pregledu osnutka:

  1. Objavite osnutek aplikacije.

  2. V nastavitvah delovnega prostora odprite stran Aplikacije, nato Omogočene in preverite, ali je aplikacija prikazana. Stran Aplikacije lahko odprete tudi prek možnosti Upravljanje starejših aplikacij v razdelku Skrbniška konzola > Vtičniki.

  3. Nastavite Uporabniški dostop za vloge, ki naj aplikacijo uporabljajo.

  4. Preglejte Nadzor dejanj za dejanja branja in pisanja.

  5. Preglejte Dovoljenja aplikacije in izberite, kdaj naj ChatGPT pred uporabo aplikacije vpraša člane za dovoljenje.

  6. Prosite testnega uporabnika z dovoljenim dostopom, naj odpre Aplikacije v ChatGPT in preveri, ali je aplikacija prikazana.

Ta dovoljenja aplikacije veljajo za pogovore v ChatGPT. Agenti delovnega prostora uporabljajo nastavitve nadzora za posameznega agenta, ki jih določi njegov ustvarjalec. Te določajo, katera dejanja aplikacije so na voljo in kdaj morajo končni uporabniki odobriti njihovo izvedbo. Za informacije o delovanju agentov glejte: Agenti delovnega prostora ChatGPT za Enterprise in Business.

Namestite in preizkusite aplikacijo GitHub

  1. V GitHub Enterprise namestite aplikacijo GitHub za organizacijo ali račun.

  2. V skladu s pravilnikom delovnega prostora izberite vse repozitorije ali le izbrane.

  3. Kot uporabnik z dovoljenim dostopom začnite postopek povezovanja v ChatGPT.

  4. Ko se prikaže poziv, odobrite dostop aplikaciji GitHub.

  5. Najprej izvedite manjše dejanje branja, na primer izpis dostopnih repozitorijev ali pridobivanje znane zahteve pull request.

  6. Če so omogočena dejanja pisanja, jih pred širšo uvedbo preizkusite v repozitoriju, kjer je tveganje majhno.

Ime gostitelja in delovanje OAuth

ChatGPT na podlagi imena gostitelja določi končne točke GitHub Enterprise. Vnesite samo ime gostitelja, na primer github.example.com ali octocorp.ghe.com.

Ne vnašajte poti API-ja, poti repozitorija ali github.com, razen če je to točno ime gostitelja GitHub Enterprise za to aplikacijo.

Odpravljanje težav

  • Neujemanje preusmeritvenega URI-ja: preverite, ali se URL povratnega klica aplikacije GitHub natančno ujema z URL-jem povratnega klica, prikazanim v ChatGPT.

  • ChatGPT ne more ustvariti ali shraniti osnutka aplikacije: preverite, ali so izpolnjena vsa obvezna polja, vključno z imenom gostitelja, poljema ID odjemalca OAuth in Skrivnost odjemalca OAuth, zasebnim ključem in skrivnostjo spletnega kavlja.

  • Preverjanje pristnosti uspe, klici repozitorija pa ne: preverite, ali je aplikacija GitHub nameščena in ima dostop do repozitorija.

  • API vrne napako 403 ali sporočilo o nezadostnih dovoljenjih: dodajte manjkajoče dovoljenje za aplikacijo GitHub in po potrebi prosite lastnika namestitve, naj odobri posodobljena dovoljenja.

  • Repozitoriji niso prikazani: preverite, ali namestitev aplikacije vključuje pričakovane repozitorije in ali ima uporabnik, ki odobri dostop v ChatGPT, dostop do njih.

  • Dostava prek spletnega kavlja ne uspe: preverite, ali se URL in skrivnost spletnega kavlja ujemata z vrednostma iz ChatGPT, pustite preverjanje SSL omogočeno in se prepričajte, da gostitelj GitHub Enterprise lahko doseže connectors.api.openai.org.

  • Napake zasebnega ključa: preverite, ali ste kopirali celotno vsebino PEM, vključno z začetno in končno vrstico.

Viri

Ali vam je bil ta članek v pomoč?