Databricks Assistant gebruiken

Databricks Assistant is een contextbewuste AI-assistent die u kan helpen met Databricks-notebooks, SQL-editor, taken, AI/BI-dashboards en bestandseditor. Databricks Assistant helpt u bij het gebruik van gegevens en code wanneer u om hulp vraagt met behulp van een gespreksinterface.

Voor een account: Functies van Databricks Assistant uitschakelen of inschakelen

Azure AI-functies van Databricks Assistant zijn standaard ingeschakeld. Accountbeheerders kunnen echter de functies van Azure AI-assistent uitschakelen voor alle werkruimten binnen een account. Accountbeheerders kunnen ook het inschakelen van Databricks Assistant afdwingen voor het hele account:

Tip

De handeling van het in- of uitschakelen van azure AI-functies van Databricks Assistant voor uw account wordt vastgelegd als een accountgebeurtenis in uw auditlogboeken. Zie Accountgebeurtenissen.

1. Meld u als accountbeheerder aan bij de accountconsole.

   Belangrijk

   Als er nog geen gebruikers in uw Microsoft Entra ID-tenant zijn aangemeld bij de accountconsole, moet u of een andere gebruiker in uw tenant zich aanmelden als de eerste accountbeheerder. Hiervoor moet u een globale beheerder van Microsoft Entra ID zijn, maar alleen wanneer u zich voor het eerst aanmeldt bij de Azure Databricks-accountconsole. Bij de eerste aanmelding wordt u een Azure Databricks-accountbeheerder en hebt u de rol globale beheerder van Microsoft Entra ID niet meer nodig om toegang te krijgen tot het Azure Databricks-account. Als eerste accountbeheerder kunt u gebruikers in de Microsoft Entra ID-tenant toewijzen als extra accountbeheerders (die meer accountbeheerders kunnen toewijzen). Voor extra accountbeheerders zijn geen specifieke rollen in Microsoft Entra ID vereist. Zie Gebruikers, service-principals en groepen beheren.

2. Klik op instellingen.

3. Klik op het tabblad Functie-inschakeling .

4. Voor de optie Azure AI-functies inschakelen, selectUit of Aan.

5. Onderdrukkingen van werkruimten voorkomen met de instelling Afdwingen :

Voor meer informatie over de services die worden gebruikt voor functies van Databricks Assistant die door Azure AI worden gebruikt, raadpleegt u Functies die worden beheerd door de door de partner aangedreven AI-ondersteunende functies.

Voor een werkruimte: Assistentfuncties uitschakelen of inschakelen

Als uw accountbeheerder Assistent inschakelt, wordt deze standaard ingeschakeld in werkruimten. Tenzij de accountbeheerder ervoor heeft gekozen om de instelling af te dwingen, kunnen werkruimtebeheerders deze uitschakelen voor hun werkruimten.

Databricks Assistant uitschakelen in een werkruimte:

1. Klik op uw gebruikersnaam in de bovenste balk van de Databricks-werkruimte-instellingen>.
2. Klik in het linkerdeelvenster onder Werkruimtebeheerder op het tabblad Geavanceerd .
3. Als u Assistent wilt uitschakelen, klikt u op de wisselknop Uitgeschakeld voor door Azure AI gemaakte AI-ondersteunende functies.

Databricks Assistant volledig uitschakelen of inschakelen

Databricks Assistant volledig uitschakelen:

1. Beheerders: volg de instructies om de functies van Databricks Assistant voor een accountuit te schakelen of in te schakelen.
2. Werkruimtebeheerders: volg de instructies voor het uitschakelen of inschakelen van assistentfuncties voor een werkruimte.

Als u alleen de Azure AI-aangedreven AI-assistente functies inschakelen optie uitschakelt, blijven door Databricks gehoste modellen de volgende functionaliteiten aansturen:

• Automatisch aanvullen
  • Unity Catalog-gegevensopmerkingen
  • Suggesties voor quickfixes

Rondleiding door het deelvenster Assistent

In deze sectie wordt de standaardervaring van het deelvenster Assistent beschreven.

