Táto stránka bola strojovo preložená. Prečítaj si pôvodný článok v angličtine.

Nastavenie šablóny aplikácie Databricks v ChatGPT

Zistite, ako môžu správcovia pracovného priestoru ChatGPT a používatelia ChatGPT Plus alebo ChatGPT Pro pripojiť Databricks pomocou klienta OAuth svojej organizácie.

Aktualizované: 27 days ago

Tento návod je určený správcom pracovných priestorov ChatGPT a používateľom ChatGPT Plus alebo Pro, ktorí nastavujú aplikáciu Databricks Genie pomocou vstavaného OAuth alebo klienta OAuth svojej organizácie.

  • Vstavané OAuth: Ak je v ChatGPT k dispozícii a je povolené pre váš pracovný priestor Databricks, použite predkonfigurované pripojenie. Nemusíte vytvárať aplikáciu OAuth ani zadávať ID klienta či tajný kľúč klienta. Postupujte podľa časti Vstavané OAuth nižšie.

  • Vlastný klient OAuth: Tento postup použite, ak vstavané OAuth nie je k dispozícii alebo vaša organizácia vyžaduje vlastného klienta OAuth. Postupujte podľa časti Vlastný klient OAuth nižšie.

Čo budete nastavovať

Vytvoríte pripojenie aplikácie Databricks pre svoj účet alebo pracovný priestor ChatGPT. Oba postupy vyžadujú údaje poskytovateľa Databricks požadované v ChatGPT a oprávnenia k prostriedkom, ktoré plánujete používať. Ak používate vlastného klienta OAuth, pripravte si aj:

  • Pripojenie aplikácie OAuth v Databricks vytvorené v konzole účtu Databricks.

  • ID klienta a tajný kľúč klienta OAuth z Databricks.

  • Presnú URL adresu spätného volania skopírovanú z ChatGPT.

  • Rozsahy oprávnení Databricks zodpovedajúce funkciám aplikácie, ktoré chcete povoliť.

  • Všetky údaje poskytovateľa Databricks požadované počas nastavenia v ChatGPT, napríklad hostiteľa pracovného priestoru, hostiteľa účtu, ID účtu alebo sklad.

Skôr než začnete

Ak nastavujete pripojenie pre pracovný priestor, otvorte konzolu správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte Doplnky. Výberom možnosti Spravovať staršie aplikácie otvorte zachovanú stránku Aplikácie. Informácie o navigácii v pracovnom priestore a prístupe k starším aplikáciám nájdete v článku Ovládacie prvky správcu, zabezpečenie a dodržiavanie predpisov pre doplnky a aplikácie.

Potrebujete:

  • Prístup správcu alebo vlastníka pracovného priestoru ChatGPT, prípadne účet ChatGPT Plus alebo Pro.

  • Pri vlastnom klientovi OAuth prístup správcu účtu Databricks. Na niektoré úlohy môže stačiť prístup správcu pracovného priestoru, no vlastné pripojenia aplikácií sa konfigurujú v konzole účtu Databricks. Pri vstavanom OAuth musí správca Databricks skontrolovať, či je aplikácia ChatGPT dostupná a povolená pre váš pracovný priestor.

  • Pri vlastnom klientovi OAuth konzolu účtu Databricks otvorenú na samostatnej karte.

  • Pri vlastnom klientovi OAuth obrazovku pripojenia Databricks Genie otvorenú v ChatGPT, aby ste mohli skopírovať presnú URL adresu spätného volania.

  • Rozhodnúť sa, ktoré funkcie aplikácia potrebuje: Genie a informačné panely AI/BI, širší prístup k rozhraniam Databricks API alebo obmedzenie len na rozhrania Databricks SQL API. Prístup iba k SQL nestačí na akcie v Genie ani v informačných paneloch.

  • Pri vlastnom klientovi OAuth bezpečné miesto na prácu s tajným kľúčom klienta Databricks.

  • Ak váš účet alebo pracovný priestor Databricks obmedzuje prístup pomocou zoznamu povolených IP adries, riadenia prichádzajúceho prístupu na základe kontextu, brány firewall alebo inej sieťovej politiky, pomoc správcu Databricks, ktorý môže povoliť aktuálne rozsahy IP adries pre odchádzajúce pripojenia aplikácií ChatGPT.

Pri vlastnom klientovi OAuth skopírujte presnú hodnotu URL adresa spätného volania zobrazenú v ChatGPT.

