Skorzystaj z tego przewodnika, jeśli jesteś administratorem przestrzeni roboczej ChatGPT i konfigurujesz szablon aplikacji Databricks dla swojej organizacji. Szablon nie jest końcową aplikacją używaną przez członków. Jest to przepływ konfiguracji, który tworzy wersję roboczą aplikacji dla danej przestrzeni roboczej po podaniu wymaganej konfiguracji Databricks.
W przypadku Databricks większość konfiguracji odbywa się w konsoli konta Databricks. Tworzysz niestandardowe połączenie aplikacji OAuth, rejestrujesz adres URL wywołania zwrotnego ChatGPT, kopiujesz wygenerowane dane uwierzytelniające klienta, a następnie wklejasz te wartości w przepływie konfiguracji szablonu ChatGPT. Po utworzeniu przez ChatGPT wersji roboczej aplikacji możesz ją opublikować i zarządzać nią tak jak innymi aplikacjami przestrzeni roboczej.
Co konfigurujesz
Tworzysz w ChatGPT aplikację Databricks przeznaczoną dla konkretnej przestrzeni roboczej. Aplikacja używa:
Połączenia aplikacji Databricks OAuth utworzonego w konsoli konta Databricks.
Identyfikatora klienta i klucza tajnego klienta Databricks OAuth.
Dokładnego adresu URL wywołania zwrotnego skopiowanego z ChatGPT.
Zakresów Databricks zgodnych z funkcjami łącznika, które chcesz włączyć.
Wszelkich danych dostawcy Databricks wymaganych przez przepływ konfiguracji ChatGPT, takich jak host przestrzeni roboczej, host konta, identyfikator konta lub magazyn.
Zanim zaczniesz
Potrzebujesz:
Dostępu administratora lub właściciela przestrzeni roboczej ChatGPT.
Dostępu administratora konta Databricks. Dostęp administratora przestrzeni roboczej może wystarczyć do niektórych zadań, ale niestandardowe połączenia aplikacji konfiguruje się z poziomu konsoli konta Databricks.
Konsoli konta Databricks otwartej na osobnej karcie.
Ekranu konfiguracji szablonu aplikacji Databricks 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 obsługi klucza tajnego klienta Databricks.
Nie wymyślaj adresu URL wywołania zwrotnego. Skopiuj dokładny adres URL wywołania zwrotnego widoczny w ChatGPT.
Wartości do przygotowania
Adres URL wywołania zwrotnego: skopiuj go z przepływu konfiguracji szablonu ChatGPT.
Identyfikator klienta Databricks OAuth.
Klucz tajny klienta Databricks OAuth.
Zakresy dostępu Databricks, takie jak ALL APIs lub SQL.
Pola przestrzeni roboczej lub konta Databricks wymagane przez przepływ konfiguracji ChatGPT.
Publikowanie aplikacji i zarządzanie 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 sekcji Ustawienia przestrzeni roboczej > Aplikacje > Włączone.
Skonfiguruj Dostęp użytkowników dla ról, które powinny z niej korzystać.
Sprawdź Kontrolę działań dla działań Databricks udostępnianych przez aplikację.
Sprawdź Uprawnienia aplikacji, aby wybrać, kiedy ChatGPT ma 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 dla poszczególnych agentów ustawionych przez twórcę agenta, 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.
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.
Wybierz Katalog.
Wyszukaj Databricks.
Wybierz szablon aplikacji Databricks i rozpocznij konfigurację.
Wprowadź jasną nazwę i opis aplikacji, na przykład Databricks lub Databricks - Data Platform.
W sekcji klienta OAuth skopiuj adres URL wywołania zwrotnego z ChatGPT. Pozostaw tę kartę otwartą.
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 połączenie aplikacji 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 ChatGPT Databricks Connector.
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.
Użyj ALL APIs w przypadku ogólnej aplikacji Databricks, która potrzebuje interfejsów API Databricks poza SQL.
Użyj tylko SQL w przypadku aplikacji ograniczonej do interfejsów API Databricks SQL.
Pozostaw czasy TTL tokenów z domyślnymi wartościami Databricks, chyba że organizacja ma określone zasady.
Włącz Wygeneruj klucz tajny klienta. ChatGPT potrzebuje poufnego klienta OAuth dla tego przepływu.
Utwórz połączenie.
Skopiuj dane uwierzytelniające z Databricks
W oknie dialogowym utworzonego połączenia skopiuj identyfikator klienta.
Natychmiast skopiuj klucz tajny klienta i przechowuj go bezpiecznie.
Jeśli zamkniesz okno dialogowe przed skopiowaniem klucza tajnego, utwórz lub obróć dane uwierzytelniające aplikacji OAuth i użyj nowego klucza tajnego.
Databricks pokazuje klucz tajny tylko raz. Traktuj go jak dane uwierzytelniające i nie umieszczaj go na zrzutach ekranu, w zgłoszeniach, komentarzach ani czatach.
Dokończ konfigurację w ChatGPT
Wróć do karty konfiguracji szablonu ChatGPT.
Wklej identyfikator klienta Databricks w polu identyfikatora klienta OAuth.
Wklej klucz tajny klienta Databricks w polu klucza tajnego klienta OAuth.
Pozostaw Zakresy bez zmian, chyba że celowo musisz zastąpić domyślne ustawienia szablonu.
Wypełnij wszystkie pola dostawcy Databricks wymagane przez przepływ konfiguracji, takie jak host przestrzeni roboczej, host konta, identyfikator konta, magazyn lub inne wartości specyficzne dla Databricks.
Utwórz wersję roboczą aplikacji.
Przetestuj aplikację jako użytkownik
Rozpocznij przepływ łączenia z ChatGPT jako dozwolony użytkownik testowy.
Potwierdź, że przeglądarka otwiera oczekiwane konto lub przestrzeń roboczą Databricks.
Zatwierdź żądane zakresy.
Sprawdź, czy przeglądarka wraca do ChatGPT i czy aplikacja jest wyświetlana jako połączona.
Najpierw uruchom działanie odczytu o niskim ryzyku, takie jak pobranie informacji o bieżącym użytkowniku lub wykonanie zapytania do zatwierdzonego zasobu Databricks SQL.
Jeśli włączono działania zapisu, przed szerszym wdrożeniem przetestuj je na wyraźnie niskiego ryzyka przepływie pracy Databricks.
Zarządzanie dostępem
Zarówno Databricks, jak i ChatGPT uczestniczą w kontroli dostępu.
W ChatGPT administratorzy przestrzeni roboczej zarządzają tym, czy opublikowana aplikacja jest dostępna, które role w przestrzeni roboczej mogą jej używać, które działania są włączone oraz kiedy ChatGPT pyta użytkowników przed użyciem aplikacji.
W Databricks administratorzy zarządzają tym, którzy użytkownicy mogą autoryzować aplikację OAuth oraz do których zasobów Databricks mają dostęp. Uprawnienia dostawcy nadal obowiązują po włączeniu aplikacji w ChatGPT.
Rozwiązywanie problemów
Niezgodność identyfikatora URI przekierowania: potwierdź, że adres URL przekierowania Databricks dokładnie odpowiada adresowi URL wywołania zwrotnego widocznemu w ChatGPT, w tym ścieżce i identyfikatorowi wywołania zwrotnego.
Brak klucza tajnego: klucze tajne Databricks są wyświetlane tylko raz. Wygeneruj nowy klucz tajny klienta, jeśli nie został skopiowany.
Aplikacja OAuth nie jest dostępna od razu: Databricks informuje, że przetworzenie aktualizacji aplikacji OAuth może potrwać do 30 minut.
Niewystarczający zakres: jeśli ChatGPT może się uwierzytelnić, ale wywołania interfejsu API Databricks kończą się niepowodzeniem, potwierdź, że aplikacja Databricks ma ALL APIs, gdy potrzebuje interfejsów API innych niż SQL.
Działania SQL kończą się niepowodzeniem: potwierdź zakres SQL, konfigurację magazynu i uprawnienia Databricks.
Nieprawidłowa przestrzeń robocza: utwórz i opublikuj aplikację w tej samej przestrzeni roboczej ChatGPT, w której użytkownicy będą ją łączyć.
Użytkownicy nie mogą się połączyć: potwierdź, że użytkownik ma dostęp do Databricks i może autoryzować aplikację OAuth.