Dela via

Utöka assistenten med agentkunskaper

Skapa färdigheter för att utöka Databricks Assistant i agentläge med särskilda funktioner för dina domänspecifika uppgifter. Den här sidan beskriver hur du skapar och optimerar färdigheter.

Vad är färdigheter?

Skapa färdigheter för att utöka assistenten med särskilda funktioner. Färdigheter följer den öppna standarden för agentkunskaper. Kompetenspaket för domänspecifika kunskaper och arbetsflöden som assistenten kan läsa in när det är relevant för att utföra specifika uppgifter. Kunskaper kan vara vägledning, metodtips, återanvändbar kod och körbara skript.

Färdigheter bör skräddarsys för domänspecifika uppgifter. Med kunskaper kan du ge större kontext (till exempel skript, exempel och andra resurser) för en uppgift än vad du kan med instruktioner. Till skillnad från anpassade instruktioner, som tillämpas globalt, läses färdigheter in automatiskt och endast i relevant kontext. I agentläge läser assistenten in färdigheter automatiskt när det är relevant, baserat på din begäran och färdighetens beskrivning. Detta upprätthåller ett effektivt kontextfönster och minskar behovet av att tillhandahålla samma kontext i flera chattar.

Anmärkning

Kunskaper stöds endast i Databricks Assistant-agentläge.

Skapa en färdighet

Färdigheter finns i katalogen /Users/{username}/.assistant/skills/ . Varje färdighet måste ha en egen mapp och en SKILL.md-fil i den mappen.

Så här skapar du en ny färdighet:

  1. Skapa en ny kompetensmapp i mappen för användararbetsytan. Mappsökvägen ska vara: /Users/{username}/.assistant/skills/.

    När du har skapat den kan du snabbt komma åt den här mappen i panelen Assistent. Klicka på kugghjulsikonen. Inställningar och klicka sedan på Pil i ikon. Öppna kompetensmappen.

  2. Skapa en dedikerad mapp för dina kunskaper i kompetensmappen. Varje färdighet måste ha en egen mapp. Om du till exempel skapar en färdighet för personliga arbetsflöden kan mappstrukturen vara:

    /Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. Skapa en SKILL.md fil i din kunskapsmapp. Den här filen krävs och definierar färdigheten. Färdigheter följer specifikationerna för agentkunskaper.

  4. Lägg till den nödvändiga metadata för din färdighet:

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Lägg till kunskapsinstruktionerna i Markdown-format efter frontmattern. Vi rekommenderar att du tar med följande avsnitt:

    • Stegvisa instruktioner: Tydlig procedurvägledning
    • Exempel: Exempelindata och förväntade utdata
    • Kantfall: Vanliga variationer och undantag

  6. (Valfritt) För mer komplexa kunskaper kan du tillhandahålla och referera till ytterligare resurser:

    • Skript som innehåller körbar kod som agenten kan köra.
    • Filer som innehåller ytterligare dokumentation att referera till, till exempel metodtips och mallar.

    När du refererar till andra filer, använd relativa sökvägar från rotmappen.

    Du kan till exempel ha en personlig arbetsflödesfärdighet som refererar till ETL-metodtips, instrumentpanelsmallar och skript för pipelinekonfiguration och distribution. Kompetensmappen kan innehålla följande filer:

    /Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         ├── pipeline-setup.sh   # Environment setup scripts
         └── model-deploy.py     # Model deployment automation

Databricks Assistant hämtar automatiskt dina kunskaper nästa gång du använder den i agentläge.

Metodtips

Följ dessa riktlinjer för att skriva effektiva färdigheter:

  • Håll färdigheterna fokuserade. Färdigheter fungerar bäst när de fokuserar på en enda uppgift eller ett arbetsflöde. Med ett begränsat omfång blir det enklare för assistenten att känna igen när en färdighet gäller.
  • Använd tydliga namn och beskrivningar. Ett kortfattat, beskrivande namn och en sammanfattning hjälper assistenten att matcha rätt kompetens till rätt begäran.
  • Var explicit och exempeldriven. Beskriv arbetsflöden steg för steg och ta med konkreta exempel eller mönster som assistenten kan återanvända.
  • Undvik onödig kontext. Inkludera endast information som krävs för uppgiften. Extra information kan göra det svårare att tillämpa färdigheterna på ett tillförlitligt sätt.
  • Iterera med tiden. Hantera färdigheter som levande arbetsflöden. Små uppdateringar baserade på verklig användning kan avsevärt förbättra resultaten.
  • Separera vägledning från automatisering. Använd markdown för att förklara avsikt och metodtips och skript för repeterbara åtgärder. Genom att hålla dessa problem åtskilda blir det lättare att underhålla och återanvända färdigheter.
  • Last updated on