Hodnoty, ktoré si treba pripraviť

  • Pri vlastnom klientovi OAuth URL adresa spätného volania: skopírujte ju počas nastavenia aplikácie v ChatGPT.

  • Pri vlastnom klientovi OAuth ID klienta OAuth z Databricks.

  • Pri vlastnom klientovi OAuth tajný kľúč klienta OAuth z Databricks.

  • Pri vlastnom klientovi OAuth rozsahy prístupu Databricks zodpovedajúce funkciám aplikácie. Pri novom pripojení ku Genie alebo informačným panelom, ktoré zobrazuje ai-gateway, dashboards a offline_access, si pripravte tieto rozsahy oprávnení. VŠETKY rozhrania API (all-apis spolu s offline_access) zostávajú staršou, širšou alternatívou. SQL používajte len pre aplikáciu obmedzenú na rozhrania Databricks SQL API.

  • Údaje o pracovnom priestore alebo účte Databricks požadované počas nastavenia v ChatGPT.

Vstavané OAuth

Najprv splňte predpoklady uvedené vyššie. Tento postup použite iba vtedy, ak je vstavané OAuth dostupné v ChatGPT a povolené pre váš pracovný priestor Databricks.

  1. Požiadajte správcu Databricks, aby overil, či je aplikácia ChatGPT dostupná v nastaveniach integrácií aplikácií v konzole účtu a povolená pre váš pracovný priestor. Ak aplikácia ChatGPT nie je uvedená v konzole účtu Databricks, obráťte sa na svojho zástupcu Databricks a opýtajte sa, či je táto funkcia dostupná pre váš účet.

  2. V ChatGPT prepnite na účet alebo pracovný priestor, v ktorom má byť aplikácia dostupná. Pri osobnom nastavení prejdite do časti Nastavenia > Doplnky. Pri nastavení pre pracovný priestor prejdite ako jeho správca alebo vlastník do časti Konzola správcu > Doplnky.

  3. Vyberte Databricks Genie a potom Pridať pripojenie aplikácie.

  4. Do poľa Názov hostiteľa pracovného priestoru (povinné) zadajte názov bez https:// a bez cesty URL.

    Z tohto názvu hostiteľa ChatGPT odvodí koncový bod MCP pre Genie v rámci pracovného priestoru: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Samostatný regionálny koncový bod MCP nie je potrebný.

  5. Vyberte Pokračovať, potom sa prihláste do Databricks a skontrolujte žiadosť o súhlas.

Pokračujte podľa častí Pripojenie a testovanie a Správa prístupu nižšie vrátane testov s členmi, ktorí majú povolený prístup, a kontrol prístupu k pracovnému priestoru.

Vlastný klient OAuth

Najprv splňte vyššie uvedené predpoklady. Tento postup použite, ak vstavané OAuth nie je dostupné alebo vaša organizácia vyžaduje vlastného klienta OAuth. Po nastavení vykonajte kroky v sekciách Pripojenie a testovanie a Správa prístupu nižšie.

Začnite nastavenie vlastného klienta OAuth v ChatGPT

  1. V ChatGPT prepnite na účet alebo pracovný priestor, v ktorom má byť aplikácia dostupná.

  2. Pri osobnom nastavení prejdite do časti Nastavenia > Doplnky. Pri nastavení pre pracovný priestor prejdite ako jeho správca alebo vlastník do časti Konzola správcu > Doplnky.

  3. V časti Adresár vyberte Databricks Genie.

  4. Vyberte Pridať pripojenie aplikácie.

  5. V dialógovom okne Pripojiť Databricks Genie nájdite polia ID klienta OAuth a Tajný kľúč klienta OAuth. Zadaním prihlasovacích údajov do týchto zobrazených polí nastavíte vlastného klienta; nie je potrebné ho vyberať samostatne.

  6. Skopírujte URL spätného volania z ChatGPT. Toto dialógové okno nechajte otvorené.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

Príklad URL spätného volania:

https://chatgpt.com/connector/oauth/<callback_id>

Neodstraňujte ID spätného volania, nepridávajte lomku na konci ani nenahrádzajte túto adresu všeobecnou URL adresou ChatGPT. URL adresa zaregistrovaná v Databricks musí presne zodpovedať hodnote URL spätného volania zobrazenej v ChatGPT.

