Verwenden des Databricks-Assistenten
Der Databricks-Assistent ist ein kontextbezogener KI-Assistent, der Ihnen bei Databricks-Notebooks, dem SQL-Editor, Aufträgen, KI/BI-Dashboards und dem Dateieditor helfen kann. Der Databricks-Assistent unterstützt Sie mit Daten und Code, wenn Sie über eine Unterhaltungsschnittstelle Hilfe anfordern.
Für ein Konto: Deaktivieren oder Aktivieren von Databricks-Assistentenfeatures
Die von Azuren KI-gesteuerte Funktionen des Databricks Assistenten sind standardmäßig aktiviert. Kontoadministratoren können Features des Azure KI-gesteuerten Assistenten jedoch für alle Arbeitsbereiche in einem Konto deaktivieren. Kontoadministratoren können auch das Aktivieren des Databricks-Assistenten für das gesamte Konto erzwingen:
Tipp
Die Aktivierung oder Deaktivierung von Databricks-Features des Azure KI-gesteuerten Assistenten für Ihr Konto wird als Kontoereignis in Ihren Überwachungsprotokollen erfasst, siehe Kontoereignisse.
Melden Sie sich als Kontoadministrator*in bei der Kontokonsole an.
Wichtig
Wenn sich keine Benutzer in Ihrem Microsoft Entra ID-Mandanten bei der Kontokonsole angemeldet haben, müssen Sie oder ein anderer Benutzer in Ihrem Mandanten sich als erster Kontoadministrator anmelden. Dazu müssen Sie ein globaler Microsoft Entra ID-Administrator sein, aber nur, wenn Sie sich zum ersten Mal bei der Azure Databricks-Kontokonsole anmelden. Bei der ersten Anmeldung werden Sie zu einem Azure Databricks-Kontoadministrator und benötigt nicht mehr die Rolle „Globaler Microsoft Entra ID-Administrator“, um auf das Azure Databricks-Konto zuzugreifen. Als erster Kontoadministrator können Sie Benutzer im Microsoft Entra ID-Mandanten als zusätzliche Kontoadministratoren zuweisen (die weitere Kontoadministratoren zuweisen können). Für zusätzliche Kontoadministratoren sind keine speziellen Rollen in Microsoft Entra ID erforderlich. Siehe Verwalten von Benutzern, Dienstprinzipalen und Gruppen.
Klicken Sie auf Einstellungen.
Klicken Sie auf die Registerkarte Featureaktivierung.
Wählen Sie für die Option Aktivieren KI-gesteuerter Features entweder Aus oder Ein aus.
Verhindern Sie Arbeitsbereichüberschreibungen mit der Einstellung Erzwingen:
Informationen zu den Diensten, die für Azure AI-basierte Databricks-Assistentenfeatures verwendet werden, finden Sie unter Features, die von partnergestützten KI-Hilfsfeatures gesteuert werden.
Für einen Arbeitsbereich: Deaktivieren oder Aktivieren von Assistentenfeatures
Wenn Ihr Kontoadministrator den Assistenten aktiviert, ist er standardmäßig in Arbeitsbereichen aktiviert. Sofern sich der Kontoadministrator nicht für die Erzwingung der Einstellung entschieden hat, können Arbeitsbereichsadministratoren sie für ihre Arbeitsbereiche deaktivieren.
Zum Deaktivieren des Databricks-Assistenten in einem Arbeitsbereich:
- Klicken Sie in der oberen Leiste des Databricks-Arbeitsbereichs >Einstellungen auf Ihren Benutzernamen.
- Klicken Sie im linken Bereich unter Arbeitsbereichsadministrator auf die Registerkarte Erweitert.
- Um den Assistenten zu deaktivieren, klicken Sie auf die Umschaltfläche Aus für Azure KI-gesteuerte Hilfsfunktionen.
Tour des Assistentenbereichs
In diesem Abschnitt wird die Standardoberfläche des Assistentenbereichs beschrieben.
Klicken Sie zum Öffnen des Assistentenbereichs auf 
in der linken Seitenleiste.
Geben Sie Fragen in das Textfeld am unteren Rand des Assistentenbereichs ein und drücken Sie die Eingabetaste oder klicken Sie auf 
rechts neben dem Textfeld. Der Assistent zeigt seine Antwort an. Der folgende Screenshot zeigt Aktionen, die Sie ausführen können, nachdem der Assistent Code im Assistentenbereich generiert hat.
Sie können dieselbe Abfrage erneut ausführen, um eine weitere Antwort zu generieren. Zeigen Sie dazu mit dem Mauszeiger auf die Antwort, und klicken Sie auf 
.
Um den Bereich zu schließen, klicken Sie erneut auf das Symbol oder klicken Sie auf 
in der oberen rechten Ecke der Zelle. Sie können den Bereich auf volle Breite erweitern, indem Sie auf 
klicken. Klicken Sie auf 
, um den Bereich auf die Standardbreite zurückzusetzen.
Der Assistentenbereich verfolgt Ihre Unterhaltungen auch dann, wenn Sie den Bereich oder das Notebook schließen. Um vorherige Unterhaltungen zu löschen, klicken Sie auf 
oben rechts im Assistentenbereich.
Threads und Promptverlauf
Unterhaltungsthreads bleiben in unterschiedlichen Kontexten erhalten, in denen der Databricks-Assistent verfügbar ist. Im Bereich „Assistent“ können Sie neue Unterhaltungsthreads erstellen, den Frage- und Promptverlauf anzeigen und Ihre Databricks-Assistentenerfahrung verwalten.
Der Databricks-Assistent betitelt die Threads basierend auf dem Kontext Ihrer Prompts, sodass Sie im Verlauf Ihrer Assistentenunterhaltung navigieren können. Das folgende Beispiel stammt aus einer Frage zu einem Notebook.
Verwenden des Databricks-Assistenten in einer Notebook-Zelle
In einem Notebook ist der Databricks-Assistent im Assistentenbereich oder inline in einer Codezelle verfügbar.
Wenn Sie den Databricks-Assistenten direkt in einer Codezelle verwenden möchten, drücken Sie BEFEHL + i unter MacOS oder STRG + i unter Windows. In der Zelle wird ein Textfeld angezeigt. Sie können eine Frage oder einen Kommentar auf Englisch eingeben und dann die EINGABETASTE drücken (nicht UMSCHALT+EINGABETASTE, wie beim Ausführen einer Zelle), damit der Assistent eine Antwort erstellt.
Verwenden von Schrägstrichbefehlen für Prompts
Schrägstrichbefehle sind Kurzbefehle zum Erstellen allgemeiner Prompts.
| Prompttext | Assistent – Funktionsweise |
|---|---|
/ |
Zeigt allgemeine Befehle an |
/doc |
Kommentiert den Code in einer Diff-Ansicht |
/explain |
Stellt eine Erläuterung des Codes in einer Zelle bereit |
/fix |
Schlägt eine Korrektur für Codefehler in einer Diff-Ansicht vor |
/findTables |
Sucht nach relevanten Tabellen auf der Basis von Unity Catalog-Metadaten. |
/findQueries |
Sucht nach relevanten Abfragen auf der Basis von Unity Catalog-Metadaten. |
/optimize |
Verbessert ineffiziente SQL-Abfragen. |
/prettify |
Formatiert Code für bessere Lesbarkeit. |
/rename |
Schlägt je nach Kontext aktualisierte Namen für Notebook-Zellen und andere Elemente vor. |
/settings |
Passt Ihre Notebook-Einstellungen direkt über den Assistenten an. |
Wenn Sie im Diff-Fenster /fix oder /doc verwenden, wählen Sie Annehmen aus, um die vorgeschlagenen Änderungen zu akzeptieren, oder Ablehnen, um den ursprünglichen Code beizubehalten. Wenn Sie den vorgeschlagenen Code akzeptieren, wird der Code nicht automatisch ausgeführt. Sie können den Code überprüfen, bevor Sie ihn ausführen. Wenn der generierte Code nicht ihren Wünschen entspricht, versuchen Sie es erneut, indem Sie Ihrem Kommentar weitere Details oder Informationen hinzufügen. Siehe Tipps für die Verwendung des Databricks-Assistenten.
Erhalten Sie detaillierte Erläuterungen zu Codeausschnitten. Verwenden Sie den Prompt /explain, und fügen Sie Begriffe wie „kurz fassen“ oder „Code zeilenweise erläutern“ ein, um die gewünschte Detailebene anzufordern. Sie können den Databricks-Assistenten auch bitten, dem Code Kommentare hinzuzufügen.
Bei der automatischen Vervollständigung von Code kann die Leistung im Assistentenbereich besser sein als in einer Notebook-Zelle.
Der Assistent wird automatisch geschlossen, wenn Sie den generierten Code Annehmen oder Ablehnen.
Verweisen auf Tabellen in Prompts mithilfe von @
Verwenden Sie das @ (at)-Symbol, um schnell auf Tabellen in Assistenten-Prompts zu verweisen.
Hilfe mit Code erhalten
Der Databricks-Assistent hilft bei Code, sowohl in SQL als auch Python:
- KI-basiertes AutoVervollständigen in Databricks-Notebooks, im SQL-Editor und im Datei-Editor.
- Datenfilterung mit Prompts in natürlicher Sprache.
- Codedebugging mit Diagnosefehler (Öffentliche Vorschau).
Hinweis
Inlinecodevorschläge sind in Azure Government-Regionen oder Arbeitsbereichen mit FedRAMP-Compliance nicht verfügbar.
Filtern von Daten mit Prompts in natürlicher Sprache
Verwenden Sie den Databricks-Assistenten, um Datenausgaben mit Prompts in natürlicher Sprache zu filtern.
Um Ausgaben mit natürlicher Sprache zu filtern, wählen Sie in der Ausgabetabelle das Filtersymbol aus und geben dann einen Prompt ein. Wie im folgenden animierten Beispiel können Sie beispielsweise den Prompt „Zeige mit nur Männer über 70 an“ verwenden.
Abrufen von Inlinecodevorschlägen: Python- und SQL-Beispiele
Die Vorschläge werden während der Eingabe automatisch angezeigt. Drücken Sie die TAB-TASTE, um einen Vorschlag zu übernehmen. Um einen Vorschlag manuell auszulösen, drücken Sie OPTION+UMSCHALT+LEERTASTE (unter macOS) oder STRG+UMSCHALT+LEERTASTE (unter Windows).
KI-basiertes AutoVervollständigen kann auch Code aus Kommentaren generieren:
Debugcode: Python- und SQL-Beispiele
Wichtig
Dieses Feature befindet sich in der Public Preview.
Führen Sie eine der folgenden Aktionen aus, um den Databricks-Assistenten zum Korrigieren von Code zu verwenden:
- Stellen Sie im Bereich „Assistent“ eine Frage.
- Klicken Sie auf die Schaltfläche Fehler diagnostizieren, die in der Zelle angezeigt wird, wenn ein Fehler auftritt.
- Klicken Sie auf Debuggen, um die Codezeile interaktiv zu durchlaufen, Haltepunkte festzulegen, Variablen zu prüfen und die Ausführung eines Programms zu analysieren.
Die folgenden Registerkarten enthalten Beispiele für Python- und SQL-Code.
Python
SQL
Wenn Sie auf Fehler diagnostizieren klicken, führt der Assistent automatisch /fix.
Schnelle Problembehebung
Wenn der Code Fehler liefert, empfiehlt Quick Fix automatisch Korrekturen für grundlegende Fehler, die mit einer einzigen Zeilenänderung behoben werden können.
Klicken Sie auf Akzeptieren und Ausführen, um die empfohlene Korrektur vorzunehmen und Ihren Code weiter auszuführen:
Fehler in Aufträgen diagnostizieren (öffentliche Vorschau)
Wichtig
Dieses Feature befindet sich in der Public Preview.
Der Databricks-Assistent hilft bei der Diagnose von Fehlern in Aufträgen.
So diagnostizieren Sie einen Auftrag mit dem Assistenten:
- Öffnen Sie den fehlgeschlagenen Auftrag über die Auftrags-UI.
- Wählen Sie dann Fehler diagnostizieren aus.
Abrufen von Antworten aus der Azure Databricks-Dokumentation
Im Notebook-Editor kann der Databricks-Assistent Fragen basierend auf der Databricks-Dokumentation beantworten. Geben Sie Ihre Frage oder Ihren Prompt in das Promptfeld ein.
Tipps für die Verwendung des Databricks-Assistenten
Dieser Abschnitt enthält einige allgemeine Tipps und bewährte Methoden bei der Verwendung des Databricks-Assistenten.
Der Databricks-Assistent verwendet Kontext, um bessere Antworten zu bieten
Der Databricks-Assistent hat Zugriff auf Tabellen- und Spaltenschemas sowie Metadaten. So können Sie natürliche Sprache verwenden und genauere Abfragen erstellen. Wenn beispielsweise eine Tabelle über eine Spalte namens Status verfügt, können Sie den Databricks-Assistenten bitten, eine Liste der Benutzer und Benutzerinnen, die in Michigan wohnen, zu generieren.
Der Databricks-Assistent verwendet den folgenden Kontext:
- Code oder Abfragen in der aktuellen Notebook-Zelle oder auf der Registerkarte des Databricks SQL-Editors.
- Namen und Beschreibungen von Tabellen und Spalten.
- Vorherige Fragen zur Eingabeaufforderung.
- Bevorzugte und aktive Tabellen.
- Für die Funktion Diagnosefehler wird die Stapelüberwachung aus der Fehlerausgabe abgerufen.
Wenn Sie Spalten aus einem DataFrame auswählen, können Sie genauere Ergebnisse erzielen, indem Sie eine Startabfrage bereitstellen. Geben Sie z. B. eine Anweisung wie SELECT * FROM <table_name>. Auf diese Weise kann der Databricks-Assistent die Spaltennamen abrufen und muss nicht raten.
Da der Databricks-Assistent Ihren Unterhaltungsverlauf verwendet, um bessere und genauere Antworten bereitzustellen, können Sie den Databricks-Assistenten bitten, die Ausgabe einer vorherigen Antwort zu ändern, ohne die gesamte Eingabeaufforderung neu schreiben zu müssen, wie unten dargestellt. Verwenden Sie den Chatverlauf von Assistent, um DataFrames im Bereich „Assistent“ iterativ zu bereinigen, zu durchsuchen, zu filtern und zu segmentieren.
Seien Sie spezifisch
Die Struktur und das Detail, das der Databricks-Assistent bereitstellt, variiert von Zeit zu Zeit, auch für die gleiche Eingabeaufforderung. Versuchen Sie, „Assistent“ so viel Anleitung wie möglich zu geben, damit er die gewünschten Informationen im gewünschten Format, Detaillierungsgrad usw. zurückgibt. Zum Beispiel:
- „Erklären Sie diesen Code in ein paar Sätzen“ oder „Erklären Sie diesen Code Zeile für Zeile“.
- “Erstellen Sie eine Visualisierung mithilfe von MatPlotLib” oder “Erstellen Sie eine Visualisierung mithilfe von Seaborn”.
Geben Sie Beispiele für Datenwerte auf Zeilenebene
Da der Databricks-Assistent keine Daten auf Zeilenebene verwendet, müssen Sie möglicherweise bei den Eingabeaufforderungen mehr Details angeben, um eine möglichst genaue Antwort zu erhalten. Verwenden Sie Tabellen- oder Spaltenkommentare im Katalog-Explorer, um eine Zeile mit Beispieldaten hinzuzufügen. Nehmen wir beispielsweise an, dass die Höhenspalte das Format feet-inches hat. Um „Assistent“ zu helfen, die Daten zu interpretieren, fügen Sie einen Kommentar wie „Die Höhenspalte ist im Zeichenfolgenformat und wird durch einen Bindestrich getrennt. Beispiel: „6-2“. Weitere Informationen zu Tabellen- und Spaltenkommentaren finden Sie unter Hinzufügen von Kommentaren zu Daten und KI-Ressourcen.
Wenn Sie Datentypkonvertierungen für Spalten verwenden müssen, um einen Vorgang auszuführen, müssen Sie möglicherweise Details angeben. Zum Beispiel: „Konvertieren Sie diesen Code von Pandas in PySpark, einschließlich des Codes, der erforderlich ist, um die Pandas DataFrame in einen PySpark DataFrame zu konvertieren und den Datentyp der Spaltenabwanderung von booleschen in ganze Zahlen zu ändern“.
Verwenden Sie die Umschalt+Eingabetaste, um eine neue Zeile in das Chat-Textfeld einzufügen
Verwenden Sie die Umschalt+Eingabetaste, um eine neue Zeile in das Chat-Textfeld einzufügen. Dies erleichtert das Formatieren und Organisieren Ihrer Nachrichten an den Databricks-Assistenten.
Bearbeiten und Ausführen von Code im Chatbereich des Databricks-Assistenten
Führen Sie Code im Assistentenbereich aus, um ihn zu überprüfen oder als Scratchpad zu verwenden. Klicken Sie auf 
zum Ausführen von Code in der oberen linken Ecke des Codefelds im Assistentenbereich.
Die folgenden Registerkarten zeigen Beispiele für Python- und SQL-Code.
Python
SQL
Wenn Sie Code im Assistentenbereich ausführen, wird die Ausgabe angezeigt und die Variablen können im Notebook verwendet werden.
Sie können auch den Code bearbeiten, den der Databricks-Assistent direkt im Assistenten-Chatfeld generiert, bevor Sie den Code in das Notebook verschieben.
Weitere Informationen
Die folgenden Artikel enthalten zusätzliche Informationen zur Verwendung des Databricks-Assistenten: