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: 10 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 GitHubi rakendus GitHub Enterprise’is

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

  2. Ava organisatsioon või konto, mis peaks olema rakenduse omanik.

  3. Ava Seaded > Arendaja seaded > GitHubi rakendused.

  4. Vali Uus GitHubi rakendus.

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

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

  7. Kleebi väljale „Tagasikutse URL” ChatGPT-st kopeeritud tagasikutse URL täpselt muutmata kujul.

  8. Jäta valik „Kasutaja autoriseerimistõendite aegumine” lubatuks, välja arvatud juhul, kui sinu turvatiimil on konkreetne põhjus seda muuta.

  9. Luba valik „Küsi installimise ajal kasutaja autoriseeringut”, et kasutajad saaksid rakendusele installimise või ühendamise käigus loa anda.

  10. Jaotises „Kuhu saab selle GitHubi rakenduse installida?” vali oma juurutusplaanile vastav kõige piiratum valik.

  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 automaatselt liikmetele kättesaadavaks. Pärast mustandi ülevaatamist:

  1. Avalda rakenduse mustand.

  2. Ava tööjaama seadetes leht Rakendused, ava jaotis Lubatud ja kontrolli, kas rakendus on loendis. Rakenduste lehe saad avada ka valikuga „Halda pärandrakendusi” jaotises Halduskonsool > Pistikprogrammid.

  3. Enterprise’i ja Edu puhul vali jaotises Kasutajate juurdepääs, milliste rollidega kasutajad saavad rakendust kasutada. Businessi puhul halda rakenduse kättesaadavust kogu tööjaamas.

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

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

  6. Palu juurdepääsuõigusega testkasutajal avada ChatGPT rakendused ja kontrollida, kas rakendus on loendis.

Need rakenduse õigused kehtivad ChatGPT vestlustes. Tööjaama agendid kasutavad agendi looja määratud agendipõhiseid seadeid, et otsustada, millised rakenduse toimingud on saadaval ja millal küsitakse lõppkasutajatelt nende heakskiitu. Agentide käitumise kohta vaata: 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.

Kas sellest artiklist oli abi?