Επισκόπηση
Χρησιμοποιήστε αυτόν τον οδηγό αν είστε διαχειριστής χώρου εργασίας του ChatGPT και ρυθμίζετε το πρότυπο εφαρμογής GitHub Enterprise για τον οργανισμό σας. Το πρότυπο δεν είναι η τελική εφαρμογή που χρησιμοποιούν τα μέλη. Είναι μια διαδικασία ρύθμισης που δημιουργεί ένα προσχέδιο εφαρμογής ειδικά για τον χώρο εργασίας σας, αφού δώσετε τα απαιτούμενα στοιχεία διαμόρφωσης του GitHub Enterprise.
Για το GitHub Enterprise, η ρύθμιση συνδέει το ChatGPT με τον διακομιστή GitHub Enterprise του οργανισμού σας. Δημιουργείτε μια εφαρμογή GitHub, καταχωρίζετε το URL επανάκλησης του ChatGPT, δημιουργείτε διαπιστευτήρια και, στη συνέχεια, επικολλάτε αυτές τις τιμές στη διαδικασία ρύθμισης του προτύπου στο ChatGPT. Αφού το ChatGPT δημιουργήσει το προσχέδιο της εφαρμογής, μπορείτε να το δημοσιεύσετε και να το διαχειριστείτε όπως τις άλλες εφαρμογές του χώρου εργασίας.
Για την πλοήγηση στον χώρο εργασίας και την πρόσβαση στις εφαρμογές, δείτε: Στοιχεία ελέγχου διαχειριστή, ασφάλεια και συμμόρφωση για πρόσθετα και εφαρμογές.
Τι ρυθμίζετε
Δημιουργείτε μια εφαρμογή GitHub Enterprise στο ChatGPT ειδικά για τον χώρο εργασίας σας. Η εφαρμογή χρησιμοποιεί:
Μια εφαρμογή GitHub καταχωρισμένη στον διακομιστή GitHub Enterprise σας.
Το αναγνωριστικό πελάτη και το μυστικό πελάτη της εφαρμογής GitHub για την εξουσιοδότηση χρηστών μέσω OAuth.
Το ιδιωτικό κλειδί της εφαρμογής GitHub, ώστε το ChatGPT να μπορεί να εκδίδει διακριτικά εγκατάστασης για λειτουργίες στα αποθετήρια.
Ένα μυστικό webhook και ένα URL webhook, ώστε το GitHub Enterprise να μπορεί να στέλνει συμβάντα εγκατάστασης και αποθετηρίων πίσω στο ChatGPT.
Το όνομα κεντρικού υπολογιστή του GitHub Enterprise σας, όπως
github.example.com.
Δημιουργήστε μια εφαρμογή GitHub, όχι μια αυτόνομη εφαρμογή OAuth του GitHub. Η ρύθμιση του προτύπου στο ChatGPT απαιτεί διαπιστευτήρια εφαρμογής GitHub, ένα ιδιωτικό κλειδί και ρυθμίσεις webhook.
Πριν ξεκινήσετε
Θα χρειαστείτε:
Πρόσβαση διαχειριστή ή κατόχου στον χώρο εργασίας του ChatGPT.
Πρόσβαση διαχειριστή GitHub Enterprise ή κατόχου οργανισμού, με δυνατότητα δημιουργίας και εγκατάστασης εφαρμογών GitHub.
Μόνο το όνομα κεντρικού υπολογιστή του GitHub Enterprise, χωρίς
https://ή διαδρομή.Να έχετε αποφασίσει ποιες ενέργειες αποθετηρίων θα πρέπει να υποστηρίζει το ChatGPT, όπως αναζήτηση αποθετηρίων μόνο για ανάγνωση, ροές εργασίας για pull request, ροές εργασίας για ζητήματα, επεξεργασία αρχείων, GitHub Actions ή ευρύτερες ροές εργασίας του Codex.
Έναν ασφαλή χώρο για τη διαχείριση του ιδιωτικού κλειδιού και του μυστικού πελάτη της εφαρμογής GitHub.
Κρατήστε το ChatGPT και το GitHub Enterprise ανοιχτά σε ξεχωριστές καρτέλες. Μη δημιουργήσετε μόνοι σας το URL επανάκλησης. Αντιγράψτε το ακριβές URL επανάκλησης που εμφανίζεται στο ChatGPT.
Τιμές που πρέπει να προετοιμάσετε
Όνομα κεντρικού υπολογιστή του GitHub Enterprise: για παράδειγμα,
github.example.com.URL επανάκλησης: αντιγράψτε το από τη διαδικασία ρύθμισης του προτύπου στο ChatGPT.
Αναγνωριστικό πελάτη της εφαρμογής GitHub.
Μυστικό πελάτη της εφαρμογής GitHub.
Ιδιωτικό κλειδί PEM της εφαρμογής GitHub.
Μυστικό webhook που δημιουργείται από το ChatGPT.
URL webhook που δημιουργείται μετά τη δημιουργία του προσχεδίου της εφαρμογής στο ChatGPT.
Ξεκινήστε τη ρύθμιση του προτύπου στο ChatGPT
Στο ChatGPT, μεταβείτε στον χώρο εργασίας όπου θέλετε να είναι διαθέσιμη η εφαρμογή.
Ανοίξτε τις Ρυθμίσεις χώρου εργασίας > Εφαρμογές. Μπορείτε επίσης να μεταβείτε στην Κονσόλα διαχειριστή, να επιλέξετε τον επιθυμητό χώρο εργασίας του ChatGPT και να ανοίξετε τα Πρόσθετα. Επιλέξτε Διαχείριση παλαιών εφαρμογών για να ανοίξετε την παλαιά σελίδα Εφαρμογές που παραμένει διαθέσιμη.
Επιλέξτε Κατάλογος.
Αναζητήστε το GitHub Enterprise.
Επιλέξτε το πρότυπο εφαρμογής GitHub Enterprise και ξεκινήστε τη ρύθμιση.
Εισαγάγετε ένα σαφές όνομα και μια περιγραφή για την εφαρμογή, όπως GitHub Enterprise ή GitHub Enterprise - Ομάδα ανάπτυξης.
Εισαγάγετε το όνομα κεντρικού υπολογιστή του GitHub Enterprise, όπως
github.example.com.Αντιγράψτε το URL επανάκλησης που εμφανίζεται στο ChatGPT. Κρατήστε αυτή την καρτέλα ανοιχτή.
Αντιγράψτε το μυστικό webhook που δημιουργήθηκε, αν εμφανίζεται κατά τη ρύθμιση.
Παράδειγμα URL επανάκλησης: https://chatgpt.com/connector/oauth/<callback_id>
Μην αφαιρέσετε το αναγνωριστικό επανάκλησης, μην προσθέσετε κάθετο στο τέλος και μην αντικαταστήσετε το URL με ένα γενικό URL του ChatGPT.
Δημιουργήστε την εφαρμογή GitHub στο GitHub Enterprise
Ανοίξτε τον διακομιστή GitHub Enterprise σας, όπως
https://github.example.com.Μεταβείτε στον οργανισμό ή στον λογαριασμό στον οποίο θα πρέπει να ανήκει η εφαρμογή.
Ανοίξτε τις Ρυθμίσεις > Ρυθμίσεις προγραμματιστή > Εφαρμογές GitHub.
Επιλέξτε Νέα εφαρμογή GitHub.
Εισαγάγετε ένα σαφές όνομα εφαρμογής, όπως Σύνδεση ChatGPT με GitHub Enterprise.
Εισαγάγετε ένα URL αρχικής σελίδας. Αν δεν υπάρχει ειδική εσωτερική σελίδα, χρησιμοποιήστε το URL του οργανισμού στο GitHub Enterprise.
Στο πεδίο URL επανάκλησης, επικολλήστε το ακριβές URL επανάκλησης που αντιγράψατε από το ChatGPT.
Διατηρήστε ενεργοποιημένη την επιλογή Λήξη διακριτικών εξουσιοδότησης χρήστη, εκτός αν η ομάδα ασφάλειας έχει συγκεκριμένο λόγο να την αλλάξει.
Ενεργοποιήστε την επιλογή Αίτημα εξουσιοδότησης χρήστη κατά την εγκατάσταση, ώστε οι χρήστες να μπορούν να εξουσιοδοτούν την εφαρμογή κατά τη διαδικασία εγκατάστασης ή σύνδεσης.
Στην ενότητα «Πού μπορεί να εγκατασταθεί αυτή η εφαρμογή GitHub;», επιλέξτε την πιο περιορισμένη επιλογή που καλύπτει το σχέδιο διάθεσής σας.
Δημιουργήστε την εφαρμογή GitHub.
Ρυθμίστε δικαιώματα και συμβάντα
Επιλέξτε τα ελάχιστα δικαιώματα που απαιτούνται για τις ενέργειες του ChatGPT που σκοπεύετε να ενεργοποιήσετε.
Για εντοπισμό αποθετηρίων και ερωτήσεις και απαντήσεις με πρόσβαση μόνο για ανάγνωση, ξεκινήστε με δικαιώματα ανάγνωσης όπως:
Μεταδεδομένα: μόνο για ανάγνωση. Το GitHub απαιτεί πρόσβαση στα μεταδεδομένα για τις εφαρμογές GitHub.
Περιεχόμενα: μόνο για ανάγνωση, για πρόσβαση στο περιεχόμενο αρχείων και αποθετηρίων.
Ζητήματα: μόνο για ανάγνωση, αν χρειάζεται αναζήτηση ή ανάγνωση ζητημάτων.
Pull requests: μόνο για ανάγνωση, αν χρειάζεται αναζήτηση pull request ή πληροφορίες για την ανασκόπησή τους.
Ενέργειες: μόνο για ανάγνωση, αν χρειάζονται στοιχεία για την κατάσταση εκτέλεσης ροών εργασίας, εργασίες, αρχεία καταγραφής ή παραγόμενα αρχεία.
Για ροές εργασίας με δυνατότητα εγγραφής, προσθέστε δικαιώματα εγγραφής μόνο όπου χρειάζεται, όπως στα Περιεχόμενα, Pull requests, Ζητήματα, Ενέργειες ή Ροές εργασίας. Χρησιμοποιήστε τα πιο περιορισμένα δικαιώματα που επιτρέπουν τις προβλεπόμενες ενέργειες του ChatGPT.
Τα συμβάντα webhook θα πρέπει να αντιστοιχούν στις ροές εργασίας που υποστηρίζετε. Στα συνηθισμένα συμβάντα περιλαμβάνονται τα εξής: Εγκατάσταση, Αποθετήρια εγκατάστασης, Προώθηση, Pull request, Ζητήματα, Σχόλιο σε ζήτημα, Εκτέλεση ροής εργασίας και Εργασία ροής εργασίας.
Δημιουργήστε και αντιγράψτε τα διαπιστευτήρια της εφαρμογής GitHub
Στις ρυθμίσεις της εφαρμογής GitHub, αντιγράψτε το Αναγνωριστικό πελάτη.
Δημιουργήστε ένα Μυστικό πελάτη και αντιγράψτε το αμέσως.
Στην ενότητα Ιδιωτικά κλειδιά, δημιουργήστε ένα ιδιωτικό κλειδί.
Κατεβάστε το αρχείο .pem και αποθηκεύστε το με ασφάλεια.
Ανοίξτε το αρχείο .pem τοπικά και αντιγράψτε ολόκληρο το κείμενο PEM, συμπεριλαμβανομένων των γραμμών αρχής και τέλους.
Το ιδιωτικό κλειδί είναι ευαίσθητο στοιχείο. Χειριστείτε το όπως ένα διαπιστευτήριο. Αν διαρρεύσει, δημιουργήστε ένα νέο ιδιωτικό κλειδί, ενημερώστε τις ρυθμίσεις της εφαρμογής στο ChatGPT και διαγράψτε το παραβιασμένο κλειδί στο GitHub Enterprise.
Ολοκληρώστε τη ρύθμιση στο ChatGPT
Επιστρέψτε στην καρτέλα ρύθμισης του προτύπου στο ChatGPT.
Επικολλήστε το αναγνωριστικό πελάτη της εφαρμογής GitHub στο πεδίο Αναγνωριστικό πελάτη OAuth.
Επικολλήστε το μυστικό πελάτη της εφαρμογής GitHub στο πεδίο Μυστικό πελάτη OAuth.
Αφήστε τα Πεδία πρόσβασης αμετάβλητα, εκτός αν ο οργανισμός σας έχει συγκεκριμένη ανάγκη να παρακάμψει τις προεπιλογές του προτύπου.
Βεβαιωθείτε ότι το όνομα κεντρικού υπολογιστή του GitHub Enterprise περιλαμβάνει μόνο το όνομα, όπως
github.example.com.Επικολλήστε ή μεταφορτώστε το ιδιωτικό κλειδί PEM της εφαρμογής GitHub στο πεδίο Ιδιωτικό κλειδί εφαρμογής GitHub.
Βεβαιωθείτε ότι υπάρχει το μυστικό webhook που δημιουργήθηκε.
Δημιουργήστε το προσχέδιο της εφαρμογής.
Ανοίξτε τις λεπτομέρειες του προσχεδίου εφαρμογής που δημιουργήθηκε στο ChatGPT και αντιγράψτε το URL webhook που δημιουργήθηκε.
Το URL webhook θα πρέπει να έχει τη μορφή: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Ολοκληρώστε τη ρύθμιση του webhook στο GitHub Enterprise
Επιστρέψτε στις ρυθμίσεις της εφαρμογής GitHub στο GitHub Enterprise.
Ανοίξτε τις Γενικές ρυθμίσεις της εφαρμογής GitHub.
Ενεργοποιήστε την επιλογή Ενεργά webhook, αν δεν είναι ήδη ενεργοποιημένη.
Επικολλήστε το URL webhook του ChatGPT στο πεδίο URL webhook.
Επικολλήστε το μυστικό webhook του ChatGPT στο πεδίο Μυστικό webhook.
Διατηρήστε ενεργοποιημένη την επαλήθευση SSL.
Βεβαιωθείτε ότι τα συμβάντα webhook στα οποία έχετε εγγραφεί αντιστοιχούν στα δικαιώματα και στις ενέργειες που ενεργοποιήσατε.
Αποθηκεύστε τις αλλαγές.
Δημοσιεύστε και διαχειριστείτε την εφαρμογή στο ChatGPT
Η δημιουργία του προσχεδίου της εφαρμογής δεν την καθιστά αυτόματα διαθέσιμη στα μέλη. Αφού ελέγξετε το προσχέδιο:
Δημοσιεύστε το προσχέδιο της εφαρμογής.
Στις Ρυθμίσεις χώρου εργασίας, ανοίξτε τη σελίδα Εφαρμογές, ανοίξτε την ενότητα Ενεργοποιημένες και βεβαιωθείτε ότι εμφανίζεται η εφαρμογή. Μπορείτε επίσης να ανοίξετε τη σελίδα Εφαρμογές μέσω της επιλογής Διαχείριση παλαιών εφαρμογών στην Κονσόλα διαχειριστή > Πρόσθετα.
Ρυθμίστε την Πρόσβαση χρηστών για τους ρόλους που θα πρέπει να τη χρησιμοποιούν.
Ελέγξτε τον Έλεγχο ενεργειών για ενέργειες ανάγνωσης και εγγραφής.
Ελέγξτε τα Δικαιώματα εφαρμογής για να επιλέξετε πότε το ChatGPT θα ζητά άδεια από τα μέλη πριν χρησιμοποιήσει την εφαρμογή.
Ζητήστε από έναν δοκιμαστικό χρήστη με άδεια πρόσβασης να ανοίξει τις Εφαρμογές στο ChatGPT και να επιβεβαιώσει ότι εμφανίζεται η εφαρμογή.
Αυτά τα δικαιώματα εφαρμογής ισχύουν για τις συνομιλίες στο ChatGPT. Οι πράκτορες χώρου εργασίας χρησιμοποιούν ξεχωριστά στοιχεία ελέγχου για κάθε πράκτορα, τα οποία ορίζει ο δημιουργός του, ώστε να καθορίζεται ποιες ενέργειες εφαρμογών είναι διαθέσιμες και πότε ζητείται από τους τελικούς χρήστες να τις εγκρίνουν. Για τη συμπεριφορά των πρακτόρων, δείτε: Πράκτορες χώρου εργασίας του ChatGPT για Enterprise και Business.
Εγκαταστήστε και δοκιμάστε την εφαρμογή GitHub
Στο GitHub Enterprise, εγκαταστήστε την εφαρμογή GitHub στον οργανισμό ή στον λογαριασμό.
Επιλέξτε όλα τα αποθετήρια ή συγκεκριμένα αποθετήρια, σύμφωνα με την πολιτική του χώρου εργασίας.
Ξεκινήστε τη διαδικασία σύνδεσης από το ChatGPT ως χρήστης με άδεια πρόσβασης.
Εξουσιοδοτήστε την εφαρμογή GitHub όταν σας ζητηθεί.
Εκτελέστε πρώτα μια απλή ενέργεια ανάγνωσης, όπως εμφάνιση των προσβάσιμων αποθετηρίων ή ανάκτηση ενός γνωστού pull request.
Αν είναι ενεργοποιημένες οι ενέργειες εγγραφής, κάντε μια δοκιμή σε αποθετήριο χαμηλού κινδύνου πριν από την ευρύτερη διάθεση.
Όνομα κεντρικού υπολογιστή και συμπεριφορά OAuth
Το ChatGPT χρησιμοποιεί το όνομα κεντρικού υπολογιστή για να προσδιορίσει τα τελικά σημεία του GitHub Enterprise. Εισαγάγετε μόνο το όνομα κεντρικού υπολογιστή, όπως github.example.com ή octocorp.ghe.com.
Μην εισαγάγετε διαδρομή API, διαδρομή αποθετηρίου ή github.com, εκτός αν αυτός είναι πράγματι ο διακομιστής GitHub Enterprise για αυτή την εφαρμογή.
Αντιμετώπιση προβλημάτων
Αναντιστοιχία URI ανακατεύθυνσης: βεβαιωθείτε ότι το URL επανάκλησης της εφαρμογής GitHub ταιριάζει ακριβώς με το URL επανάκλησης που εμφανίζεται στο ChatGPT.
Το ChatGPT δεν μπορεί να δημιουργήσει ή να αποθηκεύσει το προσχέδιο της εφαρμογής: βεβαιωθείτε ότι έχουν συμπληρωθεί όλα τα απαιτούμενα πεδία, συμπεριλαμβανομένων των πεδίων όνομα κεντρικού υπολογιστή, Αναγνωριστικό πελάτη OAuth, Μυστικό πελάτη OAuth, ιδιωτικό κλειδί και μυστικό webhook.
Ο έλεγχος ταυτότητας επιτυγχάνει, αλλά οι κλήσεις προς το αποθετήριο αποτυγχάνουν: βεβαιωθείτε ότι η εφαρμογή GitHub είναι εγκατεστημένη και έχει πρόσβαση στο αποθετήριο.
Το API επιστρέφει 403 ή ανεπαρκή δικαιώματα: προσθέστε το δικαίωμα που λείπει από την εφαρμογή GitHub και ζητήστε από τον κάτοχο της εγκατάστασης να εγκρίνει τα ενημερωμένα δικαιώματα, αν ζητηθεί.
Δεν εμφανίζονται αποθετήρια: βεβαιωθείτε ότι η εγκατάσταση της εφαρμογής περιλαμβάνει τα αναμενόμενα αποθετήρια και ότι ο χρήστης που παρέχει εξουσιοδότηση στο ChatGPT έχει πρόσβαση σε αυτά.
Οι παραδόσεις webhook αποτυγχάνουν: βεβαιωθείτε ότι το URL webhook και το μυστικό webhook ταιριάζουν με τις τιμές από το ChatGPT, διατηρήστε ενεργοποιημένη την επαλήθευση SSL και βεβαιωθείτε ότι ο διακομιστής GitHub Enterprise μπορεί να συνδεθεί στο
connectors.api.openai.org.Σφάλματα ιδιωτικού κλειδιού: βεβαιωθείτε ότι αντιγράφηκε ολόκληρο το περιεχόμενο PEM, συμπεριλαμβανομένων των γραμμών αρχής και τέλους.