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: 6 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. To je potek nastavitve, ki ustvari osnutek aplikacije za določen delovni prostor, ko navedete zahtevano konfiguracijo GitHub Enterprise.

Za GitHub Enterprise nastavitev poveže ChatGPT z gostiteljem GitHub Enterprise vaše organizacije. Ustvarite GitHub App, registrirate URL povratnega klica ChatGPT, ustvarite poverilnice in nato te vrednosti prilepite v potek nastavitve predloge ChatGPT. Ko ChatGPT ustvari osnutek aplikacije, ga lahko objavite in upravljate kot druge aplikacije delovnega prostora.

Kaj nastavljate

V ChatGPT ustvarjate aplikacijo GitHub Enterprise za določen delovni prostor. Aplikacija uporablja:

  • GitHub App, registrirano pri vašem gostitelju GitHub Enterprise.

  • ID odjemalca in skrivnost odjemalca GitHub App za uporabniško avtorizacijo OAuth.

  • Zasebni ključ GitHub App, da lahko ChatGPT izdaja namestitvene žetone za operacije v repozitoriju.

  • Skrivnost webhooka in URL webhooka, da lahko GitHub Enterprise pošilja dogodke namestitve in repozitorija nazaj v ChatGPT.

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

Ustvarite GitHub App, ne samostojne aplikacije GitHub OAuth App. Nastavitev predloge ChatGPT zahteva poverilnice GitHub App, zasebni ključ in nastavitve webhooka.

Preden začnete

Potrebujete:

  • Skrbniški ali lastniški dostop do delovnega prostora ChatGPT.

  • Skrbniški dostop ali dostop lastnika organizacije v GitHub Enterprise, ki lahko ustvari in namesti GitHub Apps.

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

  • Odločitev o tem, katera dejanja repozitorija naj ChatGPT podpira, na primer iskanje repozitorijev samo za branje, poteke dela zahtev za združitev sprememb, poteke dela težav, urejanje datotek, GitHub Actions ali širše poteke dela Codex.

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

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

Vrednosti za pripravo

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

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

  • ID odjemalca GitHub App.

  • Skrivnost odjemalca GitHub App.

  • Zasebni ključ PEM GitHub App.

  • Skrivnost webhooka, ki jo ustvari ChatGPT.

  • URL webhooka, ustvarjen po ustvarjanju osnutka aplikacije v ChatGPT.

Začnite nastavitev predloge v ChatGPT

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

  2. Odprite Nastavitve delovnega prostora > 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 - Engineering.

  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 webhooka, če je prikazana med nastavitvijo.

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

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

Ustvarite GitHub App v GitHub Enterprise

  1. Odprite 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 > GitHub Apps.

  4. Izberite Nova GitHub App.

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

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

  7. V polje URL povratnega klica prilepite točen URL povratnega klica, kopiran iz ChatGPT.

  8. Pustite omogočeno potekanje žetonov za avtorizacijo uporabnikov, razen če ima vaša varnostna ekipa poseben razlog za spremembo.

  9. Omogočite zahtevo za avtorizacijo uporabnika med namestitvijo, da lahko uporabniki avtorizirajo aplikacijo med namestitvijo ali povezovanjem.

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

  11. Ustvarite GitHub App.

Konfigurirajte dovoljenja in dogodke

Izberite najmanjša dovoljenja, potrebna za dejanja ChatGPT, ki jih nameravate omogočiti.

Za odkrivanje repozitorijev samo za branje ter vprašanja in odgovore začnite z dovoljenji za branje, kot so:

  • Metapodatki: samo za branje. GitHub zahteva metapodatke za GitHub Apps.

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

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

  • Zahteve za združitev sprememb: samo za branje, če je potreben kontekst iskanja ali pregleda zahtev za združitev sprememb.

  • Dejanja: samo za branje, če potrebujete stanje zagonov potekov dela, opravila, dnevnike ali artefakte.

Za poteke dela s pisanjem dodajte dovoljenja za pisanje le tam, kjer so potrebna, na primer za vsebino, zahteve za združitev sprememb, težave, dejanja ali poteke dela. Uporabite najožja dovoljenja, ki podpirajo predvidena dejanja ChatGPT.

Dogodki webhooka se morajo ujemati s poteki dela, ki jih podpirate. Pogosti dogodki vključujejo namestitev, namestitvene repozitorije, potiskanje, zahtevo za združitev sprememb, težave, komentar težave, zagon poteka dela in opravilo poteka dela.

Ustvarite in kopirajte poverilnice GitHub App

  1. V nastavitvah GitHub App 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. Lokalno odprite datoteko .pem in kopirajte celotno besedilo PEM, vključno z začetno in končno vrstico.

Zasebni ključ je občutljiv. Obravnavajte ga kot poverilnico. Če je razkrit, ustvarite nov zasebni ključ, posodobite nastavitev aplikacije ChatGPT in izbrišite ogroženi ključ v GitHub Enterprise.

Dokončajte nastavitev v ChatGPT

  1. Vrnite se na zavihek za nastavitev predloge ChatGPT.

  2. ID odjemalca GitHub App prilepite v ID odjemalca OAuth.

  3. Skrivnost odjemalca GitHub App prilepite v skrivnost odjemalca OAuth.

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

  5. Potrdite, da je ime gostitelja GitHub Enterprise samo ime gostitelja, na primer github.example.com.

  6. Prilepite ali naložite zasebni ključ PEM za GitHub App v zasebni ključ GitHub App.

  7. Potrdite, da je ustvarjena skrivnost webhooka prisotna.

  8. Ustvarite osnutek aplikacije.

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

URL webhooka bi moral biti videti tako: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Dokončajte nastavitev webhooka v GitHub Enterprise

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

  2. Odprite splošne nastavitve GitHub App.

  3. Omogočite aktivne webhooke, če še niso omogočeni.

  4. URL webhooka ChatGPT prilepite v URL webhooka.

  5. Skrivnost webhooka ChatGPT prilepite v skrivnost webhooka.

  6. Preverjanje SSL pustite omogočeno.

  7. Potrdite, da se naročeni dogodki webhooka ujemajo z dovoljenji in dejanji, ki ste jih omogočili.

  8. Shranite spremembe.

Objavite in upravljajte aplikacijo v ChatGPT

Ustvarjanje osnutka aplikacije je članom ne da samodejno na voljo. Po pregledu osnutka:

  1. Objavite osnutek aplikacije.

  2. Potrdite, da se aplikacija prikaže v Nastavitve delovnega prostora > Aplikacije > Omogočeno.

  3. Konfigurirajte Uporabniški dostop za vloge, ki naj jo uporabljajo.

  4. Preglejte Nadzor dejanj za dejanja branja in pisanja.

  5. Preglejte Dovoljenja aplikacije, da izberete, kdaj ChatGPT pred uporabo aplikacije vpraša člane.

  6. Dovoljenemu testnemu uporabniku naročite, naj odpre Aplikacije v ChatGPT in potrdi, da se aplikacija prikaže.

Ta dovoljenja aplikacije veljajo za pogovore v ChatGPT. Agenti delovnega prostora uporabljajo kontrolnike za posameznega agenta, ki jih nastavi ustvarjalec agenta, da določijo, katera dejanja aplikacije so na voljo in kdaj so končni uporabniki pozvani, da jih odobrijo. Za vedenje agentov glejte: Agenti delovnega prostora ChatGPT za Enterprise in Business.

Namestite in preizkusite GitHub App

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

  2. Izberite vse repozitorije ali izbrane repozitorije v skladu s pravilnikom delovnega prostora.

  3. Kot dovoljen uporabnik začnite potek povezovanja iz ChatGPT.

  4. Ko ste pozvani, avtorizirajte aplikacijo GitHub.

  5. Najprej izvedite majhno dejanje branja, na primer izpis dostopnih repozitorijev ali pridobitev znane zahteve za združitev sprememb.

  6. Če so omogočena dejanja pisanja, jih pred širšo uvedbo preizkusite z repozitorijem z nizkim tveganjem.

Ime gostitelja in vedenje OAuth

ChatGPT uporablja ime gostitelja za izpeljavo končnih točk GitHub Enterprise. Vnesite samo 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čen gostitelj GitHub Enterprise za to aplikacijo.

Odpravljanje težav

  • Neujemanje URI-ja preusmeritve: potrdite, da se URL povratnega klica GitHub App natančno ujema z URL-jem povratnega klica, prikazanim v ChatGPT.

  • ChatGPT ne more ustvariti ali shraniti osnutka aplikacije: potrdite, da so prisotna vsa obvezna polja, vključno z imenom gostitelja, ID-jem odjemalca OAuth, skrivnostjo odjemalca OAuth, zasebnim ključem in skrivnostjo webhooka.

  • Preverjanje pristnosti uspe, vendar klici repozitorija ne uspejo: potrdite, da je GitHub App nameščena in ima dostop do repozitorija.

  • API vrne 403 ali nezadostna dovoljenja: dodajte manjkajoče dovoljenje GitHub App in naj lastnik namestitve odobri posodobljena dovoljenja, če je pozvan.

  • Repozitoriji se ne prikažejo: potrdite, da namestitev aplikacije vključuje pričakovane repozitorije in da ima uporabnik, ki avtorizira v ChatGPT, dostop do njih.

  • Dostave webhooka ne uspejo: potrdite, da se URL webhooka in skrivnost webhooka ujemata z vrednostmi iz ChatGPT, pustite preverjanje SSL omogočeno in zagotovite, da lahko gostitelj GitHub Enterprise doseže connectors.api.openai.org.

  • Napake zasebnega ključa: potrdite, da je bila kopirana celotna vsebina PEM, vključno z začetno in končno vrstico.

Reference

Ali vam je bil ta članek v pomoč?