Antwoorden van Databricks Assistant aanpassen en verbeteren

Deze pagina bevat tips en aanbevolen procedures om Databricks Assistant te helpen betere antwoorden te bieden.

Antwoorden van assistent aanpassen door instructies toe te voegen

U kunt aanpassen hoe Databricks Assistant reageert door aangepaste instructies toe te voegen. De assistent houdt rekening met deze instructies wanneer er nieuwe antwoorden worden gegenereerd.

Instructies kunnen bijvoorbeeld het volgende omvatten:

• Informatie over uw voorkeuren, zoals welke bibliotheken u wilt gebruiken bij het schrijven van code.
• Context over wie u bent, zoals uw naam en rol.
• Codeconventies die moeten worden gevolgd.
• Richtlijnen die moeten worden gevolgd.
• Aanwijzingen over hoe de assistent moet reageren, zoals het gebruik van een informele toon.

Met uitzondering van Snelle oplossing en Automatisch aanvullen past Databricks Assistant instructies toe op elk antwoord dat wordt gegenereerd, waaronder Inline-assistent, Algemene chat, Oplossing voorstellen en Bewerkingsmodus.

Databricks Assistant ondersteunt twee typen instructies: gebruikersinstructies en werkruimte-instructies. Tenzij anders wordt aangegeven, geeft de assistent over het algemeen prioriteit aan werkruimte-instructies boven gebruikersinstructies.

Gebruikersinstructies toevoegen

Met gebruikersinstructies kunt u instructies op systeemniveau aan de Assistent geven. Ze zijn een permanente manier om context, voorkeuren of voorkeurscreatiemethoden te delen. Deze instructies zijn specifiek voor u en worden alleen toegepast op uw interacties met de Assistent.

Gebruikersinstructies toevoegen:

1. Open het deelvenster Assistent door op te klikken. Klik in de rechterbovenhoek van uw werkruimte.

2. Klik in het deelvenster Assistent op U opent de instellingen van de assistent.

   

3. Klik onder Gebruikersinstructies op Het bestand Instructies toevoegen. Hiermee maakt u een .assistant_instructions.md bestand in de standaardmap van de gebruikerswerkruimte (/Gebruikers/<uw-gebruikersnaam-of-e-mailadres>) en wordt het geopend op een nieuw tabblad bestand.

   Als u al een instructiesbestand hebt gemaakt, klikt u op Het bestand Met instructies openen om het bestand te openen.

4. Bewerk het .assistant_instructions.md bestand om uw aangepaste instructies toe te voegen. Databricks raadt u aan uw instructies toe te voegen in tekst zonder opmaak, waarbij elke instructie wordt gescheiden als een nieuw opsommingsteken of nieuwe alinea. Zie aanbevolen procedures voor instructies voor assistenten.

De assistent haalt automatisch de instructies op wanneer u de volgende keer met de assistent werkt.

U kunt de Assistent ook gebruiken om instructies voor u toe te voegen. Gebruik /addInstructions de opdracht in het deelvenster Assistent of een invoervak voor inlineassistent.

Werkruimte-instructies toevoegen en weergeven

Werkruimte-instructies worden geconfigureerd door uw werkruimtebeheerder en bieden meer context aan de Assistent om deze te helpen richtlijnen te volgen en efficiënter te werken in uw werkruimte.

Als uw werkruimte nog geen werkruimte-instructies heeft, kan een werkruimtebeheerder het instructiesbestand maken door de volgende stappen uit te voeren:

1. Maak in de Workspace/ map van de werkruimte een nieuw bestand met de naam .assistant_workspace_instructions.md.
2. Bewerk het bestand om instructies toe te voegen voor de Assistent die werkruimtebreed moet toepassen. Databricks raadt u aan uw instructies toe te voegen in tekst zonder opmaak, waarbij elke instructie wordt gescheiden als een nieuw opsommingsteken of nieuwe alinea. Zie aanbevolen procedures voor instructies voor assistenten.

