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-ის უკუგამოძახების 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 Apps-ის შექმნისა და დაყენების საშუალებას იძლევა.

  • მხოლოდ 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-ის მიერ გენერირებული ვებჰუკის საიდუმლო გასაღები.

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

დაიწყეთ შაბლონის დაყენება 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, არ დაამატოთ ბოლოში დახრილი ხაზი და არ ჩაანაცვლოთ მისამართი ChatGPT-ის ზოგადი URL-ით.

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

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

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

  3. გახსენით პარამეტრები > დეველოპერის პარამეტრები > GitHub Apps.

  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 Apps-ისთვის.

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

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

  • 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 App-ის პარამეტრებში GitHub Enterprise-ში.

  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-ის სრული შიგთავსი დაკოპირებულია, საწყისი და ბოლო ხაზების ჩათვლით.

წყაროები

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