OpenAI
See leht on masintõlgitud. Vaadake algset ingliskeelset artiklit.

Seadistage GitHub Enterprise’i rakenduse mall ChatGPT-s

Vaadake, kuidas tööjaama administraatorid saavad seadistada GitHub Enterprise’i rakenduse malli ChatGPT-s, kasutades oma organisatsiooni GitHub Appi.

Värskendatud: 7 days ago

Ülevaade

Kasuta seda juhendit, kui oled ChatGPT tööjaama haldur ja seadistad oma organisatsioonile GitHub Enterprise’i rakenduse malli. Mall ei ole lõplik rakendus, mida liikmed kasutavad. See on seadistusprotsess, mis loob tööjaamapõhise rakenduse mustandi pärast seda, kui oled sisestanud vajalikud GitHub Enterprise’i seadistusandmed.

GitHub Enterprise’i seadistamisel ühendatakse ChatGPT sinu organisatsiooni GitHub Enterprise’i hostiga. Lood GitHubi rakenduse, registreerid ChatGPT tagasikutse URL-i, genereerid autentimisandmed ja kleebid need väärtused ChatGPT malli seadistusvormi. Kui ChatGPT on rakenduse mustandi loonud, saad selle avaldada ja hallata seda nagu teisi tööjaama rakendusi.

Tööjaamas liikumise ja rakendustele juurdepääsu kohta vt: Pluginate ja rakenduste halduri juhtelemendid, turvalisus ja vastavusnõuded.

Mida sa seadistad

Lood ChatGPT-s tööjaamapõhise GitHub Enterprise’i rakenduse. Rakendus kasutab järgmist:

  • Sinu GitHub Enterprise’i hostis registreeritud GitHubi rakendus.

  • GitHubi rakenduse kliendi ID ja kliendisaladus kasutaja autoriseerimiseks OAutendi kaudu.

  • GitHubi rakenduse privaatvõti, et ChatGPT saaks luua varamutoiminguteks paigaldustõendeid.

  • Veebikonksu saladus ja URL, et GitHub Enterprise saaks saata paigaldus- ja varamusündmused tagasi ChatGPT-sse.

  • Sinu GitHub Enterprise’i hostinimi, näiteks github.example.com.

Loo GitHubi rakendus, mitte eraldiseisev GitHubi OAutendi rakendus. ChatGPT malli seadistamiseks on vaja GitHubi rakenduse autentimisandmeid, privaatvõtit ja veebikonksu sätteid.

Enne alustamist

Sul on vaja järgmist:

  • ChatGPT tööjaama halduri või omaniku õigused.

  • GitHub Enterprise’i halduri või organisatsiooni omaniku õigused, mis võimaldavad luua ja paigaldada GitHubi rakendusi.

  • Ainult GitHub Enterprise’i hostinimi, ilma eesliiteta https:// või teeta.

  • Otsus, milliseid varamutoiminguid ChatGPT peaks toetama, näiteks varamute otsing ilma muutmisõiguseta, pull request'ide töövood, probleemide töövood, failide muutmine, GitHub Actions või laiemad Codexi töövood.

  • Turvaline koht GitHubi rakenduse privaatvõtme ja kliendisaladuse käitlemiseks.

Hoia ChatGPT ja GitHub Enterprise eraldi vahekaartidel avatuna. Ära mõtle tagasikutse URL-i ise välja. Kopeeri täpselt ChatGPT-s kuvatav tagasikutse URL.

Ettevalmistatavad väärtused

  • GitHub Enterprise’i hostinimi: näiteks github.example.com.

  • Tagasikutse URL: kopeeri see ChatGPT malli seadistusvormist.

  • GitHubi rakenduse kliendi ID.

  • GitHubi rakenduse kliendisaladus.

  • GitHubi rakenduse PEM-vormingus privaatvõti.

  • ChatGPT loodud veebikonksu saladus.

  • Veebikonksu URL, mis luuakse pärast rakenduse mustandi loomist ChatGPT-s.

Alusta malli seadistamist ChatGPT-s

  1. Lülitu ChatGPT-s tööjaama, kus rakendus peaks saadaval olema.

  2. Ava Tööjaama sätted > Rakendused. Võid avada ka halduri konsooli, valida soovitud ChatGPT tööjaama ja avada jaotise Pluginad. Vali Halda pärandrakendusi, et avada säilitatud leht Rakendused.

  3. Vali Kataloog.

  4. Otsi GitHub Enterprise’i.

  5. Vali GitHub Enterprise’i rakenduse mall ja alusta seadistamist.

  6. Sisesta rakendusele selge nimi ja kirjeldus, näiteks GitHub Enterprise või GitHub Enterprise – Arendus.

  7. Sisesta GitHub Enterprise’i hostinimi, näiteks github.example.com.

  8. Kopeeri ChatGPT-s kuvatav tagasikutse URL. Jäta see vahekaart avatuks.

  9. Kopeeri loodud veebikonksu saladus, kui see seadistamise ajal kuvatakse.

