Extend genie Code pomocí dovedností agenta

Vytvářejte dovednosti pro rozšíření Genie Code v režimu agenta se specializovanými možnostmi pro úlohy specifické pro vaši doménu. Tato stránka vysvětluje, jak vytvářet a optimalizovat dovednosti.

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. V režimu agenta Genie Code automaticky načte dovednosti, pokud jsou relevantní, na základě vaší žádosti 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.

Poznámka:

Dovednosti jsou podporovány pouze v režimu agenta kódu Genie.

Vytvoření dovednosti

Dovednosti žijí v adresáři /Users/{username}/.assistant/skills/ . Každá dovednost musí mít svou vlastní složku a SKILL.md soubor v této složce.

Vytvoření nové dovednosti:

1. Ve složce pracovního prostoru uživatele vytvořte novou složku dovedností. Cesta ke složce by měla být: /Users/{username}/.assistant/skills/.

   Po vytvoření můžete rychle získat přístup k této složce na panelu Kódu Genie. Klikněte na Nastavení a potom klikněte na 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. Pokud například vytváříte dovednosti pro osobní pracovní postupy, může struktura složek vypadat takto:

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

   Můžete mít například osobní dovednost pracovního postupu, která odkazuje na osvědčené postupy ETL, šablony řídicích panelů a skripty pro nastavení a nasazení pipeline. Složka vaší dovednosti může obsahovat následující soubory:

   /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
   

Genie Code automaticky převezme vaše dovednosti při příštím použití v režimu agenta. Můžete také @ zmínit dovednosti, abyste zajistili, že je Genie Code používá.

Osvědčené postupy

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

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

Viz také

• Jak zdokonalit odpovědi Genie Code: Naučte se, jak manuálně odkazovat na schopnosti v chatovém promptu.