Omówienie
Skorzystaj z tego przewodnika, jeśli jesteś administratorem przestrzeni roboczej ChatGPT konfigurującym szablon aplikacji GitHub Enterprise dla swojej organizacji. Szablon nie jest ostateczną aplikacją używaną przez członków. Jest to przepływ konfiguracji, który tworzy wersję roboczą aplikacji właściwą dla przestrzeni roboczej po podaniu wymaganej konfiguracji GitHub Enterprise.
W przypadku GitHub Enterprise konfiguracja łączy ChatGPT z hostem GitHub Enterprise organizacji. Tworzysz GitHub App, rejestrujesz adres URL wywołania zwrotnego ChatGPT, generujesz dane uwierzytelniające, a następnie wklejasz te wartości w przepływie konfiguracji szablonu ChatGPT. Gdy ChatGPT utworzy wersję roboczą aplikacji, możesz ją opublikować i zarządzać nią tak jak innymi aplikacjami przestrzeni roboczej.
Co konfigurujesz
Tworzysz w ChatGPT aplikację GitHub Enterprise właściwą dla przestrzeni roboczej. Aplikacja używa:
GitHub App zarejestrowanej na hoście GitHub Enterprise.
Identyfikatora klienta i sekretu klienta GitHub App do autoryzacji użytkowników przez OAuth.
Klucza prywatnego GitHub App, aby ChatGPT mógł wystawiać tokeny instalacji do operacji na repozytoriach.
Sekretu webhooka i adresu URL webhooka, aby GitHub Enterprise mógł wysyłać zdarzenia instalacji i repozytoriów z powrotem do ChatGPT.
Nazwy hosta GitHub Enterprise, np.
github.example.com.
Utwórz GitHub App, a nie samodzielną GitHub OAuth App. Konfiguracja szablonu ChatGPT wymaga danych uwierzytelniających GitHub App, klucza prywatnego i ustawień webhooka.
Zanim zaczniesz
Potrzebujesz:
Dostępu administratora lub właściciela przestrzeni roboczej ChatGPT.
Dostępu administratora GitHub Enterprise lub właściciela organizacji, który może tworzyć i instalować GitHub Apps.
Samej nazwy hosta GitHub Enterprise, bez
https://ani ścieżki.Decyzji, które działania na repozytoriach ma obsługiwać ChatGPT, np. wyszukiwanie repozytoriów tylko do odczytu, przepływy pracy żądań pull request, przepływy pracy zgłoszeń, edycje plików, GitHub Actions lub szersze przepływy pracy Codex.
Bezpiecznego miejsca do obsługi klucza prywatnego i sekretu klienta GitHub App.
Pozostaw ChatGPT i GitHub Enterprise otwarte w osobnych kartach. Nie wymyślaj adresu URL wywołania zwrotnego. Skopiuj dokładny adres URL wywołania zwrotnego widoczny w ChatGPT.
Wartości do przygotowania
Nazwa hosta GitHub Enterprise: na przykład
github.example.com.Adres URL wywołania zwrotnego: skopiuj go z przepływu konfiguracji szablonu ChatGPT.
Identyfikator klienta GitHub App.
Sekret klienta GitHub App.
Klucz prywatny PEM GitHub App.
Sekret webhooka wygenerowany przez ChatGPT.
Adres URL webhooka wygenerowany po utworzeniu wersji roboczej aplikacji w ChatGPT.
Rozpocznij konfigurację szablonu w ChatGPT
W ChatGPT przełącz się do przestrzeni roboczej, w której aplikacja ma być dostępna.
Otwórz Ustawienia przestrzeni roboczej > Aplikacje.
Wybierz Katalog.
Wyszukaj GitHub Enterprise.
Wybierz szablon aplikacji GitHub Enterprise i rozpocznij konfigurację.
Wpisz jasną nazwę i opis aplikacji, np. GitHub Enterprise lub GitHub Enterprise - Engineering.
Wpisz nazwę hosta GitHub Enterprise, np.
github.example.com.Skopiuj adres URL wywołania zwrotnego widoczny w ChatGPT. Pozostaw tę kartę otwartą.
Skopiuj wygenerowany sekret webhooka, jeśli pojawi się podczas konfiguracji.
Przykładowy adres URL wywołania zwrotnego: https://chatgpt.com/connector/oauth/<callback_id>
Nie usuwaj identyfikatora wywołania zwrotnego, nie dodawaj ukośnika na końcu ani nie zastępuj go ogólnym adresem URL ChatGPT.
Utwórz GitHub App w GitHub Enterprise
Otwórz swój host GitHub Enterprise, np.
https://github.example.com.Przejdź do organizacji lub konta, które ma być właścicielem aplikacji.
Otwórz Ustawienia > Ustawienia deweloperskie > GitHub Apps.
Wybierz Nowa GitHub App.
Wpisz jasną nazwę aplikacji, np. ChatGPT GitHub Enterprise Connector.
Wpisz adres URL strony głównej. Jeśli nie ma dedykowanej strony wewnętrznej, użyj adresu URL organizacji GitHub Enterprise.
W polu Adres URL wywołania zwrotnego wklej dokładny adres URL wywołania zwrotnego skopiowany z ChatGPT.
Pozostaw włączone wygasanie tokenów autoryzacji użytkownika, chyba że zespół ds. bezpieczeństwa ma konkretny powód, aby to zmienić.
Włącz żądanie autoryzacji użytkownika podczas instalacji, aby użytkownicy mogli autoryzować aplikację w trakcie instalowania lub łączenia.
W sekcji Gdzie można zainstalować tę GitHub App?, wybierz najwęższą opcję pasującą do wdrożenia.
Utwórz GitHub App.
Skonfiguruj uprawnienia i zdarzenia
Wybierz minimalne uprawnienia wymagane dla działań ChatGPT, które planujesz włączyć.
W przypadku wykrywania repozytoriów i pytań oraz odpowiedzi tylko do odczytu zacznij od uprawnień do odczytu, takich jak:
Metadane: tylko do odczytu. GitHub wymaga metadanych dla GitHub Apps.
Zawartość: tylko do odczytu, na potrzeby dostępu do plików i zawartości repozytorium.
Zgłoszenia: tylko do odczytu, jeśli potrzebne jest wyszukiwanie lub odczytywanie zgłoszeń.
Żądania pull request: tylko do odczytu, jeśli potrzebne jest wyszukiwanie żądań pull request lub kontekst przeglądu.
Działania: tylko do odczytu, jeśli potrzebne są statusy uruchomień przepływów pracy, zadania, dzienniki lub artefakty.
W przypadku przepływów pracy z zapisem dodaj uprawnienia do zapisu tylko tam, gdzie są potrzebne, np. Zawartość, Żądania pull request, Zgłoszenia, Działania lub Przepływy pracy. Użyj najwęższych uprawnień obsługujących zamierzone działania ChatGPT.
Zdarzenia webhooków powinny odpowiadać obsługiwanym przepływom pracy. Typowe zdarzenia to Instalacja, Repozytoria instalacji, Push, Żądanie pull request, Zgłoszenia, Komentarz do zgłoszenia, Uruchomienie przepływu pracy i Zadanie przepływu pracy.
Wygeneruj i skopiuj dane uwierzytelniające GitHub App
W ustawieniach GitHub App skopiuj identyfikator klienta.
Wygeneruj sekret klienta i natychmiast go skopiuj.
W sekcji Klucze prywatne wygeneruj klucz prywatny.
Pobierz plik .pem i przechowuj go bezpiecznie.
Otwórz plik .pem lokalnie i skopiuj pełny tekst PEM, łącznie z liniami początkową i końcową.
Klucz prywatny jest poufny. Traktuj go jak dane uwierzytelniające. Jeśli zostanie ujawniony, wygeneruj nowy klucz prywatny, zaktualizuj konfigurację aplikacji ChatGPT i usuń naruszony klucz w GitHub Enterprise.
Dokończ konfigurację w ChatGPT
Wróć do karty konfiguracji szablonu ChatGPT.
Wklej identyfikator klienta GitHub App w polu Identyfikator klienta OAuth.
Wklej sekret klienta GitHub App w polu Sekret klienta OAuth.
Pozostaw Zakresy bez zmian, chyba że organizacja celowo musi zastąpić domyślne ustawienia szablonu.
Potwierdź, że nazwa hosta GitHub Enterprise zawiera tylko nazwę hosta, np.
github.example.com.Wklej lub prześlij klucz prywatny PEM GitHub App w polu klucza prywatnego GitHub App.
Potwierdź, że wygenerowany sekret webhooka jest obecny.
Utwórz wersję roboczą aplikacji.
Otwórz szczegóły utworzonej wersji roboczej aplikacji w ChatGPT i skopiuj wygenerowany adres URL webhooka.
Adres URL webhooka powinien wyglądać tak: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Dokończ konfigurację webhooka w GitHub Enterprise
Wróć do ustawień GitHub App w GitHub Enterprise.
Otwórz ustawienia ogólne GitHub App.
Włącz aktywne webhooki, jeśli nie są jeszcze włączone.
Wklej adres URL webhooka ChatGPT w polu Adres URL webhooka.
Wklej sekret webhooka ChatGPT w polu Sekret webhooka.
Pozostaw włączoną weryfikację SSL.
Potwierdź, że subskrybowane zdarzenia webhooka odpowiadają włączonym uprawnieniom i działaniom.
Zapisz zmiany.
Opublikuj aplikację i zarządzaj nią w ChatGPT
Utworzenie wersji roboczej aplikacji nie powoduje automatycznie jej udostępnienia członkom. Po sprawdzeniu wersji roboczej:
Opublikuj wersję roboczą aplikacji.
Potwierdź, że aplikacja pojawia się w Ustawienia przestrzeni roboczej > Aplikacje > Włączone.
Skonfiguruj Dostęp użytkowników dla ról, które powinny jej używać.
Sprawdź Kontrolę działań dla działań odczytu i zapisu.
Sprawdź Uprawnienia aplikacji, aby wybrać, kiedy ChatGPT pyta członków przed użyciem aplikacji.
Poproś dozwolonego użytkownika testowego, aby otworzył Aplikacje w ChatGPT i potwierdził, że aplikacja się pojawia.
Te uprawnienia aplikacji dotyczą rozmów w ChatGPT. Agenci przestrzeni roboczej używają kontroli właściwych dla danego agenta, ustawianych przez jego konstruktora, aby określić, które działania aplikacji są dostępne i kiedy użytkownicy końcowi są proszeni o ich zatwierdzenie. Informacje o zachowaniu agentów znajdziesz tutaj: Agenci przestrzeni roboczej ChatGPT dla Enterprise i Business.
Zainstaluj i przetestuj GitHub App
W GitHub Enterprise zainstaluj aplikację GitHub w organizacji lub na koncie.
Wybierz wszystkie repozytoria lub wybrane repozytoria zgodnie z zasadami przestrzeni roboczej.
Rozpocznij przepływ łączenia z ChatGPT jako dozwolony użytkownik.
Autoryzuj aplikację GitHub po wyświetleniu monitu.
Najpierw uruchom małe działanie odczytu, np. wyświetlenie dostępnych repozytoriów lub pobranie znanego żądania pull request.
Jeśli działania zapisu są włączone, przetestuj je w repozytorium o niskim ryzyku przed szerszym wdrożeniem.
Nazwa hosta i działanie OAuth
ChatGPT używa nazwy hosta do wyprowadzania punktów końcowych GitHub Enterprise. Wpisz tylko host, np. github.example.com lub octocorp.ghe.com.
Nie wpisuj ścieżki API, ścieżki repozytorium ani github.com, chyba że jest to dokładny host GitHub Enterprise dla tej aplikacji.
Rozwiązywanie problemów
Niezgodność identyfikatora URI przekierowania: potwierdź, że adres URL wywołania zwrotnego GitHub App dokładnie odpowiada adresowi URL wywołania zwrotnego widocznemu w ChatGPT.
ChatGPT nie może utworzyć ani zapisać wersji roboczej aplikacji: potwierdź, że podano wszystkie wymagane pola, w tym nazwę hosta, identyfikator klienta OAuth, sekret klienta OAuth, klucz prywatny i sekret webhooka.
Uwierzytelnianie się udaje, ale wywołania repozytorium kończą się niepowodzeniem: potwierdź, że GitHub App jest zainstalowana i ma dostęp do repozytorium.
API zwraca 403 lub niewystarczające uprawnienia: dodaj brakujące uprawnienie GitHub App i poproś właściciela instalacji o zatwierdzenie zaktualizowanych uprawnień, jeśli pojawi się monit.
Nie pojawiają się żadne repozytoria: potwierdź, że instalacja aplikacji obejmuje oczekiwane repozytoria i że użytkownik autoryzujący w ChatGPT ma do nich dostęp.
Dostarczenia webhooków kończą się niepowodzeniem: potwierdź, że adres URL webhooka i sekret webhooka odpowiadają wartościom z ChatGPT, pozostaw włączoną weryfikację SSL i upewnij się, że host GitHub Enterprise może uzyskać dostęp do
connectors.api.openai.org.Błędy klucza prywatnego: potwierdź, że skopiowano pełną zawartość PEM, łącznie z liniami początkową i końcową.