Få kodningshjälp från Databricks Assistant
Den här artikeln beskriver hur du kan använda Databricks Assistant för att hjälpa dig att koda och felsöka dina notebook-filer och ger tips om hur du får ut mesta möjliga av assistenten.
Vad kan Databricks Assistant hjälpa till med?
Databricks Assistant är en kontextmedveten AI-assistent som du kan interagera med med ett konversationsgränssnitt, vilket gör dig mer produktiv i Databricks. Du kan beskriva din uppgift på engelska och låta assistenten generera Python-kod eller SQL-frågor, förklara komplex kod och automatiskt åtgärda fel. Assistenten använder Unity Catalog-metadata för att förstå dina tabeller, kolumner, beskrivningar och populära datatillgångar i företaget för att tillhandahålla anpassade svar.
Databricks Assistant kan hjälpa dig med följande uppgifter:
- Generera kod.
- Felsöka kod, inklusive att identifiera och föreslå korrigeringar för fel.
- Transformera och optimera kod.
- Förklara kod.
- Hjälp dig att hitta relevant information i Azure Databricks-dokumentationen.
Information om hur du aktiverar och använder Databricks Assistant finns i Aktivera och prova Databricks Assistant. Allmän information om Databricks Assistant finns i DatabricksIQ-baserade funktioner.
Assistant-kommandogenvägar för anteckningsböcker
I en notebook är Databricks Assistant tillgängligt i Assistentpanelen eller infogat i en kodcell.
Om du vill använda Databricks Assistant direkt i en kodcell trycker du på Cmd+I på MacOS eller Ctrl+I i Windows. En textruta visas i cellen. Du kan skriva en fråga eller kommentar på engelska och sedan trycka på Enter (inte Shift+Enter, som om du vill köra en cell) för att få Assistenten att generera ett svar.
Använd snedstreckskommandon för prompter
Snedstreckskommandon är en genväg för att skapa vanliga uppmaningar.
| Uppmaningstext | Vad assistenten gör |
|---|---|
/ |
Visar vanliga kommandon |
/doc |
Kommenterar koden i en diff-vy |
/explain |
Ger en förklaring av koden i en cell |
/fix |
Föreslår en korrigering av eventuella kodfel i en diff-vy |
/findTables |
Söker efter relevanta tabeller baserat på Unity Catalog-metadata. Om du vill hitta funktioner eller funktionstabeller nämner du "funktioner" eller "funktionstabeller" i frågan. Se Hitta funktioner och funktionstabeller med hjälp av Databricks Assistant. |
/findQueries |
Söker efter relevanta frågor baserat på Unity Catalog-metadata. |
/optimize |
Förbättrar ineffektiva SQL-frågor. |
/prettify |
Formaterar kod för läsbarhet. |
/rename |
Föreslår uppdaterade namn för notebook-celler och andra element, beroende på kontexten. |
/settings |
Justerar dina notebook-inställningar direkt från Assistent. |
När du använder /fix eller /docväljer du i fönstret diff Acceptera för att acceptera de föreslagna ändringarna eller Avvisa för att behålla den ursprungliga koden. Om du godkänner den föreslagna koden körs inte koden automatiskt. Du kan granska koden innan du kör den. Om den genererade koden inte är vad du vill ha, försök igen genom att lägga till fler detaljer eller mer information i din kommentar. Se tips för användning av Databricks Assistant.
Få detaljerade förklaringar av kodfragment. Använd /explain fråga och inkludera termer som "var koncis" eller "förklara kod rad för rad" för att begära den detaljnivå som du vill ha. Du kan också be Databricks Assistant att lägga till kommentarer i koden.
För automatisk komplettering av kod kan prestanda vara bättre genom att använda fönstret Assistent än i en anteckningsbokscell.
Assistenten stängs automatiskt om du accepterar eller avvisar den kod som genererades.
referenstabeller i prompter med hjälp av @
Om du snabbt vill referera till tabeller i assistentprompter använder du symbolen @ (at).
Få hjälp med kod
Databricks Assistant hjälper till med kod, både SQL och Python:
- AI-baserad automatisk komplettering i Databricks-notebook-filer, SQL-redigeraren och filredigeraren.
- Datafiltrering med frågor på naturligt språk.
- Kodfelsökning med Diagnostisera fel (offentlig förhandsversion).
Noten
Förslag för inbäddad kod är inte tillgängliga i Azure Government-regioner eller arbetsytor med FedRAMP-överensstämmelse.
Hämta förslag på infogad kod: Python- och SQL-exempel
När du skriver visas förslag automatiskt. Tryck på Tab för att acceptera ett förslag. Om du vill utlösa ett förslag manuellt trycker du på Option+Shift+Space (på macOS) eller Control+Shift+Space (i Windows).
AI-baserad automatisk komplettering kan också generera kod från kommentarer:
Filtrera data med frågor om naturligt språk
Använd Databricks Assistant för att filtrera datautdata med frågor om naturligt språk.
Om du vill filtrera utdata med naturligt språk klickar du på filterikonen i utdatatabellen och anger en prompt. Som i det animerade exemplet nedan kan du till exempel fråga "Visa mig bara män över 70 år".
Felsökningskod: Python- och SQL-exempel
Viktig
Den här funktionen finns i offentlig förhandsversion.
Om du vill använda Databricks Assistant för att åtgärda kod gör du något av följande:
- Ställ en fråga i fönstret Assistent.
- Klicka på knappen Diagnostisera fel som visas i cellresultatet när ett fel inträffar.
- Klicka på Felsök för att interaktivt gå igenom koden rad för rad, ange brytpunkter, inspektera variabler och analysera ett programs körning.
Flikarna nedan visar exempel i Python- och SQL-kod:
Python
SQL
När du klickar på Diagnostisera felkörs /fixautomatiskt av assistenten.
snabbkorrigering
När koden returnerar fel rekommenderar Snabbkorrigering automatiskt korrigeringar för grundläggande fel som kan åtgärdas i en enskild radändring.
Klicka på Acceptera och kör för att göra den rekommenderade korrigeringen och fortsätt att köra koden:
tips för att använda Databricks Assistant
Det här avsnittet innehåller några allmänna tips och metodtips när du använder Databricks Assistant.
Databricks Assistant använder kontext för att ge bättre svar
Databricks Assistant har åtkomst till tabell- och kolumnscheman och metadata. På så sätt kan du använda naturligt språk och generera mer exakta frågor. Om en tabell till exempel har en kolumn med namnet Statekan du be Databricks Assistant att generera en lista över användare som bor i Michigan.
Databricks Assistant använder följande kontext:
- Kod eller frågor i den aktuella notebook-cellen eller Databricks SQL-redigerarens tab.
- Tabell- och kolumnnamn och beskrivningar.
- Tidigare promptfrågor.
- Favorit- och aktiva tabeller.
- För diagnostiseringen av fel i funktion, stackspårningen från felutdata.
När du väljer kolumner från en DataFrame kan du få mer exakta resultat genom att ange en startfråga. Ange till exempel ett påstående som SELECT * FROM <table_name>. Detta gör att Databricks Assistant kan hämta kolumnnamnen och inte behöva gissa.
Eftersom Databricks Assistant använder din konversationshistorik för att ge bättre och mer exakta svar kan du be Databricks Assistant att ändra utdata från ett tidigare svar utan att behöva skriva om hela prompten. Använd assistentens chatthistorik för att iterativt rensa, utforska, filtrera och segmentera DataFrames i fönstret Assistent.
Var specifik
Strukturen och informationen som Databricks Assistant tillhandahåller varierar från tid till gång, även för samma fråga. Försök att ge assistenten så mycket vägledning som möjligt för att hjälpa den att returnera den information du vill ha i önskat format, detaljnivå och så vidare. Till exempel:
- "Förklara den här koden i några meningar" eller "Förklara den här koden rad för rad".
- "Skapa en visualisering med hjälp av MatPlotLib" eller "Skapa en visualisering med Seaborn".
Ge exempel på datavärden på radnivå
Eftersom Databricks Assistant inte använder data på radnivå kan du behöva ange mer information för att få det mest exakta svaret. Använd tabell- eller kolumnkommentarer i Katalogutforskaren för att lägga till en rad med exempeldata. Anta till exempel att din höjdkolumn är i formatet feet-inches. Om du vill hjälpa Assistenten att tolka data lägger du till en kommentar som "Höjdkolumnen är i strängformat och avgränsas med ett bindestreck. Exempel: '6-2'." Information om tabell- och kolumnkommentarer finns i Lägg till kommentarer till data och AI-tillgångar.
Om du behöver använda kolumndatatypkonverteringar för att köra en åtgärd kan du behöva ange information. Till exempel: "konvertera den här koden från Pandas till PySpark, inklusive den kod som behövs för att konvertera Pandas DataFrame till en PySpark DataFrame och ändra datatypen för kolumnomsättning från booleskt till heltal".
Använd Skift+Retur för att lägga till en ny rad i chatttextrutan
Använd Skift+ Retur för att lägga till en ny rad i textrutan Assistentchatt. Det gör det enkelt att formatera och organisera dina meddelanden till Databricks Assistant.
Redigera och köra kod i chattfönstret i Databricks Assistant
Kör kod i fönstret Assistent för att verifiera den eller använda den som en scratchpad. Om du vill köra kod klickar du på 
i det övre vänstra hörnet av kodrutan i Assistent-rutan.
Flikarna nedan visar exempel på Python- och SQL-kod:
Python
SQL
När du kör kod i fönstret Assistent visas utdata och variablerna kan användas i notebook-filen.
Du kan också redigera koden som Databricks Assistant genererar direkt i chattrutan Assistent innan du flyttar koden till notebook-filen.
Ytterligare information
Följande artiklar innehåller ytterligare information om hur du använder Databricks Assistant: