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

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

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

განახლებულია: 10 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 აპის შექმნა GitHub Enterprise-ში

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

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

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

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

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

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

  7. ველში „უკუგამოძახების URL“ ჩასვით ChatGPT-დან კოპირებული უკუგამოძახების URL ზუსტად, ცვლილებების გარეშე.

  8. დატოვეთ ჩართული პარამეტრი „მომხმარებლის ავტორიზაციის ტოკენების მოქმედების ვადის შეზღუდვა“, თუ თქვენს უსაფრთხოების გუნდს მისი შეცვლის კონკრეტული მიზეზი არ აქვს.

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

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

  11. შექმენით GitHub აპი.

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

აირჩიეთ მინიმალური ნებართვები, რომლებიც საჭიროა 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. Enterprise-სა და Edu-ში გამოიყენეთ მომხმარებელთა წვდომა, რათა აირჩიოთ, რომელი როლების მქონე მომხმარებლებს შეეძლებათ აპის გამოყენება. Business-ში მართეთ აპის ხელმისაწვდომობა მთელ სამუშაო სივრცეში.

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

წყაროები

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