Gebruik deze handleiding als je beheerder van een ChatGPT-werkruimte of gebruiker van ChatGPT Plus of Pro bent en de Databricks Genie-app instelt met ingebouwde OAuth of de OAuth-client van je organisatie.
Ingebouwde OAuth: Gebruik de vooraf geconfigureerde verbinding als deze beschikbaar is in ChatGPT en is ingeschakeld voor je Databricks-werkruimte. Je hoeft geen OAuth-app te maken of een client-ID of clientgeheim in te voeren. Volg de stappen in het gedeelte Ingebouwde OAuth hieronder.
Aangepaste OAuth-client: Kies deze optie als ingebouwde OAuth niet beschikbaar is of als je organisatie een eigen OAuth-client vereist. Volg de stappen in het gedeelte Aangepaste OAuth-client hieronder.
Wat je gaat instellen
Je maakt een verbinding met de Databricks-app voor je ChatGPT-account of -werkruimte. Voor beide opties heb je de in ChatGPT gevraagde providergegevens van Databricks nodig, plus machtigingen voor de resources die je wilt gebruiken. Als je een aangepaste OAuth-client gebruikt, zorg dan ook voor:
Een Databricks OAuth-appverbinding die is aangemaakt in de Databricks-accountconsole.
De Databricks OAuth-client-ID en het bijbehorende clientgeheim.
De exacte callback-URL, gekopieerd uit ChatGPT.
Databricks-scopes die passen bij de appfuncties die je wilt inschakelen.
Alle providergegevens van Databricks die tijdens het instellen in ChatGPT worden gevraagd, zoals de werkruimtehost, accounthost, account-ID of het warehouse.
Voordat je begint
Om de app voor een werkruimte in te stellen, open je de beheerconsole, selecteer je de gewenste ChatGPT-werkruimte en open je Plug-ins. Selecteer Verouderde apps beheren om de behouden Apps-pagina te openen. Zie Beheerdersinstellingen, beveiliging en compliance voor plug-ins en apps voor informatie over werkruimtenavigatie en toegang tot verouderde apps.
Je hebt het volgende nodig:
Beheerders- of eigenaarstoegang tot de ChatGPT-werkruimte, of een ChatGPT Plus- of Pro-account.
Voor een aangepaste OAuth-client: beheerderstoegang tot het Databricks-account. Voor sommige taken kan beheerderstoegang tot de werkruimte voldoende zijn, maar aangepaste appverbindingen worden ingesteld vanuit de Databricks-accountconsole. Voor ingebouwde OAuth moet een Databricks-beheerder controleren of de ChatGPT-applicatie beschikbaar is en is ingeschakeld voor je werkruimte.
Voor een aangepaste OAuth-client: de Databricks-accountconsole, geopend in een apart tabblad.
Voor een aangepaste OAuth-client: het verbindingsscherm voor Databricks Genie, geopend in ChatGPT, zodat je de exacte callback-URL kunt kopiëren.
Een keuze voor de functies die de app nodig heeft: Genie en AI/BI-dashboards, ruimere toegang tot Databricks-API's of een app die beperkt is tot Databricks SQL-API's. Toegang tot alleen SQL is niet voldoende voor Genie- of dashboardacties.
Voor een aangepaste OAuth-client: een veilige plek om het Databricks-clientgeheim te beheren.
Als je Databricks-account of -werkruimte de toegang beperkt via een IP-toegangslijst, contextafhankelijke regels voor inkomend verkeer, een firewall of ander netwerkbeleid: hulp van een Databricks-beheerder die de huidige IP-bereiken voor uitgaand verkeer van ChatGPT-apps kan toestaan.
Kopieer voor een aangepaste OAuth-client de exacte Callback-URL die in ChatGPT wordt weergegeven.
Gegevens om klaar te zetten
Voor een aangepaste OAuth-client, de Callback-URL: kopieer deze tijdens het instellen van de app in ChatGPT.
Voor een aangepaste OAuth-client: de Databricks OAuth-client-ID.
Voor een aangepaste OAuth-client: het Databricks OAuth-clientgeheim.
Voor een aangepaste OAuth-client: Databricks-toegangsscopes die passen bij de functies van de app. Als bij een nieuwe Genie-/dashboardverbinding
ai-gateway,dashboardsenoffline_accessworden weergegeven, bereid dan die scopes voor. ALLE API's (all-apismetoffline_access) blijft het oudere, ruimere alternatief. Gebruik SQL alleen voor een app die beperkt is tot Databricks SQL-API's.De Databricks-werkruimte- of accountgegevens die tijdens het instellen in ChatGPT worden gevraagd.
Ingebouwde OAuth
Zorg eerst dat je aan de bovenstaande vereisten voldoet. Gebruik deze methode alleen als ingebouwde OAuth beschikbaar is in ChatGPT en is ingeschakeld voor je Databricks-werkruimte.
Vraag een Databricks-beheerder te controleren of de ChatGPT-applicatie beschikbaar is in de instellingen voor app-integraties van de accountconsole en is ingeschakeld voor je werkruimte. Als de ChatGPT-applicatie niet in je Databricks-accountconsole staat, neem dan contact op met je Databricks-accountmanager om te vragen of de functie beschikbaar is voor je account.
Schakel in ChatGPT over naar het account of de werkruimte waarin de app beschikbaar moet zijn. Ga naar Instellingen > Plug-ins voor een persoonlijke configuratie, of ga als werkruimtebeheerder of -eigenaar naar Beheerconsole > Plug-ins voor een werkruimteconfiguratie.
Selecteer Databricks Genie en vervolgens App-verbinding toevoegen.
Voer de Hostnaam van de werkruimte (verplicht) in zonder
https://of een URL-pad.ChatGPT leidt het Genie MCP-endpoint binnen de werkruimte,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, af van deze hostnaam. Er is geen apart regionaal MCP-endpoint nodig.Selecteer Doorgaan, log vervolgens in bij Databricks en controleer het toestemmingsverzoek.
Ga verder met de onderstaande onderdelen Verbinden en testen en Toegang beheren, inclusief de tests met toegestane leden en de controles van de werkruimtetoegang.
Eigen OAuth-client
Zorg eerst dat je aan de bovenstaande vereisten voldoet. Kies deze methode als ingebouwde OAuth niet beschikbaar is of je organisatie een eigen OAuth-client vereist. Volg na het instellen de stappen in Verbinden en testen en Toegang beheren hieronder.
De configuratie van aangepaste OAuth in ChatGPT starten
Schakel in ChatGPT over naar het account of de werkruimte waarin de app beschikbaar moet zijn.
Ga naar Instellingen > Plug-ins voor een persoonlijke configuratie, of ga als werkruimtebeheerder of -eigenaar naar Beheerconsole > Plug-ins voor een werkruimteconfiguratie.
Selecteer Databricks Genie in Catalogus.
Selecteer App-verbinding toevoegen.
Zoek in het dialoogvenster Databricks Genie verbinden de velden OAuth-client-ID en OAuth-clientgeheim. Door inloggegevens in deze zichtbare velden in te voeren, configureer je een aangepaste client; je hoeft hiervoor geen aparte optie te selecteren.
Kopieer de Callback-URL uit ChatGPT. Houd dit dialoogvenster open.
Voorbeeld van een callback-URL:
https://chatgpt.com/connector/oauth/<callback_id>
Verwijder de callback-ID niet, voeg geen slash aan het einde toe en vervang de URL niet door een algemene ChatGPT-URL. De URL die in Databricks is geregistreerd, moet exact overeenkomen met de Callback-URL die in ChatGPT wordt weergegeven.
Een aangepaste OAuth-appverbinding maken in Databricks
Open de Databricks-accountconsole voor je Databricks-account.
Open Instellingen in de linkerzijbalk.
Open het tabblad Appverbindingen.
Selecteer Verbinding toevoegen.
Voer een applicatienaam in, zoals ChatGPT Databricks.
Plak bij Omleidings-URL's de exacte callback-URL die je uit ChatGPT hebt gekopieerd.
Kies onder Toegangsscopes de scopes die de app nodig heeft.
Als in ChatGPT bij een nieuwe Genie-/dashboardverbinding
ai-gateway,dashboardsenoffline_accessworden weergegeven, sta diezelfde scopes dan toe in de Databricks OAuth-app.ALLE API's blijft het oudere, ruimere alternatief voor algemene toegang tot Databricks-API's. Gebruik voor deze configuratie
all-apisenoffline_accessin ChatGPT en zorg dat de Databricks OAuth-app beide toestaat. Gebruik voor een nieuwe Genie-/dashboardverbinding bij voorkeur de weergegeven specifieke scopes.Gebruik SQL alleen voor een app die beperkt is tot Databricks SQL-API's. Toegang tot alleen SQL is niet voldoende voor Genie- of dashboardacties.
Zorg dat elke scope die later in ChatGPT wordt vermeld, is ingeschakeld in deze Databricks OAuth-app. Databricks staat openid, email, profile en offline_access automatisch toe voor apps die via de gebruikersinterface zijn gemaakt.
Laat de geldigheidsduur (TTL) van tokens op de standaardwaarden van Databricks staan, tenzij je organisatie hiervoor specifiek beleid heeft: 60 minuten voor het toegangstoken en 10080 minuten voor het vernieuwingstoken.
Schakel Een clientgeheim genereren in. ChatGPT heeft voor dit proces een vertrouwelijke OAuth-client nodig.
Maak de verbinding aan.
Inloggegevens kopiëren uit Databricks
Kopieer de Client-ID in het dialoogvenster Verbinding aangemaakt.
Kopieer het Clientgeheim meteen en bewaar het op een veilige plek.
Als je het dialoogvenster sluit voordat je het clientgeheim hebt gekopieerd, maak dan nieuwe inloggegevens voor de OAuth-app aan of vervang de bestaande en gebruik het nieuwe clientgeheim.
Databricks toont het clientgeheim slechts één keer. Behandel het als een inloggegeven en neem het niet op in schermafbeeldingen, tickets, opmerkingen of chats.
De configuratie van aangepaste OAuth in ChatGPT afronden
Ga terug naar het dialoogvenster Databricks Genie verbinden.
Voer de Databricks-client-ID in bij OAuth-client-ID.
Voer het Databricks-clientgeheim in bij OAuth-clientgeheim.
Door deze inloggegevens in te voeren, gebruik je je aangepaste OAuth-client; je hoeft hiervoor geen aparte optie te selecteren.
Voer bij Scopes (optioneel) de scopes in die vereist zijn voor het Databricks-endpoint en de mogelijkheden van je app. Zorg dat ze overeenkomen met de scopes die zijn ingeschakeld voor de Databricks OAuth-app.
Behoud bij een nieuwe Genie-/dashboardverbinding de scopes
ai-gateway,dashboardsenoffline_accessals deze worden weergegeven. Zorg dat de Databricks OAuth-app dezelfde scopes toestaat.ai-gatewaymaakt de Genie MCP-verbinding binnen de werkruimte mogelijk,dashboardsmaakt AI/BI-dashboardacties mogelijk enoffline_accessmaakt vernieuwingstokens mogelijk.Het oudere, ruimere alternatief,
all-apisenoffline_access, wordt nog steeds ondersteund voor bredere API-toegang, maar heeft niet de voorkeur voor deze Genie-/dashboardverbinding. Als de Databricks-app alleenall-apistoestaat, werk deze dan bij of maak deze opnieuw aan omai-gateway,dashboardsenoffline_accesstoe te staan. Als fijnmazige scopes niet beschikbaar zijn, stel ChatGPT dan bewust in opall-apisenoffline_accessen zorg dat de Databricks-app beide toestaat. Vraag de drie fijnmazige scopes niet aan in ChatGPT als de Databricks-app alleenall-apistoestaat.Voer één scope per regel in of scheid de scopes met komma's. Elke scope die in ChatGPT wordt vermeld, moet zijn ingeschakeld voor de Databricks OAuth-app.
Voer de Hostnaam van de werkruimte (verplicht) in zonder https:// of een URL-pad. Vul alle andere verplichte Databricks-providervelden in die tijdens de configuratie worden weergegeven.
ChatGPT leidt het Genie MCP-endpoint binnen de werkruimte,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, af van deze hostnaam. Er is geen apart regionaal MCP-endpoint nodig.Selecteer Doorgaan.
ChatGPT vraagt precies de scopes aan die bij Scopes (optioneel) zijn ingevoerd. Het voegt niet automatisch ruimere scopes uit een sjabloon toe.
Verbinding maken en testen
Voer voor beide OAuth-opties de volgende verbindingstests en toegangscontroles uit.
Controleer de appgegevens, acties en authenticatie-instellingen.
Als je werkruimtebeheerder bent, schakel je de app in voor de werkruimte en stel je volgens het werkruimtebeleid in wie deze mag gebruiken.
Start het verbindingsproces vanuit ChatGPT als testgebruiker met de juiste toegang en meld je vervolgens aan bij Databricks.
Controleer of de browser het verwachte Databricks-account of de verwachte werkruimte opent.
Controleer de aangevraagde scopes en selecteer vervolgens Autoriseren.
Controleer of de browser terugkeert naar ChatGPT en of de app als verbonden wordt weergegeven.
Voer een leesactie met een laag risico uit die past bij de functies van de verbinding. Stuur voor een Genie-verbinding een Genie-verzoek over gegevens waartoe de testgebruiker toegang heeft. Haal voor andere ondersteunde functies de gegevens van de huidige gebruiker op of voer een query uit op een goedgekeurde Databricks SQL-resource. Controleer of de gebruiker de vereiste machtigingen voor Databricks-resources heeft; OAuth-scopes alleen geven geen toegang tot gegevens.
Als schrijfacties zijn ingeschakeld, test deze dan vóór een bredere uitrol met een Databricks-workflow waarvan het risico duidelijk laag is.
Als je de app voor een werkruimte instelt, vraag dan een werkruimtelid met toegang maar zonder beheerdersrechten om verbinding te maken en de test met laag risico te herhalen.
Toegang beheren
Databricks en ChatGPT spelen allebei een rol in het toegangsbeheer.
In ChatGPT bepalen werkruimtebeheerders of de app beschikbaar is en hoe leden deze kunnen gebruiken. In Business bepalen beheerders of de app voor de hele werkruimte is ingeschakeld. Bekijk de beheerdersinstellingen voor Databricks-apps (Werkruimte-instellingen > Apps of Beheerconsole > Plug-ins > Verouderde apps beheren) voor:
Gebruikerstoegang, om in te stellen welke werkruimterollen de app mogen gebruiken in ondersteunde Enterprise- en Edu-werkruimten.
Actiebeheer, om in te stellen welke Databricks-acties zijn ingeschakeld.
Appmachtigingen, om in te stellen wanneer ChatGPT leden om toestemming vraagt voordat de app wordt gebruikt.
Deze appmachtigingen gelden voor ChatGPT-gesprekken. Werkruimte-agents gebruiken instellingen die de maker per agent vastlegt. Deze bepalen welke appacties beschikbaar zijn en wanneer eindgebruikers om goedkeuring worden gevraagd. Zie voor het gedrag van agents: ChatGPT-werkruimte-agents voor Enterprise en Business.
In Databricks bepalen beheerders welke gebruikers de OAuth-app mogen autoriseren en tot welke Databricks-resources die gebruikers toegang hebben. De machtigingen bij de provider blijven gelden nadat de app in ChatGPT is ingeschakeld.
Zie voor werkruimtenavigatie, toegang tot apps en appinstellingen per abonnement: Beheerdersinstellingen, beveiliging en compliance in apps.
Problemen bij het instellen van de Databricks-app oplossen
Omleidings-URI komt niet overeen: Als je een aangepaste OAuth-client gebruikt, controleer dan of de waarde bij Omleidings-URL's in Databricks exact overeenkomt met de Callback-URL in ChatGPT, inclusief het pad en de callback-ID. Verwijder de callback-ID niet, voeg geen slash aan het einde toe en gebruik geen andere ChatGPT-omleidings-URL.
Clientgeheim ontbreekt: Als je een aangepaste OAuth-client gebruikt, houd er dan rekening mee dat Databricks clientgeheimen slechts één keer toont. Genereer een nieuw clientgeheim als je het niet hebt gekopieerd.
OAuth-app niet direct beschikbaar: Volgens Databricks kan het tot 30 minuten duren voordat wijzigingen in OAuth-applicaties zijn verwerkt.
Ontoereikende of niet-overeenkomende scope: Als je een aangepaste OAuth-client gebruikt, vergelijk dan Scopes (optioneel) in ChatGPT met Toegangsscopes in de Databricks OAuth-app. Elke scope die ChatGPT aanvraagt, moet daar zijn ingeschakeld. Controleer of de scopes het endpoint en de functies die je gebruikt ondersteunen.
Als bij een nieuwe Genie-/dashboardverbinding
ai-gateway,dashboardsenoffline_accessworden weergegeven, behoud die scopes dan in ChatGPT en zorg dat de Databricks-app alle drie toestaat. Als de app alleenall-apistoestaat, werk deze dan bij of maak deze opnieuw aan om de drie specifieke scopes toe te staan.Als specifieke scopes niet beschikbaar zijn, gebruik dan het ondersteunde, ruimere alternatief: stel ChatGPT in op
all-apisenoffline_accessen zorg dat de Databricks-app beide toestaat. Een app die alleenall-apistoestaat, voldoet niet aan een ChatGPT-aanvraag voorai-gateway,dashboardsenoffline_access. Toegang tot alleen SQL is uitsluitend geschikt voor een app die beperkt is tot Databricks SQL-API's; dit is niet voldoende voor Genie- of dashboardacties.SQL-acties mislukken: Controleer bij een app die beperkt is tot Databricks SQL-API's de SQL-scope, de warehouseconfiguratie en de Databricks-machtigingen.
Verkeerde ChatGPT-werkruimte: Maak de app aan en schakel deze in binnen dezelfde ChatGPT-werkruimte waarin gebruikers er verbinding mee zullen maken.
Verkeerd Databricks-account of verkeerde werkruimte: Controleer de waarde bij Hostnaam van werkruimte (verplicht), doorloop de aanmeldstappen opnieuw en controleer of Databricks het verwachte account of de verwachte werkruimte opent.
Gebruikers kunnen geen verbinding maken: Controleer of de gebruiker toegang heeft tot Databricks en de OAuth-app mag autoriseren. Controleer in Business of de app voor de hele werkruimte is ingeschakeld. Controleer in ondersteunde Enterprise- en Edu-werkruimten ook of Gebruikerstoegang in ChatGPT de app toestaat.
Het netwerkbeleid van Databricks blokkeert de app: Als Databricks alleen specifieke bron-IP-adressen toestaat, moet een Databricks-beheerder de relevante IP-toegangslijsten voor het account of de werkruimte, contextafhankelijke regels voor inkomend verkeer, firewall of andere door de klant beheerde netwerkregels bijwerken.
Sta inkomende verbindingen toe vanaf de huidige IP-bereiken voor uitgaand verkeer van ChatGPT-apps.
Stel deze toelatingslijst in Databricks of in de door de klant beheerde netwerklaag in. Dit staat los van de IP-toelatingslijst van de ChatGPT-werkruimte.
De gepubliceerde bereiken kunnen veranderen. Automatiseer updates vanuit de JSON waar mogelijk.
Vervang het clientgeheim niet en wijzig geen OAuth-scopes om een netwerkblokkade te omzeilen. Controleer eerst of Databricks de bron-IP-adressen van de app weigert.