Vytvorenie vlastného pripojenia aplikácie OAuth v Databricks

  1. Otvorte konzolu účtu Databricks pre svoj účet Databricks.

  2. Na ľavom bočnom paneli otvorte Nastavenia.

  3. Otvorte kartu Pripojenia aplikácií.

  4. Vyberte Pridať pripojenie.

    Databricks Account Console Settings page showing the App connections tab and Add connection button.
  5. Zadajte názov aplikácie, napríklad ChatGPT Databricks.

  6. Do poľa URL adresy presmerovania prilepte presnú URL adresu spätného volania skopírovanú z ChatGPT.

  7. V časti Rozsahy prístupu vyberte rozsahy oprávnení, ktoré aplikácia potrebuje.

  8. Pri novom pripojení ku Genie alebo informačným panelom, ktoré v ChatGPT zobrazuje ai-gateway, dashboards a offline_access, povoľte tie isté rozsahy oprávnení v aplikácii OAuth v Databricks.

  9. VŠETKY rozhrania API zostávajú staršou, širšou alternatívou pre všeobecný prístup k rozhraniam Databricks API. Pri tejto konfigurácii použite v ChatGPT all-apis a offline_access a uistite sa, že aplikácia OAuth v Databricks povoľuje oba rozsahy. Pri novom pripojení ku Genie alebo informačným panelom uprednostnite zobrazené podrobné rozsahy oprávnení.

  10. SQL používajte len pre aplikáciu obmedzenú na rozhrania Databricks SQL API. Prístup iba k SQL nestačí na akcie v Genie ani v informačných paneloch.

  11. Uistite sa, že v tejto aplikácii OAuth v Databricks je povolený každý rozsah oprávnení, ktorý bude neskôr uvedený v ChatGPT. Databricks automaticky povoľuje openid, email, profile a offline_access pre aplikácie vytvorené v používateľskom rozhraní.

  12. Ak vaša organizácia nemá konkrétne pravidlá, ponechajte predvolené doby platnosti (TTL) tokenov v Databricks: 60 minút pre prístupový token a 10 080 minút pre obnovovací token.

  13. Zapnite možnosť Vygenerovať tajný kľúč klienta. ChatGPT na tento postup potrebuje dôverného klienta OAuth.

  14. Vytvorte pripojenie.

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

Skopírovanie prihlasovacích údajov z Databricks

  1. V dialógovom okne Pripojenie vytvorené skopírujte ID klienta.

  2. Ihneď skopírujte Tajný kľúč klienta a bezpečne ho uložte.

  3. Ak dialógové okno zatvoríte pred skopírovaním tajného kľúča, vytvorte alebo vymeňte prihlasovacie údaje aplikácie OAuth a použite nový tajný kľúč.

Databricks zobrazuje tajný kľúč iba raz. Zaobchádzajte s ním ako s prihlasovacím údajom a neuvádzajte ho na snímkach obrazovky, v požiadavkách na podporu, komentároch ani chatoch.

Dokončite nastavenie vlastného klienta OAuth v ChatGPT

  1. Vráťte sa do dialógového okna Pripojiť Databricks Genie.

  2. Do poľa ID klienta OAuth zadajte ID klienta Databricks.

  3. Do poľa Tajný kľúč klienta OAuth zadajte tajný kľúč klienta Databricks.

    Zadaním týchto prihlasovacích údajov sa použije váš vlastný klient OAuth; nie je potrebné ho vyberať samostatne.

  4. Do poľa Rozsahy oprávnení (voliteľné) zadajte rozsahy oprávnení potrebné pre koncový bod Databricks a funkcie vašej aplikácie. Musia zodpovedať rozsahom oprávnení povoleným v aplikácii OAuth v Databricks.

    Pri novom pripojení ku Genie/riadiacim panelom, ktoré zobrazuje ai-gateway, dashboards a offline_access, ponechajte tieto rozsahy oprávnení. Uistite sa, že aplikácia OAuth v Databricks povoľuje rovnaké rozsahy oprávnení. Rozsah ai-gateway umožňuje pripojenie ku Genie cez MCP v rámci pracovného priestoru, dashboards umožňuje akcie s riadiacimi panelmi AI/BI a offline_access umožňuje používanie obnovovacích tokenov.

    Staršia, širšia alternatíva, all-apis a offline_access, je naďalej podporovaná pre širší prístup k API, no pre toto pripojenie ku Genie/riadiacim panelom sa neuprednostňuje. Ak aplikácia v Databricks povoľuje iba all-apis, aktualizujte ju alebo ju vytvorte znova tak, aby povoľovala ai-gateway, dashboards a offline_access. Ak podrobné rozsahy oprávnení nie sú dostupné, v ChatGPT výslovne nastavte all-apis a offline_access a uistite sa, že aplikácia v Databricks povoľuje oba. Nevyžadujte v ChatGPT tieto tri podrobné rozsahy oprávnení, ak aplikácia v Databricks povoľuje iba all-apis.

  5. Každý rozsah oprávnení zadajte do samostatného riadka alebo ich oddeľte čiarkami. Každý rozsah oprávnení uvedený v ChatGPT musí byť povolený v aplikácii OAuth v Databricks.

  6. Do poľa Názov hostiteľa pracovného priestoru (povinné) zadajte názov bez https:// a bez cesty URL. Vyplňte všetky ďalšie povinné polia poskytovateľa Databricks zobrazené počas nastavovania.

    Z tohto názvu hostiteľa ChatGPT odvodí koncový bod MCP pre Genie v rámci pracovného priestoru: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Samostatný regionálny koncový bod MCP nie je potrebný.

  7. Vyberte Pokračovať.

ChatGPT vyžaduje presne tie rozsahy oprávnení, ktoré sú zadané v poli Rozsahy oprávnení (voliteľné). Širšie rozsahy oprávnení zo šablóny nepridáva automaticky.

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

Pripojenie a testovanie

Pri oboch postupoch OAuth vykonajte nasledujúce testy pripojenia a kontroly prístupu.

  1. Skontrolujte podrobnosti aplikácie, akcie a nastavenia overovania.

  2. Ak ste správcom pracovného priestoru, povoľte v ňom aplikáciu a podľa pravidiel pracovného priestoru nastavte, kto ju môže používať.

  3. V ChatGPT spustite postup pripojenia ako testovací používateľ s povoleným prístupom a potom sa prihláste do Databricks.

  4. Overte, či prehliadač otvorí očakávaný účet alebo pracovný priestor Databricks.

  5. Skontrolujte požadované rozsahy oprávnení a potom vyberte Autorizovať.

    Databricks permission request for a mock ChatGPT Databricks Connector showing requested access and the Authorize button.
  6. Overte, či sa prehliadač vráti do ChatGPT a aplikácia sa zobrazí ako pripojená.

  7. Spustite akciu čítania s nízkym rizikom, ktorá zodpovedá funkciám pripojenia. Pri pripojení ku Genie odošlite požiadavku do Genie týkajúcu sa údajov, ku ktorým má testovací používateľ povolený prístup. Pri ostatných podporovaných funkciách načítajte informácie o aktuálnom používateľovi alebo vykonajte dotaz na schválený prostriedok Databricks SQL. Overte, či má používateľ potrebné oprávnenia k prostriedkom Databricks; samotné rozsahy oprávnení OAuth neudeľujú prístup k údajom.

  8. Ak sú povolené akcie zápisu, pred širším nasadením ich otestujte pomocou pracovného postupu v Databricks, ktorý predstavuje jednoznačne nízke riziko.

  9. Pri nastavení pre pracovný priestor požiadajte člena s povoleným prístupom, ktorý nie je správcom, aby sa pripojil a zopakoval test s nízkym rizikom.

Správa prístupu

Na riadení prístupu sa podieľajú Databricks aj ChatGPT.

V ChatGPT správcovia pracovného priestoru určujú, či je aplikácia dostupná a ako ju môžu členovia používať. V pláne Business správcovia určujú, či je aplikácia povolená pre celý pracovný priestor. V ovládacích prvkoch správcu pre aplikácie Databricks (Nastavenia pracovného priestoru > Aplikácie alebo Konzola správcu > Doplnky > Spravovať staršie aplikácie) skontrolujte tieto nastavenia:

  • Prístup používateľov – určuje, ktoré roly v pracovnom priestore môžu používať aplikáciu v podporovaných pracovných priestoroch Enterprise a Edu.

  • Riadenie akcií – určuje, ktoré akcie Databricks sú povolené.

  • Oprávnenia aplikácie – určuje, kedy ChatGPT požiada členov o súhlas pred použitím aplikácie.

Tieto oprávnenia aplikácie sa vzťahujú na konverzácie v ChatGPT. Agenti pracovného priestoru používajú nastavenia, ktoré ich tvorca určuje pre každého agenta samostatne. Tieto nastavenia určujú, ktoré akcie aplikácie sú dostupné a kedy sa od koncových používateľov vyžaduje ich schválenie. Informácie o správaní agentov nájdete v článku Agenti pracovného priestoru ChatGPT pre Enterprise a Business.

V Databricks správcovia určujú, ktorí používatelia môžu autorizovať aplikáciu OAuth a ku ktorým prostriedkom Databricks majú títo používatelia prístup. Oprávnenia poskytovateľa sa naďalej uplatňujú aj po povolení aplikácie v ChatGPT.

Informácie o navigácii v pracovnom priestore, prístupe k aplikáciám a ovládacích prvkoch aplikácií pre jednotlivé plány nájdete v článku Ovládacie prvky správcu, zabezpečenie a dodržiavanie predpisov v aplikáciách.

