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řte dovednost v Agent Canvas
  • 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.

Open Agent Canvas, kde vytváříte a spravujete dovednosti.

  1. Otevřete portál agenta SRE.
  2. Vyberte agenta.
  3. V levém navigačním panelu vyberte Tvůrce .
  4. Vyberte Plátno agenta.
  5. Vybrat + Vytvořit 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 požadovaný název dovednosti. Přidejte popis, který pomůže makléři rozhodnout, kdy dovednost využít.

Pole Příklad hodnoty
Název (povinný) high-cpu-troubleshooting
Popis (nepovinné) 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.

Tvé schopnosti se objevují na Agent Canvas. 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ů Agent Canvas vyberte přepínač zobrazení testovacího 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 Agent Canvas vyberte dovednost a pak zvolte Editovat.

  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