OpenAI
Tämä sivu on konekäännetty. Katso alkuperäinen englanninkielinen artikkeli.

Määritä GitHub Enterprise -sovellusmalli ChatGPT:ssä

Lue, miten työtilan järjestelmänvalvojat voivat määrittää GitHub Enterprise -sovellusmallin ChatGPT:ssä organisaationsa omalla GitHub Appilla.

Päivitetty: 14 days ago

Yleiskatsaus

Tämä opas on tarkoitettu ChatGPT-työtilan ylläpitäjille, jotka määrittävät GitHub Enterprise -sovellusmallin organisaationsa käyttöön. Malli ei ole lopullinen sovellus, jota jäsenet käyttävät. Se on ohjattu määritys, joka luo työtilakohtaisen sovellusluonnoksen, kun olet antanut tarvittavat GitHub Enterprise -asetukset.

GitHub Enterprisen määrityksessä ChatGPT yhdistetään organisaatiosi GitHub Enterprise -palvelimeen. Luot GitHub App -sovelluksen, rekisteröit ChatGPT:n paluuosoitteen, luot tunnistetiedot ja liität sitten nämä arvot ChatGPT:n mallin määritykseen. Kun ChatGPT on luonut sovellusluonnoksen, voit julkaista sen ja hallita sitä muiden työtilan sovellusten tavoin.

Lisätietoja työtilassa siirtymisestä ja sovellusten käyttöoikeuksista: Laajennusten ja sovellusten ylläpitoasetukset, tietoturva ja vaatimustenmukaisuus.

Mitä olet määrittämässä

Luot ChatGPT:hen työtilakohtaisen GitHub Enterprise -sovelluksen. Sovellus käyttää seuraavia:

  • GitHub Enterprise -palvelimellesi rekisteröity GitHub App -sovellus.

  • GitHub App -sovelluksen asiakastunnus ja asiakassalaisuus käyttäjän OAuth-valtuutusta varten.

  • GitHub App -sovelluksen yksityinen avain, jonka avulla ChatGPT voi luoda asennuskohtaisia tunnuksia repositoriotoimintoja varten.

  • Webhook-salaisuus ja webhook-osoite, joiden avulla GitHub Enterprise voi lähettää asennus- ja repositoriotapahtumat takaisin ChatGPT:lle.

  • GitHub Enterprisen isäntänimi, esimerkiksi github.example.com.

Luo GitHub App -sovellus, älä erillistä GitHub OAuth App -sovellusta. ChatGPT:n mallin määritys edellyttää GitHub App -sovelluksen tunnistetietoja, yksityistä avainta ja webhook-asetuksia.

Ennen kuin aloitat

Tarvitset seuraavat:

  • ChatGPT-työtilan ylläpitäjän tai omistajan oikeudet.

  • GitHub Enterprisen ylläpitäjän tai organisaation omistajan oikeudet, joilla voi luoda ja asentaa GitHub App -sovelluksia.

  • Pelkkä GitHub Enterprisen isäntänimi ilman https://-alkua tai polkua.

  • Päätös siitä, mitä repositoriotoimintoja ChatGPT:n tulisi tukea, esimerkiksi vain lukuun perustuvaa repositoriohakua, pull request -työnkulkuja, ongelmien työnkulkuja, tiedostojen muokkauksia, GitHub Actions -toimintoja tai laajempia Codex-työnkulkuja.

  • Turvallinen paikka GitHub App -sovelluksen yksityisen avaimen ja asiakassalaisuuden käsittelyyn.

Pidä ChatGPT ja GitHub Enterprise auki eri välilehdillä. Älä keksi paluuosoitetta itse. Kopioi ChatGPT:ssä näkyvä paluuosoite täsmälleen sellaisenaan.