De assistent haalt automatisch de nieuwe werkruimte-instructies op wanneer een gebruiker er de volgende keer mee werkt.

Werkruimte-instructies weergeven of bewerken:

1. Open het deelvenster Assistent door op te klikken. Klik in de rechterbovenhoek van uw werkruimte.

2. Klik in het deelvenster Assistent op U opent de instellingen van de assistent.

3. Klik onder Werkruimte-instructies op Bestand weergeven. Hiermee opent u het .assistant_workspace_instructions.md bestand op een nieuw tabblad.

4. Als u een werkruimtebeheerder bent, kunt u het bestand bewerken en instructies toevoegen die van toepassing zijn op het gedrag van de assistent in de hele werkruimte. Zie Aanbevolen procedures voor instructies voor assistent voor meer informatie over het toevoegen van instructies.

   Als u geen beheerder bent, kunt u het bestand nog steeds bekijken om te begrijpen welke instructies de assistent volgt naast de gebruikersinstructies die u mogelijk hebt opgegeven.

   

Aanbevolen procedures voor instructies voor assistenten

Het is belangrijk om rekening te houden met de mogelijke beperkingen van de assistent bij het verstrekken van instructies. Hier volgen enkele algemene richtlijnen en tips voor het schrijven van instructies om uw ervaring te optimaliseren en optimaal gebruik te maken van deze functie.

• Schrijf duidelijke, specifieke instructies: Wees expliciet en ondubbelzinnig bij het schrijven van uw instructies.
• Houd de instructies onder de 4000 tekens: Instructiebestanden zijn beperkt tot 4000 tekens. Alle instructies die deze limiet overschrijden, worden niet gebruikt door de Assistent. Wees beknopt en geef prioriteit aan belangrijke instructies.
• Koppen en scheidingstekens gebruiken voor structuur: Instructies bevinden zich in Markdown-bestanden. Gebruik Markdown-opmaak in uw instructies om structuur te bieden. Gebruik opsommingstekens als scheidingstekens om afzonderlijke instructies te scheiden. Gebruik koppen om een set instructies te groeperen. U hebt bijvoorbeeld een kop voor 'Python-codeconventies' met een lijst met opsommingstekens met specifieke Python-richtlijnen die de Assistent moet volgen bij het werken met Python-code.
• Draagwijdte: De assistent past instructies toe op elk antwoord dat wordt gegenereerd wanneer u ermee communiceert met behulp van inlineassistent, algemene chat, suggestieoplossing, bewerkingsmodus, enzovoort. De assistent houdt echter geen rekening met instructies voor Snelle oplossing en Automatisch aanvullen. Houd instructies breed relevant voor verschillende assistentfuncties om onbedoeld gedrag te voorkomen.
• Geef context en verwijzingen op: Hoewel de assistent gebruikmaakt van omringende context zoals notebookcode en tabelmetagegevens, worden er nog geen aanvullende gegevens opgehaald op basis van de instructies. Als u nuttige antwoorden wilt garanderen, moet u belangrijke gegevens rechtstreeks in de instructies opnemen, zoals wanneer u een bepaalde tabel of functie wilt gebruiken.

Tips voor het verbeteren van antwoorden van assistenten

Door instructies te geven, kan de Assistent antwoorden genereren die zijn aangepast aan uw voorkeuren. Daarnaast zijn er andere algemene dingen die u kunt doen wanneer u met de assistent werkt om betere antwoorden te retourneren.

Databricks Assistant houdt rekening met de geschiedenis van het gesprek, zodat u uw vragen kunt verfijnen terwijl u gaat.

Wees specifiek

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

• Geef het detailniveau op dat u zoekt. Bijvoorbeeld 'Leg deze code in een paar zinnen uit' of 'Leg deze code regel voor regel uit'.
• Geef op welke bibliotheek u de assistent wilt gebruiken. Bijvoorbeeld 'Een visualisatie maken met Matplotlib' of 'Een visualisatie maken met Behulp van Seaborn'.
• Geef de structuur op van het gewenste antwoord. Bijvoorbeeld 'Geef instructies op in genummerde stappen' of 'Geef instructies met de stappen als opsommingstekens met korte uitleg'.
• Wees specifiek in uw prompts. Databricks Assistant weet wat uw tabel- en kolomschema en metagegevens zijn, zodat u natuurlijke taal kunt gebruiken om uw vraag te stellen. Bijvoorbeeld: 'Lijst met actieve en buiten gebruik gestelde NFL-quarterbacks' doorgeven voltooiingspercentage, voor degenen die meer dan 500 pogingen in een seizoen hadden. Databricks Assistant antwoorden met behulp van gegevens uit kolommen zoals s.player_id en s.attempts.

Databricks Assistant gebruikt context om betere antwoorden te geven

Databricks Assistant heeft toegang tot tabel- en kolomschema's en metagegevens. Hierdoor kunt u natuurlijke taal gebruiken en nauwkeurigere query's genereren. Als een tabel bijvoorbeeld een kolom heeft met de naam State, kunt u Databricks Assistant vragen een lijst te genereren met gebruikers die in Michigan wonen.

Databricks Assistant gebruikt de volgende context:

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

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 de hele prompt opnieuw te hoeven schrijven. Gebruik de chatgeschiedenis van assistent om dataframes iteratief op te schonen, te verkennen, te filteren en te segmenteren in het deelvenster Assistent.

Help de assistent met gegevenssets te werken

De assistent heeft toegang tot de context van de tabellen waarmee u werkt. Hier volgen enkele dingen die u kunt doen om het beter te laten reageren bij het werken met gegevenssets:

• Wanneer u naar een tabel zoekt, gebruikt u de prompt 'Tabellen zoeken' of de opdracht /findTables voor betere antwoorden. Bijvoorbeeld 'Tabellen zoeken die betrekking hebben op NFL-games'.

• Gebruik @<table-name> dit om te verwijzen naar een specifieke tabel in een prompt. De assistent past de antwoorden aan om die tabel te gebruiken.

• Wanneer u kolommen in een DataFrame selecteert, kunt u nauwkeurigere resultaten krijgen door een beginquery op te geven. Geef bijvoorbeeld een instructie op zoals SELECT * FROM <table_name>. Hierdoor kan Databricks Assistant de kolomnamen ophalen en hoeft u niet te raden.

• Als u conversies van kolomgegevenstypen 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 kolomverloop te wijzigen van booleaans naar geheel getal'.

• Documenttabellen en -kolommen in Unity Catalog. Zie Door AI gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten. Hierdoor krijgt de Assistent meer context over de gegevens. Gebruik tabel- of kolomopmerkingen in Catalog Explorer om een regel met voorbeeldgegevens toe te voegen. Stel dat de hoogtekolom de notatie heeft feet-inches. Voeg een opmerking toe, zoals 'De kolom hoogte heeft een tekenreeksindeling en wordt gescheiden door een afbreekstreepje' om de gegevens te interpreteren. Voorbeeld: '6-2'. Zie Opmerkingen toevoegen aan gegevens en AI-assets voor informatie over tabel- en kolomopmerkingen.

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

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

Hiermee Shift + Enter voegt u een nieuwe regel toe aan het tekstvak Assistentchat. Hierdoor kunt u uw berichten eenvoudig opmaken en ordenen in Databricks Assistant.

Celacties gebruiken in een notitieblok

Celacties omvatten snelkoppelingen naar algemene taken, zoals documenteren (opmerkingen), corrigeren en uitleggen van code.

Aanvullende bronnen

Zie voor meer tips:

• Tips en trucs voor Databricks Assistant voor gegevensanalisten
• Tips en trucs voor Databricks Assistant voor data engineers