Nutze diese Anleitung, wenn du als ChatGPT-Workspace-Administrator:in die Databricks-App-Vorlage für deine Organisation einrichtest. Eine Vorlage ist nicht die fertige App, die Mitglieder verwenden. Sie ist ein Einrichtungsablauf, der einen workspace-spezifischen App-Entwurf erstellt, nachdem du die erforderliche Databricks-Konfiguration angegeben hast.
Bei Databricks erfolgt der Großteil der Einrichtung in der Databricks Account Console. Du erstellst eine benutzerdefinierte OAuth-App-Verbindung, registrierst die ChatGPT-Callback-URL, kopierst die generierten Client-Anmeldedaten und fügst diese Werte dann in den Einrichtungsablauf der ChatGPT-Vorlage ein. Nachdem ChatGPT den App-Entwurf erstellt hat, kannst du ihn veröffentlichen und wie andere Workspace-Apps verwalten.
Was du einrichtest
Du erstellst in ChatGPT eine workspace-spezifische Databricks-App. Die App verwendet:
Eine Databricks-OAuth-App-Verbindung, die in deiner Databricks Account Console erstellt wurde.
Die Databricks-OAuth-Client-ID und das Client Secret.
Die exakte aus ChatGPT kopierte Callback-URL.
Databricks-Berechtigungsbereiche, die zu den Connector-Funktionen passen, die du aktivieren möchtest.
Alle Databricks-Anbieterdetails, die der ChatGPT-Einrichtungsablauf anfordert, etwa Workspace-Host, Account-Host, Account-ID oder Warehouse.
Bevor du beginnst
Du benötigst:
Administrator:innen- oder Inhaber:innenzugriff auf den ChatGPT-Workspace.
Administrator:innenzugriff auf das Databricks-Konto. Workspace-Administrator:innenzugriff kann für einige Aufgaben ausreichen, benutzerdefinierte App-Verbindungen werden jedoch in der Databricks Account Console konfiguriert.
Die Databricks Account Console in einem separaten Tab geöffnet.
Der Einrichtungsbildschirm der Databricks-App-Vorlage in ChatGPT geöffnet, damit du die exakte Callback-URL kopieren kannst.
Eine Entscheidung darüber, ob die App allgemeinen Databricks-API-Zugriff benötigt oder nur Zugriff auf Databricks SQL.
Einen sicheren Ort für den Umgang mit dem Databricks-Client-Secret.
Erfinde keine Callback-URL. Kopiere die exakt in ChatGPT angezeigte Callback-URL.
Vorzubereitende Werte
Callback-URL: Kopiere sie aus dem Einrichtungsablauf der ChatGPT-Vorlage.
Databricks-OAuth-Client-ID.
Databricks-OAuth-Client-Secret.
Databricks-Zugriffsbereiche, etwa ALL APIs oder SQL.
Databricks-Workspace- oder Kontofelder, die der ChatGPT-Einrichtungsablauf anfordert.
App in ChatGPT veröffentlichen und verwalten
Durch das Erstellen des App-Entwurfs wird die App nicht automatisch für Mitglieder verfügbar. Nach der Prüfung des Entwurfs:
Veröffentliche den App-Entwurf.
Bestätige, dass die App unter Workspace-Einstellungen > Apps > Aktiviert angezeigt wird.
Konfiguriere den Nutzer:innenzugriff für die Rollen, die die App verwenden sollen.
Prüfe die Aktionssteuerung für die Databricks-Aktionen, die die App bereitstellt.
Prüfe die App-Berechtigungen, um festzulegen, wann ChatGPT Mitglieder fragt, bevor die App verwendet wird.
Bitte eine zugelassene Testperson, Apps in ChatGPT zu öffnen und zu bestätigen, dass die App angezeigt wird.
Diese App-Berechtigungen gelten für ChatGPT-Unterhaltungen. Workspace-Agents verwenden agentenspezifische Steuerungen, die von der Person festgelegt werden, die den Agent erstellt hat. Damit wird bestimmt, welche App-Aktionen verfügbar sind und wann Endnutzer:innen um Genehmigung gebeten werden. Informationen zum Verhalten von Agents findest du hier: ChatGPT Workspace Agents for Enterprise and Business.
Einrichtung der Vorlage in ChatGPT starten
Wechsle in ChatGPT zu dem Workspace, in dem die App verfügbar sein soll.
Öffne Workspace-Einstellungen > Apps.
Wähle Verzeichnis aus.
Suche nach Databricks.
Wähle die Databricks-App-Vorlage aus und starte die Einrichtung.
Gib einen klaren App-Namen und eine Beschreibung ein, etwa Databricks oder Databricks - Data Platform.
Kopiere im Abschnitt für den OAuth-Client die Callback-URL aus ChatGPT. Lass diesen Tab geöffnet.
Beispiel für eine Callback-URL: https://chatgpt.com/connector/oauth/<callback_id>
Entferne die Callback-ID nicht, füge keinen abschließenden Schrägstrich hinzu und ersetze sie nicht durch eine generische ChatGPT-URL.
OAuth-App-Verbindung in Databricks erstellen
Öffne die Databricks Account Console für dein Databricks-Konto.
Öffne in der linken Seitenleiste Einstellungen.
Öffne den Tab App-Verbindungen.
Wähle Verbindung hinzufügen aus.
Gib einen Anwendungsnamen ein, etwa ChatGPT Databricks Connector.
Füge unter Redirect URLs die exakte aus ChatGPT kopierte Callback-URL ein.
Wähle unter Zugriffsbereiche die Scopes aus, die die App benötigt.
Verwende ALL APIs für eine allgemeine Databricks-App, die Databricks-APIs über SQL hinaus benötigt.
Verwende nur SQL für eine App, die auf Databricks-SQL-APIs beschränkt ist.
Belasse die Token-TTLs auf den Databricks-Standardwerten, sofern deine Organisation keine bestimmte Richtlinie hat.
Aktiviere Client Secret generieren. ChatGPT benötigt für diesen Ablauf einen vertraulichen OAuth-Client.
Erstelle die Verbindung.
Anmeldedaten aus Databricks kopieren
Kopiere im Dialog „Connection created“ die Client ID.
Kopiere das Client Secret sofort und speichere es sicher.
Wenn du den Dialog schließt, bevor du das Secret kopiert hast, erstelle oder rotiere die Anmeldedaten der OAuth-App und verwende das neue Secret.
Databricks zeigt das Secret nur einmal an. Behandle es wie Anmeldedaten und füge es nicht in Screenshots, Tickets, Kommentare oder Chats ein.
Einrichtung in ChatGPT abschließen
Kehre zum Tab für die Einrichtung der ChatGPT-Vorlage zurück.
Füge die Databricks-Client-ID in OAuth-Client-ID ein.
Füge das Databricks-Client-Secret in OAuth-Client-Secret ein.
Lass Scopes unverändert, sofern du die Standardwerte der Vorlage nicht bewusst überschreiben musst.
Fülle alle Databricks-Anbieterfelder aus, die der Einrichtungsablauf erfordert, etwa Workspace-Host, Account-Host, Account-ID, Warehouse oder andere Databricks-spezifische Werte.
Erstelle den App-Entwurf.
App als Nutzer:in testen
Starte den Verbindungsablauf aus ChatGPT als zugelassene Testperson.
Bestätige, dass der Browser das erwartete Databricks-Konto oder den erwarteten Workspace öffnet.
Genehmige die angeforderten Scopes.
Prüfe, ob der Browser zu ChatGPT zurückkehrt und die App als verbunden angezeigt wird.
Führe zuerst eine Leseaktion mit geringem Risiko aus, etwa das Abrufen aktueller Nutzer:inneninformationen oder eine Abfrage einer genehmigten Databricks-SQL-Ressource.
Wenn Schreibaktionen aktiviert sind, teste sie vor dem breiteren Rollout mit einem eindeutig risikoarmen Databricks-Workflow.
Zugriff verwalten
Databricks und ChatGPT tragen beide zur Zugriffskontrolle bei.
In ChatGPT verwalten Workspace-Administrator:innen, ob die veröffentlichte App verfügbar ist, welche Workspace-Rollen sie verwenden können, welche Aktionen aktiviert sind und wann ChatGPT Nutzer:innen vor der Verwendung der App fragt.
In Databricks verwalten Administrator:innen, welche Nutzer:innen die OAuth-App autorisieren können und auf welche Databricks-Ressourcen diese Nutzer:innen zugreifen dürfen. Die Berechtigungen des Anbieters gelten weiterhin, nachdem die App in ChatGPT aktiviert wurde.
Fehlerbehebung
Redirect URI stimmt nicht überein: Bestätige, dass die Databricks-Redirect-URL exakt mit der in ChatGPT angezeigten Callback-URL übereinstimmt, einschließlich Pfad und Callback-ID.
Secret fehlt: Databricks-Secrets werden nur einmal angezeigt. Generiere ein neues Client Secret, wenn es nicht kopiert wurde.
OAuth-App nicht sofort verfügbar: Laut Databricks kann die Verarbeitung von Aktualisierungen an OAuth-Anwendungen bis zu 30 Minuten dauern.
Unzureichender Scope: Wenn ChatGPT sich authentifizieren kann, Databricks-API-Aufrufe aber fehlschlagen, bestätige, dass die Databricks-App ALL APIs hat, wenn die App Nicht-SQL-APIs benötigt.
SQL-Aktionen schlagen fehl: Bestätige SQL-Scope, Warehouse-Konfiguration und Databricks-Berechtigungen.
Falscher Workspace: Erstelle und veröffentliche die App in demselben ChatGPT-Workspace, in dem Nutzer:innen sie verbinden werden.
Nutzer:innen können keine Verbindung herstellen: Bestätige, dass die jeweilige Person Databricks-Zugriff hat und die OAuth-App autorisieren darf.