Bruk denne veiledningen hvis du er administrator for et ChatGPT-arbeidsområde eller bruker ChatGPT Plus eller Pro og skal konfigurere Databricks Genie-appen med innebygd OAuth eller organisasjonens egen OAuth-klient.
Innebygd OAuth: Bruk den forhåndskonfigurerte tilkoblingen når den er tilgjengelig i ChatGPT og aktivert for Databricks-arbeidsområdet ditt. Du trenger ikke å opprette en OAuth-app eller angi en klient-ID eller klienthemmelighet. Følg avsnittet Innebygd OAuth nedenfor.
Egendefinert OAuth-klient: Bruk denne fremgangsmåten hvis innebygd OAuth ikke er tilgjengelig, eller organisasjonen krever en egen OAuth-klient. Følg avsnittet Egendefinert OAuth-klient nedenfor.
Dette skal du konfigurere
Du skal opprette en tilkobling til Databricks-appen for ChatGPT-kontoen eller -arbeidsområdet ditt. Begge fremgangsmåtene krever leverandøropplysningene for Databricks som ChatGPT ber om, og tillatelser til ressursene du planlegger å bruke. Hvis du bruker en egendefinert OAuth-klient, må du også klargjøre:
En OAuth-apptilkobling for Databricks opprettet i Databricks-kontokonsollen.
Klient-ID-en og klienthemmeligheten for Databricks OAuth.
Den nøyaktige tilbakeringings-URL-en kopiert fra ChatGPT.
Databricks-omfang som samsvarer med appfunksjonene du vil aktivere.
Eventuelle leverandøropplysninger for Databricks som etterspørres under oppsettet i ChatGPT, for eksempel arbeidsområdevert, kontovert, konto-ID eller datavarehus.
Før du begynner
For oppsett i et arbeidsområde åpner du administrasjonskonsollen, velger ønsket ChatGPT-arbeidsområde og åpner Programtillegg. Velg Administrer eldre apper for å åpne den tidligere Apper-siden, som fortsatt er tilgjengelig. Les om navigasjon i arbeidsområdet og tilgang til eldre apper i Administratorkontroller, sikkerhet og samsvar for programtillegg og apper.
Du trenger:
Administrator- eller eiertilgang til ChatGPT-arbeidsområdet, eller en ChatGPT Plus- eller Pro-konto.
For en egendefinert OAuth-klient: administratortilgang til Databricks-kontoen. Administratortilgang til arbeidsområdet kan være nok for enkelte oppgaver, men egendefinerte apptilkoblinger konfigureres fra Databricks-kontokonsollen. For innebygd OAuth må en Databricks-administrator kontrollere at ChatGPT-appen er tilgjengelig og aktivert for arbeidsområdet ditt.
For en egendefinert OAuth-klient: Databricks-kontokonsollen åpen i en egen fane.
For en egendefinert OAuth-klient: tilkoblingsskjermen for Databricks Genie åpen i ChatGPT, slik at du kan kopiere den nøyaktige tilbakeringings-URL-en.
En avklaring av hvilke funksjoner appen trenger: Genie og AI/BI-dashbord, bredere tilgang til Databricks-API-er eller en app som er begrenset til Databricks SQL-API-er. Tilgang kun til SQL er ikke tilstrekkelig for Genie- eller dashbordhandlinger.
For en egendefinert OAuth-klient: et sikkert sted å håndtere klienthemmeligheten for Databricks.
Hvis Databricks-kontoen eller -arbeidsområdet begrenser tilgangen gjennom en IP-tilgangsliste, kontekstbasert kontroll av innkommende trafikk, en brannmur eller en annen nettverkspolicy: hjelp fra en Databricks-administrator som kan tillate gjeldende IP-områder for utgående trafikk fra ChatGPT-apper.
For en egendefinert OAuth-klient kopierer du den nøyaktige verdien i Tilbakeringings-URL som vises i ChatGPT.
Verdier du må klargjøre
For en egendefinert OAuth-klient, Tilbakeringings-URL: Kopier denne fra appoppsettet i ChatGPT.
For en egendefinert OAuth-klient: klient-ID-en for Databricks OAuth.
For en egendefinert OAuth-klient: klienthemmeligheten for Databricks OAuth.
For en egendefinert OAuth-klient: Databricks-tilgangsomfang som passer til appens funksjoner. For en ny Genie-/dashbordtilkobling som viser
ai-gateway,dashboardsogoffline_access, klargjør du disse omfangene. ALLE API-er (all-apismedoffline_access) er fortsatt det eldre alternativet med bredere tilgang. Bruk SQL bare for en app som er begrenset til Databricks SQL-API-er.Arbeidsområde- eller kontofelter for Databricks som etterspørres under oppsettet i ChatGPT.
Innebygd OAuth
Oppfyll forutsetningene ovenfor først. Bruk denne fremgangsmåten bare når innebygd OAuth er tilgjengelig i ChatGPT og aktivert for Databricks-arbeidsområdet ditt.
Be en Databricks-administrator kontrollere at ChatGPT-appen er tilgjengelig i innstillingene for appintegrasjoner i kontokonsollen og aktivert for arbeidsområdet ditt. Hvis ChatGPT-appen ikke er oppført i Databricks-kontokonsollen, kontakter du kontoansvarlig hos Databricks for å spørre om funksjonen er tilgjengelig for kontoen din.
Bytt til kontoen eller arbeidsområdet der appen skal være tilgjengelig, i ChatGPT. Gå til Innstillinger > Programtillegg for et personlig oppsett, eller til Administrasjonskonsoll > Programtillegg som administrator eller eier av arbeidsområdet for å konfigurere det for arbeidsområdet.
Velg Databricks Genie, og velg deretter Legg til apptilkobling.
Angi Vertsnavn for arbeidsområdet (obligatorisk) uten
https://eller en URL-bane.ChatGPT utleder det lokale Genie MCP-endepunktet i arbeidsområdet,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, fra dette vertsnavnet. Det er ikke nødvendig med et eget regionalt MCP-endepunkt.Velg Fortsett, logg deretter på Databricks og gjennomgå samtykkeforespørselen.
Fortsett med Koble til og test og Administrer tilgang nedenfor, inkludert testene med medlemmer som har tillatelse, og kontrollene av arbeidsområdetilgang.
Egen OAuth-klient
Sørg først for at forutsetningene ovenfor er oppfylt. Bruk dette alternativet hvis innebygd OAuth ikke er tilgjengelig, eller hvis organisasjonen krever en egen OAuth-klient. Etter oppsettet følger du trinnene under Koble til og test og Administrer tilgang nedenfor.
Start oppsettet av egendefinert OAuth i ChatGPT
Bytt til kontoen eller arbeidsområdet der appen skal være tilgjengelig, i ChatGPT.
Gå til Innstillinger > Programtillegg for et personlig oppsett, eller til Administrasjonskonsoll > Programtillegg som administrator eller eier av arbeidsområdet for å konfigurere det for arbeidsområdet.
Velg Databricks Genie i Katalog.
Velg Legg til apptilkobling.
Finn feltene OAuth-klient-ID og OAuth-klienthemmelighet i dialogboksen Koble til Databricks Genie. Du konfigurerer den egendefinerte klienten ved å oppgi påloggingsopplysninger i disse synlige feltene. Du trenger ikke velge den separat.
Kopier Tilbakekalls-URL fra ChatGPT. La denne dialogboksen stå åpen.
Eksempel på tilbakekalls-URL:
https://chatgpt.com/connector/oauth/<callback_id>
Ikke fjern tilbakekalls-ID-en, legg til en avsluttende skråstrek eller erstatt URL-en med en generell ChatGPT-URL. URL-en som er registrert i Databricks, må samsvare nøyaktig med Tilbakekalls-URL som vises i ChatGPT.
Opprett en egendefinert OAuth-apptilkobling i Databricks
Åpne Databricks-kontokonsollen for Databricks-kontoen din.
Åpne Innstillinger i sidefeltet til venstre.
Åpne fanen Apptilkoblinger.
Velg Legg til tilkobling.
Angi et appnavn, for eksempel ChatGPT Databricks.
I Omdirigerings-URL-er limer du inn den nøyaktige tilbakeringings-URL-en du kopierte fra ChatGPT.
Under Tilgangsomfang velger du omfangene appen trenger.
For en ny Genie-/dashbordtilkobling som viser
ai-gateway,dashboardsogoffline_accessi ChatGPT, tillater du de samme omfangene i Databricks OAuth-appen.ALLE API-er er fortsatt det eldre alternativet med bredere tilgang for generell tilgang til Databricks-API-er. For denne konfigurasjonen bruker du
all-apisogoffline_accessi ChatGPT og sørger for at Databricks OAuth-appen tillater begge. For en ny Genie-/dashbordtilkobling bør du velge de mer spesifikke omfangene som vises.Bruk SQL bare for en app som er begrenset til Databricks SQL-API-er. Tilgang kun til SQL er ikke tilstrekkelig for Genie- eller dashbordhandlinger.
Sørg for at alle omfang som senere oppføres i ChatGPT, er aktivert i denne Databricks OAuth-appen. Databricks tillater automatisk openid, email, profile og offline_access for apper som opprettes i brukergrensesnittet.
Behold Databricks-standardverdiene for tokenlevetid (TTL), med mindre organisasjonen har egne retningslinjer: 60 minutter for tilgangstokenet og 10080 minutter for oppdateringstokenet.
Slå på Generer en klienthemmelighet. ChatGPT trenger en konfidensiell OAuth-klient for denne prosessen.
Opprett tilkoblingen.
Kopier påloggingsinformasjon fra Databricks
I dialogboksen Tilkobling opprettet kopierer du Klient-ID.
Kopier Klienthemmelighet med en gang, og lagre den sikkert.
Hvis du lukker dialogboksen før du har kopiert hemmeligheten, må du opprette eller rotere påloggingsinformasjonen for OAuth-appen og bruke den nye hemmeligheten.
Databricks viser hemmeligheten bare én gang. Behandle den som påloggingsinformasjon, og ikke ta den med i skjermbilder, supportsaker, kommentarer eller chatter.
Fullfør oppsettet av egendefinert OAuth i ChatGPT
Gå tilbake til dialogboksen Koble til Databricks Genie.
Skriv inn klient-ID-en fra Databricks i OAuth-klient-ID.
Skriv inn klienthemmeligheten fra Databricks i OAuth-klienthemmelighet.
Når du oppgir disse påloggingsopplysningene, brukes den egendefinerte OAuth-klienten din. Du trenger ikke velge den separat.
I Omfang (valgfritt) angir du tilgangsomfangene som kreves for appens Databricks-endepunkt og funksjoner. Disse må samsvare med tilgangsomfangene som er aktivert i Databricks OAuth-appen.
For en ny Genie-/dashbordtilkobling som viser
ai-gateway,dashboardsogoffline_access, beholder du disse tilgangsomfangene. Sørg for at Databricks OAuth-appen tillater de samme tilgangsomfangene.ai-gatewayaktiverer den lokale Genie MCP-tilkoblingen i arbeidsområdet,dashboardsaktiverer AI/BI-dashbordhandlinger, ogoffline_accessaktiverer oppdateringstokener.Det eldre, mer omfattende alternativet,
all-apisogoffline_access, støttes fortsatt for bredere API-tilgang, men anbefales ikke for denne Genie-/dashbordtilkoblingen. Hvis Databricks-appen bare tillaterall-apis, må du oppdatere eller opprette den på nytt slik at den tillaterai-gateway,dashboardsogoffline_access. Hvis detaljerte tilgangsomfang ikke er tilgjengelige, angir du eksplisittall-apisogoffline_accessi ChatGPT og sørger for at Databricks-appen tillater begge. Ikke be om de tre detaljerte tilgangsomfangene i ChatGPT når Databricks-appen bare tillaterall-apis.Angi ett tilgangsomfang per linje, eller skill dem med komma. Alle tilgangsomfang som er oppført i ChatGPT, må være aktivert i Databricks OAuth-appen.
Angi Vertsnavn for arbeidsområdet (obligatorisk) uten https:// eller en URL-bane. Fyll ut eventuelle andre obligatoriske felt for Databricks som leverandør som vises under oppsettet.
ChatGPT utleder det lokale Genie MCP-endepunktet i arbeidsområdet,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, fra dette vertsnavnet. Det er ikke nødvendig med et eget regionalt MCP-endepunkt.Velg Fortsett.
ChatGPT ber om nøyaktig de tilgangsomfangene som er angitt i Omfang (valgfritt). Mer omfattende tilgangsomfang fra malen legges ikke til automatisk.
Koble til og test
Utfør følgende tilkoblingstester og tilgangskontroller uansett hvilken OAuth-fremgangsmåte du bruker.
Se gjennom appdetaljene, handlingene og autentiseringsinnstillingene.
Hvis du er administrator for arbeidsområdet, aktiverer du appen for arbeidsområdet og angir hvem som kan bruke den, i tråd med arbeidsområdets retningslinjer.
Start tilkoblingen fra ChatGPT som en testbruker med tillatelse, og logg deretter på Databricks.
Kontroller at nettleseren åpner forventet Databricks-konto eller -arbeidsområde.
Se gjennom de forespurte omfangene, og velg deretter Autoriser.
Kontroller at nettleseren går tilbake til ChatGPT, og at appen vises som tilkoblet.
Utfør en lesehandling med lav risiko som samsvarer med tilkoblingens funksjoner. For en Genie-tilkobling sender du en Genie-forespørsel om data som testbrukeren har tilgang til. For andre støttede funksjoner henter du informasjon om gjeldende bruker eller kjører en spørring mot en godkjent Databricks SQL-ressurs. Kontroller at brukeren har de nødvendige tillatelsene til Databricks-ressursene. OAuth-omfang alene gir ikke tilgang til data.
Hvis skrivehandlinger er aktivert, tester du med en Databricks-arbeidsflyt som har klart lav risiko, før du ruller ut til flere.
For oppsett i et arbeidsområde ber du et medlem som har tillatelse, men ikke er administrator, om å koble til og gjenta testen med lav risiko.
Administrer tilgang
Både Databricks og ChatGPT bidrar til tilgangskontrollen.
I ChatGPT administrerer arbeidsområdeadministratorer om appen er tilgjengelig, og hvordan medlemmene kan bruke den. I Business administrerer administratorer om appen er aktivert for hele arbeidsområdet. Se gjennom administratorkontrollene for Databricks-appene (Arbeidsområdeinnstillinger > Apper eller Administrasjonskonsoll > Programtillegg > Administrer eldre apper) for:
Brukertilgang, for å angi hvilke arbeidsområderoller som kan bruke appen i støttede Enterprise- og Edu-arbeidsområder.
Handlingskontroll, for å angi hvilke Databricks-handlinger som er aktivert.
Apptillatelser, for å angi når ChatGPT skal spørre medlemmene før appen brukes.
Disse apptillatelsene gjelder for ChatGPT-samtaler. Arbeidsområdeagenter bruker individuelle kontroller som er angitt av den som har laget agenten, for å avgjøre hvilke apphandlinger som er tilgjengelige, og når sluttbrukere blir bedt om å godkjenne dem. Les om hvordan agenter fungerer i ChatGPT-arbeidsområdeagenter for Enterprise og Business.
I Databricks administrerer administratorer hvilke brukere som kan autorisere OAuth-appen, og hvilke Databricks-ressurser disse brukerne har tilgang til. Tillatelsene hos leverandøren gjelder fortsatt etter at appen er aktivert i ChatGPT.
Les om navigasjon i arbeidsområdet, apptilgang og abonnementsspesifikke appkontroller i Administratorkontroller, sikkerhet og samsvar i apper.
Feilsøking av oppsettet for Databricks-appen
Omdirigerings-URI samsvarer ikke: Hvis du bruker en egendefinert OAuth-klient, må du kontrollere at verdien i Omdirigerings-URL-er i Databricks samsvarer nøyaktig med Tilbakeringings-URL som vises i ChatGPT, inkludert banen og tilbakeringings-ID-en. Ikke fjern tilbakeringings-ID-en, legg til en avsluttende skråstrek eller bytt til en annen omdirigerings-URL for ChatGPT.
Hemmelighet mangler: Hvis du bruker en egendefinert OAuth-klient, må du være oppmerksom på at hemmeligheter i Databricks bare vises én gang. Generer en ny klienthemmelighet hvis den ikke ble kopiert.
OAuth-appen er ikke tilgjengelig med en gang: Databricks oppgir at det kan ta opptil 30 minutter å behandle oppdateringer av OAuth-apper.
Tilgangsomfanget er utilstrekkelig eller samsvarer ikke: Hvis du bruker en egendefinert OAuth-klient, sammenligner du Omfang (valgfritt) i ChatGPT med Tilgangsomfang i Databricks OAuth-appen. Alle omfang som ChatGPT ber om, må være aktivert der. Kontroller at omfangene støtter endepunktet og funksjonene du bruker.
For en ny Genie-/dashbordtilkobling som viser
ai-gateway,dashboardsogoffline_access, beholder du disse omfangene i ChatGPT og sørger for at Databricks-appen tillater alle tre. Hvis appen bare tillaterall-apis, oppdaterer du den eller oppretter den på nytt slik at den tillater de tre mer spesifikke omfangene.Hvis mer spesifikke omfang ikke er tilgjengelige, bruker du det støttede alternativet med bredere tilgang: Angi
all-apisogoffline_accessi ChatGPT, og sørg for at Databricks-appen tillater begge. En app som bare tillaterall-apis, samsvarer ikke med en forespørsel fra ChatGPT omai-gateway,dashboardsogoffline_access. Tilgang kun til SQL er bare egnet for en app som er begrenset til Databricks SQL-API-er. Det er ikke tilstrekkelig for Genie- eller dashbordhandlinger.SQL-handlinger mislykkes: For en app som er begrenset til Databricks SQL-API-er, kontrollerer du SQL-omfanget, konfigurasjonen av datavarehuset og Databricks-tillatelsene.
Feil ChatGPT-arbeidsområde: Opprett og aktiver appen i det samme ChatGPT-arbeidsområdet som brukerne skal koble den til i.
Feil Databricks-konto eller -arbeidsområde: Kontroller verdien i Vertsnavn for arbeidsområde (obligatorisk). Gjenta deretter påloggingen og kontroller at Databricks åpner forventet konto eller arbeidsområde.
Brukere kan ikke koble til: Kontroller at brukeren har tilgang til Databricks og har tillatelse til å autorisere OAuth-appen. I Business må du kontrollere at appen er aktivert for hele arbeidsområdet. I støttede Enterprise- og Edu-arbeidsområder må du også kontrollere at Brukertilgang i ChatGPT tillater appen.
Databricks-nettverkspolicyen blokkerer appen: Hvis Databricks bare tillater bestemte kilde-IP-adresser, må en Databricks-administrator oppdatere de relevante IP-tilgangslistene for kontoen eller arbeidsområdet, kontekstbaserte kontroller for innkommende trafikk, brannmuren eller andre kundestyrte nettverksregler.
Tillat innkommende tilkoblinger fra gjeldende IP-områder for utgående trafikk fra ChatGPT-apper.
Konfigurer denne tillatelseslisten i Databricks eller det kundestyrte nettverkslaget. Den er atskilt fra IP-tillatelseslisten for ChatGPT-arbeidsområdet.
De publiserte områdene kan endres. Automatiser oppdateringer fra JSON-filen når det er mulig.
Ikke roter klienthemmeligheten eller endre OAuth-omfang for å omgå en nettverksblokkering. Kontroller først om Databricks avviser appens kilde-IP-adresser.