Brug denne vejledning, hvis du er administrator for et ChatGPT-arbejdsområde eller bruger af ChatGPT Plus eller Pro og vil konfigurere Databricks Genie-appen med indbygget OAuth eller din organisations OAuth-klient.
Indbygget OAuth: Brug den forudkonfigurerede forbindelse, når den er tilgængelig i ChatGPT og aktiveret for dit Databricks-arbejdsområde. Du behøver ikke at oprette en OAuth-app eller angive et klient-id eller en klienthemmelighed. Følg afsnittet Indbygget OAuth nedenfor.
Egen OAuth-klient: Brug denne fremgangsmåde, hvis indbygget OAuth ikke er tilgængelig, eller din organisation kræver sin egen OAuth-klient. Følg afsnittet Egen OAuth-klient nedenfor.
Det konfigurerer du
Du opretter en forbindelse til Databricks-appen for din ChatGPT-konto eller dit ChatGPT-arbejdsområde. Begge fremgangsmåder kræver de Databricks-udbyderoplysninger, som ChatGPT beder om, samt tilladelser til de ressourcer, du vil bruge. Hvis du bruger din egen OAuth-klient, skal du også have følgende klar:
En Databricks OAuth-appforbindelse, der er oprettet i Databricks-kontokonsollen.
Databricks OAuth-klientens id og klienthemmelighed.
Den nøjagtige callback-URL kopieret fra ChatGPT.
Databricks-scopes, der svarer til de appfunktioner, du vil aktivere.
De Databricks-udbyderoplysninger, som ChatGPT beder om under opsætningen, f.eks. arbejdsområdevært, kontovært, konto-id eller warehouse.
Før du starter
Ved opsætning i et arbejdsområde skal du åbne administrationskonsollen, vælge det ønskede ChatGPT-arbejdsområde og åbne Plugins. Vælg Administrer ældre apps for at åbne den bevarede Apps-side. Læs om navigation i arbejdsområdet og adgang til ældre apps i Administratorkontroller, sikkerhed og compliance for plugins og apps.
Du skal bruge:
Administrator- eller ejeradgang til et ChatGPT-arbejdsområde eller en ChatGPT Plus- eller Pro-konto.
Administratoradgang til Databricks-kontoen, hvis du bruger din egen OAuth-klient. Administratoradgang til arbejdsområdet kan være nok til visse opgaver, men brugerdefinerede appforbindelser konfigureres i Databricks-kontokonsollen. Ved indbygget OAuth skal en Databricks-administrator kontrollere, at ChatGPT-appen er tilgængelig og aktiveret for dit arbejdsområde.
Databricks-kontokonsollen åben i en separat fane, hvis du bruger din egen OAuth-klient.
Skærmen til tilslutning af Databricks Genie åben i ChatGPT, så du kan kopiere den nøjagtige callback-URL, hvis du bruger din egen OAuth-klient.
En afklaring af, hvilke funktioner appen har brug for: Genie og AI/BI-dashboards, bredere adgang til Databricks-API'er eller en app, der er begrænset til Databricks SQL-API'er. Adgang udelukkende til SQL er ikke tilstrækkelig til Genie- eller dashboardhandlinger.
Et sikkert sted at håndtere Databricks-klienthemmeligheden, hvis du bruger din egen OAuth-klient.
Hjælp fra en Databricks-administrator, der kan tillade de aktuelle IP-intervaller for udgående trafik fra ChatGPT-apps, hvis din Databricks-konto eller dit arbejdsområde begrænser adgang via en IP-adgangsliste, kontekstbaseret kontrol af indgående trafik, en firewall eller en anden netværkspolitik.
Hvis du bruger din egen OAuth-klient, skal du kopiere den nøjagtige Callback-URL, der vises i ChatGPT.
Værdier, du skal have klar
Ved brug af din egen OAuth-klient: Callback-URL. Kopiér den fra appopsætningen i ChatGPT.
Databricks OAuth-klientens id, hvis du bruger din egen OAuth-klient.
Databricks OAuth-klientens klienthemmelighed, hvis du bruger din egen OAuth-klient.
Databricks-adgangsscopes, der passer til appens funktioner, hvis du bruger din egen OAuth-klient. For en ny Genie-/dashboardforbindelse, der viser
ai-gateway,dashboardsogoffline_access, skal du have disse scopes klar. ALLE API'er (all-apismedoffline_access) er fortsat det ældre alternativ med bredere adgang. Brug kun SQL til en app, der er begrænset til Databricks SQL-API'er.De felter for Databricks-arbejdsområdet eller -kontoen, som ChatGPT beder om under opsætningen.
Indbygget OAuth
Sørg først for, at forudsætningerne ovenfor er opfyldt. Brug kun denne fremgangsmåde, når indbygget OAuth er tilgængelig i ChatGPT og aktiveret for dit Databricks-arbejdsområde.
Bed en Databricks-administrator om at kontrollere, at ChatGPT-appen er tilgængelig i kontokonsollens indstillinger for appintegrationer og aktiveret for dit arbejdsområde. Hvis ChatGPT-appen ikke er angivet i din Databricks-kontokonsol, skal du kontakte din kontaktperson hos Databricks for at spørge, om funktionen er tilgængelig for din konto.
Skift i ChatGPT til den konto eller det arbejdsområde, hvor appen skal være tilgængelig. Gå til Indstillinger > Plugins for en personlig opsætning eller til Administratorkonsol > Plugins som administrator eller ejer for at konfigurere et arbejdsområde.
Vælg Databricks Genie, og vælg derefter Tilføj appforbindelse.
Indtast Arbejdsområdets værtsnavn (påkrævet) uden
https://eller en URL-sti.ChatGPT udleder arbejdsområdets lokale Genie MCP-endepunkt,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, ud fra dette værtsnavn. Der er ikke brug for et separat regionalt MCP-endepunkt.Vælg Fortsæt, log derefter ind på Databricks, og gennemgå anmodningen om samtykke.
Fortsæt med afsnittene Forbind og test og Administrer adgang nedenfor, herunder test med medlemmer, der har tilladelse, og kontrol af adgang til arbejdsområdet.
Egen OAuth-klient
Sørg først for, at forudsætningerne ovenfor er opfyldt. Brug denne fremgangsmåde, hvis indbygget OAuth ikke er tilgængelig, eller din organisation kræver sin egen OAuth-klient. Efter opsætningen skal du følge afsnittene Tilslut og test og Administrer adgang nedenfor.
Start opsætningen af din egen OAuth-klient i ChatGPT
Skift i ChatGPT til den konto eller det arbejdsområde, hvor appen skal være tilgængelig.
Gå til Indstillinger > Plugins for en personlig opsætning eller til Administratorkonsol > Plugins som administrator eller ejer for at konfigurere et arbejdsområde.
Vælg Databricks Genie i Katalog.
Vælg Tilføj appforbindelse.
Find felterne OAuth-klient-id og OAuth-klienthemmelighed i dialogboksen Forbind Databricks Genie. Du konfigurerer din egen klient ved at indtaste legitimationsoplysninger i disse synlige felter. Du behøver ikke vælge den separat.
Kopiér Callback-URL fra ChatGPT. Lad denne dialogboks være åben.
Eksempel på en callback-URL:
https://chatgpt.com/connector/oauth/<callback_id>
Du må ikke fjerne callback-id'et, tilføje en afsluttende skråstreg eller erstatte URL'en med en generisk ChatGPT-URL. Den URL, der er registreret i Databricks, skal svare nøjagtigt til den Callback-URL, der vises i ChatGPT.
Opret en brugerdefineret OAuth-appforbindelse i Databricks
Åbn Databricks-kontokonsollen for din Databricks-konto.
Åbn Indstillinger i venstre sidepanel.
Åbn fanen Appforbindelser.
Vælg Tilføj forbindelse.
Angiv et navn til appen, f.eks. ChatGPT Databricks.
Indsæt den nøjagtige callback-URL, du har kopieret fra ChatGPT, i Omdirigerings-URL'er.
Under Adgangsscopes skal du vælge de scopes, appen har brug for.
For en ny Genie-/dashboardforbindelse, der viser
ai-gateway,dashboardsogoffline_accessi ChatGPT, skal du tillade de samme scopes i Databricks OAuth-appen.ALLE API'er er fortsat det ældre alternativ med bredere adgang til Databricks-API'er generelt. Med denne konfiguration skal du bruge
all-apisogoffline_accessi ChatGPT og sikre, at Databricks OAuth-appen tillader begge. Brug helst de viste specifikke scopes til en ny Genie-/dashboardforbindelse.Brug kun SQL til en app, der er begrænset til Databricks SQL-API'er. Adgang udelukkende til SQL er ikke tilstrækkelig til Genie- eller dashboardhandlinger.
Sørg for, at alle scopes, der senere vises i ChatGPT, er aktiveret i denne Databricks OAuth-app. Databricks tillader automatisk openid, email, profile og offline_access for apps, der er oprettet via brugergrænsefladen.
Behold Databricks' standardlevetider (TTL) for tokens, medmindre din organisation har en specifik politik: 60 minutter for adgangstokenet og 10080 minutter for opdateringstokenet.
Slå Generér en klienthemmelighed til. ChatGPT kræver en fortrolig OAuth-klient til denne proces.
Opret forbindelsen.
Kopiér legitimationsoplysninger fra Databricks
Kopiér Klient-id i dialogboksen Forbindelse oprettet.
Kopiér Klienthemmelighed med det samme, og opbevar den sikkert.
Hvis du lukker dialogboksen, før du har kopieret hemmeligheden, skal du oprette eller udskifte OAuth-appens legitimationsoplysninger og bruge den nye hemmelighed.
Databricks viser kun hemmeligheden én gang. Behandl den som en legitimationsoplysning, og medtag den ikke i skærmbilleder, supportsager, kommentarer eller chats.
Fuldfør opsætningen af din egen OAuth-klient i ChatGPT
Vend tilbage til dialogboksen Forbind Databricks Genie.
Indtast klient-id'et fra Databricks i OAuth-klient-id.
Indtast klienthemmeligheden fra Databricks i OAuth-klienthemmelighed.
Når du indtaster disse legitimationsoplysninger, bruges din egen OAuth-klient. Du behøver ikke vælge den separat.
I Adgangsområder (valgfrit) skal du indtaste de adgangsområder, der kræves til appens Databricks-endepunkt og funktioner. De skal svare til de adgangsområder, der er aktiveret i Databricks OAuth-appen.
Hvis en ny Genie-/dashboardforbindelse viser
ai-gateway,dashboardsogoffline_access, skal du beholde disse adgangsområder. Sørg for, at Databricks OAuth-appen tillader de samme adgangsområder.ai-gatewaygiver adgang til Genie MCP-forbindelsen i arbejdsområdet,dashboardsgiver adgang til handlinger i AI/BI-dashboards, ogoffline_accessgiver adgang til opdateringstokens.Det ældre, bredere alternativ,
all-apisogoffline_access, understøttes stadig til bredere API-adgang, men anbefales ikke til denne Genie-/dashboardforbindelse. Hvis Databricks-appen kun tilladerall-apis, skal du opdatere eller genoprette den, så den tilladerai-gateway,dashboardsogoffline_access. Hvis de mere specifikke adgangsområder ikke er tilgængelige, skal du udtrykkeligt indstille ChatGPT tilall-apisogoffline_accessog sikre, at Databricks-appen tillader begge. Anmod ikke om de tre specifikke adgangsområder i ChatGPT, hvis Databricks-appen kun tilladerall-apis.Indtast ét adgangsområde pr. linje, eller adskil dem med kommaer. Alle adgangsområder, der er angivet i ChatGPT, skal være aktiveret i Databricks OAuth-appen.
Indtast Arbejdsområdets værtsnavn (påkrævet) uden https:// eller en URL-sti. Udfyld eventuelle andre påkrævede felter for Databricks som udbyder, der vises under opsætningen.
ChatGPT udleder arbejdsområdets lokale Genie MCP-endepunkt,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, ud fra dette værtsnavn. Der er ikke brug for et separat regionalt MCP-endepunkt.Vælg Fortsæt.
ChatGPT anmoder om præcis de adgangsområder, der er angivet i Adgangsområder (valgfrit). Der tilføjes ikke automatisk bredere adgangsområder fra skabelonen.
Opret forbindelse, og test
Udfør følgende forbindelsestests og adgangskontroller, uanset hvilken OAuth-fremgangsmåde du bruger.
Gennemgå appens oplysninger, handlinger og godkendelsesindstillinger.
Hvis du er administrator for arbejdsområdet, skal du aktivere appen for arbejdsområdet og angive, hvem der må bruge den, i overensstemmelse med arbejdsområdets politik.
Start tilslutningsprocessen fra ChatGPT som en testbruger med adgang, og log derefter ind på Databricks.
Kontrollér, at browseren åbner den forventede Databricks-konto eller det forventede arbejdsområde.
Gennemgå de anmodede scopes, og vælg derefter Godkend.
Kontrollér, at browseren vender tilbage til ChatGPT, og at appen vises som tilsluttet.
Udfør en læsehandling med lav risiko, der passer til forbindelsens funktioner. For en Genie-forbindelse skal du sende en Genie-anmodning om data, som testbrugeren har tilladelse til at tilgå. For andre understøttede funktioner skal du hente oplysninger om den aktuelle bruger eller forespørge på en godkendt Databricks SQL-ressource. Kontrollér, at brugeren har de nødvendige tilladelser til Databricks-ressourcerne. OAuth-scopes giver ikke i sig selv adgang til data.
Hvis skrivehandlinger er aktiveret, skal du teste med en Databricks-arbejdsgang med klart lav risiko, før løsningen udrulles bredere.
Ved opsætning i et arbejdsområde skal du bede et medlem, der har adgang, men ikke er administrator, om at oprette forbindelse og gentage testen med lav risiko.
Administrer adgang
Både Databricks og ChatGPT bidrager til adgangskontrollen.
I ChatGPT styrer arbejdsområdets administratorer, om appen er tilgængelig, og hvordan medlemmer kan bruge den. I Business styrer administratorerne, om appen er aktiveret for hele arbejdsområdet. Gennemgå administratorkontrollerne for Databricks-apps (Indstillinger for arbejdsområde > Apps eller Administrationskonsol > Plugins > Administrer ældre apps) for følgende:
Brugeradgang, hvor du angiver, hvilke roller i arbejdsområdet der må bruge appen i understøttede Enterprise- og Edu-arbejdsområder.
Handlingskontrol, hvor du angiver, hvilke Databricks-handlinger der er aktiveret.
Apptilladelser, hvor du angiver, hvornår ChatGPT skal spørge medlemmerne, før appen bruges.
Disse apptilladelser gælder for ChatGPT-samtaler. Arbejdsområdeagenter bruger individuelle kontroller, som agentens udvikler har indstillet. De afgør, hvilke apphandlinger der er tilgængelige, og hvornår slutbrugerne bliver bedt om at godkende dem. Læs om agenters adfærd i ChatGPT-arbejdsområdeagenter til Enterprise og Business.
I Databricks styrer administratorerne, hvilke brugere der må godkende OAuth-appen, og hvilke Databricks-ressourcer disse brugere har adgang til. Udbyderens tilladelser gælder stadig, efter at appen er aktiveret i ChatGPT.
Læs om navigation i arbejdsområdet, appadgang og abonnementsspecifikke appkontroller i Administratorkontroller, sikkerhed og compliance i apps.
Fejlfinding ved opsætning af Databricks-appen
Uoverensstemmelse i omdirigerings-URI: Hvis du bruger din egen OAuth-klient, skal du kontrollere, at værdien for Omdirigerings-URL'er i Databricks er nøjagtig den samme som den Callback-URL, der vises i ChatGPT, inklusive sti og callback-id. Du må ikke fjerne callback-id'et, tilføje en afsluttende skråstreg eller erstatte URL'en med en anden ChatGPT-omdirigerings-URL.
Klienthemmeligheden mangler: Hvis du bruger din egen OAuth-klient, skal du være opmærksom på, at Databricks kun viser hemmeligheder én gang. Generér en ny klienthemmelighed, hvis den ikke blev kopieret.
OAuth-appen er ikke tilgængelig med det samme: Ifølge Databricks kan det tage op til 30 minutter at behandle opdateringer af OAuth-apps.
Utilstrækkelige eller uoverensstemmende scopes: Hvis du bruger din egen OAuth-klient, skal du sammenligne Scopes (valgfrit) i ChatGPT med Adgangsscopes i Databricks OAuth-appen. Alle scopes, som ChatGPT anmoder om, skal være aktiveret der. Kontrollér, at de valgte scopes understøtter det endepunkt og de funktioner, du bruger.
For en ny Genie-/dashboardforbindelse, der viser
ai-gateway,dashboardsogoffline_access, skal du beholde disse scopes i ChatGPT og sikre, at Databricks-appen tillader alle tre. Hvis appen kun tilladerall-apis, skal du opdatere eller genoprette den, så den tillader de tre specifikke scopes.Hvis specifikke scopes ikke er tilgængelige, skal du bruge det understøttede alternativ med bredere adgang: Indstil ChatGPT til
all-apisogoffline_access, og sørg for, at Databricks-appen tillader begge. En app, der kun tilladerall-apis, opfylder ikke en anmodning fra ChatGPT omai-gateway,dashboardsogoffline_access. Adgang udelukkende til SQL er kun egnet til en app, der er begrænset til Databricks SQL-API'er. Den er ikke tilstrækkelig til Genie- eller dashboardhandlinger.SQL-handlinger mislykkes: For en app, der er begrænset til Databricks SQL-API'er, skal du kontrollere SQL-scopet, warehouse-konfigurationen og Databricks-tilladelserne.
Forkert ChatGPT-arbejdsområde: Opret og aktivér appen i det samme ChatGPT-arbejdsområde, som brugerne skal tilslutte den i.
Forkert Databricks-konto eller -arbejdsområde: Kontrollér værdien for Arbejdsområdets værtsnavn (påkrævet). Gentag derefter loginprocessen, og kontrollér, at Databricks åbner den forventede konto eller det forventede arbejdsområde.
Brugere kan ikke oprette forbindelse: Kontrollér, at brugeren har adgang til Databricks og har tilladelse til at godkende OAuth-appen. I Business skal du kontrollere, at appen er aktiveret for hele arbejdsområdet. I understøttede Enterprise- og Edu-arbejdsområder skal du også kontrollere, at Brugeradgang i ChatGPT tillader appen.
Databricks' netværkspolitik blokerer appen: Hvis Databricks kun tillader bestemte kilde-IP-adresser, skal en Databricks-administrator opdatere de relevante IP-adgangslister for kontoen eller arbejdsområdet, kontekstbaserede kontroller af indgående trafik, firewallen eller andre kundestyrede netværksregler.
Tillad indgående forbindelser fra de aktuelle IP-intervaller for udgående trafik fra ChatGPT-apps.
Konfigurér denne tilladelsesliste i Databricks eller i det kundestyrede netværkslag. Den er adskilt fra IP-tilladelseslisten for ChatGPT-arbejdsområdet.
De offentliggjorte intervaller kan ændre sig. Automatisér om muligt opdateringer ud fra JSON-filen.
Udskift ikke klienthemmeligheden, og ændr ikke OAuth-scopes for at omgå en netværksblokering. Kontrollér først, om Databricks afviser appens kilde-IP-adresser.