Freigeben über


Erhalte Programmierhilfe vom Databricks-Assistenten

In diesem Artikel wird beschrieben, wie Sie den Databricks-Assistenten verwenden können, um Ihnen beim Codieren und Debuggen Ihrer Notizbücher zu helfen, und enthält Tipps, wie Sie den Assistenten optimal nutzen können.

Wozu kann der Databricks-Assistent beitragen?

Der Databricks-Assistent ist ein kontextabhängiger KI-Assistent, mit dem Sie mit einer Unterhaltungsschnittstelle interagieren können, sodass Sie in Databricks produktiver arbeiten können. Sie können Ihre Aufgabe in Englisch beschreiben und dem Assistenten das Generieren von Python-Code oder SQL-Abfragen ermöglichen, komplexen Code erläutern und Fehler automatisch beheben. Der Assistent verwendet Unity-Katalogmetadaten, um Ihre Tabellen, Spalten, Beschreibungen und beliebten Datenressourcen in Ihrem Unternehmen zu verstehen, um personalisierte Antworten bereitzustellen.

Der Databricks-Assistent kann Ihnen bei den folgenden Aufgaben helfen:

  • Generieren von Code.
  • Debugcode, einschließlich Identifizieren und Vorschlagen von Korrekturen für Fehler.
  • Transformieren und Optimieren von Code.
  • Code erklären.
  • Helfen Sie, relevante Informationen in der Azure Databricks-Dokumentation zu finden.

Informationen zum Aktivieren und Verwenden des Databricks-Assistenten finden Sie unter Enable and try Databricks Assistant. Allgemeine Informationen zum Databricks-Assistenten finden Sie unter DatabricksIQ-basierte Features.

Tastenkombinationen für Assistenten-Befehle für Notebooks

In einem Notebook ist der Databricks-Assistent im Assistentenbereich oder inline in einer Codezelle verfügbar.

Um den Databricks-Assistenten direkt in einer Codezelle zu verwenden, drücken Sie Cmd+I unter MacOS oder Ctrl+I unter Windows. In der Zelle wird ein Textfeld angezeigt. Sie können eine Frage oder einen Kommentar in Englisch eingeben und dann Enter drücken (nicht Shift+Enter, wie Sie es tun würden, um eine Zelle auszuführen), damit der Assistent eine Antwort generiert.

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

Verwenden von Schrägstrichbefehlen für Prompts

Slash-Befehle sind eine Abkürzung zum Erstellen von Standard-Eingabeaufforderungen.

Prompttext Funktionsweise des Assistenten
/ Zeigt allgemeine Befehle an.
/doc Kommentiert den Code in einer Unterschiedsanzeige
/explain Stellt eine Erläuterung des Codes in einer Zelle bereit.
/fix Schlägt eine Korrektur für Codefehler in einer Unterschiedsanzeige vor.
/findTables Sucht nach relevanten Tabellen, die auf Unity-Katalogmetadaten basieren. Um Features oder Featuretabellen zu finden, erwähnen Sie in der Abfrage "Features" oder "Featuretabellen". Siehe Suchen von Features und Featuretabellen mithilfe von Databricks Assistant.
/findQueries Sucht nach relevanten Abfragen, die auf Unity-Katalogmetadaten basieren.
/optimize Verbessert ineffiziente SQL-Abfragen.
/prettify Formatiert Code für bessere Lesbarkeit.
/rename Schlägt aktualisierte Namen für Notizbuchzellen und andere Elemente je nach Kontext vor.
/settings Passt Ihre Notizbucheinstellungen direkt über den Assistenten an.

Wenn Sie /fix oder /docverwenden, wählen Sie im Diff-Fenster 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 die /explain Eingabeaufforderung, und fügen Sie Ausdrücke wie "Kurzschrift" oder "Erläutern von Codezeilen" ein, um die gewünschte Detailebene anzufordern. Sie können auch den Databricks-Assistenten bitten, dem Code Kommentare hinzuzufügen.

Bei der Code-Autovervollständigung ist die Leistung möglicherweise im Assistentenfenster besser als in einer Notizbuchzelle.

Der Assistent wird automatisch geschlossen, wenn Sie für den generierten Code auf Annehmen oder Ablehnen klicken.

Referenztabellen in Aufforderungen mit @

Verwenden Sie das @ (at)-Symbol, um schnell auf Tabellen in Assistentenaufforderungen zu verweisen.

Tabellenverweis in einem Prompt des Assistenten mit dem @-Symbol

Hilfe bei Codeproblemen

Der Databricks-Assistent hilft bei Code, sowohl SQL als auch Python:

  • KI-basiertes AutoVervollständigen in Databricks-Notizbüchern, dem SQL-Editor und dem Datei-Editor.
  • Datenfilterung mit Eingabeaufforderungen in natürlicher Sprache.
  • Codedebuggen mit Fehler diagnostizieren (Public Preview)

Hinweis

Inline-Code-Vorschläge sind in Azure Government-Regionen oder -Arbeitsbereichen mit FedRAMP-Konformität nicht verfügbar.

Vorschläge für Inline-Code abrufen: Python- und SQL-Beispiele

Während der Eingabe werden Vorschläge automatisch angezeigt. Drücken Sie Tab, um einen Vorschlag anzunehmen. Um einen Vorschlag manuell auszulösen, drücken Sie Option+Shift+Space (unter macOS) oder Control+Shift+Space (unter Windows).

animiertes GIF zur Codevervollständigung für SQL.

animierte GIF des Codeabschlusses für Python.

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

animiertes GIF zur Codevervollständigung aus einem Kommentar.

Filtern von Daten mit Aufforderungen in natürlicher Sprache

