Brug denne vejledning, hvis du er administrator for et ChatGPT-arbejdsområde og konfigurerer Databricks-appskabelonen for din organisation. En skabelon er ikke den endelige app, som medlemmerne bruger. Det er et konfigurationsflow, der opretter en arbejdsområdespecifik kladdeapp, når du har angivet den påkrævede Databricks-konfiguration.
For Databricks foregår det meste af konfigurationen i Databricks Account Console. Du opretter en brugerdefineret OAuth-appforbindelse, registrerer ChatGPT-callback-URL'en, kopierer de genererede klientoplysninger og indsætter derefter disse værdier i ChatGPT-skabelonens konfigurationsflow. Når ChatGPT har oprettet kladdeappen, kan du udgive den og administrere den som andre apps i arbejdsområdet.
Det konfigurerer du
Du opretter en arbejdsområdespecifik Databricks-app i ChatGPT. Appen bruger:
En Databricks OAuth-appforbindelse oprettet i din Databricks Account Console.
Databricks OAuth-klient-id'et og klienthemmeligheden.
Den nøjagtige callback-URL, der er kopieret fra ChatGPT.
Databricks-omfang, der matcher de connectorfunktioner, du vil aktivere.
Alle Databricks-udbyderoplysninger, som ChatGPT-konfigurationsflowet anmoder om, f.eks. arbejdsområdevært, kontovært, konto-id eller warehouse.
Før du går i gang
Du skal bruge:
Administrator- eller ejeradgang til ChatGPT-arbejdsområde.
Administratoradgang til Databricks-kontoen. Administratoradgang til arbejdsområdet kan være nok til nogle opgaver, men brugerdefinerede appforbindelser konfigureres fra Databricks Account Console.
Databricks Account Console åben i en separat fane.
Konfigurationsskærmen for Databricks-appskabelonen åben i ChatGPT, så du kan kopiere den nøjagtige callback-URL.
En beslutning om, hvorvidt appen skal have generel Databricks API-adgang eller kun Databricks SQL-adgang.
Et sikkert sted til at håndtere Databricks-klienthemmeligheden.
Opfind ikke callback-URL'en. Kopiér den nøjagtige callback-URL, der vises i ChatGPT.
Værdier, der skal forberedes
Callback-URL: kopiér denne fra ChatGPT-skabelonens konfigurationsflow.
Databricks OAuth-klient-id.
Databricks OAuth-klienthemmelighed.
Databricks-adgangsomfang, f.eks. ALL APIs eller SQL.
Databricks-arbejdsområde- eller kontofelter, som ChatGPT-konfigurationsflowet anmoder om.
Udgiv og administrer appen i ChatGPT
Oprettelse af kladdeappen gør den ikke automatisk tilgængelig for medlemmer. Når du har gennemgået kladden:
Udgiv kladdeappen.
Bekræft, at appen vises under Indstillinger for arbejdsområde > Apps > Aktiveret.
Konfigurer Brugeradgang for de roller, der skal bruge den.
Gennemgå Handlingsstyring for de Databricks-handlinger, som appen eksponerer.
Gennemgå Apptilladelser for at vælge, hvornår ChatGPT spørger medlemmer, før appen bruges.
Bed en tilladt testbruger om at åbne Apps i ChatGPT og bekræfte, at appen vises.
Disse apptilladelser gælder for ChatGPT-samtaler. Arbejdsområdeagenter bruger styring pr. agent, som er angivet af agentens bygger, til at afgøre, hvilke apphandlinger der er tilgængelige, og hvornår slutbrugere bliver bedt om at godkende dem. Se mere om agentadfærd her: ChatGPT Workspace Agents for Enterprise and Business.
Start skabelonkonfigurationen i ChatGPT
I ChatGPT skal du skifte til det arbejdsområde, hvor appen skal være tilgængelig.
Åbn Indstillinger for arbejdsområde > Apps.
Vælg Mappe.
Søg efter Databricks.
Vælg Databricks-appskabelonen, og start konfigurationen.
Angiv et tydeligt appnavn og en tydelig beskrivelse, f.eks. Databricks eller Databricks - Data Platform.
I OAuth-klientafsnittet skal du kopiere callback-URL'en fra ChatGPT. Hold denne fane åben.
Eksempel på callback-URL: https://chatgpt.com/connector/oauth/<callback_id>
Fjern ikke callback-id'et, tilføj ikke en afsluttende skråstreg, og erstat den ikke med en generisk ChatGPT-URL.
Opret OAuth-appforbindelsen i Databricks
Åbn Databricks Account Console for din Databricks-konto.
Åbn Indstillinger i venstre sidepanel.
Åbn fanen Appforbindelser.
Vælg Tilføj forbindelse.
Angiv et programnavn, f.eks. ChatGPT Databricks Connector.
Indsæt den nøjagtige callback-URL, der er kopieret fra ChatGPT, i Omdirigerings-URL'er.
Under Adgangsomfang skal du vælge de omfang, appen har brug for.
Brug ALL APIs til en generel Databricks-app, der har brug for Databricks APIs ud over SQL.
Brug kun SQL til en app, der er begrænset til Databricks SQL APIs.
Lad token-TTL'er stå på Databricks-standarderne, medmindre din organisation har en specifik politik.
Aktivér Generer en klienthemmelighed. ChatGPT skal bruge en fortrolig OAuth-klient til dette flow.
Opret forbindelsen.
Kopiér legitimationsoplysninger fra Databricks
Kopiér Klient-id i dialogboksen Forbindelse oprettet.
Kopiér Klienthemmelighed med det samme, og gem den sikkert.
Hvis du lukker dialogboksen, før du kopierer hemmeligheden, skal du oprette eller rotere 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, sager, kommentarer eller chats.
Afslut konfigurationen i ChatGPT
Gå tilbage til fanen med ChatGPT-skabelonens konfiguration.
Indsæt Databricks-klient-id'et i OAuth-klient-id.
Indsæt Databricks-klienthemmeligheden i OAuth-klienthemmelighed.
Lad Omfang være uændret, medmindre du bevidst skal tilsidesætte skabelonens standarder.
Udfyld eventuelle Databricks-udbyderfelter, som konfigurationsflowet kræver, f.eks. arbejdsområdevært, kontovært, konto-id, warehouse eller andre Databricks-specifikke værdier.
Opret kladdeappen.
Test appen som bruger
Start forbindelsesflowet fra ChatGPT som en tilladt testbruger.
Bekræft, at browseren åbner den forventede Databricks-konto eller det forventede arbejdsområde.
Godkend de anmodede omfang.
Bekræft, at browseren vender tilbage til ChatGPT, og at appen vises som forbundet.
Kør først en læsehandling med lav risiko, f.eks. hentning af aktuelle brugeroplysninger eller forespørgsel på en godkendt Databricks SQL-ressource.
Hvis skrivehandlinger er aktiveret, skal du teste med et Databricks-workflow med tydeligt lav risiko før bredere udrulning.
Administrer adgang
Databricks og ChatGPT bidrager begge til adgangsstyring.
I ChatGPT administrerer arbejdsområdeadministratorer, om den udgivne app er tilgængelig, hvilke arbejdsområderoller der kan bruge den, hvilke handlinger der er aktiveret, og hvornår ChatGPT spørger brugere, før appen bruges.
I Databricks administrerer administratorer, hvilke brugere der kan godkende OAuth-appen, og hvilke Databricks-ressourcer disse brugere kan få adgang til. Udbydertilladelser gælder stadig, efter at appen er aktiveret i ChatGPT.
Fejlfinding
Uoverensstemmelse i omdirigerings-URI: Bekræft, at Databricks-omdirigerings-URL'en præcist matcher callback-URL'en, der vises i ChatGPT, inklusive sti og callback-id.
Hemmelighed mangler: Databricks-hemmeligheder vises kun én gang. Generer en ny klienthemmelighed, hvis den ikke blev kopieret.
OAuth-app ikke tilgængelig med det samme: Databricks oplyser, at opdateringer af OAuth-applikationer kan tage op til 30 minutter at behandle.
Utilstrækkeligt omfang: Hvis ChatGPT kan godkende, men Databricks API-kald mislykkes, skal du bekræfte, at Databricks-appen har ALL APIs, når appen har brug for ikke-SQL APIs.
SQL-handlinger mislykkes: Bekræft SQL-omfang, warehouse-konfiguration og Databricks-tilladelser.
Forkert arbejdsområde: Opret og udgiv appen i det samme ChatGPT-arbejdsområde, hvor brugerne vil forbinde den.
Brugere kan ikke oprette forbindelse: Bekræft, at brugeren har Databricks-adgang og har tilladelse til at godkende OAuth-appen.