Kurz: Vytvoření dovednosti v agentovi Azure SRE

V tomto kurzu vytvoříte vlastní dovednost, která přidává doménové znalosti a úkolové playbooky vašemu agentovi. Dovednosti jsou modulární schopnosti, které váš agent načte automaticky, když je to relevantní, například řešení potíží s konkrétní službou nebo spuštění diagnostického postupu.

V tomto návodu se naučíte, jak:

  • Vytvořit dovednost v nástroji pro tvorbu podagentů
  • Psaní pokynů k dovednostem do SKILL.md
  • Přidání podpůrných souborů a nástrojů
  • Otestování dovednosti v chatu nebo na hřišti
  • Úprava existující dovednosti

Odhadovaný čas: 10 minut

Návod

Dovednosti a znalostní dokumenty spolupracují. Dovednost naučí vašeho agenta, jak něco udělat (postupy, playbooky, podrobné pokyny). Dokument znalostí vás naučí, co potřebuje vědět agent (referenční data, dokumentace k architektuře, runbooky). Referenční dokumenty můžete také připojit přímo ke dovednostem jako podpůrné soubory. Proces nahrávání znalostí naleznete v části Nahrání dokumentů znalostí.

Předpoklady

Než začnete, ujistěte se, že máte následující požadavky:

  • Agent vytvořený na portálu agenta Azure SRE.
  • Jasné porozumění postupu nebo znalosti domény, které chcete zakódovat.

Otevřete tvůrce podagentů, kde můžete vytvářet a spravovat dovednosti.

  1. Otevřete portál agenta SRE.
  2. Vyberte agenta.
  3. V levém navigačním panelu vyberte Tvůrce .
  4. Vyberte Tvůrce subagenta.

Zahájení vytváření dovedností

Spusťte proces vytváření dovedností z panelu nástrojů.

  1. Na panelu nástrojů vyberte rozevírací seznam Vytvořit .
  2. Vyberte dovednost.

Otevře se dialogové okno pro vytvoření dovednosti s rozložením se dvěma sloupci. Pole formuláře na jedné straně a editor kódu na druhé zobrazující SKILL.md.

Zadejte název a popis.

Zadejte název a popis, který agentu pomůže rozhodnout, kdy tuto dovednost použít.

Pole Příklad hodnoty
název high-cpu-troubleshooting
Description Postup řešení potíží s vysokými upozorněními procesoru na kontejnerové aplikace Kontroluje nadřazené závislosti, fond připojení a nedávná nasazení.

Název musí být jedinečný v rámci vašich dovedností. Popis se zobrazí v seznamu dovedností a pomůže agentu rozhodnout, kdy tuto dovednost použít.

Návod

Pokud chcete přepnout do režimu úprav, vyberte Upravit vedle textu popisu. Po dokončení vyberte Uložit.

Napsat pokyny ke dovednostem

V středovém editoru se zobrazuje SKILL.md, který obsahuje pokyny dovednosti. Soubor začíná výchozí šablonou.

---
name:
description:
---

<!-- Add your skill instructions here -->

YAML úvodní část (name, description, tools) zůstává synchronizovaná s poli formuláře na levé straně. Napište své pokyny v Markdownu pod úvodní částí.

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Přidání podpůrných souborů

V části Soubory na jedné straně se zobrazuje prohlížeč souborů. Kromě výchozího nastavení SKILL.mdmůžete přidat referenční data, šablony a ukázkové dotazy.

  • Pokud chcete přidat soubory, vyberte ikonu nového souboru .
  • Výběrem ikony nové složky uspořádejte soubory do adresářů.
  • Přetáhněte složku do zóny přetažení nebo vyberte odkaz Nahrát složku a nahrajte celou strukturu složek.

Vyberte libovolný soubor v prohlížeči a upravte ho v editoru kódu. Editor podporuje zvýraznění syntaxe pro Markdown, JSON, YAML, KQL, Python a skripty prostředí.

Výběr nástrojů

