Gebruik deze gids als je een ChatGPT-werkruimtebeheerder bent die de Databricks-appsjabloon voor je organisatie instelt. Een sjabloon is niet de uiteindelijke app die leden gebruiken. Het is een instelproces dat een werkruimtespecifieke concept-app maakt nadat je de vereiste Databricks-configuratie hebt opgegeven.
Voor Databricks vindt het grootste deel van de instelling plaats in de Databricks Account Console. Je maakt een aangepaste OAuth-appverbinding, registreert de callback-URL van ChatGPT, kopieert de gegenereerde clientreferenties en plakt die waarden vervolgens in het instelproces van de ChatGPT-sjabloon. Nadat ChatGPT de concept-app heeft gemaakt, kun je deze publiceren en beheren zoals andere werkruimte-apps.
Wat je instelt
Je maakt een werkruimtespecifieke Databricks-app in ChatGPT. De app gebruikt:
Een Databricks OAuth-appverbinding die is gemaakt in je Databricks Account Console.
De Databricks OAuth-client-ID en het clientgeheim.
De exacte callback-URL die uit ChatGPT is gekopieerd.
Databricks-scopes die passen bij de connectorfuncties die je wilt inschakelen.
Alle Databricks-providergegevens waar het ChatGPT-instelproces om vraagt, zoals werkruimtehost, accounthost, account-ID of warehouse.
Voordat je begint
Je hebt nodig:
Beheerders- of eigenaarstoegang tot de ChatGPT-werkruimte.
Beheerderstoegang tot het Databricks-account. Beheerderstoegang tot de werkruimte kan voor sommige taken voldoende zijn, maar aangepaste appverbindingen worden geconfigureerd vanuit de Databricks Account Console.
De Databricks Account Console geopend in een apart tabblad.
Het instelscherm van de Databricks-appsjabloon geopend in ChatGPT, zodat je de exacte callback-URL kunt kopiëren.
Een beslissing of de app algemene toegang tot de Databricks-API nodig heeft of alleen toegang tot Databricks SQL.
Een veilige plek om het Databricks-clientgeheim te verwerken.
Verzin de callback-URL niet zelf. Kopieer de exacte callback-URL die in ChatGPT wordt weergegeven.
Voor te bereiden waarden
Callback-URL: kopieer deze uit het instelproces van de ChatGPT-sjabloon.
Databricks OAuth-client-ID.
Databricks OAuth-clientgeheim.
Databricks-toegangsscopes, zoals ALL APIs of SQL.
Databricks-werkruimte- of accountvelden waar het ChatGPT-instelproces om vraagt.
De app publiceren en beheren in ChatGPT
Het maken van de concept-app maakt deze niet automatisch beschikbaar voor leden. Na het controleren van het concept:
Publiceer de concept-app.
Bevestig dat de app wordt weergegeven in Werkruimte-instellingen > Apps > Ingeschakeld.
Configureer Gebruikerstoegang voor de rollen die de app moeten gebruiken.
Controleer Actiebeheer voor de Databricks-acties die de app beschikbaar maakt.
Controleer Appmachtigingen om te kiezen wanneer ChatGPT leden om toestemming vraagt voordat de app wordt gebruikt.
Vraag een toegestane testgebruiker om Apps in ChatGPT te openen en te bevestigen dat de app wordt weergegeven.
Deze appmachtigingen gelden voor ChatGPT-gesprekken. Werkruimte-agents gebruiken besturingselementen per agent die door de bouwer van de agent zijn ingesteld om te bepalen welke appacties beschikbaar zijn en wanneer eindgebruikers wordt gevraagd ze goed te keuren. Zie voor agentgedrag: ChatGPT-werkruimte-agents voor Enterprise en Business.
De sjablooninstelling starten in ChatGPT
Schakel in ChatGPT over naar de werkruimte waarin de app beschikbaar moet zijn.
Open Werkruimte-instellingen > Apps.
Selecteer Directory.
Zoek naar Databricks.
Selecteer de Databricks-appsjabloon en start de instelling.
Voer een duidelijke appnaam en beschrijving in, zoals Databricks of Databricks - Data Platform.
Kopieer in het gedeelte OAuth-client de callback-URL uit ChatGPT. Houd dit tabblad open.
Voorbeeld van callback-URL: https://chatgpt.com/connector/oauth/<callback_id>
Verwijder de callback-ID niet, voeg geen slash aan het einde toe en vervang deze niet door een algemene ChatGPT-URL.
De OAuth-appverbinding maken in Databricks
Open de Databricks Account Console voor je Databricks-account.
Open Instellingen in de linkerzijbalk.
Open het tabblad Appverbindingen.
Selecteer Verbinding toevoegen.
Voer een applicatienaam in, zoals ChatGPT Databricks Connector.
Plak in Omleidings-URL's de exacte callback-URL die uit ChatGPT is gekopieerd.
Kies onder Toegangsscopes de scopes die de app nodig heeft.
Gebruik ALL APIs voor een algemene Databricks-app die Databricks-API's buiten SQL nodig heeft.
Gebruik alleen SQL voor een app die beperkt is tot Databricks SQL-API's.
Laat token-TTL's op de standaardwaarden van Databricks staan, tenzij je organisatie een specifiek beleid heeft.
Schakel Een clientgeheim genereren in. ChatGPT heeft voor dit proces een vertrouwelijke OAuth-client nodig.
Maak de verbinding.
Referenties kopiëren uit Databricks
Kopieer in het dialoogvenster Verbinding gemaakt de Client-ID.
Kopieer het Clientgeheim onmiddellijk en bewaar het veilig.
Als je het dialoogvenster sluit voordat je het geheim hebt gekopieerd, maak of roteer dan de OAuth-appreferenties en gebruik het nieuwe geheim.
Databricks toont het geheim slechts één keer. Behandel het als een referentie en neem het niet op in screenshots, tickets, opmerkingen of chats.
De instelling voltooien in ChatGPT
Ga terug naar het tabblad voor het instellen van de ChatGPT-sjabloon.
Plak de Databricks-client-ID in OAuth-client-ID.
Plak het Databricks-clientgeheim in OAuth-clientgeheim.
Laat Scopes ongewijzigd, tenzij je bewust de standaardwaarden van de sjabloon moet overschrijven.
Vul alle Databricks-providervelden in die door het instelproces worden vereist, zoals werkruimtehost, accounthost, account-ID, warehouse of andere Databricks-specifieke waarden.
Maak de concept-app.
De app testen als gebruiker
Start het verbindingsproces vanuit ChatGPT als een toegestane testgebruiker.
Bevestig dat de browser het verwachte Databricks-account of de verwachte werkruimte opent.
Keur de gevraagde scopes goed.
Controleer of de browser terugkeert naar ChatGPT en de app als verbonden wordt weergegeven.
Voer eerst een leesactie met laag risico uit, zoals het ophalen van huidige gebruikersgegevens of het uitvoeren van een query op een goedgekeurde Databricks SQL-resource.
Als schrijfacties zijn ingeschakeld, test dan met een duidelijk laag-risico Databricks-workflow voordat je deze breder uitrolt.
Toegang beheren
Databricks en ChatGPT dragen beide bij aan toegangsbeheer.
In ChatGPT beheren werkruimtebeheerders of de gepubliceerde app beschikbaar is, welke werkruimterollen deze kunnen gebruiken, welke acties zijn ingeschakeld en wanneer ChatGPT gebruikers om toestemming vraagt voordat de app wordt gebruikt.
In Databricks beheren beheerders welke gebruikers de OAuth-app mogen autoriseren en tot welke Databricks-resources die gebruikers toegang hebben. Providermachtigingen blijven van toepassing nadat de app in ChatGPT is ingeschakeld.
Probleemoplossing
Redirect URI komt niet overeen: bevestig dat de Databricks Redirect URL exact overeenkomt met de callback-URL die in ChatGPT wordt weergegeven, inclusief pad en callback-ID.
Geheim ontbreekt: Databricks-geheimen worden eenmalig weergegeven. Genereer een nieuw clientgeheim als het niet is gekopieerd.
OAuth-app niet direct beschikbaar: volgens Databricks kan het verwerken van OAuth-applicatie-updates tot 30 minuten duren.
Onvoldoende scope: als ChatGPT zich kan verifiëren maar Databricks-API-aanroepen mislukken, controleer dan of de Databricks-app ALL APIs heeft wanneer de app niet-SQL-API's nodig heeft.
SQL-acties mislukken: controleer de SQL-scope, warehouseconfiguratie en Databricks-machtigingen.
Verkeerde werkruimte: maak en publiceer de app in dezelfde ChatGPT-werkruimte waar gebruikers deze zullen verbinden.
Gebruikers kunnen geen verbinding maken: bevestig dat de gebruiker Databricks-toegang heeft en de OAuth-app mag autoriseren.