Valmistele tarvittavat arvot

  • GitHub Enterprisen isäntänimi: esimerkiksi github.example.com.

  • Paluuosoite: kopioi se ChatGPT:n mallin määrityksestä.

  • GitHub App -sovelluksen asiakastunnus.

  • GitHub App -sovelluksen asiakassalaisuus.

  • GitHub App -sovelluksen yksityinen avain PEM-muodossa.

  • ChatGPT:n luoma webhook-salaisuus.

  • Webhook-osoite, joka luodaan sovellusluonnoksen luomisen jälkeen ChatGPT:ssä.

Aloita mallin määritys ChatGPT:ssä

  1. Siirry ChatGPT:ssä työtilaan, jossa sovelluksen on tarkoitus olla käytettävissä.

  2. Avaa Työtilan asetukset > Sovellukset. Voit myös siirtyä hallintakonsoliin, valita haluamasi ChatGPT-työtilan ja avata Laajennukset. Avaa edelleen käytettävissä oleva Sovellukset-sivu valitsemalla Hallitse vanhoja sovelluksia.

  3. Valitse Hakemisto.

  4. Hae GitHub Enterprise.

  5. Valitse GitHub Enterprise -sovellusmalli ja aloita määritys.

  6. Anna sovellukselle selkeä nimi ja kuvaus, esimerkiksi GitHub Enterprise tai GitHub Enterprise – Kehitystiimi.

  7. Anna GitHub Enterprisen isäntänimi, esimerkiksi github.example.com.

  8. Kopioi ChatGPT:ssä näkyvä paluuosoite. Pidä tämä välilehti auki.

  9. Kopioi luotu webhook-salaisuus, jos se näkyy määrityksen aikana.

Esimerkki paluuosoitteesta: https://chatgpt.com/connector/oauth/<callback_id>

Älä poista paluuosoitteen tunnusta, lisää loppuun kauttaviivaa tai korvaa osoitetta yleisellä ChatGPT-osoitteella.

Luo GitHub App -sovellus GitHub Enterprisessa

  1. Avaa GitHub Enterprise -palvelimesi osoite, esimerkiksi https://github.example.com.

  2. Siirry organisaatioon tai tilille, jonka on tarkoitus omistaa sovellus.

  3. Avaa Asetukset > Kehittäjäasetukset > GitHub App -sovellukset.

  4. Valitse Uusi GitHub App -sovellus.

  5. Anna sovellukselle selkeä nimi, esimerkiksi ChatGPT:n GitHub Enterprise -yhdistin.

  6. Anna kotisivun URL-osoite. Jos sovellukselle ei ole omaa sisäistä sivua, käytä GitHub Enterprise -organisaation URL-osoitetta.

  7. Liitä ChatGPT:stä kopioitu paluuosoite täsmälleen sellaisenaan Paluuosoite-kenttään.

  8. Pidä Käyttäjän valtuutustunnusten vanheneminen -asetus käytössä, ellei tietoturvatiimilläsi ole erityistä syytä muuttaa sitä.

  9. Ota käyttöön Pyydä käyttäjän valtuutus asennuksen aikana, jotta käyttäjät voivat valtuuttaa sovelluksen asennuksen tai yhdistämisen yhteydessä.

  10. Kohdassa ”Mihin tämän GitHub App -sovelluksen voi asentaa?” valitse rajatuin käyttöönottoosi sopiva vaihtoehto.

  11. Luo GitHub App -sovellus.

Määritä käyttöoikeudet ja tapahtumat

Valitse vain ne käyttöoikeudet, joita käyttöön otettavat ChatGPT-toiminnot edellyttävät.

Jos tarkoituksena on vain hakea repositorioita ja vastata niitä koskeviin kysymyksiin, aloita esimerkiksi seuraavista lukuoikeuksista:

  • Metatiedot: vain luku. GitHub edellyttää GitHub App -sovelluksilta pääsyä metatietoihin.

  • Sisältö: vain luku, jotta sovellus voi lukea tiedostojen ja repositorioiden sisältöä.

  • Ongelmat: vain luku, jos ongelmia on tarpeen hakea tai lukea.

  • Pull request: vain luku, jos pull request -haku tai katselmoinnin taustatiedot ovat tarpeen.

  • Toiminnot: vain luku, jos tarvitaan työnkulkujen suoritustiloja, tehtäviä, lokeja tai artefakteja.

