OpenAI
ეს გვერდი მანქანური თარგმანის მეშვეობით ითარგმნა. სტატიის ინგლისური დედნის ნახვა.

GitHub Enterprise აპის შაბლონის დაყენება ChatGPT-ში

გაიგეთ, როგორ შეუძლიათ სამუშაო სივრცის ადმინისტრატორებს GitHub Enterprise აპის შაბლონის კონფიგურაცია ChatGPT-ში თავიანთი ორგანიზაციის GitHub App-ის გამოყენებით.

განახლებულია: 7 days ago

მიმოხილვა

გამოიყენეთ ეს სახელმძღვანელო, თუ ხართ ChatGPT-ის სამუშაო სივრცის ადმინისტრატორი და აყენებთ GitHub-ის Enterprise აპის შაბლონს თქვენი ორგანიზაციისთვის. შაბლონი არ არის საბოლოო აპი, რომელსაც წევრები იყენებენ. ეს არის დაყენების პროცესი, რომელიც საჭირო GitHub Enterprise-ის კონფიგურაციის მიწოდების შემდეგ ქმნის სამუშაო სივრცისთვის სპეციფიკურ აპის მონახაზს.

GitHub Enterprise-ისთვის დაყენება ChatGPT-ს თქვენი ორგანიზაციის GitHub Enterprise-ის ჰოსტთან აკავშირებს. თქვენ ქმნით GitHub App-ს, არეგისტრირებთ ChatGPT-ის callback URL-ს, აგენერირებთ ავტორიზაციის მონაცემებს და შემდეგ ამ მნიშვნელობებს ChatGPT-ის შაბლონის დაყენების პროცესში სვამთ. მას შემდეგ, რაც ChatGPT აპის მონახაზს შექმნის, შეგიძლიათ ის გამოაქვეყნოთ და მართოთ, როგორც სხვა სამუშაო სივრცის აპები.

რას აყენებთ

თქვენ ქმნით სამუშაო სივრცისთვის სპეციფიკურ GitHub Enterprise აპს ChatGPT-ში. აპი იყენებს:

  • თქვენს GitHub Enterprise-ის ჰოსტზე რეგისტრირებულ GitHub App-ს.

  • GitHub App-ის კლიენტის ID-სა და კლიენტის საიდუმლოს მომხმარებლის OAuth ავტორიზაციისთვის.

  • GitHub App-ის პირად გასაღებს, რათა ChatGPT-მ რეპოზიტორიუმის ოპერაციებისთვის ინსტალაციის token-ები გამოუშვას.

  • 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-მ, მაგალითად მხოლოდ წაკითხვადი რეპოზიტორიუმის ძიება, შერწყმის მოთხოვნის workflow-ები, საკითხების workflow-ები, ფაილების რედაქტირება, GitHub Actions ან უფრო ფართო Codex workflow-ები.

  • უსაფრთხო ადგილი GitHub App-ის პირადი გასაღებისა და კლიენტის საიდუმლოს დასამუშავებლად.

ChatGPT და GitHub Enterprise ცალკე ჩანართებში ღიად დატოვეთ. არ გამოიგონოთ callback URL. დააკოპირეთ ChatGPT-ში ნაჩვენები ზუსტი callback URL.

მოსამზადებელი მნიშვნელობები

  • GitHub Enterprise-ის ჰოსტის სახელი: მაგალითად, github.example.com.

  • Callback URL: დააკოპირეთ ეს ChatGPT-ის შაბლონის დაყენების პროცესიდან.

  • GitHub App-ის კლიენტის ID.

  • GitHub App-ის კლიენტის საიდუმლო.

  • GitHub App-ის პირადი გასაღების PEM.

  • ChatGPT-ის მიერ გენერირებული webhook-ის საიდუმლო.

  • ChatGPT-ში აპის მონახაზის შექმნის შემდეგ გენერირებული webhook URL.

