Yfirlit
Notaðu þessa leiðbeiningu ef þú ert stjórnandi ChatGPT-vinnusvæðis að setja upp GitHub Enterprise-appsniðmátið fyrir fyrirtækið þitt. Sniðmát er ekki lokaappið sem meðlimir nota. Það er uppsetningarferli sem býr til appdrög fyrir tiltekið vinnusvæði eftir að þú gefur upp nauðsynlega GitHub Enterprise-stillingu.
Fyrir GitHub Enterprise tengir uppsetningin ChatGPT við GitHub Enterprise-hýsil fyrirtækisins þíns. Þú býrð til GitHub App, skráir bakvísunarslóð ChatGPT, myndar skilríki og límir síðan þessi gildi inn í uppsetningarferli ChatGPT-sniðmátsins. Eftir að ChatGPT býr til appdrögin geturðu birt þau og stjórnað þeim eins og öðrum vinnusvæðisöppum.
Það sem þú ert að setja upp
Þú ert að búa til GitHub Enterprise-app fyrir tiltekið vinnusvæði í ChatGPT. Appið notar:
GitHub App sem er skráð á GitHub Enterprise-hýsilnum þínum.
Client ID og client secret fyrir GitHub App fyrir OAuth-heimild notenda.
Einkalykil GitHub App svo ChatGPT geti myndað uppsetningartóka fyrir aðgerðir á geymslum.
Webhook-leyndarmál og webhook-slóð svo GitHub Enterprise geti sent uppsetningar- og geymsluatvik aftur til ChatGPT.
GitHub Enterprise-hýsilheitið þitt, svo sem
github.example.com.
Búðu til GitHub App, ekki sjálfstætt GitHub OAuth App. Uppsetning ChatGPT-sniðmátsins krefst skilríkja GitHub App, einkalykils og webhook-stillinga.
Áður en þú byrjar
Þú þarft:
Aðgang sem stjórnandi eða eigandi ChatGPT-vinnusvæðis.
Aðgang sem stjórnandi GitHub Enterprise eða eigandi fyrirtækis sem getur búið til og sett upp GitHub Apps.
Aðeins GitHub Enterprise-hýsilheitið, án
https://eða slóðar.Ákvörðun um hvaða geymsluaðgerðir ChatGPT á að styðja, svo sem skrifvarða geymsluleit, verkferli fyrir draga beiðni, verkferli mála, skráabreytingar, GitHub Actions eða víðari Codex-verkferli.
Öruggan stað til að meðhöndla einkalykil og client secret fyrir GitHub App.
Hafðu ChatGPT og GitHub Enterprise opin í aðskildum flipum. Ekki búa til bakvísunarslóðina sjálf/ur. Afritaðu nákvæmu bakvísunarslóðina sem birtist í ChatGPT.
Gildi til að undirbúa
GitHub Enterprise-hýsilheiti: til dæmis
github.example.com.Bakvísunarslóð: afritaðu hana úr uppsetningarferli ChatGPT-sniðmátsins.
Client ID fyrir GitHub App.
Client secret fyrir GitHub App.
PEM-einkalykill GitHub App.
Webhook-leyndarmál myndað af ChatGPT.
Webhook-slóð mynduð eftir að appdrögin eru búin til í ChatGPT.
Byrjaðu uppsetningu sniðmátsins í ChatGPT
Í ChatGPT skaltu skipta yfir í vinnusvæðið þar sem appið á að vera tiltækt.
Opnaðu Stillingar vinnusvæðis > Öpp.
Veldu Skrá.
Leitaðu að GitHub Enterprise.
Veldu appsniðmátið GitHub Enterprise og byrjaðu uppsetningu.
Sláðu inn skýrt heiti og lýsingu fyrir appið, svo sem GitHub Enterprise eða GitHub Enterprise - Engineering.
Sláðu inn hýsilheiti GitHub Enterprise, svo sem
github.example.com.Afritaðu bakvísunarslóðina sem birtist í ChatGPT. Haltu þessum flipa opnum.
Afritaðu myndaða webhook-leyndarmálið ef það birtist við uppsetningu.
Dæmi um bakvísunarslóð: https://chatgpt.com/connector/oauth/<callback_id>
Ekki fjarlægja bakvísunarauðkennið, bæta við skástriki aftast eða skipta því út fyrir almenna ChatGPT-slóð.
Búðu til GitHub App í GitHub Enterprise
Opnaðu GitHub Enterprise-hýsilinn þinn, svo sem
https://github.example.com.Farðu í fyrirtækið eða reikninginn sem á að eiga appið.
Opnaðu Settings > Developer settings > GitHub Apps.
Veldu New GitHub App.
Sláðu inn skýrt heiti apps, svo sem ChatGPT GitHub Enterprise Connector.
Sláðu inn heimasíðuslóð. Ef engin sérstök innri síða er til skaltu nota slóð GitHub Enterprise-fyrirtækisins.
Í Callback URL skaltu líma inn nákvæmu bakvísunarslóðina sem afrituð var úr ChatGPT.
Hafðu Expire user authorization tokens virkt nema öryggisteymið þitt hafi sérstaka ástæðu til að breyta því.
Virkjaðu Request user authorization during installation svo notendur geti heimilað appið í uppsetningar- eða tengingarferlinu.
Undir Where can this GitHub App be installed?, veldu þrengsta kostinn sem hentar innleiðingunni þinni.
Búðu til GitHub App.
Stilltu heimildir og atvik
Veldu lágmarksheimildir sem þarf fyrir ChatGPT-aðgerðirnar sem þú ætlar að virkja.
Fyrir skrifvarða uppgötvun geymslna og spurningar og svör skaltu byrja með lesheimildir, svo sem:
Metadata: skrifvarið. GitHub krefst lýsigagna fyrir GitHub Apps.
Contents: skrifvarið, fyrir aðgang að skráa- og geymsluefni.
Issues: skrifvarið, ef þörf er á leit eða lestri mála.
Pull requests: skrifvarið, ef þörf er á leit að draga beiðni eða yfirferðarsamhengi.
Actions: skrifvarið, ef þörf er á stöðu keyrslu verkferlis, verkum, annálum eða gripum.
Fyrir skrifverkferli skaltu aðeins bæta við skrifheimildum þar sem þarf, svo sem Contents, Pull requests, Issues, Actions eða Workflows. Notaðu þrengstu heimildir sem styðja fyrirhugaðar ChatGPT-aðgerðir.
Webhook-atvik ættu að samsvara verkferlunum sem þú styður. Algeng atvik eru Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run og Workflow job.
Myndaðu og afritaðu skilríki GitHub App
Í stillingum GitHub App skaltu afrita Client ID.
Myndaðu Client secret og afritaðu það strax.
Undir Private keys skaltu mynda einkalykil.
Sæktu .pem-skrána og geymdu hana á öruggan hátt.
Opnaðu .pem-skrána staðbundið og afritaðu allan PEM-textann, þar á meðal upphafs- og lokalínur.
Einkalykillinn er viðkvæmur. Meðhöndlaðu hann eins og skilríki. Ef hann kemst í hendur annarra skaltu mynda nýjan einkalykil, uppfæra ChatGPT-appuppsetninguna og eyða lyklinum sem var afhjúpaður í GitHub Enterprise.
Ljúktu uppsetningu í ChatGPT
Farðu aftur í flipann fyrir sniðmátsuppsetningu ChatGPT.
Límdu Client ID fyrir GitHub App í OAuth client ID.
Límdu Client secret fyrir GitHub App í OAuth client secret.
Láttu Scopes óbreytt nema fyrirtækið þitt þurfi vísvitandi að hnekkja sjálfgefnum gildum sniðmátsins.
Staðfestu að GitHub Enterprise-hýsilheitið sé aðeins hýsilheiti, svo sem
github.example.com.Límdu eða hladdu upp PEM-einkalykli GitHub App í GitHub App private key.
Staðfestu að myndaða webhook-leyndarmálið sé til staðar.
Búðu til drög að appinu.
Opnaðu upplýsingar um stofnuðu appdrögin í ChatGPT og afritaðu mynduðu webhook-slóðina.
Webhook-slóðin ætti að líta svona út: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Ljúktu webhook-uppsetningu í GitHub Enterprise
Farðu aftur í stillingar GitHub App í GitHub Enterprise.
Opnaðu almennar stillingar GitHub App.
Virkjaðu Active webhooks ef það er ekki þegar virkt.
Límdu ChatGPT webhook-slóðina í Webhook URL.
Límdu ChatGPT webhook-leyndarmálið í Webhook secret.
Hafðu SSL-staðfestingu virka.
Staðfestu að áskrifuðu webhook-atvikin samsvari heimildunum og aðgerðunum sem þú virkjaðir.
Vistaðu breytingar.
Birtu og stjórnaðu appinu í ChatGPT
Að búa til appdrögin gerir þau ekki sjálfkrafa tiltæk fyrir meðlimi. Eftir yfirferð á drögunum:
Birtu appdrögin.
Staðfestu að appið birtist í Stillingar vinnusvæðis > Öpp > Virkt.
Stilltu Aðgang notenda fyrir hlutverkin sem eiga að nota það.
Yfirfarðu Aðgerðastýringu fyrir les- og skrifaðgerðir.
Yfirfarðu Appheimildir til að velja hvenær ChatGPT spyr meðlimi áður en appið er notað.
Biddu leyfðan prófunarnotanda að opna Öpp í ChatGPT og staðfesta að appið birtist.
Þessar appheimildir gilda um samtöl í ChatGPT. Fulltrúar vinnusvæðis nota stýringar fyrir hvern fulltrúa, sem smiður fulltrúans stillir, til að ákvarða hvaða appaðgerðir eru tiltækar og hvenær endanotendur eru beðnir um að samþykkja þær. Sjá hegðun fulltrúa hér: ChatGPT Workspace Agents for Enterprise and Business.
Settu upp og prófaðu GitHub App
Í GitHub Enterprise skaltu setja GitHub-appið upp á fyrirtækinu eða reikningnum.
Veldu allar geymslur eða valdar geymslur samkvæmt stefnu vinnusvæðisins.
Byrjaðu tengingarferlið úr ChatGPT sem leyfður notandi.
Heimilaðu GitHub-appið þegar beðið er um það.
Keyrðu fyrst litla lesaðgerð, svo sem að telja upp aðgengilegar geymslur eða sækja þekkta draga beiðni.
Ef skrifaðgerðir eru virkjaðar skaltu prófa með áhættulítilli geymslu áður en víðari innleiðing hefst.
Hýsilheiti og OAuth-hegðun
ChatGPT notar hýsilheitið til að leiða út endapunkta GitHub Enterprise. Sláðu aðeins inn hýsilinn, svo sem github.example.com eða octocorp.ghe.com.
Ekki slá inn API-slóð, geymsluslóð eða github.com nema það sé nákvæmur GitHub Enterprise-hýsill fyrir þetta app.
Úrræðaleit
Redirect URI mismatch: staðfestu að bakvísunarslóð GitHub App samsvari nákvæmlega bakvísunarslóðinni sem birtist í ChatGPT.
ChatGPT getur ekki búið til eða vistað appdrögin: staðfestu að allir áskildir reitir séu til staðar, þar á meðal hýsilheiti, OAuth client ID, OAuth client secret, einkalykill og webhook-leyndarmál.
Auðkenning tekst en geymsluköll mistakast: staðfestu að GitHub App sé uppsett og hafi aðgang að geymslunni.
API skilar 403 eða ófullnægjandi heimildum: bættu við heimildinni sem vantar fyrir GitHub App og láttu uppsetningareigandann samþykkja uppfærðar heimildir ef beðið er um það.
Engar geymslur birtast: staðfestu að appuppsetningin innihaldi væntanlegar geymslur og að notandinn sem veitir heimild í ChatGPT hafi aðgang að þeim.
Webhook-afhendingar mistakast: staðfestu að webhook-slóðin og webhook-leyndarmálið samsvari gildunum úr ChatGPT, hafðu SSL-staðfestingu virka og gakktu úr skugga um að GitHub Enterprise-hýsillinn nái í
connectors.api.openai.org.Villur í einkalykli: staðfestu að allt PEM-efnið hafi verið afritað, þar á meðal upphafs- og lokalínur.