Als u het deelvenster Assistent wilt openen, klikt u in de linkerzijbalk.

Typ vragen in het tekstvak onder aan het deelvenster Assistent en druk op Enter of klik rechts van het tekstvak. De assistent geeft het antwoord weer. In de volgende schermopname ziet u acties die u kunt uitvoeren nadat De assistent code heeft gegenereerd in het deelvenster Assistent.

U kunt dezelfde query opnieuw uitvoeren om een ander antwoord te verkrijgen met generate. Als u dit wilt doen, beweegt u de cursor over het antwoord en klikt u op .

Als u het deelvenster wilt sluiten, klikt u nogmaals op het pictogram of klikt u in de rechterbovenhoek van de cel. U kunt het deelvenster uitbreiden naar volledige breedte door te klikken; klik om het deelvenster terug te keren naar de standaardbreedte.

Het deelvenster Assistent houdt uw gesprekken bij, zelfs als u het deelvenster of notitieblok sluit. Als u eerdere gesprekken wilt wissen, klikt u rechtsboven in het deelvenster Assistent.

Threads en promptgeschiedenis

Gespreksthreads blijven behouden in de verschillende contexten where Databricks Assistant beschikbaar is. In het deelvenster Assistent kunt u nieuwe gespreksthreads maken, de vraag- en promptgeschiedenis bekijken en uw Databricks Assistant-ervaring beheren.

Databricks Assistant krijgt de titels van de threads op basis van de context van uw prompts, zodat u door de geschiedenis van uw assistentgesprek kunt navigeren. Het volgende voorbeeld is afkomstig van een vraag over een notitieblok.

Databricks Assistant gebruiken in een notebookcel

In een notebook is Databricks Assistant beschikbaar in het deelvenster Assistent of inline in een codecel.

Als u Databricks Assistant rechtstreeks in een codecel wilt gebruiken, drukt u op Cmd + i in MacOS of Ctrl + i in Windows. Er wordt een tekstvak weergegeven in de cel. U kunt een vraag of opmerking in het Engels typen en vervolgens op Enter- drukken (niet Shift+Enter-, zoals wanneer u een cel wilt uitvoeren) zodat de Assistent generate een antwoord kan geven.

Slash-opdrachten gebruiken voor prompts

Slash-opdrachten zijn een snelkoppeling voor het maken van algemene prompts.

Prompttekst	Wat Assistent doet
/	Algemene opdrachten weergeven
/doc	Opmerkingen over de code in een diff-weergave
/explain	Geeft een uitleg van de code in een cel
/fix	Stelt een oplossing voor eventuele codefouten in een diff-weergave
/findTables	Zoekt naar relevante tables op basis van Unity Catalog metagegevens. Om functies of functie tableste vinden, vermeld 'functies' of 'functie tables' in de query. Zie Vind functies en functie tables met Databricks Assistant.
/findQueries	Zoekt naar relevante query's op basis van Unity Catalog metagegevens.
/optimize	Verbetert inefficiënte SQL-query's.
/prettify	Hiermee wordt code opgemaakt voor leesbaarheid.
/rename	Stelt bijgewerkte namen voor notitieblokcellen en andere elementen voor, afhankelijk van de context.
/settings	Hiermee worden de instellingen van uw notitieblok rechtstreeks vanuit Assistent aangepast.

Wanneer u /fix of /docgebruikt, kunt u in het diff windowselectAccepteer om de voorgestelde wijzigingen te accepteren of Weiger om de oorspronkelijke code te behouden. Als u de voorgestelde code accepteert, wordt de code niet automatisch uitgevoerd. U kunt de code controleren voordat u deze uitvoert. Als de gegenereerde code niet is wat u wilt, probeert u het opnieuw door meer details of informatie toe te voegen aan uw opmerking. Zie Tips voor het gebruik van Databricks Assistant.

Get gedetailleerde uitleg van codefragmenten. Gebruik de /explain prompt en neem termen op zoals 'beknopt' of 'explain code line-by-line' om het gewenste detailniveau aan te vragen. U kunt Databricks Assistant ook vragen opmerkingen aan de code toe te voegen.

