Tento návod je určen správcům pracovního prostoru ChatGPT a uživatelům ChatGPT Plus nebo Pro, kteří nastavují aplikaci Databricks Genie pomocí integrovaného OAuth nebo vlastního klienta OAuth své organizace.
Integrované OAuth: Pokud je v ChatGPT dostupné a ve vašem pracovním prostoru Databricks povolené, použijte přednastavené připojení. Nemusíte vytvářet aplikaci OAuth ani zadávat ID klienta nebo tajný klíč klienta. Postupujte podle níže uvedené části Integrované OAuth.
Vlastní klient OAuth: Tento postup použijte, pokud integrované OAuth není dostupné nebo vaše organizace vyžaduje vlastního klienta OAuth. Postupujte podle níže uvedené části Vlastní klient OAuth.
Co budete nastavovat
Vytvoříte připojení aplikace Databricks pro svůj účet nebo pracovní prostor ChatGPT. Oba postupy vyžadují údaje o poskytovateli Databricks požadované v ChatGPT a oprávnění ke zdrojům, které plánujete používat. Pokud používáte vlastního klienta OAuth, připravte si také:
Připojení aplikace OAuth vytvořené v konzoli účtu Databricks.
ID klienta OAuth a tajný klíč klienta z Databricks.
Přesnou adresu URL zpětného volání zkopírovanou z ChatGPT.
Rozsahy oprávnění Databricks odpovídající funkcím aplikace, které chcete povolit.
Veškeré údaje o poskytovateli Databricks požadované při nastavování v ChatGPT, například hostitele pracovního prostoru, hostitele účtu, ID účtu nebo sklad.
Než začnete
Pokud aplikaci nastavujete pro pracovní prostor, otevřete konzoli pro správu, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Výběrem možnosti Spravovat starší aplikace otevřete původní stránku Aplikace, která je stále dostupná. Informace o navigaci v pracovním prostoru a přístupu ke starším aplikacím najdete v článku Správa, zabezpečení a dodržování předpisů u pluginů a aplikací.
Budete potřebovat:
Oprávnění správce nebo vlastníka pracovního prostoru ChatGPT, případně účet ChatGPT Plus nebo Pro.
Pro vlastního klienta OAuth oprávnění správce účtu Databricks. Pro některé úkoly mohou stačit oprávnění správce pracovního prostoru, ale vlastní připojení aplikací se nastavují v konzoli účtu Databricks. Při použití integrovaného OAuth musí správce Databricks ověřit, že je aplikace ChatGPT pro váš pracovní prostor dostupná a povolená.
Pro vlastního klienta OAuth konzoli účtu Databricks otevřenou na samostatné kartě.
Pro vlastního klienta OAuth obrazovku připojení Databricks Genie otevřenou v ChatGPT, abyste mohli zkopírovat přesnou adresu URL zpětného volání.
Mít jasno v tom, jaké funkce aplikace potřebuje: Genie a řídicí panely AI/BI, širší přístup k rozhraní API Databricks, nebo omezení pouze na rozhraní API Databricks SQL. Přístup pouze k SQL nestačí pro akce Genie nebo řídicích panelů.
Pro vlastního klienta OAuth bezpečné místo pro práci s tajným klíčem klienta Databricks.
Pokud váš účet nebo pracovní prostor Databricks omezuje přístup pomocí seznamu přístupu podle IP adres, řízení příchozího provozu podle kontextu, firewallu nebo jiné síťové zásady, pomoc správce Databricks, který může povolit aktuální rozsahy IP adres pro odchozí provoz aplikací ChatGPT.
Pro vlastního klienta OAuth zkopírujte přesnou hodnotu Adresa URL zpětného volání zobrazenou v ChatGPT.
Údaje, které si připravit
Pro vlastního klienta OAuth Adresa URL zpětného volání: zkopírujte ji z průvodce nastavením aplikace v ChatGPT.
Pro vlastního klienta OAuth ID klienta OAuth z Databricks.
Pro vlastního klienta OAuth tajný klíč klienta OAuth z Databricks.
Pro vlastního klienta OAuth rozsahy přístupu v Databricks odpovídající funkcím aplikace. Pokud se u nového připojení ke Genie nebo řídicím panelům zobrazují rozsahy
ai-gateway,dashboardsaoffline_access, připravte si tyto rozsahy. Všechna rozhraní API (all-apisspolu soffline_access) zůstávají starší, širší alternativou. SQL použijte pouze pro aplikaci omezenou na rozhraní API Databricks SQL.Údaje o pracovním prostoru nebo účtu Databricks požadované při nastavování v ChatGPT.
Vestavěné OAuth
Nejprve splňte výše uvedené předpoklady. Tento postup použijte pouze tehdy, pokud je vestavěné OAuth dostupné v ChatGPT a povolené pro váš pracovní prostor Databricks.
Požádejte správce Databricks, aby ověřil, že je aplikace ChatGPT dostupná v nastavení integrací aplikací v konzoli účtu a povolená pro váš pracovní prostor. Pokud aplikace ChatGPT není uvedena v konzoli vašeho účtu Databricks, obraťte se na svého obchodního zástupce Databricks a zeptejte se, zda je tato funkce pro váš účet dostupná.
V ChatGPT přepněte na účet nebo pracovní prostor, ve kterém má být aplikace dostupná. Pro osobní nastavení přejděte do Nastavení > Pluginy. Pro nastavení pracovního prostoru přejděte jako jeho správce nebo vlastník do Konzole správce > Pluginy.
Vyberte Databricks Genie a poté Přidat připojení aplikace.
Zadejte Název hostitele pracovního prostoru (povinné) bez
https://a bez cesty v URL.Z tohoto názvu hostitele ChatGPT odvodí koncový bod MCP pro Genie v daném pracovním prostoru:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Samostatný regionální koncový bod MCP není potřeba.Vyberte Pokračovat, poté se přihlaste k Databricks a zkontrolujte žádost o souhlas.
Pokračujte podle níže uvedených částí Připojení a testování a Správa přístupu, včetně testů s oprávněnými členy a kontrol přístupu k pracovnímu prostoru.
Vlastní klient OAuth
Nejprve splňte výše uvedené předpoklady. Tento postup použijte, pokud integrované OAuth není dostupné nebo vaše organizace vyžaduje vlastního klienta OAuth. Po nastavení proveďte kroky v níže uvedených částech Připojení a testování a Správa přístupu.
Zahajte nastavení vlastního OAuth v ChatGPT
V ChatGPT přepněte na účet nebo pracovní prostor, ve kterém má být aplikace dostupná.
Pro osobní nastavení přejděte do Nastavení > Pluginy. Pro nastavení pracovního prostoru přejděte jako jeho správce nebo vlastník do Konzole správce > Pluginy.
V Adresáři vyberte Databricks Genie.
Vyberte Přidat připojení aplikace.
V dialogovém okně Připojit Databricks Genie najděte pole ID klienta OAuth a Tajný klíč klienta OAuth. Zadáním přihlašovacích údajů do těchto zobrazených polí nastavíte vlastního klienta; není třeba ho vybírat zvlášť.
Z ChatGPT zkopírujte hodnotu pole Adresa URL zpětného volání. Toto dialogové okno nechte otevřené.
Příklad adresy URL zpětného volání:
https://chatgpt.com/connector/oauth/<callback_id>
Neodstraňujte ID zpětného volání, nepřidávejte lomítko na konec ani adresu nenahrazujte obecnou adresou URL ChatGPT. Adresa URL zaregistrovaná v Databricks musí přesně odpovídat hodnotě pole Adresa URL zpětného volání zobrazené v ChatGPT.
Vytvoření vlastního připojení aplikace OAuth v Databricks
Otevřete konzoli účtu Databricks pro svůj účet.
Na levém postranním panelu otevřete Nastavení.
Otevřete kartu Připojení aplikací.
Vyberte Přidat připojení.
Zadejte název aplikace, například ChatGPT Databricks.
Do pole Adresy URL přesměrování vložte přesnou adresu URL zpětného volání zkopírovanou z ChatGPT.
V části Rozsahy přístupu vyberte rozsahy oprávnění, které aplikace potřebuje.
Pokud se u nového připojení ke Genie nebo řídicím panelům v ChatGPT zobrazují rozsahy
ai-gateway,dashboardsaoffline_access, povolte stejné rozsahy i v aplikaci OAuth v Databricks.Všechna rozhraní API zůstávají starší, širší alternativou pro obecný přístup k rozhraní API Databricks. Pro tuto konfiguraci použijte v ChatGPT
all-apisaoffline_accessa ujistěte se, že aplikace OAuth v Databricks povoluje oba rozsahy. U nového připojení ke Genie nebo řídicím panelům upřednostněte zobrazené dílčí rozsahy oprávnění.SQL použijte pouze pro aplikaci omezenou na rozhraní API Databricks SQL. Přístup pouze k SQL nestačí pro akce Genie nebo řídicích panelů.
Ujistěte se, že je v této aplikaci OAuth v Databricks povolený každý rozsah oprávnění, který bude později uvedený v ChatGPT. Databricks u aplikací vytvořených v uživatelském rozhraní automaticky povoluje openid, email, profile a offline_access.
Pokud vaše organizace nemá konkrétní zásady, ponechte výchozí doby platnosti (TTL) tokenů v Databricks: 60 minut pro přístupový token a 10080 minut pro obnovovací token.
Zapněte možnost Vygenerovat tajný klíč klienta. ChatGPT pro tento postup potřebuje důvěrného klienta OAuth.
Vytvořte připojení.
Zkopírování přihlašovacích údajů z Databricks
V dialogovém okně Připojení vytvořeno zkopírujte ID klienta.
Ihned zkopírujte Tajný klíč klienta a bezpečně ho uložte.
Pokud dialogové okno zavřete před zkopírováním tajného klíče, vytvořte nebo obměňte přihlašovací údaje aplikace OAuth a použijte nový tajný klíč.
Databricks zobrazuje tajný klíč pouze jednou. Zacházejte s ním jako s přihlašovacím údajem a neuvádějte ho ve snímcích obrazovky, požadavcích na podporu, komentářích ani chatech.
Dokončete nastavení vlastního OAuth v ChatGPT
Vraťte se do dialogového okna Připojit Databricks Genie.
Do pole ID klienta OAuth zadejte ID klienta Databricks.
Do pole Tajný klíč klienta OAuth zadejte tajný klíč klienta Databricks.
Zadáním těchto přihlašovacích údajů se použije váš vlastní klient OAuth; není třeba ho vybírat zvlášť.
Do pole Rozsahy oprávnění (volitelné) zadejte rozsahy oprávnění potřebné pro koncový bod Databricks a funkce vaší aplikace. Musí odpovídat rozsahům oprávnění povoleným v aplikaci OAuth v Databricks.
Pokud se u nového připojení ke Genie / řídicím panelům zobrazují rozsahy oprávnění
ai-gateway,dashboardsaoffline_access, ponechte je. Ujistěte se, že aplikace OAuth v Databricks povoluje stejné rozsahy oprávnění. Rozsahai-gatewayumožňuje připojení ke Genie přes MCP v rámci pracovního prostoru,dashboardsumožňuje akce s řídicími panely AI/BI aoffline_accessumožňuje používat obnovovací tokeny.Starší alternativa s širšími oprávněními,
all-apisaoffline_access, je nadále podporována pro širší přístup k API, ale pro toto připojení ke Genie / řídicím panelům se nedoporučuje. Pokud aplikace v Databricks povoluje pouzeall-apis, upravte ji nebo ji vytvořte znovu tak, aby povolovalaai-gateway,dashboardsaoffline_access. Pokud podrobné rozsahy oprávnění nejsou k dispozici, nastavte v ChatGPT výslovněall-apisaoffline_accessa ujistěte se, že aplikace v Databricks povoluje oba. Nevyžadujte v ChatGPT tři podrobné rozsahy oprávnění, pokud aplikace v Databricks povoluje pouzeall-apis.Zadejte každý rozsah oprávnění na samostatný řádek nebo je oddělte čárkami. Každý rozsah oprávnění uvedený v ChatGPT musí být povolen v aplikaci OAuth v Databricks.
Zadejte Název hostitele pracovního prostoru (povinné) bez https:// a bez cesty v URL. Vyplňte všechna další povinná pole pro poskytovatele Databricks zobrazená během nastavení.
Z tohoto názvu hostitele ChatGPT odvodí koncový bod MCP pro Genie v daném pracovním prostoru:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Samostatný regionální koncový bod MCP není potřeba.Vyberte Pokračovat.
ChatGPT požaduje přesně ty rozsahy oprávnění, které jsou zadané v poli Rozsahy oprávnění (volitelné). Širší rozsahy oprávnění ze šablony automaticky nepřidává.
Připojení a otestování
U obou variant OAuth proveďte následující testy připojení a kontroly přístupu.
Zkontrolujte podrobnosti aplikace, její akce a nastavení ověřování.
Pokud jste správce pracovního prostoru, povolte v něm aplikaci a podle jeho zásad nastavte, kdo ji může používat.
Jako testovací uživatel s povoleným přístupem zahajte připojení z ChatGPT a poté se přihlaste k Databricks.
Ověřte, že prohlížeč otevře očekávaný účet nebo pracovní prostor Databricks.
Zkontrolujte požadované rozsahy oprávnění a poté vyberte Autorizovat.
Ověřte, že se prohlížeč vrátí do ChatGPT a aplikace se zobrazí jako připojená.
Spusťte akci čtení s nízkým rizikem, která odpovídá funkcím připojení. U připojení ke Genie odešlete do Genie požadavek týkající se dat, ke kterým má testovací uživatel povolený přístup. U ostatních podporovaných funkcí načtěte informace o aktuálním uživateli nebo proveďte dotaz na schválený zdroj Databricks SQL. Ověřte, že má uživatel požadovaná oprávnění ke zdrojům Databricks; samotné rozsahy oprávnění OAuth přístup k datům neudělují.
Pokud jsou povolené akce zápisu, před širším nasazením je otestujte na pracovním postupu v Databricks s jednoznačně nízkým rizikem.
Při nastavení pro pracovní prostor požádejte člena s povoleným přístupem, který není správcem, aby se připojil a zopakoval test s nízkým rizikem.
Správa přístupu
Na řízení přístupu se podílí Databricks i ChatGPT.
V ChatGPT správci pracovního prostoru určují, zda je aplikace dostupná a jak ji mohou členové používat. U tarifu Business správci určují, zda je aplikace povolená pro celý pracovní prostor. V nastavení správy aplikací Databricks (Nastavení pracovního prostoru > Aplikace nebo Konzole pro správu > Pluginy > Spravovat starší aplikace) zkontrolujte tyto položky:
Přístup uživatelů – určuje, které role v podporovaných pracovních prostorech Enterprise a Edu mohou aplikaci používat.
Řízení akcí – určuje, které akce Databricks jsou povolené.
Oprávnění aplikace – určuje, kdy ChatGPT před použitím aplikace požádá členy o souhlas.
Tato oprávnění aplikace platí pro konverzace v ChatGPT. Agenti pracovního prostoru se řídí nastavením, které pro každého agenta určuje jeho tvůrce. To stanovuje, které akce aplikace jsou dostupné a kdy mají být koncoví uživatelé požádáni o jejich schválení. Informace o chování agentů najdete v článku Agenti pracovního prostoru ChatGPT pro Enterprise a Business.
V Databricks správci určují, kteří uživatelé mohou autorizovat aplikaci OAuth a ke kterým zdrojům Databricks mají tito uživatelé přístup. Oprávnění poskytovatele platí i po povolení aplikace v ChatGPT.
Informace o navigaci v pracovním prostoru, přístupu k aplikacím a možnostech správy aplikací v jednotlivých tarifech najdete v článku Správa, zabezpečení a dodržování předpisů v aplikacích.
Řešení potíží s nastavením aplikace Databricks
Neshoda URI přesměrování: Pokud používáte vlastního klienta OAuth, ověřte, že hodnota Adresy URL přesměrování v Databricks přesně odpovídá hodnotě Adresa URL zpětného volání zobrazené v ChatGPT, včetně cesty a ID zpětného volání. Neodstraňujte ID zpětného volání, nepřidávejte koncové lomítko ani adresu nenahrazujte jinou adresou URL přesměrování ChatGPT.
Chybějící tajný klíč: Pokud používáte vlastního klienta OAuth, pamatujte, že Databricks zobrazuje tajné klíče pouze jednou. Pokud jste tajný klíč klienta nezkopírovali, vygenerujte nový.
Aplikace OAuth není dostupná okamžitě: Podle Databricks může zpracování aktualizací aplikace OAuth trvat až 30 minut.
Nedostatečný nebo neodpovídající rozsah oprávnění: Pokud používáte vlastního klienta OAuth, porovnejte Rozsahy oprávnění (volitelné) v ChatGPT s položkou Rozsahy přístupu v aplikaci OAuth v Databricks. Musí tam být povolený každý rozsah oprávnění, který ChatGPT požaduje. Ověřte, že rozsahy oprávnění podporují koncový bod a funkce, které používáte.
Pokud se u nového připojení ke Genie nebo řídicím panelům zobrazují rozsahy
ai-gateway,dashboardsaoffline_access, ponechte je v ChatGPT a ujistěte se, že aplikace v Databricks povoluje všechny tři. Pokud aplikace povoluje pouzeall-apis, aktualizujte ji nebo ji vytvořte znovu tak, aby povolovala tyto tři dílčí rozsahy oprávnění.Pokud dílčí rozsahy oprávnění nejsou dostupné, použijte podporovanou širší alternativu: v ChatGPT nastavte
all-apisaoffline_accessa ujistěte se, že aplikace v Databricks povoluje oba rozsahy. Aplikace, která povoluje pouzeall-apis, nevyhovuje požadavku ChatGPT naai-gateway,dashboardsaoffline_access. Přístup pouze k SQL je vhodný jen pro aplikaci omezenou na rozhraní API Databricks SQL; pro akce Genie nebo řídicích panelů nestačí.Akce SQL selhávají: U aplikace omezené na rozhraní API Databricks SQL ověřte rozsah oprávnění SQL, konfiguraci skladu a oprávnění v Databricks.
Nesprávný pracovní prostor ChatGPT: Vytvořte a povolte aplikaci ve stejném pracovním prostoru ChatGPT, ve kterém ji budou uživatelé připojovat.
Nesprávný účet nebo pracovní prostor Databricks: Ověřte hodnotu Název hostitele pracovního prostoru (povinné), poté se znovu přihlaste a ověřte, že Databricks otevře očekávaný účet nebo pracovní prostor.
Uživatelé se nemohou připojit: Ověřte, že má uživatel přístup k Databricks a smí autorizovat aplikaci OAuth. U tarifu Business ověřte, že je aplikace povolená pro celý pracovní prostor. V podporovaných pracovních prostorech Enterprise a Edu také ověřte, že nastavení Přístup uživatelů v ChatGPT povoluje použití aplikace.
Síťové zásady Databricks blokují aplikaci: Pokud Databricks povoluje pouze konkrétní zdrojové IP adresy, musí správce Databricks aktualizovat příslušné seznamy přístupu podle IP adres pro účet nebo pracovní prostor, řízení příchozího provozu podle kontextu, firewall nebo jiná síťová pravidla spravovaná zákazníkem.
Povolte příchozí připojení z aktuálních rozsahů IP adres pro odchozí provoz aplikací ChatGPT.
Tento seznam povolených adres nastavte v Databricks nebo na síťové vrstvě spravované zákazníkem. Je nezávislý na seznamu povolených IP adres pracovního prostoru ChatGPT.
Zveřejněné rozsahy se mohou měnit. Pokud je to možné, automatizujte aktualizace podle souboru JSON.
Nepokoušejte se obejít síťové blokování výměnou tajného klíče klienta ani změnou rozsahů oprávnění OAuth. Nejprve ověřte, zda Databricks odmítá zdrojové IP adresy aplikace.