Yleiskatsaus
Käytä tätä opasta, jos olet ChatGPT-työtilan järjestelmänvalvoja ja määrität GitHubin Enterprise-sovellusmallia organisaatiollesi. Malli ei ole lopullinen sovellus, jota jäsenet käyttävät. Se on määritysvaihe, joka luo työtilakohtaisen sovellusluonnoksen, kun olet antanut vaaditun GitHub Enterprise -määrityksen.
GitHub Enterprisessa määritys yhdistää ChatGPT:n organisaatiosi GitHub Enterprise -isäntään. Luot GitHub Appin, rekisteröit ChatGPT:n takaisinkutsu-URL:n, luot tunnistetiedot ja liität sitten nämä arvot ChatGPT:n mallin määritysvaiheeseen. Kun ChatGPT on luonut sovellusluonnoksen, voit julkaista sen ja hallinnoida sitä muiden työtilan sovellusten tavoin.
Mitä olet määrittämässä
Olet luomassa työtilakohtaista GitHub Enterprise -sovellusta ChatGPT:ssä. Sovellus käyttää:
GitHub Appia, joka on rekisteröity GitHub Enterprise -isäntääsi.
GitHub Appin asiakastunnusta ja asiakassalaisuutta käyttäjän OAuth-valtuutusta varten.
GitHub Appin yksityistä avainta, jotta ChatGPT voi luoda asennustokeneita repositoriotoimintoihin.
Webhook-salaisuutta ja webhook-URL:ää, jotta GitHub Enterprise voi lähettää asennus- ja repositoriotapahtumat takaisin ChatGPT:lle.
GitHub Enterprise -isäntänimeäsi, kuten
github.example.com.
Luo GitHub App, älä erillistä GitHub OAuth Appia. ChatGPT:n mallimääritys edellyttää GitHub App -tunnistetietoja, yksityistä avainta ja webhook-asetuksia.
Ennen aloittamista
Tarvitset:
ChatGPT-työtilan järjestelmänvalvojan tai omistajan käyttöoikeuden.
GitHub Enterprise -järjestelmänvalvojan tai organisaation omistajan käyttöoikeuden, jolla voi luoda ja asentaa GitHub Appeja.
Pelkkä GitHub Enterprise -isäntänimi ilman
https://-alkua tai polkua.Päätöksen siitä, mitä repositoriotoimintoja ChatGPT:n tulee tukea, kuten vain luku -muotoista repositoriohakua, muutospyyntöjen työnkulkuja, ongelmien työnkulkuja, tiedostomuokkauksia, GitHub Actionsia tai laajempia Codex-työnkulkuja.
Turvallisen paikan GitHub Appin yksityisen avaimen ja asiakassalaisuuden käsittelyyn.
Pidä ChatGPT ja GitHub Enterprise avoinna erillisillä välilehdillä. Älä keksi takaisinkutsu-URL:ää itse. Kopioi täsmällinen ChatGPT:ssä näkyvä takaisinkutsu-URL.
Valmisteltavat arvot
GitHub Enterprise -isäntänimi: esimerkiksi
github.example.com.Takaisinkutsu-URL: kopioi tämä ChatGPT:n mallin määritysvaiheesta.
GitHub Appin asiakastunnus.
GitHub Appin asiakassalaisuus.
GitHub Appin yksityisen avaimen PEM.
ChatGPT:n luoma webhook-salaisuus.
Webhook-URL, joka luodaan, kun sovellusluonnos on luotu ChatGPT:ssä.
Aloita mallin määritys ChatGPT:ssä
Siirry ChatGPT:ssä työtilaan, jossa sovelluksen tulee olla käytettävissä.
Avaa Työtilan asetukset > Sovellukset.
Valitse Hakemisto.
Etsi GitHub Enterprise.
Valitse GitHub Enterprise -sovellusmalli ja aloita määritys.
Anna selkeä sovelluksen nimi ja kuvaus, kuten GitHub Enterprise tai GitHub Enterprise - Engineering.
Anna GitHub Enterprisen isäntänimi, kuten
github.example.com.Kopioi ChatGPT:ssä näkyvä takaisinkutsu-URL. Pidä tämä välilehti auki.
Kopioi luotu webhook-salaisuus, jos se näytetään määrityksen aikana.
Esimerkkitakaisinkutsu-URL: https://chatgpt.com/connector/oauth/<callback_id>
Älä poista takaisinkutsutunnusta, lisää loppuun kauttaviivaa tai korvaa sitä yleisellä ChatGPT-URL-osoitteella.
Luo GitHub App GitHub Enterprisessa
Avaa GitHub Enterprise -isäntäsi, kuten
https://github.example.com.Siirry organisaatioon tai tiliin, jonka tulee omistaa sovellus.
Avaa Asetukset > Kehittäjäasetukset > GitHub Apps.
Valitse Uusi GitHub App.
Anna selkeä sovelluksen nimi, kuten ChatGPT GitHub Enterprise Connector.
Anna kotisivun URL-osoite. Jos erillistä sisäistä sivua ei ole, käytä GitHub Enterprise -organisaation URL-osoitetta.
Liitä kohtaan Takaisinkutsu-URL täsmällinen ChatGPT:stä kopioitu takaisinkutsu-URL.
Pidä käyttäjän valtuutustokenien vanhentuminen käytössä, ellei tietoturvatiimillä ole erityistä syytä muuttaa sitä.
Ota käyttöön käyttäjän valtuutuksen pyytäminen asennuksen aikana, jotta käyttäjät voivat valtuuttaa sovelluksen asennus- tai yhdistämisvaiheessa.
Kohdassa Mihin tämä GitHub App voidaan asentaa?, valitse käyttöönottoosi sopiva suppein vaihtoehto.
Luo GitHub App.
Määritä käyttöoikeudet ja tapahtumat
Valitse vähimmäiskäyttöoikeudet, joita tarvitaan käyttöön otettaviin ChatGPT-toimintoihin.
Aloita vain luku -oikeuksilla, kuten seuraavilla, jos kyse on vain luku -muotoisesta repositorioiden hausta ja kysymys-vastauskäytöstä:
Metatiedot: vain luku. GitHub edellyttää metatietoja GitHub Appsille.
Sisältö: vain luku, tiedostojen ja repositorioiden sisällön käyttöä varten.
Ongelmat: vain luku, jos ongelmien haku tai lukeminen on tarpeen.
Muutospyynnöt: vain luku, jos muutospyyntöjen haku tai tarkastelukonteksti on tarpeen.
Actions: vain luku, jos työnkulun suorituksen tila, työt, lokit tai artefaktit ovat tarpeen.
Lisää kirjoitustyönkulkuihin kirjoitusoikeudet vain tarvittaviin kohteisiin, kuten sisältöön, muutospyyntöihin, ongelmiin, Actionsiin tai työnkulkuihin. Käytä suppeimpia käyttöoikeuksia, jotka tukevat aiottuja ChatGPT-toimintoja.
Webhook-tapahtumien tulee vastata tukemiasi työnkulkuja. Yleisiä tapahtumia ovat Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run ja Workflow job.
Luo ja kopioi GitHub App -tunnistetiedot
Kopioi GitHub App -asetuksista Client ID.
Luo Client secret ja kopioi se heti.
Luo yksityinen avain kohdassa Private keys.
Lataa .pem-tiedosto ja säilytä se turvallisesti.
Avaa .pem-tiedosto paikallisesti ja kopioi koko PEM-teksti, mukaan lukien alku- ja loppurivit.
Yksityinen avain on arkaluonteinen. Käsittele sitä kuin tunnistetietoa. Jos se paljastuu, luo uusi yksityinen avain, päivitä ChatGPT-sovelluksen määritys ja poista vaarantunut avain GitHub Enterprisessa.
Viimeistele määritys ChatGPT:ssä
Palaa ChatGPT:n mallin määritysvälilehdelle.
Liitä GitHub Appin Client ID kohtaan OAuth-asiakastunnus.
Liitä GitHub Appin Client secret kohtaan OAuth-asiakassalaisuus.
Jätä Scopes muuttamatta, ellei organisaatiosi tarkoituksella tarvitse ohittaa mallin oletuksia.
Varmista, että GitHub Enterprise -isäntänimi on pelkkä isäntänimi, kuten
github.example.com.Liitä tai lataa GitHub Appin yksityisen avaimen PEM GitHub Appin yksityiseen avaimeen.
Varmista, että luotu webhook-salaisuus on käytettävissä.
Luo sovellusluonnos.
Avaa luodun sovellusluonnoksen tiedot ChatGPT:ssä ja kopioi luotu webhook-URL.
Webhook-URL:n tulisi näyttää tältä: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Viimeistele webhook-määritys GitHub Enterprisessa
Palaa GitHub App -asetuksiin GitHub Enterprisessa.
Avaa GitHub Appin yleiset asetukset.
Ota aktiiviset webhookit käyttöön, jos ne eivät ole jo käytössä.
Liitä ChatGPT:n webhook-URL kohtaan Webhook URL.
Liitä ChatGPT:n webhook-salaisuus kohtaan Webhook secret.
Pidä SSL-vahvistus käytössä.
Varmista, että tilatut webhook-tapahtumat vastaavat käyttöoikeuksia ja toimintoja, jotka otit käyttöön.
Tallenna muutokset.
Julkaise ja hallinnoi sovellusta ChatGPT:ssä
Sovellusluonnoksen luominen ei automaattisesti aseta sitä jäsenten saataville. Kun olet tarkistanut luonnoksen:
Julkaise sovellusluonnos.
Varmista, että sovellus näkyy kohdassa Työtilan asetukset > Sovellukset > Käytössä.
Määritä Käyttäjien käyttöoikeus rooleille, joiden tulee käyttää sitä.
Tarkista luku- ja kirjoitustoimintojen Toimintojen hallinta.
Tarkista Sovelluksen käyttöoikeudet ja valitse, milloin ChatGPT kysyy jäseniltä ennen sovelluksen käyttöä.
Pyydä sallittua testikäyttäjää avaamaan Sovellukset ChatGPT:ssä ja varmistamaan, että sovellus näkyy.
Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit käyttävät agentin rakentajan määrittämiä agenttikohtaisia hallinta-asetuksia sen määrittämiseen, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiä pyydetään hyväksymään ne. Lisätietoja agentin toiminnasta: ChatGPT:n työtilan agentit Enterprise- ja Business-versioille.
Asenna ja testaa GitHub App
Asenna GitHub-sovellus organisaatioon tai tilille GitHub Enterprisessa.
Valitse kaikki repositoriot tai valitut repositoriot työtilan käytännön mukaisesti.
Aloita yhdistämisvaihe ChatGPT:stä sallittuna käyttäjänä.
Valtuuta GitHub-sovellus pyydettäessä.
Suorita ensin pieni lukutoiminto, kuten käytettävissä olevien repositorioiden luettelointi tai tunnetun muutospyynnön noutaminen.
Jos kirjoitustoiminnot ovat käytössä, testaa vähäriskisellä repositoriolla ennen laajempaa käyttöönottoa.
Isäntänimi ja OAuth-toiminta
ChatGPT johtaa GitHub Enterprise -endpointit isäntänimen perusteella. Anna vain isäntä, kuten github.example.com tai octocorp.ghe.com.
Älä anna API-polkua, repositoriopolkua tai github.com-osoitetta, ellei se ole tämän sovelluksen täsmällinen GitHub Enterprise -isäntä.
Vianmääritys
Uudelleenohjauksen URI ei täsmää: varmista, että GitHub Appin takaisinkutsu-URL vastaa täsmälleen ChatGPT:ssä näkyvää takaisinkutsu-URL:ää.
ChatGPT ei voi luoda tai tallentaa sovellusluonnosta: varmista, että kaikki vaaditut kentät ovat täytettyinä, mukaan lukien isäntänimi, OAuth-asiakastunnus, OAuth-asiakassalaisuus, yksityinen avain ja webhook-salaisuus.
Todennus onnistuu, mutta repositoriokutsut epäonnistuvat: varmista, että GitHub App on asennettu ja että sillä on pääsy repositorioon.
API palauttaa 403-virheen tai riittämättömät käyttöoikeudet: lisää puuttuva GitHub App -käyttöoikeus ja pyydä asennuksen omistajaa hyväksymään päivitetyt käyttöoikeudet, jos niitä pyydetään.
Repositorioita ei näy: varmista, että sovelluksen asennus sisältää odotetut repositoriot ja että ChatGPT:ssä valtuuttavalla käyttäjällä on pääsy niihin.
Webhook-toimitukset epäonnistuvat: varmista, että webhook-URL ja webhook-salaisuus vastaavat ChatGPT:n arvoja, pidä SSL-vahvistus käytössä ja varmista, että GitHub Enterprise -isäntä voi tavoittaa osoitteen
connectors.api.openai.org.Yksityisen avaimen virheet: varmista, että koko PEM-sisältö kopioitiin, mukaan lukien alku- ja loppurivit.