Bruk denne veiledningen hvis du er administrator for et ChatGPT-arbeidsområde og skal konfigurere Databricks-appmalen for organisasjonen din. En mal er ikke den endelige appen som medlemmer bruker. Det er en konfigurasjonsflyt som oppretter et arbeidsområdespesifikt utkast til app etter at du har oppgitt den nødvendige Databricks-konfigurasjonen.
For Databricks skjer det meste av konfigureringen i Databricks Account Console. Du oppretter en egendefinert OAuth-apptilkobling, registrerer ChatGPT-callback-URL-en, kopierer den genererte klientlegitimasjonen og limer deretter inn disse verdiene i konfigurasjonsflyten for ChatGPT-malen. Etter at ChatGPT har opprettet apputkastet, kan du publisere det og administrere det som andre arbeidsområdeapper.
Hva du konfigurerer
Du oppretter en arbeidsområdespesifikk Databricks-app i ChatGPT. Appen bruker:
En Databricks OAuth-apptilkobling som er opprettet i Databricks Account Console.
Databricks OAuth-klient-ID-en og klienthemmeligheten.
Den nøyaktige callback-URL-en som er kopiert fra ChatGPT.
Databricks-omfang som samsvarer med tilkoblingsfunksjonene du vil aktivere.
Eventuelle Databricks-leverandørdetaljer som konfigurasjonsflyten i ChatGPT ber om, for eksempel arbeidsområdevert, kontovert, konto-ID eller warehouse.
Før du begynner
Du trenger:
Administrator- eller eiertilgang til ChatGPT-arbeidsområdet.
Administratortilgang til Databricks-kontoen. Administratortilgang til arbeidsområdet kan være nok for enkelte oppgaver, men egendefinerte apptilkoblinger konfigureres fra Databricks Account Console.
Databricks Account Console åpen i en egen fane.
Konfigurasjonsskjermen for Databricks-appmalen åpen i ChatGPT, slik at du kan kopiere den nøyaktige callback-URL-en.
En beslutning om appen trenger generell tilgang til Databricks API eller bare tilgang til Databricks SQL.
Et sikkert sted å håndtere Databricks-klienthemmeligheten.
Ikke finn opp callback-URL-en. Kopier den nøyaktige callback-URL-en som vises i ChatGPT.
Verdier som skal klargjøres
Callback-URL: kopier denne fra konfigurasjonsflyten for ChatGPT-malen.
Databricks OAuth-klient-ID.
Databricks OAuth-klienthemmelighet.
Databricks-tilgangsomfang, for eksempel ALL APIs eller SQL.
Databricks-arbeidsområde- eller kontofelt som konfigurasjonsflyten i ChatGPT ber om.
Publiser og administrer appen i ChatGPT
Å opprette apputkastet gjør det ikke automatisk tilgjengelig for medlemmer. Etter at du har gjennomgått utkastet:
Publiser apputkastet.
Bekreft at appen vises i Arbeidsområdeinnstillinger > Apper > Aktivert.
Konfigurer Brukertilgang for rollene som skal bruke den.
Gå gjennom Handlingskontroll for Databricks-handlingene som appen eksponerer.
Gå gjennom Apptillatelser for å velge når ChatGPT spør medlemmer før appen brukes.
Be en tillatt testbruker om å åpne Apper i ChatGPT og bekrefte at appen vises.
Disse apptillatelsene gjelder for ChatGPT-samtaler. Workspace Agents bruker kontroller per agent som er angitt av agentens bygger, for å avgjøre hvilke apphandlinger som er tilgjengelige, og når sluttbrukere blir bedt om å godkjenne dem. For agentatferd, se: ChatGPT Workspace Agents for Enterprise og Business.
Start konfigurasjonen av malen i ChatGPT
I ChatGPT bytter du til arbeidsområdet der appen skal være tilgjengelig.
Åpne Arbeidsområdeinnstillinger > Apper.
Velg Katalog.
Søk etter Databricks.
Velg Databricks-appmalen og start konfigureringen.
Skriv inn et tydelig appnavn og en tydelig beskrivelse, for eksempel Databricks eller Databricks – Dataplattform.
I delen OAuth-klient kopierer du callback-URL-en fra ChatGPT. La denne fanen være åpen.
Eksempel på callback-URL: https://chatgpt.com/connector/oauth/<callback_id>
Ikke fjern callback-ID-en, legg til en avsluttende skråstrek eller erstatt den med en generisk ChatGPT-URL.
Opprett OAuth-apptilkoblingen i Databricks
Åpne Databricks Account Console for Databricks-kontoen din.
Åpne Innstillinger i venstre sidestolpe.
Åpne fanen Apptilkoblinger.
Velg Legg til tilkobling.
Skriv inn et applikasjonsnavn, for eksempel ChatGPT Databricks Connector.
I URL-er for omdirigering limer du inn den nøyaktige callback-URL-en som er kopiert fra ChatGPT.
Under Tilgangsomfang velger du omfangene appen trenger.
Bruk ALL APIs for en generell Databricks-app som trenger Databricks API-er utover SQL.
Bruk bare SQL for en app som er begrenset til Databricks SQL API-er.
La token-TTL-er stå på Databricks-standardene med mindre organisasjonen din har en spesifikk policy.
Aktiver Generer en klienthemmelighet. ChatGPT trenger en konfidensiell OAuth-klient for denne flyten.
Opprett tilkoblingen.
Kopier legitimasjon fra Databricks
I dialogboksen Tilkobling opprettet kopierer du Klient-ID.
Kopier Klienthemmelighet umiddelbart og lagre den sikkert.
Hvis du lukker dialogboksen før du kopierer hemmeligheten, må du opprette eller rotere OAuth-applegitimasjonen og bruke den nye hemmeligheten.
Databricks viser hemmeligheten bare én gang. Behandle den som legitimasjon, og ikke ta den med i skjermbilder, saker, kommentarer eller chatter.
Fullfør konfigureringen i ChatGPT
Gå tilbake til fanen for konfigurasjon av ChatGPT-malen.
Lim inn Databricks-klient-ID-en i OAuth-klient-ID.
Lim inn Databricks-klienthemmeligheten i OAuth-klienthemmelighet.
La omfang være uendret med mindre du med hensikt må overstyre malens standardinnstillinger.
Fyll ut eventuelle Databricks-leverandørfelt som kreves av konfigurasjonsflyten, for eksempel arbeidsområdevert, kontoverter, konto-ID, warehouse eller andre Databricks-spesifikke verdier.
Opprett apputkastet.
Test appen som bruker
Start tilkoblingsflyten fra ChatGPT som en tillatt testbruker.
Bekreft at nettleseren åpner den forventede Databricks-kontoen eller det forventede arbeidsområdet.
Godkjenn de forespurte omfangene.
Kontroller at nettleseren går tilbake til ChatGPT, og at appen vises som tilkoblet.
Kjør først en lesehandling med lav risiko, for eksempel å hente informasjon om gjeldende bruker eller spørre en godkjent Databricks SQL-ressurs.
Hvis skrivehandlinger er aktivert, test med en tydelig Databricks-arbeidsflyt med lav risiko før bredere utrulling.
Administrer tilgang
Både Databricks og ChatGPT bidrar til tilgangskontroll.
I ChatGPT administrerer arbeidsområdeadministratorer om den publiserte appen er tilgjengelig, hvilke arbeidsområderoller som kan bruke den, hvilke handlinger som er aktivert, og når ChatGPT spør brukere før appen brukes.
I Databricks administrerer administratorer hvilke brukere som kan autorisere OAuth-appen, og hvilke Databricks-ressurser disse brukerne har tilgang til. Leverandørtillatelser gjelder fortsatt etter at appen er aktivert i ChatGPT.
Feilsøking
Uoverensstemmelse i omdirigerings-URI: Bekreft at Databricks-URL-en for omdirigering samsvarer nøyaktig med callback-URL-en som vises i ChatGPT, inkludert bane og callback-ID.
Hemmelighet mangler: Databricks-hemmeligheter vises bare én gang. Generer en ny klienthemmelighet hvis den ikke ble kopiert.
OAuth-app ikke tilgjengelig umiddelbart: Databricks sier at oppdateringer av OAuth-applikasjoner kan ta opptil 30 minutter å behandle.
Utilstrekkelig omfang: Hvis ChatGPT kan autentisere, men Databricks API-kall mislykkes, må du bekrefte at Databricks-appen har ALL APIs når appen trenger API-er som ikke er SQL.
SQL-handlinger mislykkes: Bekreft SQL-omfang, warehouse-konfigurasjon og Databricks-tillatelser.
Feil arbeidsområde: Opprett og publiser appen i det samme ChatGPT-arbeidsområdet der brukerne skal koble den til.
Brukere kan ikke koble til: Bekreft at brukeren har Databricks-tilgang og har lov til å autorisere OAuth-appen.