OpenAI
Այս էջը թարգմանվել է մեքենայական թարգմանությամբ։ Դիտել անգլերեն բնօրինակ հոդվածը.

Կարգավորեք GitHub Enterprise հավելվածի ձևանմուշը ChatGPT-ում

Իմացեք, թե ինչպես աշխատատարածքի ադմինիստրատորները կարող են կարգավորել GitHub Enterprise հավելվածի ձևանմուշը ChatGPT-ում՝ օգտագործելով իրենց կազմակերպության սեփական GitHub App-ը։

Թարմացվել է՝ 6 days ago

Ընդհանուր նկարագիր

Օգտագործեք այս ուղեցույցը, եթե ChatGPT աշխատատարածքի ադմինիստրատոր եք և ձեր կազմակերպության համար կարգավորում եք GitHub Enterprise հավելվածի ձևանմուշը։ Ձևանմուշը այն վերջնական հավելվածը չէ, որը օգտագործում են անդամները։ Դա կարգավորման հոսք է, որը ստեղծում է աշխատատարածքին հատուկ սևագիր հավելված՝ GitHub Enterprise-ի պահանջվող կարգավորումը տրամադրելուց հետո։

GitHub Enterprise-ի համար կարգավորումը ChatGPT-ն միացնում է ձեր կազմակերպության GitHub Enterprise հոսթին։ Դուք ստեղծում եք GitHub App, գրանցում եք ChatGPT հետկանչի URL-ը, գեներացնում եք հավատարմագրեր, ապա այդ արժեքները տեղադրում եք ChatGPT ձևանմուշի կարգավորման հոսքում։ Երբ ChatGPT-ն ստեղծի սևագիր հավելվածը, կարող եք հրապարակել այն և կառավարել աշխատատարածքի մյուս հավելվածների նման։

Ինչ եք կարգավորում

Դուք ChatGPT-ում ստեղծում եք աշխատատարածքին հատուկ GitHub Enterprise հավելված։ Հավելվածը օգտագործում է՝

  • Ձեր GitHub Enterprise հոսթում գրանցված GitHub App։

  • GitHub App-ի client ID-ն և client secret-ը՝ օգտվողի OAuth լիազորման համար։

  • GitHub App-ի մասնավոր բանալին, որպեսզի ChatGPT-ն կարողանա թողարկել տեղադրման թոքեններ պահոցի գործողությունների համար։

  • Webhook-ի գաղտնիք և webhook URL, որպեսզի GitHub Enterprise-ը կարողանա տեղադրման և պահոցի իրադարձությունները հետ ուղարկել ChatGPT-ին։

  • Ձեր GitHub Enterprise հոսթանունը, օրինակ՝ github.example.com։

Ստեղծեք GitHub App, ոչ թե առանձին GitHub OAuth App։ ChatGPT ձևանմուշի կարգավորումը պահանջում է GitHub App-ի հավատարմագրեր, մասնավոր բանալի և webhook-ի կարգավորումներ։

Սկսելուց առաջ

Ձեզ անհրաժեշտ է՝

  • ChatGPT աշխատատարածքի ադմինիստրատորի կամ սեփականատիրոջ հասանելիություն։

  • GitHub Enterprise ադմինիստրատորի կամ կազմակերպության սեփականատիրոջ հասանելիություն, որը կարող է ստեղծել և տեղադրել GitHub Apps։

  • Միայն GitHub Enterprise հոսթանունը՝ առանց https://-ի կամ ուղու։

  • Որոշում այն մասին, թե պահոցի որ գործողությունները պետք է աջակցի ChatGPT-ն, օրինակ՝ միայն կարդալու պահոցի որոնում, կոդի փոփոխությունների վերահայման հարցումների աշխատանքային հոսքեր, խնդիրների աշխատանքային հոսքեր, ֆայլերի խմբագրումներ, GitHub Actions կամ ավելի լայն Codex աշխատանքային հոսքեր։

  • Ապահով տեղ՝ GitHub App-ի մասնավոր բանալու և client secret-ի հետ աշխատելու համար։

ChatGPT-ն և GitHub Enterprise-ը բաց պահեք առանձին ներդիրներում։ Մի հորինեք հետկանչի URL-ը։ Պատճենեք ChatGPT-ում ցուցադրված ճշգրիտ հետկանչի URL-ը։

Պատրաստելի արժեքներ

  • GitHub Enterprise հոսթանուն՝ օրինակ՝ github.example.com։

  • Հետկանչի URL՝ պատճենեք սա ChatGPT ձևանմուշի կարգավորման հոսքից։

  • GitHub App-ի client ID։

  • GitHub App-ի client secret։

  • GitHub App-ի մասնավոր բանալի PEM։

  • ChatGPT-ի գեներացրած webhook-ի գաղտնիք։

  • Webhook URL, որը գեներացվում է ChatGPT-ում սևագիր հավելվածը ստեղծվելուց հետո։

Սկսեք ձևանմուշի կարգավորումը ChatGPT-ում

  1. ChatGPT-ում անցեք այն աշխատատարածքին, որտեղ հավելվածը պետք է հասանելի լինի։

  2. Բացեք Աշխատատարածքի կարգավորումներ > Հավելվածներ։

  3. Ընտրեք Տեղեկատու։

  4. Որոնեք GitHub Enterprise։

  5. Ընտրեք GitHub Enterprise հավելվածի ձևանմուշը և սկսեք կարգավորումը։

  6. Մուտքագրեք հավելվածի հստակ անուն և նկարագրություն, օրինակ՝ GitHub Enterprise կամ GitHub Enterprise - Engineering։

  7. Մուտքագրեք GitHub Enterprise հոսթանունը, օրինակ՝ github.example.com։

  8. Պատճենեք ChatGPT-ում ցուցադրված հետկանչի URL-ը։ Այս ներդիրը բաց պահեք։

  9. Պատճենեք գեներացված webhook-ի գաղտնիքը, եթե այն ցուցադրվում է կարգավորման ընթացքում։

Հետկանչի URL-ի օրինակ՝ https://chatgpt.com/connector/oauth/<callback_id>

Մի հեռացրեք հետկանչի ID-ն, մի ավելացրեք վերջավոր շեղագիծ և մի փոխարինեք այն ընդհանուր ChatGPT URL-ով։

Ստեղծեք GitHub App-ը GitHub Enterprise-ում

  1. Բացեք ձեր GitHub Enterprise հոսթը, օրինակ՝ https://github.example.com։

  2. Անցեք այն կազմակերպություն կամ հաշիվ, որը պետք է տիրապետի հավելվածին։

  3. Բացեք Կարգավորումներ > Մշակողի կարգավորումներ > GitHub Apps։

  4. Ընտրեք Նոր GitHub App։

  5. Մուտքագրեք հավելվածի հստակ անուն, օրինակ՝ ChatGPT GitHub Enterprise Connector։

  6. Մուտքագրեք գլխավոր էջի URL։ Եթե հատուկ ներքին էջ չկա, օգտագործեք GitHub Enterprise կազմակերպության URL-ը։

  7. Callback URL դաշտում տեղադրեք ChatGPT-ից պատճենված ճշգրիտ հետկանչի URL-ը։

  8. Պահեք Expire user authorization tokens տարբերակը միացված, եթե ձեր անվտանգության թիմը դա փոխելու հատուկ պատճառ չունի։

  9. Միացրեք Request user authorization during installation տարբերակը, որպեսզի օգտվողները կարողանան լիազորել հավելվածը տեղադրման կամ միացման ընթացքի ժամանակ։

  10. Where can this GitHub App be installed? բաժնում, ընտրեք ձեր ներդրման համար հարմար ամենասահմանափակ տարբերակը։

  11. Ստեղծեք GitHub App-ը։

Կարգավորեք թույլտվություններն ու իրադարձությունները

Ընտրեք այն նվազագույն թույլտվությունները, որոնք անհրաժեշտ են ChatGPT-ի այն գործողությունների համար, որոնք նախատեսում եք միացնել։

Միայն կարդալու պահոցների հայտնաբերման և հարցուպատասխանի համար սկսեք կարդալու թույլտվություններից, օրինակ՝

  • Մետատվյալներ՝ միայն կարդալու։ GitHub-ը GitHub Apps-ի համար մետատվյալներ է պահանջում։

  • Բովանդակություն՝ միայն կարդալու, ֆայլերի և պահոցի բովանդակության հասանելիության համար։

  • Խնդիրներ՝ միայն կարդալու, եթե անհրաժեշտ է խնդիրների որոնում կամ ընթերցում։

  • Կոդի փոփոխությունների վերահայման հարցումներ. միայն կարդալու, եթե անհրաժեշտ է դրանց որոնում կամ վերանայման համատեքստ։

  • Գործողություններ. միայն կարդալու, եթե անհրաժեշտ են աշխատանքային հոսքի գործարկման կարգավիճակ, առաջադրանքներ, մատյաններ կամ արտեֆակտներ։