Voor automatisch aanvullen van code zijn de prestaties mogelijk beter met behulp van het deelvenster Assistent dan in een notebookcel.

De assistent wordt automatisch gesloten als u de gegenereerde code accepteert of weigert .

Verwijzing naar tables in prompts met behulp van @

Gebruik het symbool @ (at) om snel naar tables te verwijzen in assistentprompts.

hulp Get bij programmeercode

Databricks Assistant helpt bij code, zowel SQL als Python:

• Automatisch aanvullen op basis van AI in Databricks-notebooks, de SQL-editor en de bestandseditor.
• Gegevens filteren met prompts in natuurlijke taal.
• Codefoutopsporing met diagnosefout (openbare preview).

Notitie

Inline-codesuggesties zijn niet beschikbaar in Azure Government-regio's of werkruimten met FedRAMP-naleving.

Gegevens filteren met prompts voor natuurlijke taal

Gebruik Databricks Assistant om gegevensuitvoer te filteren met prompts in natuurlijke taal.

Als u uitvoer met natuurlijke taal wilt filteren, klikt u op het filterpictogram in de uitvoer table en voert u een prompt in. Zoals in het voorbeeld met animatie hieronder, kunt u bijvoorbeeld vragen 'Alleen mannen meer dan 70 weergeven'.

Get suggesties voor inlinecode: Python- en SQL-voorbeelden

Terwijl u typt, worden suggesties automatisch weergegeven. Druk op Tab om een suggestie te accepteren. Als u handmatig een suggestie wilt activeren, drukt u op Option + Shift + Spatie (in macOS) of Control + Shift + Spatie (in Windows).

AI-gebaseerd automatisch aanvullen kan ook code uit opmerkingen generate genereren.

Fouten opsporen in code: Python- en SQL-voorbeelden

Belangrijk

Deze functie is beschikbaar als openbare preview.

Ga op een van de volgende manieren te werk om Databricks Assistant te gebruiken om code op te lossen:

• Stel een vraag in het deelvenster Assistent.
• Klik op de knop Fout diagnosticeren die wordt weergegeven in de celresultaten wanneer er een fout optreedt.
• Klik op Foutopsporing om interactief regel voor regel de code door te nemen, set onderbrekingspunten te plaatsen, variabelen te inspecteren en de uitvoering van een programma te analyseren.

In de onderstaande tabbladen ziet u voorbeelden in Python en SQL-code:

Python

SQL

Wanneer u op Diagnosefout klikt, wordt Assistent automatisch uitgevoerd/fix.

Snelle oplossing

Wanneer code fouten retourneert, raadt Quick Fix automatisch oplossingen aan voor basisfouten die kunnen worden opgelost in één regelwijziging.

Klik op Accepteren en uitvoeren om de aanbevolen oplossing te maken en door te gaan met het uitvoeren van uw code:

Fouten in taken diagnosticeren (openbare preview)

Belangrijk

Deze functie is beschikbaar als openbare preview.

Databricks Assistant helpt bij het diagnosticeren van fouten in taken.

Een taak diagnosticeren met Assistent:

1. Open de mislukte taak vanuit de gebruikersinterface voor taken.
2. Select Foutdiagnosticeren.

Get antwoorden uit Azure Databricks-documentatie

In de notebook-editor kan Databricks Assistant vragen beantwoorden op basis van databricks-documentatie. Typ uw vraag of prompt in het promptvak.

Tips voor het gebruik van Databricks Assistant

Deze sectie bevat enkele algemene tips en aanbevolen procedures bij het gebruik van Databricks Assistant.

Databricks Assistant gebruikt context om betere antwoorden te geven

Databricks Assistant heeft toegang tot table en column schema's en metagegevens. Hierdoor kunt u natuurlijke taal en generate nauwkeurigere query's gebruiken. Als een table bijvoorbeeld een column heeft met de naam State, kunt u de Databricks Assistant vragen om een lijst (list) van gebruikers die in Michigan wonen te genereren (generate).

