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

Օգտվեք այս ուղեցույցից, եթե 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-ի հաճախորդի ID-ն և գաղտնի բանալին՝ օգտատիրոջ OAuth լիազորման համար։

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

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

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

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

Նախքան սկսելը

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

• ChatGPT-ի աշխատատարածքի ադմինիստրատորի կամ սեփականատիրոջ իրավունքներ։

• GitHub Enterprise-ի ադմինիստրատորի կամ կազմակերպության սեփականատիրոջ իրավունքներ, որոնք թույլ են տալիս ստեղծել և տեղադրել GitHub App-եր։

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

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

• Ապահով միջավայր՝ GitHub App-ի մասնավոր բանալու և հաճախորդի գաղտնի բանալու հետ աշխատելու համար։

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

Նախապես պատրաստեք այս արժեքները

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

• Հետադարձ կանչի URL-ը․ պատճենեք այն ChatGPT-ի ձևանմուշի կարգավորման ընթացքում։

• GitHub App-ի հաճախորդի ID-ն։

• GitHub App-ի հաճախորդի գաղտնի բանալին։

• GitHub App-ի մասնավոր բանալին՝ PEM ձևաչափով։

• ChatGPT-ի գեներացրած վեբհուկի գաղտնի բանալին։

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

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

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

2. Բացեք Աշխատատարածքի կարգավորումներ > Հավելվածներ բաժինը։ Կարող եք նաև անցնել Ադմինիստրատորի վահանակ, ընտրել ChatGPT-ի համապատասխան աշխատատարածքը և բացել Փլագիններ բաժինը։ Ընտրեք Կառավարել հին հավելվածները՝ պահպանված Հավելվածներ էջը բացելու համար։

3. Ընտրեք Կատալոգ։

4. Որոնեք GitHub Enterprise-ը։

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

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

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

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

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

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

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

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

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

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

3. Բացեք Կարգավորումներ > Մշակողի կարգավորումներ > GitHub App-եր բաժինը։

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

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

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

7. «Հետադարձ կանչի URL» դաշտում տեղադրեք ChatGPT-ից պատճենած հետադարձ կանչի URL-ը՝ առանց փոփոխելու։

8. Միացված պահեք «Սահմանել օգտատիրոջ լիազորման թոքենների վավերականության ժամկետը» կարգավորումը, եթե ձեր անվտանգության թիմը այն փոխելու հատուկ պատճառ չունի։

9. Միացրեք «Տեղադրման ընթացքում խնդրել օգտատիրոջ լիազորումը» կարգավորումը, որպեսզի օգտատերերը կարողանան լիազորել հավելվածը տեղադրման կամ միացման ընթացքում։

10. «Որտե՞ղ կարող է տեղադրվել այս GitHub App-ը» բաժնում ընտրեք ձեր ներդրման շրջանակին համապատասխանող ամենասահմանափակ տարբերակը։

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

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

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

Պահոցները միայն կարդալու ռեժիմում գտնելու և հարցուպատասխանի համար սկսեք կարդալու թույլտվություններից, օրինակ՝

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

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

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

• Pull request-ներ՝ միայն կարդալու, եթե անհրաժեշտ է որոնել pull request-ներ կամ ստանալ վերանայման համատեքստը։

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

Տվյալներ գրող աշխատանքային գործընթացների համար գրելու թույլտվություններ ավելացրեք միայն այնտեղ, որտեղ անհրաժեշտ է, օրինակ՝ Բովանդակություն, Pull request-ներ, Խնդիրներ, Գործողություններ կամ Աշխատանքային գործընթացներ բաժիններում։ Օգտագործեք հնարավորինս սահմանափակ թույլտվություններ, որոնք բավարար են ChatGPT-ի նախատեսված գործողությունների համար։

Վեբհուկի իրադարձությունները պետք է համապատասխանեն ձեր աջակցած աշխատանքային գործընթացներին։ Տարածված իրադարձություններից են՝ Տեղադրում, Տեղադրման պահոցներ, Փոփոխությունների ուղարկում, Pull request, Խնդիրներ, Խնդրի մեկնաբանություն, Աշխատանքային գործընթացի գործարկում և Աշխատանքային գործընթացի առաջադրանք։

Գեներացրեք և պատճենեք GitHub App-ի նույնականացման տվյալները

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

2. Գեներացրեք Հաճախորդի գաղտնի բանալի և անմիջապես պատճենեք այն։

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

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

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

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

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

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

2. Տեղադրեք GitHub App-ի հաճախորդի ID-ն OAuth հաճախորդի ID դաշտում։

3. Տեղադրեք GitHub App-ի հաճախորդի գաղտնի բանալին OAuth հաճախորդի գաղտնի բանալի դաշտում։

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

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

6. Տեղադրեք կամ վերբեռնեք GitHub App-ի մասնավոր բանալին՝ PEM ձևաչափով, «GitHub App-ի մասնավոր բանալի» դաշտում։

7. Համոզվեք, որ վեբհուկի գեներացված գաղտնի բանալին առկա է։

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

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

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

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

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

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

3. Միացրեք «Ակտիվ վեբհուկեր» կարգավորումը, եթե այն արդեն միացված չէ։

4. Տեղադրեք ChatGPT-ի վեբհուկի URL-ը «Վեբհուկի URL» դաշտում։

5. Տեղադրեք ChatGPT-ի վեբհուկի գաղտնի բանալին «Վեբհուկի գաղտնի բանալի» դաշտում։

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

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

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. Նախ կատարեք կարդալու պարզ գործողություն, օրինակ՝ ստացեք հասանելի պահոցների ցանկը կամ հայտնի pull request-ը։

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

Հոսթի անունը և OAuth-ի աշխատանքը

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

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

Խնդիրների լուծում

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

• ChatGPT-ն չի կարող ստեղծել կամ պահպանել հավելվածի սևագիրը․ համոզվեք, որ լրացված են բոլոր պարտադիր դաշտերը՝ հոսթի անունը, OAuth հաճախորդի ID-ն, OAuth հաճախորդի գաղտնի բանալին, մասնավոր բանալին և վեբհուկի գաղտնի բանալին։

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

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

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

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

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

Աղբյուրներ

• GitHub-ի փաստաթղթեր․ GitHub App-ի գրանցում

• GitHub-ի փաստաթղթեր․ օգտատիրոջ լիազորման հետադարձ կանչի URL-ի մասին

• GitHub-ի փաստաթղթեր․ GitHub App-ի թույլտվությունների ընտրություն

• GitHub-ի փաստաթղթեր․ վեբհուկերի օգտագործումը GitHub App-երի հետ

• GitHub-ի փաստաթղթեր․ GitHub App-երի մասնավոր բանալիների կառավարում