Գրելու աշխատանքային հոսքերի համար գրելու թույլտվություններ ավելացրեք միայն անհրաժեշտ տեղերում, օրինակ՝ Contents, Pull requests, Issues, Actions կամ Workflows։ Օգտագործեք ամենասահմանափակ թույլտվությունները, որոնք ապահովում են նախատեսված ChatGPT գործողությունները։

Webhook-ի իրադարձությունները պետք է համապատասխանեն ձեր աջակցվող աշխատանքային հոսքերին։ Տարածված իրադարձություններից են Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run և Workflow job։

Գեներացրեք և պատճենեք GitHub App-ի հավատարմագրերը

  1. GitHub App-ի կարգավորումներում պատճենեք Client ID-ն։

  2. Գեներացրեք Client secret և անմիջապես պատճենեք այն։

  3. Private keys բաժնում գեներացրեք մասնավոր բանալի։

  4. Ներբեռնեք .pem ֆայլը և պահեք այն ապահով տեղում։

  5. Բացեք .pem ֆայլը տեղայնորեն և պատճենեք ամբողջ PEM տեքստը՝ ներառյալ սկզբի և ավարտի տողերը։

Մասնավոր բանալին զգայուն է։ Վերաբերվեք դրան որպես հավատարմագրի։ Եթե այն բացահայտվել է, գեներացրեք նոր մասնավոր բանալի, թարմացրեք ChatGPT հավելվածի կարգավորումը և ջնջեք վտանգված բանալին GitHub Enterprise-ում։

Ավարտեք կարգավորումը ChatGPT-ում

  1. Վերադարձեք ChatGPT ձևանմուշի կարգավորման ներդիր։

  2. Տեղադրեք GitHub App Client ID-ն OAuth client ID դաշտում։

  3. Տեղադրեք GitHub App Client secret-ը OAuth client secret դաշտում։

  4. Թողեք Scopes-ը անփոփոխ, եթե ձեր կազմակերպությունը դիտավորյալ չի ցանկանում փոխարինել ձևանմուշի լռելյայն արժեքները։

  5. Հաստատեք, որ GitHub Enterprise հոսթանունը միայն հոսթանուն է, օրինակ՝ github.example.com։

  6. Տեղադրեք կամ վերբեռնեք GitHub App-ի մասնավոր բանալի PEM-ը GitHub App private key դաշտում։

  7. Հաստատեք, որ գեներացված webhook-ի գաղտնիքը առկա է։

  8. Ստեղծեք սևագիր հավելվածը։

  9. Բացեք ստեղծված սևագիր հավելվածի մանրամասները ChatGPT-ում և պատճենեք գեներացված webhook URL-ը։

Webhook URL-ը պետք է այսպիսի տեսք ունենա՝ https://connectors.api.openai.org/connectors/<connector_id>/webhook

Ավարտեք webhook-ի կարգավորումը GitHub Enterprise-ում

  1. Վերադարձեք GitHub App-ի կարգավորումներին GitHub Enterprise-ում։

  2. Բացեք GitHub App-ի ընդհանուր կարգավորումները։

  3. Միացրեք Active webhooks-ը, եթե դրանք արդեն միացված չեն։

  4. Տեղադրեք ChatGPT webhook URL-ը Webhook URL դաշտում։

  5. Տեղադրեք ChatGPT webhook-ի գաղտնիքը Webhook secret դաշտում։

  6. Պահեք SSL ստուգումը միացված։

  7. Հաստատեք, որ բաժանորդագրված webhook իրադարձությունները համապատասխանում են ձեր միացրած թույլտվություններին և գործողություններին։

  8. Պահեք փոփոխությունները։

Հրապարակեք և կառավարեք հավելվածը ChatGPT-ում

Սևագիր հավելվածի ստեղծումը այն ավտոմատ հասանելի չի դարձնում անդամներին։ Սևագիրը վերանայելուց հետո՝

  1. Հրապարակեք սևագիր հավելվածը։

  2. Հաստատեք, որ հավելվածը հայտնվում է Աշխատատարածքի կարգավորումներ > Հավելվածներ > Միացված բաժնում։

  3. Կարգավորեք Օգտվողի հասանելիությունը այն դերերի համար, որոնք պետք է օգտագործեն այն։

  4. Վերանայեք Գործողությունների կառավարումը կարդալու և գրելու գործողությունների համար։

  5. Վերանայեք Հավելվածի թույլտվությունները՝ ընտրելու, թե երբ ChatGPT-ն պետք է հարցնի անդամներին հավելվածն օգտագործելուց առաջ։

  6. Խնդրեք թույլատրված փորձարկող օգտվողին բացել Հավելվածները ChatGPT-ում և հաստատել, որ հավելվածը հայտնվում է։