Verwenden Sie den Databricks-Assistenten, um Datenausgaben mit Eingaben in natürlicher Sprache zu filtern.

Um Ausgaben mit natürlicher Sprache zu filtern, klicken Sie in der Ausgabetabelle auf das Filtersymbol, und geben Sie eine Eingabeaufforderung ein. Wie im folgenden animierten Beispiel können Sie beispielsweise den Prompt „Zeige mir nur Männer über 70 an“ verwenden.

Animiertes GIF des Databricks-Assistenten mit einer Tabelle von Titanic-Überlebenden, die nach Männern über 70 Jahre gefiltert ist

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 Beheben von Code zu verwenden:

  • Stellen Sie im Bereich "Assistent" eine Frage.
  • Klicken Sie auf die Schaltfläche Fehler diagnostizieren, die in den Zellergebnissen 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 Tabs unten zeigen Beispiele in Python- und SQL-Code:

Python

Assistentendebuggingbeispiel in Python.

SQL

Assistentendebuggingbeispiel in SQL.

Wenn Sie auf Fehler diagnostizierenklicken, führt der Assistent automatisch /fix aus.

Schnelllösung

Wenn Code Fehler zurückgibt, empfiehlt Quick Fix automatisch Korrekturen für grundlegende Fehler, die in einer einzelnen Zeilenänderung behoben werden können.

Klicken Sie auf Annehmen, und führen Sie aus, um den empfohlenen Fix vorzunehmen und den Code weiter auszuführen:

Screenshot: Inlinebenutzeroberfläche für die Fehlerbehebung des Databricks-Assistenten

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.

Databricks Assistant verwendet Kontext, um bessere Antworten zu bieten

Der Databricks-Assistent hat Zugriff auf Tabellen- und Spaltenschemas und Metadaten. Auf diese Weise können Sie natürliche Sprache verwenden und genauere Abfragen generieren. Wenn beispielsweise eine Tabelle eine Spalte namens Stateenthält, können Sie den Databricks-Assistenten bitten, eine Liste der Benutzer zu generieren, die in Michigan leben.

Der Databricks-Assistent verwendet den folgenden Kontext:

  • Code oder Abfragen in der aktuellen Notebook-Zelle oder auf der Registerkarte des Databricks SQL-Editors.
  • Tabellen- und Spaltennamen und -beschreibungen.
  • Vorherige Promptfragen
  • Favoriten- und aktive Tabellen.
  • Für die Funktion Fehler diagnostizieren 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 beispielsweise eine Anweisung wie SELECT * FROM <table_name> an. Auf diese Weise kann der Databricks-Assistent die Spaltennamen abrufen, ohne raten zu müssen.

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. Verwenden Sie den Chatverlauf des Assistenten, um DataFrames im Assistentenbereich iterativ zu bereinigen, zu durchsuchen, zu filtern und zu segmentieren.

Genaue Angaben machen

Die Struktur und das Detail, das der Databricks-Assistent bereitstellt, variiert von Zeit zu Zeit, auch für die gleiche Eingabeaufforderung. Versuchen Sie, dem Assistenten so viele Anleitungen wie möglich bereitzustellen, um die gewünschten Informationen im gewünschten Format, detailgrad usw. zurückzugeben. Beispiel:

  • "Erklären Sie diesen Code in einigen Sätzen" oder "Erklären Sie diesen Code zeilenweise".
  • "Erstellen Einer Visualisierung mit MatPlotLib" oder "Erstellen einer Visualisierung mit Seaborn".

Stellen Sie Beispiele für Datenwerte auf Zeilenebene bereit.

Da der Databricks-Assistent keine Daten auf Zeilenebene verwendet, müssen Sie möglicherweise weitere Details bereitstellen, um die genaueste Antwort zu erhalten. Verwenden Sie Tabellen- oder Spaltenkommentare im Katalog-Explorer, um eine Zeile mit Beispieldaten hinzuzufügen. Nehmen wir beispielsweise an, Ihre Höhenspalte befindet sich im Format feet-inches. Um dem Assistenten zu helfen, die Daten zu interpretieren, fügen Sie einen Kommentar wie "Die Höhen-Spalte ist im Zeichenfolgenformat und wird durch einen Bindestrich getrennt." hinzu. Beispiel: '6-2'." Informationen zu Tabellen- und Spaltenkommentaren finden Sie unter Hinzufügen von Kommentaren zu Daten und AI-Ressourcen.

Wenn Sie Spaltendatentypkonvertierungen verwenden müssen, um einen Vorgang auszuführen, müssen Sie möglicherweise Details angeben. Beispiel: "Konvertieren Sie diesen Code von Pandas in PySpark, einschließlich des Codes, der erforderlich ist, um die Pandas DataFrame in eine PySpark DataFrame zu konvertieren und den Datentyp der Spalte churn von Boolean zu Integer zu ändern".

Verwenden von UMSCHALT+EINGABETASTE zum Hinzufügen einer neuen Zeile im Chattextfeld

Verwenden Sie UMSCHALT+EINGABETASTE, um im Textfeld "Assistent-Chat" eine neue Zeile hinzuzufügen. Dies erleichtert das Formatieren und Organisieren Ihrer Nachrichten an den Databricks Assistant.

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 zum Ausführen von Code in der oberen linken Ecke des Codefelds im Assistentenbereich auf Symbol für Codeausführung.

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 Notizbuch verwendet werden.

Sie können auch den Code bearbeiten, den der Databricks-Assistent direkt im Assistenten-Chatfeld generiert, bevor Sie den Code in das Notizbuch verschieben.

Zusätzliche Informationen

Die folgenden Artikel enthalten zusätzliche Informationen zur Verwendung des Databricks-Assistenten: