Freigeben über


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.

  1. 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.

  2. Klicken Sie auf Einstellungen.

  3. Klicken Sie auf die Registerkarte Featureaktivierung.

  4. Wählen Sie für die Option Aktivieren KI-gesteuerter Features entweder Aus oder Ein aus.

  5. Verhindern Sie Arbeitsbereichüberschreibungen mit der Einstellung Erzwingen: Erzwingen Sie die Einstellung, die eine Arbeitsbereichseinstellung außer Kraft setzt.

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:

  1. Klicken Sie in der oberen Leiste des Databricks-Arbeitsbereichs >Einstellungen auf Ihren Benutzernamen.
  2. Klicken Sie im linken Bereich unter Arbeitsbereichsadministrator auf die Registerkarte Erweitert.
  3. 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 Symbol für den Hilfeassistenten im Produkt – grau in der linken Seitenleiste.

Screenshot: Verwendeter Assistentenbereich

Geben Sie Fragen in das Textfeld am unteren Rand des Assistentenbereichs ein und drücken Sie die Eingabetaste oder klicken Sie auf Geben Sie Text für den Assistenten ein. 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.

Symbole am oberen Rand des Codefelds im Bereich „Assistent“

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 Symbo „Abfrage erneut generieren“.

Um den Bereich zu schließen, klicken Sie erneut auf das Symbol oder klicken Sie auf Symbol „Assistent schließen“ in der oberen rechten Ecke der Zelle. Sie können den Bereich auf volle Breite erweitern, indem Sie auf Symbol „Volle Breite öffnen“ klicken. Klicken Sie auf Symbol „Volle Breite schließen“, um den Bereich auf die Standardbreite zurückzusetzen.

Symbole am oberen Rand des Bereich „Assistent“

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 Symbol „Assistent löschen“ 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.

Symbole im Assistentenbereich.

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.

Beispiel für einen Titel für einen Thread im Databricks-Assistenten

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.

Der Inline-Assistent hilft Ihnen beim Suchen und Hinzufügen von Anreicherungsdaten.

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.

Tabellenverweis in einem Assistenten-Prompt mit dem @-Symbol

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.

Animiertes GIF des Databricks-Assistenten mit einer Tabelle von Titanic-Überlebenden mit Männern über 70 Jahren

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).

Animierte GIF der Codevervollständigung für SQL

Animierte GIF der Codevervollständigung für Python

KI-basiertes AutoVervollständigen kann auch Code aus Kommentaren generieren:

Animierte GIF der Codevervollständigung aus einem Kommentar

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

Beispiel für das Debuggen mit dem Assistenten in Python

SQL

Beispiel für das Debuggen mit dem Assistenten in 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:

Screenshot der Inline-Fehlerbehebungs-Benutzeroberfläche des Databricks-Assistenten.

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:

  1. Öffnen Sie den fehlgeschlagenen Auftrag über die Auftrags-UI.
  2. Wählen Sie dann Fehler diagnostizieren aus.

Fehlgeschlagener Auftrag mit der Schaltfläche

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.

Beantworten Sie eine Frage anhand der Databricks-Dokumentation.

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 Symbol für Codeausführung 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

Python-Code im Assistentenbereich ausführen.

SQL

SQL-Code im Assistentenbereich ausführen.

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: