Przegląd
Skorzystaj z tego przewodnika, jeśli jako administrator przestrzeni roboczej ChatGPT konfigurujesz szablon aplikacji GitHub Enterprise dla swojej organizacji. Szablon nie jest gotową aplikacją, z której korzystają członkowie. To proces konfiguracji, który po podaniu wymaganych ustawień GitHub Enterprise tworzy wersję roboczą aplikacji przeznaczoną dla danej przestrzeni roboczej.
W przypadku GitHub Enterprise konfiguracja łączy ChatGPT z hostem GitHub Enterprise Twojej organizacji. Tworzysz aplikację GitHub, rejestrujesz adres URL wywołania zwrotnego ChatGPT, generujesz dane uwierzytelniające, a następnie wklejasz te wartości podczas konfiguracji szablonu w ChatGPT. Gdy ChatGPT utworzy wersję roboczą aplikacji, możesz ją opublikować i zarządzać nią tak jak innymi aplikacjami w przestrzeni roboczej.
Informacje o nawigacji w przestrzeni roboczej i dostępie do aplikacji znajdziesz w artykule: Ustawienia administracyjne, bezpieczeństwo i zgodność wtyczek i aplikacji.
Co konfigurujesz
Tworzysz w ChatGPT aplikację GitHub Enterprise przeznaczoną dla konkretnej przestrzeni roboczej. Aplikacja korzysta z:
Aplikacji GitHub zarejestrowanej na Twoim hoście GitHub Enterprise.
Identyfikatora klienta i klucza tajnego klienta aplikacji GitHub do autoryzacji użytkowników przez OAuth.
Klucza prywatnego aplikacji GitHub, dzięki któremu ChatGPT może generować tokeny instalacji do operacji na repozytoriach.
Klucza tajnego i adresu URL webhooka, dzięki którym GitHub Enterprise może przesyłać do ChatGPT zdarzenia dotyczące instalacji i repozytoriów.
Nazwy Twojego hosta GitHub Enterprise, np.
github.example.com.
Utwórz aplikację GitHub, a nie samodzielną aplikację GitHub OAuth. Konfiguracja szablonu w ChatGPT wymaga danych uwierzytelniających aplikacji GitHub, klucza prywatnego i ustawień webhooka.
Zanim zaczniesz
Potrzebujesz:
Uprawnień administratora lub właściciela przestrzeni roboczej ChatGPT.
Uprawnień administratora GitHub Enterprise lub właściciela organizacji, które pozwalają tworzyć i instalować aplikacje GitHub.
Samej nazwy hosta GitHub Enterprise, bez
https://ani ścieżki.Decyzji, jakie działania na repozytoriach ma obsługiwać ChatGPT, np. wyszukiwanie repozytoriów tylko do odczytu, obsługę pull request i zgłoszeń, edycję plików, GitHub Actions lub szersze przepływy pracy z Codex.
Bezpiecznego miejsca do pracy z kluczem prywatnym i kluczem tajnym klienta aplikacji GitHub.
Pozostaw ChatGPT i GitHub Enterprise otwarte w osobnych kartach. Nie twórz samodzielnie adresu URL wywołania zwrotnego. Skopiuj dokładny adres URL wywołania zwrotnego widoczny w ChatGPT.
Wartości do przygotowania
Nazwa hosta GitHub Enterprise: np.
github.example.com.Adres URL wywołania zwrotnego: skopiuj go z procesu konfiguracji szablonu w ChatGPT.
Identyfikator klienta aplikacji GitHub.
Klucz tajny klienta aplikacji GitHub.
Klucz prywatny aplikacji GitHub w formacie PEM.
Klucz tajny 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ę na przestrzeń roboczą, w której aplikacja ma być dostępna.
Otwórz Ustawienia przestrzeni roboczej > Aplikacje. Możesz też przejść do Konsoli administratora, wybrać odpowiednią przestrzeń roboczą ChatGPT i otworzyć Wtyczki. Wybierz Zarządzaj starszymi aplikacjami, aby otworzyć zachowaną stronę Aplikacje.
Wybierz Katalog.
Wyszukaj GitHub Enterprise.
Wybierz szablon aplikacji GitHub Enterprise i rozpocznij konfigurację.
Podaj zrozumiałą nazwę i opis aplikacji, np. GitHub Enterprise lub GitHub Enterprise – Inżynieria.
Podaj nazwę hosta GitHub Enterprise, np.
github.example.com.Skopiuj adres URL wywołania zwrotnego widoczny w ChatGPT. Pozostaw tę kartę otwartą.
Skopiuj wygenerowany klucz tajny 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 tego adresu ogólnym adresem URL ChatGPT.
Utwórz aplikację GitHub w GitHub Enterprise
Otwórz swojego hosta GitHub Enterprise, np.
https://github.example.com.Przejdź do organizacji lub konta, które ma być właścicielem aplikacji.
Otwórz Ustawienia > Ustawienia programistyczne > Aplikacje GitHub.
Wybierz Nowa aplikacja GitHub.
Podaj zrozumiałą nazwę aplikacji, np. Konektor GitHub Enterprise dla ChatGPT.
Podaj adres URL strony głównej. Jeśli nie ma dedykowanej strony wewnętrznej, użyj adresu URL organizacji w GitHub Enterprise.
W polu Adres URL wywołania zwrotnego wklej dokładny adres URL wywołania zwrotnego skopiowany z ChatGPT.
Pozostaw włączoną opcję Wygasanie tokenów autoryzacji użytkowników, chyba że Twój zespół ds. bezpieczeństwa ma konkretny powód, by to zmienić.
Włącz opcję Żądaj autoryzacji użytkownika podczas instalacji, aby użytkownicy mogli autoryzować aplikację w trakcie instalacji lub łączenia.
W sekcji „Gdzie można zainstalować tę aplikację GitHub?” wybierz opcję o najwęższym zakresie, która odpowiada Twojemu wdrożeniu.
Utwórz aplikację GitHub.
Skonfiguruj uprawnienia i zdarzenia
Wybierz minimalne uprawnienia wymagane do działań ChatGPT, które planujesz włączyć.
Aby umożliwić wyszukiwanie repozytoriów i odpowiadanie na pytania w trybie tylko do odczytu, zacznij od takich uprawnień do odczytu jak:
Metadane: tylko do odczytu. GitHub wymaga dostępu do metadanych dla aplikacji GitHub.
Zawartość: tylko do odczytu, aby zapewnić dostęp do plików i zawartości repozytoriów.
Zgłoszenia: tylko do odczytu, jeśli potrzebne jest wyszukiwanie lub odczytywanie zgłoszeń.
Pull requests: tylko do odczytu, jeśli potrzebne jest wyszukiwanie pull request lub dostęp do kontekstu przeglądu kodu.
Akcje: tylko do odczytu, jeśli potrzebny jest dostęp do stanu uruchomień przepływów pracy, zadań, dzienników lub artefaktów.
W przypadku przepływów pracy obejmujących zapis dodaj uprawnienia do zapisu tylko tam, gdzie są potrzebne, np. w kategoriach Zawartość, Pull requests, Zgłoszenia, Akcje lub Przepływy pracy. Nadaj możliwie najwęższy zakres uprawnień, który pozwala wykonywać zamierzone działania ChatGPT.
Zdarzenia webhooka powinny odpowiadać obsługiwanym przepływom pracy. Typowe zdarzenia to: Instalacja, Repozytoria instalacji, Wypchnięcie zmian, Pull request, Zgłoszenia, Komentarz do zgłoszenia, Uruchomienie przepływu pracy i Zadanie przepływu pracy.
Wygeneruj i skopiuj dane uwierzytelniające aplikacji GitHub
W ustawieniach aplikacji GitHub skopiuj Identyfikator klienta.
Wygeneruj Klucz tajny klienta i od razu go skopiuj.
W sekcji Klucze prywatne wygeneruj klucz prywatny.
Pobierz plik .pem i przechowuj go w bezpiecznym miejscu.
Otwórz plik .pem lokalnie i skopiuj cały tekst PEM, w tym wiersze początkowy i końcowy.
Klucz prywatny jest poufny. Chroń go tak jak inne dane uwierzytelniające. Jeśli zostanie ujawniony, wygeneruj nowy klucz prywatny, zaktualizuj konfigurację aplikacji w ChatGPT i usuń ujawniony klucz w GitHub Enterprise.
Dokończ konfigurację w ChatGPT
Wróć do karty konfiguracji szablonu w ChatGPT.
Wklej identyfikator klienta aplikacji GitHub w polu Identyfikator klienta OAuth.
Wklej klucz tajny klienta aplikacji GitHub w polu Klucz tajny klienta OAuth.
Pozostaw pole Zakresy bez zmian, chyba że Twoja organizacja ma konkretną potrzebę zmiany domyślnych ustawień szablonu.
Sprawdź, czy pole nazwy hosta GitHub Enterprise zawiera wyłącznie nazwę hosta, np.
github.example.com.Wklej lub prześlij klucz prywatny aplikacji GitHub w formacie PEM do pola Klucz prywatny aplikacji GitHub.
Sprawdź, czy wygenerowany klucz tajny 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 mieć następującą postać: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Dokończ konfigurację webhooka w GitHub Enterprise
Wróć do ustawień aplikacji GitHub w GitHub Enterprise.
Otwórz ustawienia ogólne aplikacji GitHub.
Włącz opcję Aktywne webhooki, jeśli nie jest jeszcze włączona.
Wklej adres URL webhooka z ChatGPT w polu Adres URL webhooka.
Wklej klucz tajny webhooka z ChatGPT w polu Klucz tajny webhooka.
Pozostaw włączoną weryfikację SSL.
Sprawdź, czy 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 udostępnia jej automatycznie członkom. Po sprawdzeniu wersji roboczej:
Opublikuj wersję roboczą aplikacji.
W Ustawieniach przestrzeni roboczej otwórz stronę Aplikacje, przejdź do sekcji Włączone i sprawdź, czy aplikacja jest widoczna. Możesz też otworzyć stronę Aplikacje, wybierając Zarządzaj starszymi aplikacjami w Konsoli administratora > Wtyczki.
Skonfiguruj Dostęp użytkowników dla ról, które mają korzystać z aplikacji.
Sprawdź ustawienia Kontroli działań dla operacji odczytu i zapisu.
Sprawdź Uprawnienia aplikacji, aby określić, kiedy ChatGPT ma pytać członków o zgodę przed użyciem aplikacji.
Poproś użytkownika testowego z przyznanym dostępem, aby otworzył Aplikacje w ChatGPT i sprawdził, czy aplikacja jest widoczna.
Te uprawnienia aplikacji dotyczą rozmów w ChatGPT. Agenty przestrzeni roboczej korzystają z ustawień określanych indywidualnie przez twórcę każdego agenta. Decydują one, które działania aplikacji są dostępne i kiedy użytkownicy końcowi są proszeni o ich zatwierdzenie. Informacje o działaniu agentów znajdziesz w artykule: Agenty przestrzeni roboczej ChatGPT w planach Enterprise i Business.
Zainstaluj i przetestuj aplikację GitHub
W GitHub Enterprise zainstaluj aplikację GitHub w organizacji lub na koncie.
Wybierz wszystkie repozytoria lub tylko wybrane, zgodnie z zasadami przestrzeni roboczej.
Rozpocznij proces łączenia z poziomu ChatGPT jako użytkownik z przyznanym dostępem.
Gdy pojawi się monit, autoryzuj aplikację GitHub.
Zacznij od prostej operacji odczytu, np. wyświetlenia listy dostępnych repozytoriów lub pobrania znanego pull request.
Jeśli włączono operacje zapisu, przed szerszym wdrożeniem przetestuj je w repozytorium, w którym ewentualne błędy niosą niewielkie ryzyko.
Nazwa hosta i działanie OAuth
ChatGPT ustala punkty końcowe GitHub Enterprise na podstawie nazwy hosta. Podaj wyłącznie nazwę hosta, np. github.example.com lub octocorp.ghe.com.
Nie podawaj ścieżki API ani ścieżki repozytorium. Nie wpisuj też github.com, chyba że jest to dokładna nazwa hosta GitHub Enterprise dla tej aplikacji.
Rozwiązywanie problemów
Niezgodność URI przekierowania: sprawdź, czy adres URL wywołania zwrotnego aplikacji GitHub jest identyczny z adresem widocznym w ChatGPT.
ChatGPT nie może utworzyć ani zapisać wersji roboczej aplikacji: sprawdź, czy uzupełniono wszystkie wymagane pola, w tym nazwę hosta, Identyfikator klienta OAuth, Klucz tajny klienta OAuth, klucz prywatny i klucz tajny webhooka.
Uwierzytelnianie działa, ale wywołania dotyczące repozytorium kończą się błędem: sprawdź, czy aplikacja GitHub jest zainstalowana i ma dostęp do repozytorium.
API zwraca kod 403 lub informację o niewystarczających uprawnieniach: dodaj brakujące uprawnienie aplikacji GitHub i, jeśli pojawi się taki monit, poproś właściciela instalacji o zatwierdzenie zaktualizowanych uprawnień.
Nie widać żadnych repozytoriów: sprawdź, czy instalacja aplikacji obejmuje oczekiwane repozytoria i czy użytkownik udzielający autoryzacji w ChatGPT ma do nich dostęp.
Dostarczanie webhooków kończy się błędem: sprawdź, czy adres URL i klucz tajny webhooka są zgodne z wartościami z ChatGPT, pozostaw włączoną weryfikację SSL i upewnij się, że host GitHub Enterprise może połączyć się z
connectors.api.openai.org.Błędy klucza prywatnego: sprawdź, czy skopiowano całą zawartość PEM, w tym wiersze początkowy i końcowy.