Tagasikutse URL-i näide: https://chatgpt.com/connector/oauth/<callback_id>

Ära eemalda tagasikutse ID-d, lisa lõppu kaldkriipsu ega asenda seda üldise ChatGPT URL-iga.

Loo GitHub Enterprise’is GitHubi rakendus

  1. Ava oma GitHub Enterprise’i host, näiteks https://github.example.com.

  2. Mine organisatsiooni või konto juurde, millele rakendus peaks kuuluma.

  3. Ava Sätted > Arendaja sätted > GitHubi rakendused.

  4. Vali Uus GitHubi rakendus.

  5. Sisesta rakendusele selge nimi, näiteks ChatGPT GitHub Enterprise’i konnektor.

  6. Sisesta avalehe URL. Kui eraldi ettevõttesisest lehte pole, kasuta GitHub Enterprise’i organisatsiooni URL-i.

  7. Kleebi väljale Tagasikutse URL täpselt ChatGPT-st kopeeritud tagasikutse URL.

  8. Hoia valik „Kasutaja autoriseerimistõendid aeguvad“ lubatuna, välja arvatud juhul, kui sinu turbetiimil on konkreetne põhjus seda muuta.

  9. Luba valik „Küsi paigaldamise ajal kasutaja volitust“, et kasutajad saaksid rakendusele paigaldamise või ühendamise käigus volituse anda.

  10. Jaotises „Kuhu saab selle GitHubi rakenduse paigaldada?“ vali kõige piiratum variant, mis sobib sinu kasutuselevõtuplaaniga.

  11. Loo GitHubi rakendus.

Seadista õigused ja sündmused

Vali minimaalsed õigused, mida on vaja nende ChatGPT toimingute jaoks, mida kavatsed lubada.

Varamute leidmiseks ja küsimustele vastamiseks ilma muudatusi tegemata alusta näiteks järgmistest lugemisõigustest:

  • Metaandmed: kirjutuskaitstud. GitHub nõuab GitHubi rakendustelt juurdepääsu metaandmetele.

  • Sisu: kirjutuskaitstud, et pääseda ligi failidele ja varamu sisule.

  • Probleemid: kirjutuskaitstud, kui on vaja probleeme otsida või lugeda.

  • Pull request'id: kirjutuskaitstud, kui on vaja otsida pull request'e või saada konteksti nende ülevaatamiseks.

  • Toimingud: kirjutuskaitstud, kui on vaja töövoo käivituse olekut, töid, logisid või artefakte.

Kirjutavate töövoogude jaoks lisa kirjutamisõigused ainult sinna, kus neid on vaja, näiteks jaotistesse Sisu, Pull request'id, Probleemid, Toimingud või Töövood. Kasuta võimalikult piiratud õigusi, mis võimaldavad soovitud ChatGPT toiminguid.

Veebikonksu sündmused peaksid vastama toetatavatele töövoogudele. Levinud sündmused on Paigaldus, Paigalduse varamud, Tõuge, Pull request, Probleemid, Probleemi kommentaar, Töövoo käivitus ja Töövoo töö.

Genereeri ja kopeeri GitHubi rakenduse autentimisandmed

  1. Kopeeri GitHubi rakenduse sätetest kliendi ID.

  2. Genereeri kliendisaladus ja kopeeri see kohe.

  3. Genereeri jaotises Privaatvõtmed privaatvõti.

  4. Laadi .pem-fail alla ja hoia seda turvaliselt.

  5. Ava .pem-fail oma arvutis ja kopeeri kogu PEM-tekst, sealhulgas algus- ja lõpuread.

Privaatvõti on tundlik teave. Käsitle seda nagu autentimisandmeid. Kui see lekib, genereeri uus privaatvõti, uuenda ChatGPT rakenduse seadistust ja kustuta GitHub Enterprise’ist lekkinud võti.

Lõpeta seadistamine ChatGPT-s

  1. Naase ChatGPT malli seadistamise vahekaardile.

  2. Kleebi GitHubi rakenduse kliendi ID väljale OAutendi kliendi ID.

  3. Kleebi GitHubi rakenduse kliendisaladus väljale OAutendi kliendisaladus.

  4. Jäta Õiguste ulatused muutmata, välja arvatud juhul, kui sinu organisatsioonil on teadlik vajadus malli vaikesätteid muuta.

  5. Veendu, et GitHub Enterprise’i hostinime väljal oleks ainult hostinimi, näiteks github.example.com.

  6. Kleebi või laadi GitHubi rakenduse PEM-vormingus privaatvõti väljale GitHubi rakenduse privaatvõti.

  7. Veendu, et loodud veebikonksu saladus oleks olemas.

  8. Loo rakenduse mustand.

  9. Ava ChatGPT-s loodud rakenduse mustandi üksikasjad ja kopeeri loodud veebikonksu URL.

