Dela via

Utöka Genie Code med agentfärdigheter

Genie Code levereras med inbyggda kunskaper som är förkonfigurerade för vanliga Azure Databricks arbetsflöden, till exempel att skriva kod i Azure Databricks notebook-filer, utforska data i Unity Catalog, skapa instrumentpaneler, skapa pipelines och arbeta med MLflow. Du kan också skapa egna kunskaper för att utöka Genie Code 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 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 arbetsflöden som i stort sett är användbara i hela teamet, till exempel arbetsflöden för maskininlärning eller domänspecifika processer.
  • Användarkunskaper: Endast tillgängligt för dig. Använd användarkunskaper för personliga arbetsflöden som inte är relevanta för andra medlemmar på arbetsytan.

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 Genie Code-panelen. 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.

Metodtips

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

  • Välj lämplig kompetenstyp. Använd arbetsytekunskaper för arbetsflöden som gynnar många användare, till exempel delade maskininlärningspipelines eller domänspecifika processer. Använd användarkunskaper för personliga arbetsflöden som inte är relevanta för andra.
  • 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.
  • 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.

Se även

  • Last updated on