Extend genie Code pomocí dovedností agenta

Genie Code se dodává s integrovanými dovednostmi pro běžné pracovní postupy Azure Databricks: psaní kódu v poznámkových blocích, zkoumání dat v katalogu Unity, vytváření řídicích panelů, vytváření kanálů a práce s MLflow. Vytvářejte vlastní dovednosti pro rozšíření Genie Code se specializovanými možnostmi pro úlohy specifické pro doménu vašeho týmu. Tato stránka vysvětluje, jak je vytvořit a optimalizovat.

Co jsou dovednosti?

Vytvářejte dovednosti pro rozšíření Genie Code se specifickými schopnostmi. Dovednosti se řídí otevřeným standardem dovedností agenta. Balíčky dovedností specifické pro doménu a pracovních postupů, které může Genie Code načíst, pokud jsou potřebné pro provádění konkrétních úloh. Dovednosti můžou zahrnovat pokyny, osvědčené postupy, opakovaně použitelný kód a spustitelné skripty.

Dovednosti by měly být přizpůsobené pro úlohy specifické pro doménu. Díky dovednostem můžete pro úkol poskytnout větší kontext (například skripty, příklady a další zdroje), než je možné s pokyny. Na rozdíl od vlastních instrukcí, které se používají globálně, se dovednosti načítají automaticky a pouze v příslušném kontextu. Genie Code automaticky načte dovednosti, pokud jsou relevantní, na základě vašeho požadavku a popisu dovednosti. Dovednosti můžete vyvolat také ručně tak, že @ je zmíníte. To udržuje efektivní kontextové okno a snižuje potřebu poskytovat stejný kontext napříč několika chaty.

Existují dva typy dovedností:

  • Dovednosti v pracovním prostoru: K dispozici všem uživatelům v pracovním prostoru. Správci pracovních prostorů můžou vytvářet dovednosti pracovního prostoru a udělovat ostatním přístup ke složce dovedností, aby mohli přidat další. Využijte dovednosti pracovního prostoru k vynucení standardů pro celou organizaci, zajištění konzistentního výstupu napříč uživateli (například dovednosti zpracování piI, která maskuje citlivé sloupce) nebo obsluhu různých týmů (například šablony kanálů pro datové inženýry a playbooky trénování modelů pro uživatele platformy ML).
  • Uživatelské dovednosti: K dispozici pouze vám. Používejte uživatelské dovednosti pro osobní předvolby, jako jsou upřednostňované knihovny, styl kódování nebo kontext role a pozadí. Uživatelské skilly jsou také užitečné k vytvoření prototypu skillu před jeho povýšením na úroveň pracovního prostoru.

Vytvoření dovednosti

Dovednosti žijí v adresáři .assistant/skills/ . Každá dovednost musí mít svou vlastní složku a SKILL.md soubor v této složce. Umístění závisí na typu dovednosti:

  • Dovednosti v pracovním prostoru: Workspace/.assistant/skills/
  • Uživatelské dovednosti: /Users/{username}/.assistant/skills/

Vytvoření nové dovednosti:

  1. Vytvořte novou složku schopností na příslušné cestě pro váš typ schopností.

    Po vytvoření můžete rychle získat přístup ke složce dovedností na panelu Kód Genie. Klikněte na ikonu nastavení. Nastavení a potom klikněte na ikonu šipky. Otevřít složku Dovednosti.

  2. Ve složce dovedností vytvořte vyhrazenou složku pro vaši dovednost. Každá dovednost musí mít svou vlastní složku. Například:

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

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

  3. Ve složce skill vytvořte soubor SKILL.md. Tento soubor je povinný a definuje dovednost. Dovednosti se řídí specifikacemi dovedností agenta.

  4. Přidejte požadovaný frontmatter pro svoji dovednost:

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

  5. Přidejte pokyny pro dovednosti ve formátu Markdown za frontmatter. Doporučujeme zahrnout následující části:

    • Podrobné pokyny: Jasné postupové pokyny
    • Příklady: Ukázkové vstupy a očekávané výstupy
    • Hraniční případy: Běžné varianty a výjimky

  6. (Volitelné) Pro složitější dovednosti můžete poskytnout a odkazovat na další zdroje informací:

    • Skripty obsahující spustitelný kód, který může agent spustit.
    • Soubory obsahující další dokumentaci k referenci, jako jsou osvědčené postupy a šablony.

    Při odkazování na jiné soubory použijte relativní cesty z kořenové dovednosti.

    Například schopnosti pracovního postupu strojového učení v pracovní oblasti a osobního pracovního postupu mohou mít následující strukturu:

    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 automaticky převezme vaše dovednosti při příštím použití. Můžete také @ zmínit dovednosti, abyste zajistili, že je Genie Code používá.

Když upravujete stávající dovednost, zahajte nové chatovací vlákno, aby se vaše změny projevily. Úpravy se neprojeví v aktivních vláknech. Pokud se dovednost stále jeví jako zastaralá, například se zobrazuje staré chování nebo zastaralý popis, vynuceně obnovte kartu prohlížeče, aby se vymazala metadata dovednosti uložená v mezipaměti.

Osvědčené postupy

Při psaní efektivních dovedností postupujte podle těchto pokynů:

  • Zvolte vhodný typ dovednosti. Využijte dovednosti pracovního prostoru ke kodifikování sdílených standardů (jako je zpracování PII, konvence pojmenování nebo šablony specifické pro tým), aby každý uživatel získal konzistentní výstup. Použijte uživatelské dovednosti pro osobní předvolby a vytvořte prototyp dovednosti před povýšením do pracovního prostoru.
  • Zaměřte se na dovednosti. Dovednosti fungují nejlépe, když se zaměřují na jeden úkol nebo pracovní postup. Úzký rozsah usnadňuje Genie Code rozpoznat, kdy se dovednost uplatní.
  • Používejte jasné názvy a popisy. Stručné, popisné jméno a shrnutí pomáhají Genie Code spojit správnou dovednost se správným požadavkem.
  • Buďte explicitní a zaměřte se na příklady. Popište pracovní postupy krok za krokem a zahrňte konkrétní příklady nebo vzory, které může Genie Code znovu použít.
  • Vyhněte se zbytečnému kontextu. Uveďte pouze informace, které jsou pro úkol požadovány. Další podrobnosti můžou znesnadnit spolehlivé použití dovedností.
  • Iterujte v průběhu času. Zacházejte s dovednostmi jako s živými pracovními postupy. Malé aktualizace založené na skutečném využití můžou výrazně zlepšit výsledky.
  • Vytváření dovedností pomocí Genie Code. Využijte Genie Code k vytváření a upřesňování dovedností. Otestujte nové nebo aktualizované dovednosti na reprezentativních úkolech, zjistěte, s čím má agent potíže, a poté aktualizujte pokyny, abyste tyto nedostatky odstranili.
  • Oddělte pokyny od automatizace. Markdown slouží k vysvětlení záměru a osvědčených postupů a skriptů pro opakovatelné akce. Udržováním těchto aspektů odděleně je snazší udržovat a opakovaně používat dovednosti.
  • Správa verzí– vaše dovednosti. Pomocí složek Git Databricks můžete zálohovat složku dovedností, abyste mohli sledovat změny, spolupracovat s členy týmu a v případě potřeby se vrátit zpět.

Další zdroje informací

  • Last updated on