Επισκόπηση
Χρησιμοποιήστε αυτόν τον οδηγό αν είστε διαχειριστής χώρου εργασίας ChatGPT και ρυθμίζετε το πρότυπο εφαρμογής Enterprise του GitHub για τον οργανισμό σας. Ένα πρότυπο δεν είναι η τελική εφαρμογή που χρησιμοποιούν τα μέλη. Είναι μια ροή ρύθμισης που δημιουργεί μια πρόχειρη εφαρμογή ειδική για τον χώρο εργασίας, αφού παρέχετε την απαιτούμενη διαμόρφωση GitHub Enterprise.
Για το GitHub Enterprise, η ρύθμιση συνδέει το ChatGPT με τον κεντρικό υπολογιστή GitHub Enterprise του οργανισμού σας. Δημιουργείτε μια GitHub App, καταχωρίζετε το URL επιστροφής κλήσης του ChatGPT, δημιουργείτε διαπιστευτήρια και μετά επικολλάτε αυτές τις τιμές στη ροή ρύθμισης προτύπου ChatGPT. Αφού το ChatGPT δημιουργήσει την πρόχειρη εφαρμογή, μπορείτε να τη δημοσιεύσετε και να τη διαχειριστείτε όπως άλλες εφαρμογές χώρου εργασίας.
Τι ρυθμίζετε
Δημιουργείτε μια εφαρμογή GitHub Enterprise ειδική για τον χώρο εργασίας στο ChatGPT. Η εφαρμογή χρησιμοποιεί:
Μια GitHub App καταχωρισμένη στον κεντρικό υπολογιστή GitHub Enterprise.
Το client ID και το client secret της GitHub App για εξουσιοδότηση χρήστη OAuth.
Το ιδιωτικό κλειδί της GitHub App, ώστε το ChatGPT να μπορεί να εκδίδει token εγκατάστασης για λειτουργίες αποθετηρίου.
Ένα μυστικό webhook και ένα URL webhook, ώστε το 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.
Ένα ασφαλές μέρος για τον χειρισμό του ιδιωτικού κλειδιού και του client secret της GitHub App.
Κρατήστε το ChatGPT και το GitHub Enterprise ανοιχτά σε ξεχωριστές καρτέλες. Μην επινοήσετε το URL επιστροφής κλήσης. Αντιγράψτε το ακριβές URL επιστροφής κλήσης που εμφανίζεται στο ChatGPT.
Τιμές προς προετοιμασία
Όνομα κεντρικού υπολογιστή GitHub Enterprise: για παράδειγμα,
github.example.com.URL επιστροφής κλήσης: αντιγράψτε το από τη ροή ρύθμισης προτύπου ChatGPT.
Client ID της GitHub App.
Client secret της GitHub App.
PEM ιδιωτικού κλειδιού GitHub App.
Μυστικό webhook που δημιουργείται από το ChatGPT.
URL webhook που δημιουργείται αφού δημιουργηθεί η πρόχειρη εφαρμογή στο ChatGPT.
Ξεκινήστε τη ρύθμιση του προτύπου στο ChatGPT
Στο ChatGPT, μεταβείτε στον χώρο εργασίας όπου θα πρέπει να είναι διαθέσιμη η εφαρμογή.
Ανοίξτε τις Ρυθμίσεις χώρου εργασίας > Εφαρμογές.
Επιλέξτε Κατάλογος.
Αναζητήστε το GitHub Enterprise.
Επιλέξτε το πρότυπο εφαρμογής GitHub Enterprise και ξεκινήστε τη ρύθμιση.
Εισαγάγετε ένα σαφές όνομα και περιγραφή εφαρμογής, όπως GitHub Enterprise ή GitHub Enterprise - Engineering.
Εισαγάγετε το όνομα κεντρικού υπολογιστή του GitHub Enterprise, όπως
github.example.com.Αντιγράψτε το URL επιστροφής κλήσης που εμφανίζεται στο ChatGPT. Κρατήστε αυτήν την καρτέλα ανοιχτή.
Αντιγράψτε το δημιουργημένο μυστικό webhook αν εμφανίζεται κατά τη ρύθμιση.
Παράδειγμα URL επιστροφής κλήσης: https://chatgpt.com/connector/oauth/<callback_id>
Μην αφαιρέσετε το ID επιστροφής κλήσης, μην προσθέσετε τελική κάθετο και μην το αντικαταστήσετε με ένα γενικό URL του ChatGPT.
Δημιουργήστε τη GitHub App στο GitHub Enterprise
Ανοίξτε τον κεντρικό υπολογιστή GitHub Enterprise, όπως
https://github.example.com.Μεταβείτε στον οργανισμό ή τον λογαριασμό που θα πρέπει να κατέχει την εφαρμογή.
Ανοίξτε Ρυθμίσεις > Ρυθμίσεις προγραμματιστή > GitHub Apps.
Επιλέξτε Νέα GitHub App.
Εισαγάγετε ένα σαφές όνομα εφαρμογής, όπως ChatGPT GitHub Enterprise Connector.
Εισαγάγετε ένα URL αρχικής σελίδας. Αν δεν υπάρχει ειδική εσωτερική σελίδα, χρησιμοποιήστε το URL του οργανισμού GitHub Enterprise.
Στο URL επιστροφής κλήσης, επικολλήστε το ακριβές URL επιστροφής κλήσης που αντιγράψατε από το ChatGPT.
Διατηρήστε ενεργή τη λήξη των token εξουσιοδότησης χρήστη, εκτός αν η ομάδα ασφαλείας σας έχει συγκεκριμένο λόγο να την αλλάξει.
Ενεργοποιήστε την αίτηση εξουσιοδότησης χρήστη κατά την εγκατάσταση, ώστε οι χρήστες να μπορούν να εξουσιοδοτούν την εφαρμογή κατά τη ροή εγκατάστασης ή σύνδεσης.
Στην ενότητα Πού μπορεί να εγκατασταθεί αυτή η GitHub App;, επιλέξτε τη στενότερη επιλογή που ταιριάζει στην κυκλοφορία σας.
Δημιουργήστε τη GitHub App.
Διαμορφώστε δικαιώματα και συμβάντα
Επιλέξτε τα ελάχιστα δικαιώματα που απαιτούνται για τις ενέργειες ChatGPT που σκοπεύετε να ενεργοποιήσετε.
Για εντοπισμό αποθετηρίων μόνο για ανάγνωση και ερωτήσεις-απαντήσεις, ξεκινήστε με δικαιώματα ανάγνωσης όπως:
Μεταδεδομένα: μόνο για ανάγνωση. Το GitHub απαιτεί μεταδεδομένα για τις GitHub Apps.
Περιεχόμενα: μόνο για ανάγνωση, για πρόσβαση σε αρχεία και περιεχόμενο αποθετηρίου.
Ζητήματα: μόνο για ανάγνωση, αν απαιτείται αναζήτηση ή ανάγνωση ζητημάτων.
Αιτήματα συγχώνευσης κώδικα: μόνο για ανάγνωση, αν απαιτείται αναζήτηση αιτημάτων συγχώνευσης κώδικα ή πλαίσιο ελέγχου.
Ενέργειες: μόνο για ανάγνωση, αν απαιτούνται κατάσταση εκτέλεσης ροής εργασίας, εργασίες, αρχεία καταγραφής ή τεχνουργήματα.
Για ροές εργασίας εγγραφής, προσθέστε δικαιώματα εγγραφής μόνο όπου χρειάζεται, όπως Περιεχόμενα, Αιτήματα συγχώνευσης κώδικα, Ζητήματα, Ενέργειες ή Ροές εργασίας. Χρησιμοποιήστε τα στενότερα δικαιώματα που υποστηρίζουν τις προβλεπόμενες ενέργειες ChatGPT.
Τα συμβάντα webhook θα πρέπει να αντιστοιχούν στις ροές εργασίας που υποστηρίζετε. Συνηθισμένα συμβάντα περιλαμβάνουν Εγκατάσταση, Αποθετήρια εγκατάστασης, Push, Αίτημα συγχώνευσης κώδικα, Ζητήματα, Σχόλιο ζητήματος, Εκτέλεση ροής εργασίας και Εργασία ροής εργασίας.
Δημιουργήστε και αντιγράψτε διαπιστευτήρια GitHub App
Στις ρυθμίσεις GitHub App, αντιγράψτε το Client ID.
Δημιουργήστε ένα Client secret και αντιγράψτε το αμέσως.
Στην ενότητα Ιδιωτικά κλειδιά, δημιουργήστε ένα ιδιωτικό κλειδί.
Κατεβάστε το αρχείο .pem και αποθηκεύστε το με ασφάλεια.
Ανοίξτε το αρχείο .pem τοπικά και αντιγράψτε ολόκληρο το κείμενο PEM, συμπεριλαμβανομένων των γραμμών αρχής και τέλους.
Το ιδιωτικό κλειδί είναι ευαίσθητο. Χειριστείτε το σαν διαπιστευτήριο. Αν εκτεθεί, δημιουργήστε νέο ιδιωτικό κλειδί, ενημερώστε τη ρύθμιση εφαρμογής ChatGPT και διαγράψτε το παραβιασμένο κλειδί στο GitHub Enterprise.
Ολοκληρώστε τη ρύθμιση στο ChatGPT
Επιστρέψτε στην καρτέλα ρύθμισης προτύπου ChatGPT.
Επικολλήστε το Client ID της GitHub App στο Αναγνωριστικό πελάτη OAuth.
Επικολλήστε το Client secret της GitHub App στο Μυστικό πελάτη OAuth.
Αφήστε τα Πεδία εφαρμογής αμετάβλητα, εκτός αν ο οργανισμός σας χρειάζεται σκόπιμα να παρακάμψει τις προεπιλογές του προτύπου.
Επιβεβαιώστε ότι το όνομα κεντρικού υπολογιστή GitHub Enterprise είναι μόνο όνομα κεντρικού υπολογιστή, όπως
github.example.com.Επικολλήστε ή ανεβάστε το PEM ιδιωτικού κλειδιού GitHub App στο ιδιωτικό κλειδί GitHub App.
Επιβεβαιώστε ότι υπάρχει το δημιουργημένο μυστικό webhook.
Δημιουργήστε την πρόχειρη εφαρμογή.
Ανοίξτε τις λεπτομέρειες της δημιουργημένης πρόχειρης εφαρμογής στο ChatGPT και αντιγράψτε το δημιουργημένο URL webhook.
Το URL webhook θα πρέπει να μοιάζει με: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Ολοκληρώστε τη ρύθμιση webhook στο GitHub Enterprise
Επιστρέψτε στις ρυθμίσεις GitHub App στο GitHub Enterprise.
Ανοίξτε τις γενικές ρυθμίσεις GitHub App.
Ενεργοποιήστε τα ενεργά webhook αν δεν είναι ήδη ενεργοποιημένα.
Επικολλήστε το URL webhook του ChatGPT στο URL webhook.
Επικολλήστε το μυστικό webhook του ChatGPT στο μυστικό webhook.
Διατηρήστε ενεργή την επαλήθευση SSL.
Επιβεβαιώστε ότι τα εγγεγραμμένα συμβάντα webhook αντιστοιχούν στα δικαιώματα και τις ενέργειες που ενεργοποιήσατε.
Αποθηκεύστε τις αλλαγές.
Δημοσιεύστε και διαχειριστείτε την εφαρμογή στο ChatGPT
Η δημιουργία της πρόχειρης εφαρμογής δεν την καθιστά αυτόματα διαθέσιμη στα μέλη. Αφού ελέγξετε το πρόχειρο:
Δημοσιεύστε την πρόχειρη εφαρμογή.
Επιβεβαιώστε ότι η εφαρμογή εμφανίζεται στις Ρυθμίσεις χώρου εργασίας > Εφαρμογές > Ενεργοποιημένες.
Διαμορφώστε την Πρόσβαση χρήστη για τους ρόλους που θα πρέπει να τη χρησιμοποιούν.
Ελέγξτε τον Έλεγχο ενεργειών για ενέργειες ανάγνωσης και εγγραφής.
Ελέγξτε τα Δικαιώματα εφαρμογής για να επιλέξετε πότε το ChatGPT ρωτά τα μέλη πριν χρησιμοποιήσει την εφαρμογή.
Ζητήστε από έναν επιτρεπόμενο δοκιμαστικό χρήστη να ανοίξει τις Εφαρμογές στο ChatGPT και να επιβεβαιώσει ότι εμφανίζεται η εφαρμογή.
Αυτά τα δικαιώματα εφαρμογής ισχύουν για συνομιλίες ChatGPT. Οι πράκτορες χώρου εργασίας χρησιμοποιούν στοιχεία ελέγχου ανά πράκτορα που ορίζονται από τον δημιουργό του πράκτορα για να καθορίζουν ποιες ενέργειες εφαρμογής είναι διαθέσιμες και πότε ζητείται από τους τελικούς χρήστες να τις εγκρίνουν. Για τη συμπεριφορά πράκτορα, δείτε: Πράκτορες χώρου εργασίας ChatGPT για Enterprise και Business.
Εγκαταστήστε και δοκιμάστε τη GitHub App
Στο GitHub Enterprise, εγκαταστήστε τη GitHub app στον οργανισμό ή τον λογαριασμό.
Επιλέξτε όλα τα αποθετήρια ή επιλεγμένα αποθετήρια σύμφωνα με την πολιτική του χώρου εργασίας.
Ξεκινήστε τη ροή σύνδεσης από το ChatGPT ως επιτρεπόμενος χρήστης.
Εξουσιοδοτήστε τη GitHub app όταν σας ζητηθεί.
Εκτελέστε πρώτα μια μικρή ενέργεια ανάγνωσης, όπως καταχώριση προσβάσιμων αποθετηρίων ή ανάκτηση ενός γνωστού αιτήματος συγχώνευσης κώδικα.
Αν είναι ενεργοποιημένες ενέργειες εγγραφής, δοκιμάστε με ένα αποθετήριο χαμηλού κινδύνου πριν από ευρύτερη κυκλοφορία.
Συμπεριφορά ονόματος κεντρικού υπολογιστή και OAuth
Το ChatGPT χρησιμοποιεί το όνομα κεντρικού υπολογιστή για να αντλήσει τελικά σημεία GitHub Enterprise. Εισαγάγετε μόνο τον κεντρικό υπολογιστή, όπως github.example.com ή octocorp.ghe.com.
Μην εισαγάγετε διαδρομή API, διαδρομή αποθετηρίου ή github.com, εκτός αν αυτός είναι ο ακριβής κεντρικός υπολογιστής GitHub Enterprise για αυτήν την εφαρμογή.
Αντιμετώπιση προβλημάτων
Ασυμφωνία URI ανακατεύθυνσης: επιβεβαιώστε ότι το URL επιστροφής κλήσης της GitHub App ταιριάζει ακριβώς με το URL επιστροφής κλήσης που εμφανίζεται στο ChatGPT.
Το ChatGPT δεν μπορεί να δημιουργήσει ή να αποθηκεύσει την πρόχειρη εφαρμογή: επιβεβαιώστε ότι υπάρχουν όλα τα απαιτούμενα πεδία, συμπεριλαμβανομένων του ονόματος κεντρικού υπολογιστή, του αναγνωριστικού πελάτη OAuth, του μυστικού πελάτη OAuth, του ιδιωτικού κλειδιού και του μυστικού webhook.
Ο έλεγχος ταυτότητας πετυχαίνει, αλλά οι κλήσεις αποθετηρίου αποτυγχάνουν: επιβεβαιώστε ότι η GitHub App είναι εγκατεστημένη και έχει πρόσβαση στο αποθετήριο.
Το API επιστρέφει 403 ή ανεπαρκή δικαιώματα: προσθέστε το δικαίωμα GitHub App που λείπει και ζητήστε από τον κάτοχο εγκατάστασης να εγκρίνει τα ενημερωμένα δικαιώματα, αν ζητηθεί.
Δεν εμφανίζονται αποθετήρια: επιβεβαιώστε ότι η εγκατάσταση εφαρμογής περιλαμβάνει τα αναμενόμενα αποθετήρια και ότι ο χρήστης που εξουσιοδοτεί στο ChatGPT έχει πρόσβαση σε αυτά.
Οι παραδόσεις webhook αποτυγχάνουν: επιβεβαιώστε ότι το URL webhook και το μυστικό webhook ταιριάζουν με τις τιμές από το ChatGPT, διατηρήστε ενεργή την επαλήθευση SSL και βεβαιωθείτε ότι ο κεντρικός υπολογιστής GitHub Enterprise μπορεί να φτάσει στο
connectors.api.openai.org.Σφάλματα ιδιωτικού κλειδιού: επιβεβαιώστε ότι αντιγράφηκε ολόκληρο το περιεχόμενο PEM, συμπεριλαμβανομένων των γραμμών αρχής και τέλους.