Riešenie problémov s nastavením aplikácie Databricks

  • Nezhoda URI presmerovania: Ak používate vlastného klienta OAuth, overte, či sa hodnota URL adresy presmerovania v Databricks presne zhoduje s hodnotou URL adresa spätného volania zobrazenou v ChatGPT vrátane cesty a ID spätného volania. Neodstraňujte ID spätného volania, nepridávajte lomku na koniec ani nepoužívajte inú URL adresu presmerovania ChatGPT.

  • Chýbajúci tajný kľúč: Ak používate vlastného klienta OAuth, nezabudnite, že Databricks zobrazuje tajné kľúče iba raz. Ak ste tajný kľúč klienta neskopírovali, vygenerujte nový.

  • Aplikácia OAuth nie je dostupná okamžite: Podľa Databricks môže spracovanie aktualizácií aplikácie OAuth trvať až 30 minút.

  • Nedostatočný alebo nezhodný rozsah oprávnení: Ak používate vlastného klienta OAuth, porovnajte Rozsahy oprávnení (voliteľné) v ChatGPT s položkou Rozsahy prístupu v aplikácii OAuth v Databricks. Musí tam byť povolený každý rozsah oprávnení, ktorý ChatGPT požaduje. Overte, či rozsahy oprávnení podporujú koncový bod a funkcie, ktoré používate.

    Pri novom pripojení ku Genie alebo informačným panelom, ktoré zobrazuje ai-gateway, dashboards a offline_access, ponechajte tieto rozsahy oprávnení v ChatGPT a uistite sa, že aplikácia Databricks povoľuje všetky tri. Ak aplikácia povoľuje iba all-apis, aktualizujte ju alebo ju vytvorte znova tak, aby povoľovala tieto tri podrobné rozsahy oprávnení.

    Ak podrobné rozsahy oprávnení nie sú dostupné, použite podporovanú širšiu alternatívu: v ChatGPT nastavte all-apis a offline_access a uistite sa, že aplikácia Databricks povoľuje oba. Aplikácia, ktorá povoľuje iba all-apis, nezodpovedá požiadavke ChatGPT na ai-gateway, dashboards a offline_access. Prístup iba k SQL je vhodný len pre aplikáciu obmedzenú na rozhrania Databricks SQL API; nestačí na akcie v Genie ani v informačných paneloch.

  • Akcie SQL zlyhávajú: Pri aplikácii obmedzenej na rozhrania Databricks SQL API overte rozsah oprávnení SQL, konfiguráciu skladu a oprávnenia v Databricks.

  • Nesprávny pracovný priestor ChatGPT: Aplikáciu vytvorte a povoľte v tom istom pracovnom priestore ChatGPT, v ktorom ju budú používatelia pripájať.

  • Nesprávny účet alebo pracovný priestor Databricks: Overte hodnotu Názov hostiteľa pracovného priestoru (povinné), potom zopakujte postup prihlásenia a skontrolujte, či Databricks otvorí očakávaný účet alebo pracovný priestor.

  • Používatelia sa nemôžu pripojiť: Overte, či má používateľ prístup do Databricks a oprávnenie autorizovať aplikáciu OAuth. V pláne Business overte, či je aplikácia povolená pre celý pracovný priestor. V podporovaných pracovných priestoroch Enterprise a Edu tiež overte, či nastavenie Prístup používateľov v ChatGPT povoľuje aplikáciu.

  • Sieťová politika Databricks blokuje aplikáciu: Ak Databricks povoľuje iba konkrétne zdrojové IP adresy, správca Databricks musí aktualizovať príslušné zoznamy povolených IP adries účtu alebo pracovného priestoru, pravidlá riadenia prichádzajúceho prístupu na základe kontextu, bránu firewall alebo iné sieťové pravidlá spravované zákazníkom.

    • Povoľte prichádzajúce pripojenia z aktuálnych rozsahov IP adries pre odchádzajúce pripojenia aplikácií ChatGPT.

    • Tento zoznam povolených adries nastavte v Databricks alebo v sieťovej vrstve spravovanej zákazníkom. Ide o samostatné nastavenie, nezávislé od zoznamu povolených IP adries pracovného priestoru ChatGPT.

    • Zverejnené rozsahy sa môžu meniť. Ak je to možné, automatizujte aktualizácie zo súboru JSON.

    • Nepokúšajte sa obísť sieťové blokovanie výmenou tajného kľúča klienta ani zmenou rozsahov oprávnení OAuth. Najprv overte, či Databricks odmieta zdrojové IP adresy aplikácie.

Bol tento článok užitočný?