Veebikonksu URL peaks olema järgmise kujuga: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Lõpeta veebikonksu seadistamine GitHub Enterprise’is

  1. Naase GitHub Enterprise’is GitHubi rakenduse sätetesse.

  2. Ava GitHubi rakenduse üldsätted.

  3. Luba valik „Aktiivsed veebikonksud“, kui see pole juba lubatud.

  4. Kleebi ChatGPT veebikonksu URL väljale Veebikonksu URL.

  5. Kleebi ChatGPT veebikonksu saladus väljale Veebikonksu saladus.

  6. Hoia SSL-i kontroll lubatuna.

  7. Veendu, et tellitud veebikonksu sündmused vastaksid lubatud õigustele ja toimingutele.

  8. Salvesta muudatused.

Avalda ja halda rakendust ChatGPT-s

Rakenduse mustandi loomine ei tee seda liikmetele automaatselt kättesaadavaks. Pärast mustandi ülevaatamist:

  1. Avalda rakenduse mustand.

  2. Ava tööjaama sätetes leht Rakendused, ava jaotis Lubatud ja veendu, et rakendus oleks seal nähtav. Rakenduste lehe saad avada ka valikuga Halda pärandrakendusi jaotises Halduri konsool > Pluginad.

  3. Seadista Kasutajate juurdepääs rollidele, mis peaksid rakendust kasutama.

  4. Vaata jaotises Toimingute juhtimine üle lugemis- ja kirjutamistoimingud.

  5. Vaata üle Rakenduse õigused, et valida, millal ChatGPT küsib liikmetelt enne rakenduse kasutamist luba.

  6. Palu juurdepääsuõigusega testkasutajal avada ChatGPT rakendused ja veenduda, et rakendus oleks seal nähtav.

Need rakenduse õigused kehtivad ChatGPT vestlustele. Tööjaama agendid kasutavad agendi looja määratud agendipõhiseid sätteid, mis määravad, millised rakenduse toimingud on saadaval ja millal küsitakse lõppkasutajatelt nende kinnitamist. Agentide käitumise kohta vt: ChatGPT tööjaama agendid Enterprise’i ja Businessi jaoks.

Paigalda ja testi GitHubi rakendust

  1. Paigalda GitHub Enterprise’is GitHubi rakendus organisatsioonile või kontole.

  2. Vali kõik varamud või kindlad varamud vastavalt tööjaama eeskirjadele.

  3. Alusta ChatGPT-s ühendamist juurdepääsuõigusega kasutajana.

  4. Kui seda küsitakse, anna GitHubi rakendusele volitus.

  5. Tee esmalt väike lugemistoiming, näiteks kuva juurdepääsetavate varamute loend või too teadaolev pull request.

  6. Kui kirjutamistoimingud on lubatud, testi neid enne laiemat kasutuselevõttu väikese riskiga varamus.

Hostinimi ja OAutendi toimimine

ChatGPT tuletab hostinime põhjal GitHub Enterprise’i lõpp-punktid. Sisesta ainult hostinimi, näiteks github.example.com või octocorp.ghe.com.

Ära sisesta API teed, varamu teed ega aadressi github.com, välja arvatud juhul, kui see on selle rakenduse täpne GitHub Enterprise’i host.

Tõrkeotsing

  • Ümbersuunamise URI ei ühti: veendu, et GitHubi rakenduse tagasikutse URL ühtiks täpselt ChatGPT-s kuvatava tagasikutse URL-iga.

  • ChatGPT ei saa rakenduse mustandit luua ega salvestada: veendu, et kõik kohustuslikud väljad oleksid täidetud, sealhulgas hostinimi, OAutendi kliendi ID, OAutendi kliendisaladus, privaatvõti ja veebikonksu saladus.

  • Autentimine õnnestub, kuid varamupäringud nurjuvad: veendu, et GitHubi rakendus oleks paigaldatud ja sellel oleks varamule juurdepääs.

  • API tagastab vea 403 või ebapiisavate õiguste teate: lisa GitHubi rakendusele puuduv õigus ja palu paigalduse omanikul uuendatud õigused kinnitada, kui seda küsitakse.

  • Varamuid ei kuvata: veendu, et rakenduse paigaldus hõlmaks soovitud varamuid ja ChatGPT-s autoriseerival kasutajal oleks neile juurdepääs.

  • Veebikonksu edastused nurjuvad: veendu, et veebikonksu URL ja saladus ühtiksid ChatGPT väärtustega, hoia SSL-i kontroll lubatuna ning veendu, et GitHub Enterprise’i host pääseks ligi aadressile connectors.api.openai.org.

  • Privaatvõtme vead: veendu, et kogu PEM-sisu, sealhulgas algus- ja lõpuread, oleks kopeeritud.

Viited

Kas sellest artiklist oli abi?