Databricks Assistant gebruikt de volgende context:

• Code of query's in de huidige notebookcel of het tabblad Sql-editor van Databricks.
• Table en Column namen en beschrijvingen.
• Vorige promptvragen.
• Favoriete en actieve tables.
• Voor de diagnosefoutfunctie , de stacktracering uit de foutuitvoer.

Wanneer u columns selecteert in een DataFrame, kunt u nauwkeurigere resultaten get door een beginquery op te geven. Geef bijvoorbeeld een instructie op zoals SELECT * FROM <table_name>. Hierdoor kan Databricks Assistant de namen getcolumn en hoeft u niet te raden.

Omdat Databricks Assistant uw gespreksgeschiedenis gebruikt om betere en nauwkeurigere antwoorden te geven, kunt u Databricks Assistant vragen om de uitvoer van een vorig antwoord te wijzigen zonder having om de hele prompt opnieuw te schrijven. Gebruik de chatgeschiedenis van assistent om dataframes iteratief op te schonen, te verkennen, te filteren en te segmenteren in het deelvenster Assistent.

Wees specifiek

De structuur en details die Databricks Assistant biedt, varieert van tijd tot tijd, zelfs voor dezelfde prompt. Probeer assistent zo veel mogelijk richtlijnen te bieden om te helpen de gewenste informatie in de gewenste indeling, detailniveau, enzovoort te retourneren. Voorbeeld:

• "Explain deze code in een paar zinnen" of "Explain deze code regel-voor-regel".
• Een visualisatie maken met MatPlotLib of Een visualisatie maken met Behulp van Seaborn.

Voorbeelden geven van gegevens op rijniveau values

Omdat Databricks Assistant geen gegevens op rijniveau gebruikt, moet u mogelijk meer details opgeven om te vragen om het meest nauwkeurige antwoord te get. Gebruik table of column opmerkingen in Catalog Explorer om een regel met voorbeeldgegevens toe te voegen. Stel dat uw hoogte column de notatie feet-inchesheeft. Om de assistent te helpen de gegevens te interpreteren, voegt u een opmerking toe, zoals 'De hoogte column is in tekenreeksindeling en is gescheiden met een afbreekstreepje. Voorbeeld: '6-2'. Zie Opmerkingen toevoegen aan gegevens en AI-assetsvoor meer informatie over table en column opmerkingen.

Als u column gegevenstypeconversies moet gebruiken om een bewerking uit te voeren, moet u mogelijk details opgeven. Bijvoorbeeld: 'converteer deze code van pandas naar PySpark, inclusief de code die nodig is om het Pandas DataFrame te converteren naar een PySpark DataFrame en het gegevenstype van column verloop van booleaanse waarde te wijzigen in geheel getal'.

Shift+Enter gebruiken om een nieuwe regel toe te voegen in het chattekstvak

Gebruik Shift+Enter om een nieuwe regel toe te voegen in het chatvak Assistent. Hierdoor kunt u uw berichten eenvoudig opmaken en ordenen in Databricks Assistant.

Code bewerken en uitvoeren in het chatvenster van Databricks Assistant

Voer code uit in het deelvenster Assistent om deze te valideren of als kladblok te gebruiken. Als u code wilt uitvoeren, klikt u in de linkerbovenhoek van het codevak in het deelvenster Assistent.

In de onderstaande tabbladen ziet u voorbeelden voor Python- en SQL-code:

Python

SQL

Wanneer u code uitvoert in het deelvenster Assistent, wordt de uitvoer weergegeven en worden de variabelen bruikbaar in het notebook.

U kunt ook de code bewerken die Databricks Assistant rechtstreeks in het chatvak Assistent genereert voordat u de code naar het notebook verplaatst.

Aanvullende informatie

De volgende artikelen bevatten aanvullende informatie over het gebruik van Databricks Assistant:

• Wat is Databricks Assistant?
• Vertrouwen en veiligheid van DatabricksIQ
• Impact van Databricks Assistant meten