Volitelně můžete připojit nástroje, které dovednost používá během provádění.

  1. V části Nástroje vyberte Zvolit nástroje.
  2. Procházejte nebo vyhledejte nástroje. Filtrovat podle typu (vlastní nástroj, nástroj MCP) nebo hledat podle názvu.
  3. Zkontrolujte nástroje, které tato dovednost potřebuje (například kusto_queryazure_resource_health).
  4. Zavřete panel.

Vybrané nástroje se zobrazují jako vyměnitelné pilulky. Tyto nástroje jsou při aktivaci dovednosti dynamicky dostupné.

Poznámka:

Nástroje přidané do dovednosti jsou při aktivaci dovednosti dynamicky dostupné. Pokud chcete konzistentnější chování, nakonfigurujte nástroje přímo v podagentu.

Pokud chcete vytvořit vlastní nástroje, přečtěte si téma Vytvoření nástroje Kusto nebo Vytvoření nástroje Pythonu. Další informace o nástrojích naleznete v tématu Nástroje.

Vytvoření dovednosti

Vyberte Vytvořit , abyste si uložili svoji dovednost.

Vaše dovednost se zobrazí na kartě Dovednosti v tvůrci podagentů. Agent teď může tuto dovednost používat automaticky, když narazí na relevantní situaci.

Otestování dovednosti

Hlavní agent může ve výchozím nastavení používat dovednosti, takže je můžete otestovat přímo v chatu, aniž byste nejdřív vytvořili podagent.

Testování v novém chatu

Pomocí nového vlákna chatu ověřte, že agent aktivuje vaši dovednost.

  1. Na bočním panelu vyberte nové vlákno chatu .
  2. Zadejte výzvu, která by měla aktivovat vaši dovednost. Příklad: "V naší kontejnerové aplikaci dochází k vysokému využití procesoru, můžete to prověřit?"
  3. Ověřte, že agent aktivuje dovednost a postupuje podle vámi definovaných postupů.

Test v dětském hřišti

Pomocí sandboxu otestujte dovednost pomocí podagenta.

  1. Vytvořte podagenta a přiřaďte mu tuto dovednost.
  2. Na panelu nástrojů tvůrce podagentů vyberte přepínač zobrazení Testovací hřiště .
  3. Vyberte subagenta, zadejte testovací výzvu a ověřte, že používá dovednost správně.

Další informace naleznete v tématu Agent playground.

Úprava dovednosti

Existující dovednost můžete upravit tak, aby aktualizovala pokyny, nástroje nebo podpůrné soubory.

  1. Na kartě Dovednosti vyberte název dovednosti nebo ho vyberte a zvolte Upravit.

  2. Otevře se dialogové okno pro úpravy se všemi aktuálními hodnotami, které jsou předem vyplněné. Změňte pole, která potřebujete.

    Co změnit Kde aktualizovat
    Když ho agent používá Popis a pokyny k SKILL.md
    Jaké postupy je třeba dodržovat SKILL.md obsah v editoru
    Které nástroje jsou k dispozici Nástroje> Volba nástrojů
    Referenční data Soubory> přidání, úprava nebo odebrání souborů

  3. Vyberte Uložit.

Tipy pro psaní efektivních dovedností

Pomocí následujících pokynů můžete vytvářet dovednosti, které může váš agent efektivně používat.

  • Buďte specifická ohledně toho, kdy ho použít. Agent přečte popis a pokyny k rozhodnutí o relevance.
  • Zahrňte podrobné postupy. Číslovaný postup dává agentovi jasný postupový pokyn.
  • Zadejte očekávaný výstup. Sdělte agentovi, v jakém formátu mají být výsledky.
  • Přidejte referenční data. Nahrajte šablony dotazů, standardní hodnoty konfigurace nebo známé dobré hodnoty jako podpůrné soubory.
  • Přiřaďte relevantní nástroje. Pokud dovednost potřebuje konkrétní nástroje, jako jsou dotazy Kusto nebo akce Azure, přidejte je.

Další krok

Další informace o dovednostech

Související obsah

  • Last updated on