Skorzystaj z tego przewodnika, jeśli jesteś administratorem przestrzeni roboczej ChatGPT albo użytkownikiem ChatGPT Plus lub Pro i konfigurujesz łącznik Databricks Genie przy użyciu klienta OAuth Databricks swojej organizacji.
W przypadku Databricks większość konfiguracji odbywa się w konsoli konta Databricks. Utwórz niestandardowe połączenie aplikacji OAuth, zarejestruj adres URL wywołania zwrotnego ChatGPT, skopiuj wygenerowane dane logowania klienta, a następnie wprowadź te wartości podczas konfiguracji łącznika w ChatGPT.
Co konfigurujesz
Tworzysz połączenie z aplikacją Databricks dla swojego konta lub swojej przestrzeni roboczej ChatGPT. Połączenie korzysta z:
Połączenia z aplikacją OAuth Databricks utworzonego w konsoli konta Databricks.
Identyfikatora i klucza tajnego klienta OAuth Databricks.
Dokładnego adresu URL wywołania zwrotnego skopiowanego z ChatGPT.
Zakresów Databricks odpowiadających funkcjom łącznika, które chcesz włączyć.
Wymaganych podczas konfiguracji w ChatGPT informacji o dostawcy Databricks, takich jak host przestrzeni roboczej, host konta, identyfikator konta lub magazyn.
Zanim zaczniesz
Potrzebujesz:
Uprawnień administratora lub właściciela przestrzeni roboczej ChatGPT albo konta ChatGPT Plus lub Pro.
Uprawnień administratora konta Databricks. Do niektórych zadań mogą wystarczyć uprawnienia administratora przestrzeni roboczej, ale niestandardowe połączenia aplikacji konfiguruje się w konsoli konta Databricks.
Konsoli konta Databricks otwartej na osobnej karcie.
Ekranu połączenia Databricks Genie otwartego w ChatGPT, aby można było skopiować dokładny adres URL wywołania zwrotnego.
Decyzji, czy aplikacja potrzebuje ogólnego dostępu do interfejsu API Databricks, czy tylko dostępu do Databricks SQL.
Bezpiecznego miejsca do przechowywania klucza tajnego klienta Databricks.
Jeśli konto lub przestrzeń robocza Databricks ogranicza dostęp za pomocą listy dozwolonych adresów IP, kontroli ruchu przychodzącego zależnej od kontekstu, zapory sieciowej albo innej zasady sieciowej, potrzebujesz pomocy administratora Databricks, który może zezwolić na bieżące zakresy wychodzących adresów IP łączników ChatGPT.
Uwaga: musisz skopiować dokładny Adres URL wywołania zwrotnego wyświetlany w ChatGPT.
Wartości do przygotowania
Adres URL wywołania zwrotnego: skopiuj go podczas konfiguracji łącznika w ChatGPT.
Identyfikator klienta OAuth Databricks.
Klucz tajny klienta OAuth Databricks.
Zakresy dostępu Databricks, takie jak WSZYSTKIE INTERFEJSY API lub SQL.
Pola przestrzeni roboczej lub konta Databricks wymagane podczas konfiguracji w ChatGPT.
Rozpocznij konfigurację aplikacji w ChatGPT
W ChatGPT przełącz się na konto lub przestrzeń roboczą, w której aplikacja ma być dostępna.
Jako administrator lub właściciel przejdź do sekcji Ustawienia przestrzeni roboczej > Wtyczki.
W sekcji Katalog wybierz Databricks Genie.
Wybierz Dodaj połączenie aplikacji.
W oknie Połącz Databricks Genie znajdź sekcję klienta OAuth.
Adres URL wywołania zwrotnego z ChatGPT. Pozostaw to okno otwarte.
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 adresu ogólnym adresem URL ChatGPT. Adres URL zarejestrowany w Databricks musi dokładnie odpowiadać Adresowi URL wywołania zwrotnego wyświetlanemu w ChatGPT.
Utwórz połączenie z aplikacją OAuth w Databricks
Otwórz konsolę konta Databricks dla swojego konta Databricks.
Na lewym pasku bocznym otwórz Ustawienia.
Otwórz kartę Połączenia aplikacji.
Wybierz Dodaj połączenie.
Wprowadź nazwę aplikacji, na przykład Łącznik ChatGPT Databricks.
W polu Adresy URL przekierowania wklej dokładny adres URL wywołania zwrotnego skopiowany z ChatGPT.
W sekcji Zakresy dostępu wybierz zakresy potrzebne aplikacji.
Wybierz WSZYSTKIE INTERFEJSY API dla ogólnej aplikacji Databricks, która potrzebuje interfejsów API Databricks innych niż SQL.
Wybierz tylko SQL, jeśli aplikacja ma korzystać wyłącznie z interfejsów API Databricks SQL.
Upewnij się, że każdy zakres podany później w ChatGPT jest włączony w tej aplikacji OAuth Databricks. Databricks automatycznie zezwala aplikacjom utworzonym w interfejsie na zakresy openid, email, profile i offline_access.
Pozostaw domyślne okresy ważności tokenów Databricks, chyba że organizacja stosuje inną zasadę: 60 minut dla tokenu dostępu i 10080 minut dla tokenu odświeżania.
Włącz opcję Wygeneruj klucz tajny klienta. Ten proces wymaga, aby ChatGPT korzystał z poufnego klienta OAuth.
Utwórz połączenie.
Skopiuj dane logowania z Databricks
W oknie Utworzono połączenie skopiuj Identyfikator klienta.
Natychmiast skopiuj Klucz tajny klienta i przechowuj go bezpiecznie.
Jeśli zamkniesz okno bez skopiowania klucza tajnego, utwórz lub zmień dane logowania aplikacji OAuth i użyj nowego klucza.
Databricks wyświetla klucz tajny tylko raz. Traktuj go jak dane logowania i nie umieszczaj w zrzutach ekranu, zgłoszeniach, komentarzach ani czatach.
Dokończ konfigurację w ChatGPT
Wróć do okna Połącz Databricks Genie.
Wprowadź identyfikator klienta Databricks w polu Identyfikator klienta OAuth.
Wprowadź klucz tajny klienta Databricks w polu Klucz tajny klienta OAuth.
W polu Zakresy (opcjonalnie) pozostaw all-apis i offline_access, aby zapewnić ogólny dostęp do interfejsu API.
Wpisz po jednym zakresie w każdym wierszu lub rozdziel zakresy przecinkami. Każdy zakres wymieniony w ChatGPT musi być włączony w aplikacji OAuth Databricks.
Wprowadź Nazwę hosta przestrzeni roboczej (wymagana) bez https:// ani ścieżki adresu URL. Uzupełnij wszystkie pozostałe wymagane pola dostawcy Databricks wyświetlane podczas konfiguracji.
Wybierz Kontynuuj.
ChatGPT żąda dokładnie tych zakresów, które podano w polu Zakresy (opcjonalnie). Nie dodaje automatycznie szerszych zakresów z szablonu.
Połącz i przetestuj
Sprawdź szczegóły łącznika, działania i ustawienia uwierzytelniania.
Jeśli jesteś administratorem przestrzeni roboczej, włącz w niej łącznik i zgodnie z jej zasadami określ, kto może z niego korzystać.
Jako uprawniony użytkownik testowy rozpocznij proces łączenia w ChatGPT, a następnie zaloguj się do Databricks.
Potwierdź, że przeglądarka otwiera właściwe konto lub właściwą przestrzeń roboczą Databricks.
Sprawdź wymagane zakresy, a następnie wybierz Autoryzuj.
Sprawdź, czy przeglądarka wraca do ChatGPT, a łącznik ma stan połączonego.
Najpierw wykonaj operację odczytu niskiego ryzyka, na przykład pobierz informacje o bieżącym użytkowniku lub wyślij zapytanie do zatwierdzonego zasobu Databricks SQL.
Jeśli włączono operacje zapisu, przed szerszym wdrożeniem przetestuj je w procesie Databricks o wyraźnie niskim ryzyku.
W przypadku konfiguracji dla przestrzeni roboczej poproś uprawnionego członka, który nie jest administratorem, o połączenie łącznika i powtórzenie testu niskiego ryzyka.
Zarządzaj dostępem
Zarówno Databricks, jak i ChatGPT uczestniczą w kontroli dostępu.
W ChatGPT administratorzy przestrzeni roboczej określają dostępność aplikacji i sposób, w jaki członkowie mogą z niej korzystać. Sprawdź ustawienia administracyjne aplikacji Databricks (Ustawienia przestrzeni roboczej > Aplikacje) dotyczące:
Dostępu użytkowników — aby określić, które role w przestrzeni roboczej mogą korzystać z łącznika.
Kontroli działań — aby określić, które działania Databricks są włączone.
Uprawnień aplikacji — aby określić, kiedy ChatGPT ma pytać członków o zgodę przed użyciem łącznika.
Te uprawnienia aplikacji dotyczą rozmów w ChatGPT. Agenci przestrzeni roboczej korzystają z ustawień poszczególnych agentów skonfigurowanych przez ich twórcę, aby określić dostępne działania aplikacji oraz sytuacje, w których użytkownik końcowy jest proszony o ich zatwierdzenie. Więcej informacji o działaniu agentów znajdziesz tutaj: Agenci przestrzeni roboczej ChatGPT dla planów Enterprise i Business.
W Databricks administratorzy określają, którzy użytkownicy mogą autoryzować aplikację OAuth i do jakich zasobów Databricks mają dostęp. Uprawnienia dostawcy nadal obowiązują po włączeniu aplikacji w ChatGPT.
Rozwiązywanie problemów z konfiguracją łącznika Databricks
Niezgodny identyfikator URI przekierowania: sprawdź, czy wartość Adresy URL przekierowania w Databricks dokładnie odpowiada Adresowi URL wywołania zwrotnego wyświetlanemu w ChatGPT, łącznie ze ścieżką i identyfikatorem wywołania zwrotnego. Nie usuwaj identyfikatora wywołania zwrotnego, nie dodawaj ukośnika na końcu ani nie zastępuj adresu innym adresem URL przekierowania ChatGPT.
Brak klucza tajnego: Databricks wyświetla klucze tajne tylko raz. Jeśli klucz tajny klienta nie został skopiowany, wygeneruj nowy.
Aplikacja OAuth nie jest od razu dostępna: według Databricks przetworzenie zmian aplikacji OAuth może potrwać do 30 minut.
Niewystarczający lub niezgodny zakres: porównaj Zakresy (opcjonalnie) w ChatGPT z Zakresami dostępu w aplikacji OAuth Databricks. Każdy zakres wymagany przez ChatGPT musi być tam włączony. W przypadku interfejsów API innych niż SQL sprawdź, czy zakres all-apis jest włączony w Databricks i nadal znajduje się na liście zakresów ChatGPT.
Działania SQL kończą się niepowodzeniem: sprawdź zakres SQL, konfigurację magazynu i uprawnienia Databricks.
Niewłaściwa przestrzeń robocza ChatGPT: utwórz i włącz łącznik w tej samej przestrzeni roboczej ChatGPT, w której użytkownicy będą go łączyć.
Niewłaściwe konto lub niewłaściwa przestrzeń robocza Databricks: sprawdź wartość Nazwa hosta przestrzeni roboczej (wymagana), a następnie ponownie się zaloguj i upewnij się, że Databricks otwiera właściwe konto lub właściwą przestrzeń roboczą.
Użytkownicy nie mogą się połączyć: sprawdź, czy użytkownik ma dostęp do Databricks i może autoryzować aplikację OAuth. Sprawdź też, czy ustawienie Dostęp użytkowników w ChatGPT zezwala temu użytkownikowi na korzystanie z łącznika.
Zasady sieciowe Databricks blokują łącznik: jeśli Databricks zezwala tylko na określone źródłowe adresy IP, administrator Databricks musi zaktualizować odpowiednie listy dozwolonych adresów IP konta lub przestrzeni roboczej, ustawienia kontroli ruchu przychodzącego zależnej od kontekstu, zaporę sieciową albo inne reguły sieciowe zarządzane przez klienta.
Zezwól na połączenia przychodzące z bieżących zakresów wychodzących adresów IP łączników ChatGPT.
Skonfiguruj tę listę dozwolonych adresów w Databricks lub w warstwie sieciowej zarządzanej przez klienta. Jest ona niezależna od listy dozwolonych adresów IP przestrzeni roboczej ChatGPT.
Opublikowane zakresy mogą się zmieniać. W miarę możliwości zautomatyzuj aktualizacje na podstawie pliku JSON.
Nie zmieniaj klucza tajnego klienta ani zakresów OAuth, aby obejść blokadę sieciową. Najpierw sprawdź, czy Databricks odrzuca źródłowe adresy IP łącznika.