Lisää kirjoitusoikeuksia vain niitä tarvitseville työnkuluille, esimerkiksi kohtiin Sisältö, Pull request, Ongelmat, Toiminnot tai Työnkulut. Käytä mahdollisimman rajattuja käyttöoikeuksia, joilla halutut ChatGPT-toiminnot toimivat.

Webhook-tapahtumien tulisi vastata tuettuja työnkulkuja. Yleisiä tapahtumia ovat Asennus, Asennuksen repositoriot, Lähetys, Pull request, Ongelmat, Ongelman kommentti, Työnkulun suoritus ja Työnkulun tehtävä.

Luo ja kopioi GitHub App -sovelluksen tunnistetiedot

  1. Kopioi GitHub App -sovelluksen asetuksista Asiakastunnus.

  2. Luo Asiakassalaisuus ja kopioi se heti.

  3. Luo yksityinen avain kohdassa Yksityiset avaimet.

  4. Lataa .pem-tiedosto ja säilytä se turvallisesti.

  5. Avaa .pem-tiedosto paikallisesti ja kopioi koko PEM-teksti, myös aloitus- ja lopetusrivit.

Yksityinen avain on arkaluonteinen. Käsittele sitä kuten muitakin tunnistetietoja. Jos se paljastuu ulkopuolisille, luo uusi yksityinen avain, päivitä ChatGPT-sovelluksen määritys ja poista paljastunut avain GitHub Enterprisesta.

Viimeistele määritys ChatGPT:ssä

  1. Palaa ChatGPT:n mallin määritysvälilehdelle.

  2. Liitä GitHub App -sovelluksen asiakastunnus kenttään OAuth-asiakastunnus.

  3. Liitä GitHub App -sovelluksen asiakassalaisuus kenttään OAuth-asiakassalaisuus.

  4. Jätä Käyttöoikeusalueet ennalleen, ellei organisaatiosi nimenomaisesti tarvitse mallin oletusasetuksista poikkeavia arvoja.

  5. Varmista, että GitHub Enterprisen isäntänimi sisältää vain isäntänimen, kuten github.example.com.

  6. Liitä tai lataa GitHub App -sovelluksen yksityinen avain PEM-muodossa kenttään GitHub App -sovelluksen yksityinen avain.

  7. Varmista, että luotu webhook-salaisuus on paikallaan.

  8. Luo sovellusluonnos.

  9. Avaa luodun sovellusluonnoksen tiedot ChatGPT:ssä ja kopioi luotu webhook-osoite.

Webhook-osoitteen pitäisi olla muotoa https://connectors.api.openai.org/connectors/<connector_id>/webhook

Viimeistele webhook-määritys GitHub Enterprisessa

  1. Palaa GitHub App -sovelluksen asetuksiin GitHub Enterprisessa.

  2. Avaa GitHub App -sovelluksen yleiset asetukset.

  3. Ota Aktiiviset webhookit käyttöön, jos ne eivät vielä ole käytössä.

  4. Liitä ChatGPT:n webhook-osoite Webhook-osoite-kenttään.

  5. Liitä ChatGPT:n webhook-salaisuus Webhook-salaisuus-kenttään.

  6. Pidä SSL-varmennus käytössä.

  7. Varmista, että tilatut webhook-tapahtumat vastaavat käyttöön ottamiasi käyttöoikeuksia ja toimintoja.

  8. Tallenna muutokset.

Julkaise sovellus ja hallitse sitä ChatGPT:ssä