დაიწყეთ შაბლონის დაყენება 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-ში ნაჩვენები callback URL. ეს ჩანართი ღიად დატოვეთ.

  9. დააკოპირეთ გენერირებული webhook-ის საიდუმლო, თუ ის დაყენებისას გამოჩნდება.

callback URL-ის მაგალითი: https://chatgpt.com/connector/oauth/<callback_id>

არ წაშალოთ callback ID, არ დაამატოთ ბოლოში დახრილი ხაზი და არ ჩაანაცვლოთ ის ზოგადი ChatGPT URL-ით.

შექმენით GitHub App GitHub Enterprise-ში

  1. გახსენით თქვენი GitHub Enterprise-ის ჰოსტი, მაგალითად https://github.example.com.

  2. გადადით ორგანიზაციაში ან ანგარიშზე, რომელსაც აპი უნდა ეკუთვნოდეს.

  3. გახსენით Settings > Developer settings > GitHub Apps.

  4. აირჩიეთ ახალი GitHub App.

  5. შეიყვანეთ აპის მკაფიო სახელი, მაგალითად ChatGPT GitHub Enterprise Connector.

  6. შეიყვანეთ მთავარი გვერდის URL. თუ გამოყოფილი შიდა გვერდი არ არსებობს, გამოიყენეთ GitHub Enterprise-ის ორგანიზაციის URL.

  7. Callback URL-ში ჩასვით ChatGPT-დან დაკოპირებული ზუსტი callback URL.

  8. დატოვეთ ჩართული მომხმარებლის ავტორიზაციის token-ების ვადის ამოწურვა, თუ თქვენს უსაფრთხოების გუნდს მისი შეცვლის კონკრეტული მიზეზი არ აქვს.

  9. ჩართეთ მომხმარებლის ავტორიზაციის მოთხოვნა ინსტალაციისას, რათა მომხმარებლებმა აპის ავტორიზაცია ინსტალაციის ან დაკავშირების პროცესში შეძლონ.

  10. განყოფილებაში „სად შეიძლება ამ GitHub App-ის დაინსტალირება?“, აირჩიეთ ყველაზე ვიწრო ვარიანტი, რომელიც თქვენს გაშვებას შეესაბამება.

  11. შექმენით GitHub App.

ნებართვებისა და მოვლენების კონფიგურაცია

აირჩიეთ მინიმალური ნებართვები, რომლებიც საჭიროა ChatGPT-ის იმ ქმედებებისთვის, რომელთა ჩართვასაც გეგმავთ.

მხოლოდ წაკითხვადი რეპოზიტორიუმების აღმოჩენისა და კითხვა-პასუხისთვის დაიწყეთ წაკითხვის ნებართვებით, როგორიცაა:

  • მეტამონაცემები: მხოლოდ წაკითხვა. GitHub მოითხოვს მეტამონაცემებს GitHub Apps-ისთვის.

  • შიგთავსი: მხოლოდ წაკითხვა, ფაილისა და რეპოზიტორიუმის შიგთავსზე წვდომისთვის.

  • საკითხები: მხოლოდ წაკითხვა, თუ საჭიროა საკითხების ძიება ან კითხვა.

  • შერწყმის მოთხოვნები: მხოლოდ წაკითხვა, თუ საჭიროა შერწყმის მოთხოვნის ძიება ან განხილვის კონტექსტი.

  • ქმედებები: მხოლოდ წაკითხვა, თუ საჭიროა workflow-ის გაშვების სტატუსი, დავალებები, ჟურნალები ან არტეფაქტები.

ჩაწერის workflow-ებისთვის დაამატეთ ჩაწერის ნებართვები მხოლოდ იქ, სადაც საჭიროა, მაგალითად Contents, Pull requests, Issues, Actions ან Workflows. გამოიყენეთ ყველაზე ვიწრო ნებართვები, რომლებიც განკუთვნილ ChatGPT-ის ქმედებებს უჭერს მხარს.

