Självstudie: Skapa en färdighet i Azure SRE Agent

I den här handledningen skapar du en anpassad färdighet som lägger till domänspecifik kunskap och spelböcker för uppgifter till din agent. Kunskaper är modulära funktioner som agenten läser in automatiskt när det är relevant, till exempel felsökning av en specifik tjänst eller körning av en diagnostikprocedur.

I den här tutorialen lär du dig följande:

Uppskattad tid: 10 minuter

Förutsättningar

Kontrollera att du har följande förutsättningar innan du börjar:

• En agent som skapats i Azure SRE-agentportalen.
• En tydlig förståelse för den procedur eller domänkunskap som du vill koda.

Navigera till underagentverktyget

Öppna underagentverktyget där du skapar och hanterar kunskaper.

1. Öppna SRE-agentportalen.
2. Välj din handläggare.
3. Välj Builder i det vänstra navigeringsfältet.
4. Välj Underagent builder.

Starta kunskapsskapande

Starta skapandeprocessen för färdigheter från verktygsfältet.

1. Välj listrutan Skapa i verktygsfältet.
2. Välj Kompetens.

Dialogrutan för att skapa färdigheter öppnas med en tvåkolumns-layout. Formulärfält på ena sidan och en kodredigerare på den andra som visar SKILL.md.

Ange namn och beskrivning

Ange ett namn och en beskrivning som hjälper agenten att bestämma när den här färdigheten ska användas.

Namnet måste vara unikt för dina kunskaper. Beskrivningen visas i kompetenslistan och hjälper agenten att bestämma när den här färdigheten ska användas.

Skriv instruktioner för färdigheter

I den centrala redigeraren visas SKILL.md, som innehåller färdighetens instruktioner. Filen börjar med en standardmall.

---
name:
description:
---

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

YAML-fronten (name, description, tools) förblir synkroniserad med formulärfälten till vänster. Skriv dina instruktioner i Markdown under det inledande materialet

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

Lägga till stödfiler

I avsnittet Filer på ena sidan visas en filwebbläsare. Utöver standardvärdet SKILL.mdkan du lägga till referensdata, mallar och exempelfrågor.

• Välj den nya filikonen för att lägga till filer.
• Välj den nya mappikonen för att ordna filer i kataloger.
• Dra och släpp en mapp i släppzonen eller välj länken Ladda upp mapp för att ladda upp en hel mappstruktur.

Välj valfri fil i webbläsaren för att redigera den i kodredigeraren. Redigeraren stöder syntaxmarkering för Markdown-, JSON-, YAML-, KQL-, Python- och shell-skript.

Välj verktyg

Du kan, om så önskas, också bifoga verktyg som funktionen använder under körningen.

1. Välj Välj verktyg i avsnittet Verktyg .
2. Bläddra eller sök efter verktyg. Filtrera efter typ (anpassat verktyg, MCP-verktyg) eller sök efter namn.
3. Kontrollera de verktyg som den här kompetensen behöver (till exempel kusto_query eller azure_resource_health).
4. Stäng panelen.

Valda verktyg visas som avtagbara piller. Dessa verktyg är dynamiskt tillgängliga när kunskapen aktiveras.

Information om hur du skapar anpassade verktyg finns i Skapa ett Kusto-verktyg eller Skapa ett Python-verktyg. Mer information om verktyg finns i Verktyg.

Skapa kunskapen

Välj Skapa för att spara dina kunskaper.

Din kompetens visas på fliken Kunskaper i underagentverktyget. Agenten kan nu använda färdigheten automatiskt när den stöter på en relevant situation.

Testa färdigheten

Huvudagenten kan använda kunskaper som standard, så att du kan testa dem direkt i chatten utan att först skapa en underagent.

Testa i en ny chatt

Använd en ny chatttråd för att kontrollera att agenten aktiverar din kompetens.

1. Välj Ny chatttråd i sidopanelen.
2. Skriv en uppmaning som ska utlösa din skicklighet. Till exempel: "Vi ser hög CPU i vår containerapp, kan du undersöka?"
3. Kontrollera att agenten aktiverar färdigheten och följer de procedurer som du har definierat.

Testa på lekplatsen

Prova färdigheten på lekplatsen genom en underagent.

1. Skapa en underagent och tilldela den här färdigheten till den.
2. I verktygsfältet för underagentverktyget väljer du växlingsknappen Testa lekplatsvy .
3. Välj underagenten, skriv en testprompt och kontrollera att den använder färdigheten korrekt.

Mer information finns i Agent playground.

Redigera en färdighet

Du kan ändra en befintlig färdighet för att uppdatera dess instruktioner, verktyg eller stödfiler.

1. På fliken Kunskaper väljer du kunskapsnamnet eller väljer det och väljer Redigera.

2. Redigeringsdialogrutan öppnas med alla aktuella värden ifyllda. Ändra de fält du behöver:

   Vad du ska ändra	Var du ska uppdatera
   När agenten använder den	Beskrivning och SKILL.md instruktioner
   Vilka procedurer som ska följas	SKILL.md innehåll i redigeraren
   Vilka verktyg som är tillgängliga	Verktyg> Välj verktyg
   Referensdata	Filer> lägga till, redigera eller ta bort filer

3. Välj Spara.

Tips för att skriva om färdigheter på ett effektivt sätt

Använd följande riktlinjer för att skapa färdigheter som din agent kan använda effektivt.

• Var specifik om när du ska använda den. Agenten läser beskrivningen och instruktionerna för att avgöra relevans.
• Inkludera stegvisa procedurer. Numrerade steg ger agenten en tydlig spelbok.
• Ange förväntade utdata. Tala om för agenten vilket format resultatet ska ha.
• Lägg till referensdata. Ladda upp frågemallar, konfigurationsbaslinjer eller kända värden som stödfiler.
• Tilldela relevanta verktyg. Om kunskapen behöver specifika verktyg som Kusto-frågor eller Azure-åtgärder lägger du till dem.

Nästa steg

Relaterat innehåll

• Färdigheter
• Ladda upp kunskapsdokument
• Underagenter
• Agentlekplats
• Arbetsredskap
• Skapa ett Kusto-verktyg
• Skapa ett Python-verktyg
• Skapa schemalagda aktiviteter
• Testa ett verktyg på lekplatsen