Använd den här guiden om du är administratör för en ChatGPT-arbetsyta och ska konfigurera Databricks-appmallen för din organisation. En mall är inte den slutliga appen som medlemmarna använder. Det är ett konfigurationsflöde som skapar ett arbetsytespecifikt apputkast när du har angett den Databricks-konfiguration som krävs.
För Databricks sker det mesta av konfigurationen i Databricks Account Console. Du skapar en anpassad OAuth-appanslutning, registrerar ChatGPT:s callback-URL, kopierar de genererade klientuppgifterna och klistrar sedan in värdena i ChatGPT-mallens konfigurationsflöde. När ChatGPT har skapat apputkastet kan du publicera det och hantera det som andra arbetsyteappar.
Det här konfigurerar du
Du skapar en arbetsytespecifik Databricks-app i ChatGPT. Appen använder:
En Databricks OAuth-appanslutning som skapats i din Databricks Account Console.
Databricks OAuth-klient-ID och klienthemlighet.
Den exakta callback-URL:en som kopierats från ChatGPT.
Databricks-omfattningar som matchar de anslutningsfunktioner du vill aktivera.
Eventuell Databricks-leverantörsinformation som ChatGPT:s konfigurationsflöde begär, till exempel arbetsytevärd, kontovärd, konto-ID eller lager.
Innan du börjar
Du behöver:
Administratörs- eller ägaråtkomst till ChatGPT-arbetsytan.
Administratörsåtkomst till Databricks-kontot. Administratörsåtkomst till arbetsytan kan räcka för vissa uppgifter, men anpassade appanslutningar konfigureras från Databricks Account Console.
Databricks Account Console öppen på en separat flik.
Konfigurationsskärmen för Databricks-appmallen öppen i ChatGPT så att du kan kopiera den exakta callback-URL:en.
Ett beslut om appen behöver allmän Databricks API-åtkomst eller endast åtkomst till Databricks SQL.
En säker plats för att hantera Databricks-klienthemligheten.
Hitta inte på en callback-URL. Kopiera den exakta callback-URL som visas i ChatGPT.
Värden att förbereda
Callback-URL: kopiera den från ChatGPT-mallens konfigurationsflöde.
Databricks OAuth-klient-ID.
Databricks OAuth-klienthemlighet.
Databricks-åtkomstomfattningar, till exempel ALL APIs eller SQL.
Databricks-arbetsyte- eller kontofält som ChatGPT:s konfigurationsflöde begär.
Publicera och hantera appen i ChatGPT
Att skapa apputkastet gör inte appen automatiskt tillgänglig för medlemmar. Efter att ha granskat utkastet:
Publicera apputkastet.
Bekräfta att appen visas i Arbetsyteinställningar > Appar > Aktiverade.
Konfigurera Användaråtkomst för de roller som ska använda den.
Granska Åtgärdskontroll för de Databricks-åtgärder som appen exponerar.
Granska Appbehörigheter för att välja när ChatGPT ska fråga medlemmar innan appen används.
Be en tillåten testanvändare att öppna Appar i ChatGPT och bekräfta att appen visas.
Dessa appbehörigheter gäller för ChatGPT-konversationer. Arbetsytans Agents använder kontroller per Agent, som anges av Agentens byggare, för att avgöra vilka appåtgärder som är tillgängliga och när slutanvändare ombeds godkänna dem. För Agent-beteende, se: ChatGPT Workspace Agents för Enterprise och Business.
Starta mallkonfigurationen i ChatGPT
I ChatGPT växlar du till den arbetsyta där appen ska vara tillgänglig.
Öppna Arbetsyteinställningar > Appar.
Välj Katalog.
Sök efter Databricks.
Välj Databricks-appmallen och starta konfigurationen.
Ange ett tydligt appnamn och en beskrivning, till exempel Databricks eller Databricks – Data Platform.
Kopiera callback-URL:en från ChatGPT i avsnittet OAuth-klient. Håll den här fliken öppen.
Exempel på callback-URL: https://chatgpt.com/connector/oauth/<callback_id>
Ta inte bort callback-ID:t, lägg inte till ett avslutande snedstreck och ersätt den inte med en generisk ChatGPT-URL.
Skapa OAuth-appanslutningen i Databricks
Öppna Databricks Account Console för ditt Databricks-konto.
Öppna Inställningar i det vänstra sidofältet.
Öppna fliken Appanslutningar.
Välj Lägg till anslutning.
Ange ett programnamn, till exempel ChatGPT Databricks Connector.
I Omdirigerings-URL:er klistrar du in den exakta callback-URL som kopierats från ChatGPT.
Under Åtkomstomfattningar väljer du de omfattningar som appen behöver.
Använd ALL APIs för en allmän Databricks-app som behöver Databricks-API:er utöver SQL.
Använd endast SQL för en app som är begränsad till Databricks SQL-API:er.
Lämna token-TTL:er på Databricks standardvärden om inte organisationen har en särskild policy.
Aktivera Generera en klienthemlighet. ChatGPT behöver en konfidentiell OAuth-klient för det här flödet.
Skapa anslutningen.
Kopiera uppgifter från Databricks
Kopiera Client ID i dialogrutan Anslutning skapad.
Kopiera Client secret omedelbart och lagra den säkert.
Om du stänger dialogrutan innan du kopierar hemligheten ska du skapa eller rotera OAuth-appens uppgifter och använda den nya hemligheten.
Databricks visar hemligheten endast en gång. Behandla den som en inloggningsuppgift och inkludera den inte i skärmbilder, ärenden, kommentarer eller chattar.
Slutför konfigurationen i ChatGPT
Gå tillbaka till fliken för ChatGPT-mallens konfiguration.
Klistra in Databricks Client ID i OAuth-klient-ID.
Klistra in Databricks Client secret i OAuth-klienthemlighet.
Lämna Omfattningar oförändrade om du inte avsiktligt behöver åsidosätta mallens standardvärden.
Fyll i eventuella Databricks-leverantörsfält som krävs av konfigurationsflödet, till exempel arbetsytevärd, kontovärd, konto-ID, lager eller andra Databricks-specifika värden.
Skapa apputkastet.
Testa appen som användare
Starta anslutningsflödet från ChatGPT som en tillåten testanvändare.
Bekräfta att webbläsaren öppnar det förväntade Databricks-kontot eller den förväntade arbetsytan.
Godkänn de begärda omfattningarna.
Verifiera att webbläsaren återgår till ChatGPT och att appen visas som ansluten.
Kör först en läsåtgärd med låg risk, till exempel att hämta aktuell användarinformation eller fråga en godkänd Databricks SQL-resurs.
Om skrivåtgärder är aktiverade testar du med ett Databricks-arbetsflöde med tydligt låg risk innan bredare lansering.
Hantera åtkomst
Databricks och ChatGPT bidrar båda till åtkomstkontrollen.
I ChatGPT hanterar arbetsyteadministratörer om den publicerade appen är tillgänglig, vilka arbetsyteroller som kan använda den, vilka åtgärder som är aktiverade och när ChatGPT frågar användare innan appen används.
I Databricks hanterar administratörer vilka användare som kan auktorisera OAuth-appen och vilka Databricks-resurser dessa användare kan komma åt. Leverantörsbehörigheter gäller fortfarande efter att appen har aktiverats i ChatGPT.
Felsökning
Omdirigerings-URI matchar inte: bekräfta att Databricks Redirect URL exakt matchar den callback-URL som visas i ChatGPT, inklusive sökväg och callback-ID.
Hemlighet saknas: Databricks-hemligheter visas bara en gång. Generera en ny klienthemlighet om den inte kopierades.
OAuth-appen är inte tillgänglig direkt: Databricks anger att uppdateringar av OAuth-applikationer kan ta upp till 30 minuter att bearbeta.
Otillräcklig omfattning: om ChatGPT kan autentisera men Databricks API-anrop misslyckas, bekräfta att Databricks-appen har ALL APIs när appen behöver API:er som inte är SQL-API:er.
SQL-åtgärder misslyckas: bekräfta SQL-omfattning, lagerkonfiguration och Databricks-behörigheter.
Fel arbetsyta: skapa och publicera appen i samma ChatGPT-arbetsyta där användarna ska ansluta den.
Användare kan inte ansluta: bekräfta att användaren har Databricks-åtkomst och får auktorisera OAuth-appen.