Webhook-ის მოვლენები უნდა შეესაბამებოდეს workflow-ებს, რომლებსაც მხარს უჭერთ. ხშირი მოვლენებია Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run და Workflow job.

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. დაადასტურეთ, რომ გენერირებული 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. ჩართეთ აქტიური webhook-ები, თუ ისინი უკვე ჩართული არ არის.

  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 App ორგანიზაციაზე ან ანგარიშზე.

  2. აირჩიეთ ყველა რეპოზიტორიუმი ან შერჩეული რეპოზიტორიუმები სამუშაო სივრცის პოლიტიკის მიხედვით.

  3. დაიწყეთ დაკავშირების პროცესი ChatGPT-დან, როგორც დაშვებულმა მომხმარებელმა.

  4. მოთხოვნისას მიანიჭეთ ავტორიზაცია GitHub app-ს.

  5. ჯერ გაუშვით მცირე წაკითხვის ქმედება, მაგალითად ხელმისაწვდომი რეპოზიტორიუმების ჩამოთვლა ან ცნობილი შერწყმის მოთხოვნის მიღება.

  6. თუ ჩაწერის ქმედებები ჩართულია, ფართო გაშვებამდე დატესტეთ დაბალი რისკის რეპოზიტორიუმში.

ჰოსტის სახელი და OAuth-ის ქცევა

ChatGPT ჰოსტის სახელს იყენებს GitHub Enterprise-ის საბოლოო წერტილების გამოსაყვანად. შეიყვანეთ მხოლოდ ჰოსტი, მაგალითად github.example.com ან octocorp.ghe.com.

არ შეიყვანოთ API-ის ბილიკი, რეპოზიტორიუმის ბილიკი ან github.com, თუ ეს არ არის ზუსტი GitHub Enterprise-ის ჰოსტი ამ აპისთვის.

პრობლემების მოგვარება

  • Redirect URI-ის შეუსაბამობა: დაადასტურეთ, რომ GitHub App-ის callback URL ზუსტად ემთხვევა ChatGPT-ში ნაჩვენებ callback URL-ს.

  • ChatGPT ვერ ქმნის ან ინახავს აპის მონახაზს: დაადასტურეთ, რომ ყველა საჭირო ველი შევსებულია, მათ შორის ჰოსტის სახელი, OAuth კლიენტის ID, OAuth კლიენტის საიდუმლო, პირადი გასაღები და webhook-ის საიდუმლო.

  • ავთენტიფიკაცია წარმატებულია, მაგრამ რეპოზიტორიუმის გამოძახებები ვერ სრულდება: დაადასტურეთ, რომ GitHub App დაინსტალირებულია და რეპოზიტორიუმზე წვდომა აქვს.

  • API აბრუნებს 403-ს ან არასაკმარის ნებართვებს: დაამატეთ GitHub App-ის გამოტოვებული ნებართვა და, მოთხოვნის შემთხვევაში, ინსტალაციის მფლობელს განახლებული ნებართვების დამტკიცება სთხოვეთ.

  • რეპოზიტორიუმები არ ჩანს: დაადასტურეთ, რომ აპის ინსტალაცია მოიცავს მოსალოდნელ რეპოზიტორიუმებს და ChatGPT-ში ავტორიზაციის გამცემ მომხმარებელს მათზე წვდომა აქვს.

  • Webhook-ის მიწოდებები ვერ სრულდება: დაადასტურეთ, რომ webhook URL და webhook-ის საიდუმლო ემთხვევა ChatGPT-დან მიღებულ მნიშვნელობებს, დატოვეთ SSL შემოწმება ჩართული და დარწმუნდით, რომ GitHub Enterprise-ის ჰოსტს შეუძლია connectors.api.openai.org-თან დაკავშირება.

  • პირადი გასაღების შეცდომები: დაადასტურეთ, რომ დაკოპირებულია სრული PEM შიგთავსი, საწყისი და დასასრული ხაზების ჩათვლით.

ცნობები

სასარგებლო იყო ეს სტატია?