Հավելվածի այս թույլտվությունները կիրառվում են ChatGPT զրույցների վրա։ Աշխատատարածքի ագենտները օգտագործում են յուրաքանչյուր ագենտի համար սահմանված կառավարումները, որոնք սահմանում է ագենտի ստեղծողը՝ որոշելու համար, թե հավելվածի որ գործողություններն են հասանելի և երբ վերջնական օգտվողներից պետք է հաստատում խնդրել։ Ագենտի վարքագծի համար տես՝ ChatGPT Աշխատատարածքի ագենտներ Enterprise-ի և Business-ի համար։

Տեղադրեք և փորձարկեք GitHub App-ը

  1. GitHub Enterprise-ում տեղադրեք GitHub հավելվածը կազմակերպության կամ հաշվի վրա։

  2. Ընտրեք բոլոր պահոցները կամ ընտրված պահոցները՝ ըստ աշխատատարածքի քաղաքականության։

  3. Սկսեք միացման հոսքը ChatGPT-ից՝ որպես թույլատրված օգտվող։

  4. Լիազորեք GitHub հավելվածը, երբ հուշում ստանաք։

  5. Նախ գործարկեք փոքր կարդալու գործողություն, օրինակ՝ հասանելի պահոցների ցուցակում կամ հայտնի կոդի փոփոխությունների վերահայման հարցում ստանալը։

  6. Եթե գրելու գործողությունները միացված են, նախ փորձարկեք ցածր ռիսկով պահոցում՝ նախքան ավելի լայն ներդրումը։

Հոսթանուն և OAuth-ի վարքագիծ

ChatGPT-ն օգտագործում է հոսթանունը՝ GitHub Enterprise վերջնակետեր ստանալու համար։ Մուտքագրեք միայն հոսթը, օրինակ՝ github.example.com կամ octocorp.ghe.com։

Մի մուտքագրեք API ուղի, պահոցի ուղի կամ github.com, եթե դա այս հավելվածի ճշգրիտ GitHub Enterprise հոսթը չէ։

Խնդիրների վերացում

  • Redirect URI-ի անհամապատասխանություն. հաստատեք, որ GitHub App-ի հետկանչի URL-ը ճշգրիտ համապատասխանում է ChatGPT-ում ցուցադրված հետկանչի URL-ին։

  • ChatGPT-ն չի կարող ստեղծել կամ պահել սևագիր հավելվածը. հաստատեք, որ բոլոր պարտադիր դաշտերը լրացված են, այդ թվում՝ հոսթանունը, OAuth client ID-ն, OAuth client secret-ը, մասնավոր բանալին և webhook-ի գաղտնիքը։

  • Նույնականացումը հաջողվում է, բայց պահոցի կանչերը ձախողվում են. հաստատեք, որ GitHub App-ը տեղադրված է և հասանելիություն ունի պահոցին։

  • API-ը վերադարձնում է 403 կամ թույլտվությունները բավարար չեն. ավելացրեք բացակայող GitHub App թույլտվությունը և, եթե հուշում ստանաք, խնդրեք տեղադրման սեփականատիրոջը հաստատել թարմացված թույլտվությունները։

  • Պահոցներ չեն հայտնվում. հաստատեք, որ հավելվածի տեղադրումը ներառում է սպասվող պահոցները, և ChatGPT-ում լիազորող օգտվողը հասանելիություն ունի դրանց։

  • Webhook-ի առաքումները ձախողվում են. հաստատեք, որ webhook URL-ը և webhook-ի գաղտնիքը համապատասխանում են ChatGPT-ի արժեքներին, պահեք SSL ստուգումը միացված և համոզվեք, որ GitHub Enterprise հոսթը կարող է հասնել connectors.api.openai.org։

  • Մասնավոր բանալու սխալներ. հաստատեք, որ ամբողջ PEM բովանդակությունը պատճենվել է՝ ներառյալ սկզբի և ավարտի տողերը։

Հղումներ

Այս հոդվածն օգտակա՞ր էր։