Sovellusluonnoksen luominen ei tuo sovellusta automaattisesti jäsenten saataville. Kun olet tarkistanut luonnoksen:

  1. Julkaise sovellusluonnos.

  2. Avaa työtilan asetuksista Sovellukset-sivu, avaa Käytössä ja varmista, että sovellus näkyy. Voit avata Sovellukset-sivun myös valitsemalla Hallintakonsoli > Laajennukset > Hallitse vanhoja sovelluksia.

  3. Määritä Käyttäjien pääsy rooleille, joiden on tarkoitus käyttää sovellusta.

  4. Tarkista luku- ja kirjoitustoimintojen Toimintojen hallinta -asetukset.

  5. Valitse Sovelluksen käyttöoikeudet -kohdasta, milloin ChatGPT pyytää jäseniltä luvan ennen sovelluksen käyttöä.

  6. Pyydä testikäyttäjää, jolla on käyttöoikeus, avaamaan ChatGPT:n sovellukset ja varmistamaan, että sovellus näkyy.

Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit käyttävät rakentajansa määrittämiä agenttikohtaisia asetuksia. Ne määrittävät, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiltä pyydetään niiden hyväksyntää. Lisätietoja agenttien toiminnasta: ChatGPT-työtilan agentit Enterprise- ja Business-asiakkaille.

Asenna ja testaa GitHub App -sovellus

  1. Asenna GitHub-sovellus organisaatiolle tai tilille GitHub Enterprisessa.

  2. Valitse kaikki repositoriot tai vain tietyt repositoriot työtilan käytännön mukaisesti.

  3. Aloita yhdistäminen ChatGPT:stä käyttäjänä, jolla on käyttöoikeus.

  4. Valtuuta GitHub-sovellus pyydettäessä.

  5. Suorita ensin pieni lukutoiminto, kuten käytettävissä olevien repositorioiden luetteloiminen tai tunnetun pull request -kohteen hakeminen.

  6. Jos kirjoitustoiminnot ovat käytössä, testaa niitä vähäriskisessä repositoriossa ennen laajempaa käyttöönottoa.

Isäntänimi ja OAuth-toiminta

ChatGPT muodostaa GitHub Enterprisen päätepisteet isäntänimen perusteella. Anna vain isäntänimi, kuten github.example.com tai octocorp.ghe.com.

Älä anna API-polkua tai repositorion polkua. Älä myöskään anna osoitetta github.com, ellei se ole juuri tämän sovelluksen GitHub Enterprise -palvelimen osoite.

Vianmääritys

  • Uudelleenohjauksen URI ei täsmää: varmista, että GitHub App -sovelluksen paluuosoite vastaa täsmälleen ChatGPT:ssä näkyvää paluuosoitetta.

  • ChatGPT ei voi luoda tai tallentaa sovellusluonnosta: varmista, että kaikki pakolliset kentät on täytetty, mukaan lukien isäntänimi, OAuth-asiakastunnus, OAuth-asiakassalaisuus, yksityinen avain ja webhook-salaisuus.

  • Todennus onnistuu, mutta repositoriokutsut epäonnistuvat: varmista, että GitHub App -sovellus on asennettu ja että sillä on pääsy repositorioon.

  • API palauttaa virheen 403 tai ilmoittaa riittämättömistä käyttöoikeuksista: lisää puuttuva GitHub App -sovelluksen käyttöoikeus ja pyydä asennuksen omistajaa hyväksymään päivitetyt käyttöoikeudet, jos hyväksyntää pyydetään.

  • Repositorioita ei näy: varmista, että sovelluksen asennus kattaa halutut repositoriot ja että ChatGPT:ssä valtuutuksen antavalla käyttäjällä on niihin pääsy.

  • Webhook-lähetykset epäonnistuvat: varmista, että webhook-osoite ja webhook-salaisuus vastaavat ChatGPT:n arvoja. Pidä SSL-varmennus käytössä ja varmista, että GitHub Enterprise -palvelin saa yhteyden osoitteeseen connectors.api.openai.org.

  • Yksityisen avaimen virheet: varmista, että koko PEM-sisältö on kopioitu, myös aloitus- ja lopetusrivit.

Lähteet

Oliko tästä artikkelista apua?