Utöka Genie Code med agentfärdigheter

Genie Code levereras med inbyggda kunskaper för vanliga Azure Databricks arbetsflöden: skriva kod i notebook-filer, utforska data i Unity Catalog, skapa instrumentpaneler, skapa pipelines och arbeta med MLflow. Skapa anpassade kunskaper för att utöka Genie Code Agent-läget med särskilda funktioner för teamets domänspecifika uppgifter. På den här sidan beskrivs hur du skapar och optimerar dem.

Vad är färdigheter?

Skapa färdigheter för att utöka Genie Code med specialiserade funktioner. Färdigheter följer den öppna standarden för agentkunskaper. Kompetenspaket för domänspecifika kunskaper och arbetsflöden som Genie Code 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 Genie Code automatiskt in färdigheter när det är relevant, baserat på din begäran och kunskapens beskrivning. Du kan också anropa färdigheter manuellt genom @ att nämna dem. Detta upprätthåller ett effektivt kontextfönster och minskar behovet av att tillhandahålla samma kontext i flera chattar.

Det finns två typer av färdigheter:

  • Arbetsytekunskaper: Tillgänglig för alla på arbetsytan. Arbetsyteadministratörer kan skapa arbetsytekunskaper och ge andra åtkomst till kompetensmappen för att lägga till mer. Använd arbetsytekunskaper för att framtvinga organisationsomfattande standarder, leverera konsekventa utdata mellan användare (till exempel en PII-hanteringsfärdighet som maskerar känsliga kolumner) eller hantera olika team (till exempel pipelinemallar för datatekniker och modellträningsspelböcker för ML-plattformsanvändare).
  • Användarkunskaper: Endast tillgängligt för dig. Använd användarkunskaper för personliga inställningar, till exempel föredragna bibliotek, kodningsformat eller roll- och bakgrundskontext. Användarkunskaper är också användbara för att skapa prototyper för en färdighet innan du befordrar den till arbetsytenivå.

Anmärkning

Kunskaper stöds endast i Genie Code Agent-läge.

Skapa en färdighet

Färdigheter finns i en .assistant/skills/ mapp. Varje färdighet måste ha en egen mapp och en SKILL.md-fil i den mappen. Platsen beror på kunskapstypen:

  • Arbetsytekunskaper: Workspace/.assistant/skills/
  • Användarkunskaper: /Users/{username}/.assistant/skills/

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

  1. Skapa en ny kompetensmapp på rätt sökväg för din kompetenstyp.

    När du har skapat den kan du snabbt komma åt din kompetensmapp i panelen Genie Code. 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. Som exempel:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

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

    En maskininlärningsarbetsflödesfärdighet för arbetsyta och en personlig arbetsflödesfärdighet kan till exempel ha följande struktur:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/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

Genie Code hämtar automatiskt dina kunskaper nästa gång du använder den i agentläge. Du kan också @ nämna färdigheter för att se till att Genie Code använder dem.

När du redigerar en befintlig färdighet startar du en ny chatttråd för att tillämpa ändringarna. Redigeringar får ingen effekt i aktiva trådar. Om en färdighet fortfarande verkar inaktuell, till exempel genom att visa gammalt beteende eller en föråldrad beskrivning, gör en hård uppdatering av webbläsarfliken för att rensa cachelagrade metadata för färdigheten.

Metodtips

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

  • Välj lämplig kompetenstyp. Använd arbetsytekunskaper för att kodifiera delade standarder (till exempel PII-hantering, namngivningskonventioner eller teamspecifika mallar) så att varje användare får konsekventa utdata. Använd användarkunskaper för personliga preferenser och för att skapa en färdighet innan du befordrar den till arbetsytan.
  • 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 Genie Code 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 Genie Code 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 Genie Code 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.
  • Skapa kunskaper med Genie Code. Använd Genie Code för att skriva och förfina färdigheter. Testa nya eller uppdaterade kunskaper om representativa uppgifter för att hitta var agenten kämpar och uppdatera sedan anvisningarna för att stänga dessa luckor.
  • 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.
  • Versionsstyr dina kunskaper. Backa upp din kompetensmapp med Databricks Git-mappar för att spåra ändringar, samarbeta med teammedlemmar och återställa när det behövs.

Ytterligare resurser

  • Last updated on