Använd den här guiden om du är administratör för en ChatGPT-arbetsyta eller använder ChatGPT Plus eller Pro och ska konfigurera Databricks Genie-appen med inbyggd OAuth eller organisationens egen OAuth-klient.
Inbyggd OAuth: Använd den förkonfigurerade anslutningen om den är tillgänglig i ChatGPT och aktiverad för din Databricks-arbetsyta. Du behöver inte skapa en OAuth-app eller ange något klient-ID eller någon klienthemlighet. Följ avsnittet Inbyggd OAuth nedan.
Egen OAuth-klient: Välj det här alternativet om inbyggd OAuth inte är tillgänglig eller om din organisation kräver en egen OAuth-klient. Följ avsnittet Egen OAuth-klient nedan.
Det här ska du konfigurera
Du ska skapa en anslutning till Databricks-appen för ditt ChatGPT-konto eller din arbetsyta. Båda alternativen kräver de leverantörsuppgifter för Databricks som efterfrågas i ChatGPT samt behörighet till de resurser du planerar att använda. Om du använder en egen OAuth-klient ska du också förbereda följande:
En anslutning till en Databricks OAuth-app som skapats i kontokonsolen i Databricks.
Klient-ID och klienthemlighet för Databricks OAuth.
Den exakta callback-URL:en, kopierad från ChatGPT.
Databricks-behörighetsomfång som matchar de appfunktioner du vill aktivera.
De leverantörsuppgifter för Databricks som efterfrågas i ChatGPT:s konfigurationsflöde, till exempel arbetsytevärd, kontovärd, konto-ID eller datalager.
Innan du börjar
Om du konfigurerar för en arbetsyta öppnar du administratörskonsolen, väljer den aktuella ChatGPT-arbetsytan och öppnar Insticksprogram. Välj Hantera äldre appar för att öppna sidan Appar som finns kvar. Information om navigering i arbetsytan och åtkomst till äldre appar finns i Administratörskontroller, säkerhet och regelefterlevnad för insticksprogram och appar.
Du behöver:
Administratörs- eller ägarbehörighet för en ChatGPT-arbetsyta, eller ett ChatGPT Plus- eller Pro-konto.
För en egen OAuth-klient: administratörsbehörighet för Databricks-kontot. Administratörsbehörighet för arbetsytan kan räcka för vissa uppgifter, men egna appanslutningar konfigureras i kontokonsolen i Databricks. För inbyggd OAuth måste en Databricks-administratör kontrollera att ChatGPT-appen är tillgänglig och aktiverad för din arbetsyta.
För en egen OAuth-klient: kontokonsolen i Databricks öppen i en separat flik.
För en egen OAuth-klient: anslutningsvyn för Databricks Genie öppen i ChatGPT så att du kan kopiera den exakta callback-URL:en.
Ett beslut om vilka funktioner appen behöver: Genie och AI/BI-instrumentpaneler, bredare åtkomst till Databricks API:er eller en app begränsad till Databricks SQL-API:er. Åtkomst till enbart SQL räcker inte för åtgärder i Genie eller instrumentpaneler.
För en egen OAuth-klient: en säker plats för att hantera klienthemligheten för Databricks.
Om ditt Databricks-konto eller din arbetsyta begränsar åtkomsten genom en IP-åtkomstlista, kontextbaserad kontroll av inkommande trafik, en brandvägg eller annan nätverkspolicy: hjälp från en Databricks-administratör som kan tillåta de aktuella IP-intervallen för utgående trafik från ChatGPT-appar.
För en egen OAuth-klient ska du kopiera exakt den Callback-URL som visas i ChatGPT.
Värden att förbereda
För en egen OAuth-klient, Callback-URL: kopiera den från appens konfigurationsflöde i ChatGPT.
För en egen OAuth-klient: klient-ID för Databricks OAuth.
För en egen OAuth-klient: klienthemligheten för Databricks OAuth.
För en egen OAuth-klient: åtkomstomfång i Databricks som passar appens funktioner. För en ny anslutning till Genie eller instrumentpaneler som visar
ai-gateway,dashboardsochoffline_accessska du förbereda dessa behörighetsomfång. ALLA API:er (all-apismedoffline_access) finns kvar som det äldre, bredare alternativet. Använd SQL endast för en app som är begränsad till Databricks SQL-API:er.Fält för Databricks-arbetsytan eller kontot som efterfrågas i ChatGPT:s konfigurationsflöde.
Inbyggd OAuth
Se först till att förutsättningarna ovan är uppfyllda. Använd bara den här metoden om inbyggd OAuth är tillgänglig i ChatGPT och aktiverad för din Databricks-arbetsyta.
Be en Databricks-administratör kontrollera att ChatGPT-appen är tillgänglig i kontokonsolens inställningar för appintegrationer och aktiverad för din arbetsyta. Om ChatGPT-appen inte finns med i Databricks kontokonsol kontaktar du din kundansvariga på Databricks för att fråga om funktionen är tillgänglig för ditt konto.
Byt till det konto eller den arbetsyta i ChatGPT där appen ska vara tillgänglig. Gå till Inställningar > Pluginprogram för en personlig konfiguration. För en arbetsyta går du som administratör eller ägare till Administratörskonsol > Pluginprogram.
Välj Databricks Genie och sedan Lägg till appanslutning.
Ange Arbetsytans värdnamn (obligatoriskt) utan
https://eller någon URL-sökväg.ChatGPT använder värdnamnet för att härleda den arbetsytelokala Genie MCP-slutpunkten,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ingen separat regional MCP-slutpunkt behövs.Välj Fortsätt, logga sedan in på Databricks och granska begäran om samtycke.
Fortsätt med avsnitten Anslut och testa och Hantera åtkomst nedan, inklusive testerna med behöriga medlemmar och kontrollerna av åtkomst till arbetsytan.
Egen OAuth-klient
Se först till att förutsättningarna ovan är uppfyllda. Välj det här alternativet om inbyggd OAuth inte är tillgänglig eller om din organisation kräver en egen OAuth-klient. Efter konfigurationen följer du avsnitten Anslut och testa samt Hantera åtkomst nedan.
Starta konfigurationen av anpassad OAuth i ChatGPT
Byt till det konto eller den arbetsyta i ChatGPT där appen ska vara tillgänglig.
Gå till Inställningar > Pluginprogram för en personlig konfiguration. För en arbetsyta går du som administratör eller ägare till Administratörskonsol > Pluginprogram.
Välj Databricks Genie i Katalog.
Välj Lägg till appanslutning.
Leta upp fälten OAuth-klient-ID och OAuth-klienthemlighet i dialogrutan Anslut Databricks Genie. Du använder flödet för en anpassad klient genom att ange autentiseringsuppgifter i dessa synliga fält. Du behöver inte välja det separat.
Kopiera Callback-URL från ChatGPT. Låt dialogrutan vara öppen.
Exempel på callback-URL:
https://chatgpt.com/connector/oauth/<callback_id>
Ta inte bort callback-ID:t, lägg inte till ett avslutande snedstreck och byt inte ut adressen mot en generell ChatGPT-URL. URL:en som registreras i Databricks måste exakt matcha den Callback-URL som visas i ChatGPT.
Skapa en egen OAuth-appanslutning i Databricks
Öppna kontokonsolen i Databricks för ditt Databricks-konto.
Öppna Inställningar i det vänstra sidofältet.
Öppna fliken Appanslutningar.
Välj Lägg till anslutning.
Ange ett namn för appen, till exempel ChatGPT Databricks.
Klistra in den exakta callback-URL:en som du kopierade från ChatGPT i Omdirigerings-URL:er.
Under Åtkomstomfång väljer du de behörighetsomfång som appen behöver.
För en ny anslutning till Genie eller instrumentpaneler som visar
ai-gateway,dashboardsochoffline_accessi ChatGPT ska du tillåta samma behörighetsomfång i Databricks OAuth-app.ALLA API:er finns kvar som det äldre, bredare alternativet för allmän åtkomst till Databricks API:er. För den här konfigurationen ska du använda
all-apisochoffline_accessi ChatGPT och se till att Databricks OAuth-app tillåter båda. Välj i första hand de mer avgränsade behörighetsomfång som visas för en ny anslutning till Genie eller instrumentpaneler.Använd SQL endast för en app som är begränsad till Databricks SQL-API:er. Åtkomst till enbart SQL räcker inte för åtgärder i Genie eller instrumentpaneler.
Se till att alla behörighetsomfång som senare anges i ChatGPT är aktiverade i den här Databricks OAuth-appen. Databricks tillåter automatiskt openid, email, profile och offline_access för appar som skapas i användargränssnittet.
Behåll Databricks standardvärden för tokenlivslängd (TTL) om inte din organisation har en särskild policy: 60 minuter för åtkomsttoken och 10 080 minuter för uppdateringstoken.
Aktivera Generera en klienthemlighet. ChatGPT behöver en konfidentiell OAuth-klient för det här flödet.
Skapa anslutningen.
Kopiera autentiseringsuppgifter från Databricks
Kopiera Klient-ID i dialogrutan Anslutning skapad.
Kopiera Klienthemlighet direkt och förvara den säkert.
Om du stänger dialogrutan innan du kopierar hemligheten ska du skapa nya eller rotera OAuth-appens autentiseringsuppgifter och använda den nya hemligheten.
Databricks visar hemligheten bara en gång. Hantera den som en autentiseringsuppgift och ta inte med den i skärmbilder, supportärenden, kommentarer eller chattar.
Slutför konfigurationen av anpassad OAuth i ChatGPT
Gå tillbaka till dialogrutan Anslut Databricks Genie.
Ange klient-ID:t från Databricks i OAuth-klient-ID.
Ange klienthemligheten från Databricks i OAuth-klienthemlighet.
När du anger dessa autentiseringsuppgifter används din anpassade OAuth-klient. Du behöver inte välja den separat.
I Behörighetsomfång (valfritt) anger du de omfång som krävs för appens Databricks-slutpunkt och funktioner. De ska matcha de omfång som är aktiverade i OAuth-appen i Databricks.
För en ny Genie-/instrumentpanelsanslutning som visar
ai-gateway,dashboardsochoffline_accessska du behålla dessa omfång. Se till att OAuth-appen i Databricks tillåter samma omfång.ai-gatewaymöjliggör den arbetsytelokala Genie MCP-anslutningen,dashboardsmöjliggör åtgärder i AI/BI-instrumentpaneler ochoffline_accessmöjliggör uppdateringstoken.Det äldre, bredare alternativet
all-apisochoffline_accessstöds fortfarande för bredare API-åtkomst, men rekommenderas inte för den här Genie-/instrumentpanelsanslutningen. Om Databricks-appen bara tillåterall-apisska du uppdatera eller återskapa den så att den tillåterai-gateway,dashboardsochoffline_access. Om detaljerade omfång inte är tillgängliga ska du uttryckligen ställa in ChatGPT påall-apisochoffline_accessoch se till att Databricks-appen tillåter båda. Begär inte de tre detaljerade omfången i ChatGPT om Databricks-appen bara tillåterall-apis.Ange ett omfång per rad eller skilj dem åt med kommatecken. Alla omfång som anges i ChatGPT måste vara aktiverade i OAuth-appen i Databricks.
Ange Arbetsytans värdnamn (obligatoriskt) utan https:// eller någon URL-sökväg. Fyll i eventuella andra obligatoriska fält för Databricks som visas under konfigurationen.
ChatGPT använder värdnamnet för att härleda den arbetsytelokala Genie MCP-slutpunkten,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ingen separat regional MCP-slutpunkt behövs.Välj Fortsätt.
ChatGPT begär exakt de omfång som anges i Behörighetsomfång (valfritt). Bredare omfång från mallen läggs inte till automatiskt.
Anslut och testa
Genomför följande anslutningstester och åtkomstkontroller oavsett vilket OAuth-alternativ du använder.
Granska appens uppgifter, åtgärder och autentiseringsinställningar.
Om du är administratör för arbetsytan ska du aktivera appen för arbetsytan och ange vilka som får använda den enligt arbetsytans policy.
Starta anslutningsflödet i ChatGPT som en testanvändare med behörighet och logga sedan in i Databricks.
Kontrollera att webbläsaren öppnar rätt Databricks-konto eller arbetsyta.
Granska de begärda behörighetsomfången och välj sedan Auktorisera.
Kontrollera att webbläsaren återgår till ChatGPT och att appen visas som ansluten.
Utför en läsåtgärd med låg risk som matchar anslutningens funktioner. För en Genie-anslutning ska du skicka en Genie-förfrågan om data som testanvändaren har behörighet att komma åt. För andra funktioner som stöds kan du hämta information om den aktuella användaren eller köra en fråga mot en godkänd Databricks SQL-resurs. Kontrollera att användaren har de resursbehörigheter som krävs i Databricks. OAuth-behörighetsomfång ger inte i sig åtkomst till data.
Om skrivåtgärder är aktiverade ska du testa med ett Databricks-arbetsflöde med tydligt låg risk innan appen införs bredare.
Om du konfigurerar för en arbetsyta ska du be en medlem som har åtkomst till appen men inte är administratör att ansluta och upprepa lågrisktestet.
Hantera åtkomst
Åtkomsten styrs av både Databricks och ChatGPT.
I ChatGPT styr arbetsytans administratörer om appen är tillgänglig och hur medlemmarna får använda den. I Business styr administratörerna om appen är aktiverad för hela arbetsytan. Granska följande administratörskontroller för Databricks-appar (Arbetsyteinställningar > Appar eller Administratörskonsolen > Insticksprogram > Hantera äldre appar):
Användaråtkomst, för att ange vilka roller i arbetsytan som får använda appen i Enterprise- och Edu-arbetsytor som stöds.
Åtgärdskontroll, för att ange vilka Databricks-åtgärder som är aktiverade.
Appbehörigheter, för att ange när ChatGPT ska fråga medlemmarna innan appen används.
Dessa appbehörigheter gäller för ChatGPT-konversationer. Arbetsyteagenter använder agentspecifika kontroller som ställs in av den som skapat agenten. De avgör vilka appåtgärder som är tillgängliga och när slutanvändare ombeds godkänna dem. Information om hur agenter fungerar finns i ChatGPT-arbetsyteagenter för Enterprise och Business.
I Databricks styr administratörerna vilka användare som får auktorisera OAuth-appen och vilka Databricks-resurser dessa användare har åtkomst till. Leverantörens behörigheter gäller fortfarande efter att appen har aktiverats i ChatGPT.
Information om navigering i arbetsytan, appåtkomst och abonnemangsspecifika appkontroller finns i Administratörskontroller, säkerhet och regelefterlevnad i appar.
Felsöka konfigurationen av Databricks-appen
Omdirigerings-URI stämmer inte: Om du använder en egen OAuth-klient ska du kontrollera att värdet för Omdirigerings-URL:er i Databricks exakt matchar den Callback-URL som visas i ChatGPT, inklusive sökväg och callback-ID. Ta inte bort callback-ID:t, lägg inte till ett avslutande snedstreck och ersätt inte adressen med en annan omdirigerings-URL för ChatGPT.
Hemlighet saknas: Om du använder en egen OAuth-klient visas hemligheter i Databricks bara en gång. Generera en ny klienthemlighet om den inte kopierades.
OAuth-appen är inte tillgänglig direkt: Enligt Databricks kan det ta upp till 30 minuter att behandla uppdateringar av OAuth-appar.
Otillräckliga eller felaktiga behörighetsomfång: Om du använder en egen OAuth-klient ska du jämföra Behörighetsomfång (valfritt) i ChatGPT med Åtkomstomfång i Databricks OAuth-app. Alla behörighetsomfång som ChatGPT begär måste vara aktiverade där. Kontrollera att behörighetsomfången stöder den slutpunkt och de funktioner du använder.
För en ny anslutning till Genie eller instrumentpaneler som visar
ai-gateway,dashboardsochoffline_accessska du behålla dessa behörighetsomfång i ChatGPT och se till att Databricks-appen tillåter alla tre. Om appen bara tillåterall-apisska du uppdatera eller återskapa den så att den tillåter de tre mer avgränsade behörighetsomfången.Om de mer avgränsade behörighetsomfången inte är tillgängliga ska du använda det bredare alternativ som stöds: ange
all-apisochoffline_accessi ChatGPT och se till att Databricks-appen tillåter båda. En app som bara tillåterall-apismatchar inte en begäran från ChatGPT omai-gateway,dashboardsochoffline_access. Åtkomst till enbart SQL är bara lämplig för en app som är begränsad till Databricks SQL-API:er. Den räcker inte för åtgärder i Genie eller instrumentpaneler.SQL-åtgärder misslyckas: För en app som är begränsad till Databricks SQL-API:er ska du kontrollera behörighetsomfånget SQL, konfigurationen av datalagret och behörigheterna i Databricks.
Fel ChatGPT-arbetsyta: Skapa och aktivera appen i samma ChatGPT-arbetsyta som användarna ska ansluta den i.
Fel Databricks-konto eller arbetsyta: Kontrollera värdet för Arbetsytans värdnamn (obligatoriskt). Upprepa sedan inloggningsflödet och kontrollera att Databricks öppnar rätt konto eller arbetsyta.
Användare kan inte ansluta: Kontrollera att användaren har åtkomst till Databricks och får auktorisera OAuth-appen. I Business ska du kontrollera att appen är aktiverad för hela arbetsytan. I Enterprise- och Edu-arbetsytor som stöds ska du också kontrollera att Användaråtkomst i ChatGPT tillåter appen.
Databricks nätverkspolicy blockerar appen: Om Databricks bara tillåter vissa käll-IP-adresser måste en Databricks-administratör uppdatera berörda IP-åtkomstlistor för kontot eller arbetsytan, kontextbaserade kontroller för inkommande trafik, brandväggen eller andra nätverksregler som kunden styr.
Tillåt inkommande anslutningar från de aktuella IP-intervallen för utgående trafik från ChatGPT-appar.
Konfigurera den här tillåtelselistan i Databricks eller i det nätverkslager som kunden styr. Den är separat från IP-tillåtelselistan för ChatGPT-arbetsytan.
De publicerade intervallen kan ändras. Automatisera om möjligt uppdateringar från JSON-filen.
Rotera inte klienthemligheten och ändra inte OAuth-behörighetsomfången för att kringgå en nätverksblockering. Kontrollera först om Databricks avvisar appens käll-IP-adresser.