Túto príručku použite, ak ste správca pracovného priestoru ChatGPT a nastavujete šablónu aplikácie Databricks pre svoju organizáciu. Šablóna nie je finálna aplikácia, ktorú používajú členovia. Ide o postup nastavenia, ktorý po zadaní požadovanej konfigurácie Databricks vytvorí koncept aplikácie špecifický pre pracovný priestor.
V prípade Databricks prebieha väčšina nastavenia v konzole Databricks Account Console. Vytvoríte vlastné pripojenie aplikácie OAuth, zaregistrujete callback URL ChatGPT, skopírujete vygenerované prihlasovacie údaje klienta a potom tieto hodnoty vložíte do postupu nastavenia šablóny v ChatGPT. Keď ChatGPT vytvorí koncept aplikácie, môžete ju publikovať a spravovať rovnako ako ostatné aplikácie pracovného priestoru.
Čo nastavujete
V ChatGPT vytvárate aplikáciu Databricks špecifickú pre pracovný priestor. Aplikácia používa:
Pripojenie aplikácie Databricks OAuth vytvorené vo vašej konzole Databricks Account Console.
ID klienta a tajný kľúč klienta Databricks OAuth.
Presnú callback URL skopírovanú z ChatGPT.
Rozsahy Databricks, ktoré zodpovedajú možnostiam konektora, ktoré chcete povoliť.
Všetky údaje poskytovateľa Databricks vyžadované postupom nastavenia v ChatGPT, napríklad hostiteľ pracovného priestoru, hostiteľ účtu, ID účtu alebo sklad.
Skôr než začnete
Potrebujete:
Prístup správcu alebo vlastníka pracovného priestoru ChatGPT.
Prístup správcu účtu Databricks. Na niektoré úlohy môže stačiť prístup správcu pracovného priestoru, ale vlastné pripojenia aplikácií sa konfigurujú v konzole Databricks Account Console.
Konzolu Databricks Account Console otvorte na samostatnej karte.
Obrazovku nastavenia šablóny aplikácie Databricks otvorte v ChatGPT, aby ste mohli skopírovať presnú callback URL.
Rozhodnutie, či aplikácia potrebuje všeobecný prístup k rozhraniu Databricks API alebo iba prístup k Databricks SQL.
Bezpečné miesto na spracovanie tajného kľúča klienta Databricks.
Callback URL nevymýšľajte. Skopírujte presnú callback URL zobrazenú v ChatGPT.
Hodnoty na prípravu
Callback URL: skopírujte ju z postupu nastavenia šablóny v ChatGPT.
ID klienta Databricks OAuth.
Tajný kľúč klienta Databricks OAuth.
Rozsahy prístupu Databricks, napríklad ALL APIs alebo SQL.
Polia pracovného priestoru alebo účtu Databricks vyžadované postupom nastavenia v ChatGPT.
Publikovanie a správa aplikácie v ChatGPT
Vytvorením konceptu aplikácie sa aplikácia automaticky nesprístupní členom. Po kontrole konceptu:
Publikujte koncept aplikácie.
Skontrolujte, či sa aplikácia zobrazuje v časti Nastavenia pracovného priestoru > Aplikácie > Povolené.
Nakonfigurujte Prístup používateľov pre roly, ktoré ju majú používať.
Skontrolujte Riadenie akcií pre akcie Databricks sprístupnené aplikáciou.
Skontrolujte Povolenia aplikácie a vyberte, kedy sa má ChatGPT členov opýtať pred použitím aplikácie.
Požiadajte povoleného testovacieho používateľa, aby otvoril Aplikácie v ChatGPT a potvrdil, že sa aplikácia zobrazuje.
Tieto povolenia aplikácie platia pre konverzácie ChatGPT. Agenti pracovného priestoru používajú ovládacie prvky pre jednotlivých agentov nastavené tvorcom agenta, aby určili, ktoré akcie aplikácie sú dostupné a kedy sa od koncových používateľov žiada ich schválenie. Správanie agentov nájdete tu: Agenti pracovného priestoru ChatGPT pre Enterprise a Business.
Spustenie nastavenia šablóny v ChatGPT
V ChatGPT prepnite na pracovný priestor, v ktorom má byť aplikácia dostupná.
Otvorte Nastavenia pracovného priestoru > Aplikácie.
Vyberte Adresár.
Vyhľadajte Databricks.
Vyberte šablónu aplikácie Databricks a spustite nastavenie.
Zadajte jasný názov a opis aplikácie, napríklad Databricks alebo Databricks - Data Platform.
V časti klienta OAuth skopírujte callback URL z ChatGPT. Túto kartu nechajte otvorenú.
Príklad callback URL: https://chatgpt.com/connector/oauth/<callback_id>
Neodstraňujte ID callbacku, nepridávajte lomku na koniec ani ho nenahrádzajte všeobecnou URL adresou ChatGPT.
Vytvorenie pripojenia aplikácie OAuth v Databricks
Otvorte konzolu Databricks Account Console pre svoj účet Databricks.
V ľavom bočnom paneli otvorte Nastavenia.
Otvorte kartu Pripojenia aplikácií.
Vyberte Pridať pripojenie.
Zadajte názov aplikácie, napríklad ChatGPT Databricks Connector.
Do poľa Redirect URLs vložte presnú callback URL skopírovanú z ChatGPT.
V časti Rozsahy prístupu vyberte rozsahy, ktoré aplikácia potrebuje.
Použite ALL APIs pre všeobecnú aplikáciu Databricks, ktorá potrebuje rozhrania Databricks API nad rámec SQL.
Použite iba SQL pre aplikáciu obmedzenú na rozhrania Databricks SQL API.
Ponechajte hodnoty TTL tokenov na predvolených hodnotách Databricks, pokiaľ vaša organizácia nemá konkrétnu politiku.
Povoľte Generate a client secret. ChatGPT potrebuje pre tento postup dôverného klienta OAuth.
Vytvorte pripojenie.
Kopírovanie prihlasovacích údajov z Databricks
V dialógovom okne Vytvorené pripojenie skopírujte Client ID.
Okamžite skopírujte Client secret a bezpečne ho uložte.
Ak dialógové okno zavriete pred skopírovaním tajného kľúča, vytvorte alebo vymeňte prihlasovacie údaje aplikácie OAuth a použite nový tajný kľúč.
Databricks zobrazí tajný kľúč iba raz. Zaobchádzajte s ním ako s prihlasovacím údajom a nezahŕňajte ho do snímok obrazovky, ticketov, komentárov ani chatov.
Dokončenie nastavenia v ChatGPT
Vráťte sa na kartu nastavenia šablóny v ChatGPT.
Vložte Databricks Client ID do poľa OAuth client ID.
Vložte Databricks Client secret do poľa OAuth client secret.
Ponechajte Scopes nezmenené, pokiaľ zámerne nepotrebujete prepísať predvolené hodnoty šablóny.
Vyplňte všetky polia poskytovateľa Databricks vyžadované postupom nastavenia, napríklad hostiteľ pracovného priestoru, hostiteľ účtu, ID účtu, sklad alebo iné hodnoty špecifické pre Databricks.
Vytvorte koncept aplikácie.
Otestovanie aplikácie ako používateľ
Spustite postup pripojenia z ChatGPT ako povolený testovací používateľ.
Skontrolujte, či prehliadač otvorí očakávaný účet alebo pracovný priestor Databricks.
Schváľte požadované rozsahy.
Overte, že sa prehliadač vráti do ChatGPT a aplikácia sa zobrazí ako pripojená.
Najprv spustite čitateľskú akciu s nízkym rizikom, napríklad načítanie informácií o aktuálnom používateľovi alebo dotazovanie schváleného zdroja Databricks SQL.
Ak sú povolené akcie zápisu, pred širším nasadením ich otestujte na jednoznačne nízkorizikovom pracovnom postupe Databricks.
Správa prístupu
Databricks aj ChatGPT prispievajú k riadeniu prístupu.
V ChatGPT správcovia pracovného priestoru spravujú, či je publikovaná aplikácia dostupná, ktoré roly pracovného priestoru ju môžu používať, ktoré akcie sú povolené a kedy sa ChatGPT používateľov opýta pred použitím aplikácie.
V Databricks správcovia spravujú, ktorí používatelia môžu autorizovať aplikáciu OAuth a ku ktorým zdrojom Databricks majú títo používatelia prístup. Povolenia poskytovateľa platia aj po povolení aplikácie v ChatGPT.
Riešenie problémov
Nezhoda URI presmerovania: skontrolujte, či sa Redirect URL v Databricks presne zhoduje s callback URL zobrazenou v ChatGPT vrátane cesty a ID callbacku.
Chýbajúci tajný kľúč: tajné kľúče Databricks sa zobrazujú jednorazovo. Ak nebol skopírovaný, vygenerujte nový tajný kľúč klienta.
Aplikácia OAuth nie je dostupná okamžite: Databricks uvádza, že spracovanie aktualizácií aplikácie OAuth môže trvať až 30 minút.
Nedostatočný rozsah: ak sa ChatGPT dokáže overiť, ale volania Databricks API zlyhávajú, skontrolujte, či má aplikácia Databricks ALL APIs, keď aplikácia potrebuje API mimo SQL.
Akcie SQL zlyhávajú: skontrolujte rozsah SQL, konfiguráciu skladu a povolenia Databricks.
Nesprávny pracovný priestor: vytvorte a publikujte aplikáciu v tom istom pracovnom priestore ChatGPT, v ktorom ju budú používatelia pripájať.
Používatelia sa nemôžu pripojiť: skontrolujte, či má používateľ prístup k Databricks a či môže autorizovať aplikáciu OAuth.