Zelfstudie: Een vaardigheid maken in Azure SRE Agent

In deze zelfstudie maakt u een aangepaste vaardigheid waarmee domeinkennis en taakplaybooks aan uw agent worden toegevoegd. Vaardigheden zijn modulaire mogelijkheden die uw agent automatisch laadt wanneer dit relevant is, zoals het oplossen van problemen met een specifieke service of het uitvoeren van een diagnostische procedure.

In deze handleiding leer je hoe je:

Geschatte tijd: 10 minuten

Vereiste voorwaarden

Voordat u begint, zorg ervoor dat u over de volgende vereisten beschikt:

• Een agent die is gemaakt in de Azure SRE-agentportal.
• Een duidelijk begrip van de procedure of domeinkennis die u wilt coderen.

Navigeer naar de opbouwfunctie voor subagenten

Open de opbouwfunctie voor subagenten waar u vaardigheden maakt en beheert.

1. Open de SRE Agent-portal.
2. Selecteer uw agent.
3. Selecteer Opbouwfunctie in het linkernavigatievenster.
4. Selecteer Subagent builder.

Start met het creëren van vaardigheden

Start het skill-creatieproces vanuit de werkbalk.

1. Selecteer de vervolgkeuzelijst Maken op de werkbalk.
2. Selecteer Vaardigheid.

Het dialoogvenster voor het maken van vaardigheden wordt geopend met een indeling met twee kolommen. Formuliervelden aan de ene kant en een code-editor aan de andere kant die SKILL.md toont.

Voer de naam en beschrijving in

Geef een naam en beschrijving op waarmee de agent kan bepalen wanneer deze vaardigheid moet worden gebruikt.

De naam moet uniek zijn voor al uw vaardigheden. De beschrijving wordt weergegeven in de lijst met vaardigheden en helpt de agent te bepalen wanneer deze vaardigheid moet worden gebruikt.

Instructies voor schrijfvaardigheden

De middelste editor toont SKILL.md, die de instructies van de vaardigheid bevat. Het bestand begint met een standaardsjabloon.

---
name:
description:
---

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

De YAML-front-matter (name, description, tools) blijft gesynchroniseerd met de formuliervelden aan de linkerkant. Schrijf uw instructies in Markdown onder de front-matter:

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

Ondersteunende bestanden toevoegen

In de sectie Bestanden aan de ene kant ziet u een bestandsbrowser. Naast de standaardinstelling SKILL.mdkunt u referentiegegevens, sjablonen en voorbeeldquery's toevoegen.

• Selecteer het pictogram voor het nieuwe bestand om bestanden toe te voegen.
• Selecteer het nieuwe mappictogram om bestanden in mappen te ordenen.
• Sleep een map naar de sleepzone of klik op de koppeling Map uploaden om een volledige mapstructuur te uploaden.

Selecteer een bestand in de browser om het te bewerken in de code-editor. De editor ondersteunt syntaxismarkeringen voor Markdown-, JSON-, YAML-, KQL-, Python- en shellscripts.

Tools selecteren

Voeg eventueel hulpprogramma's toe die door de vaardigheid worden gebruikt tijdens de uitvoering.

1. Selecteer Kies hulpmiddelen in de sectie Hulpmiddelen.
2. Blader of zoek naar hulpprogramma's. Filter op type (aangepast hulpprogramma, MCP-hulpprogramma) of zoek op naam.
3. Controleer de hulpprogramma's die deze vaardigheid nodig heeft (bijvoorbeeld kusto_query of azure_resource_health).
4. Sluit het paneel.

Geselecteerde hulpmiddelen verschijnen als verwisselbare pillen. Deze hulpprogramma's zijn dynamisch beschikbaar wanneer de vaardigheid wordt geactiveerd.

Zie Een Kusto-hulpprogramma maken of Een Python-hulpprogramma maken om aangepaste hulpprogramma's te maken. Zie Hulpprogramma's voor meer informatie over hulpprogramma's.

De vaardigheid creëren

Selecteer Aanmaken om uw vaardigheid op te slaan.

Uw vaardigheid wordt weergegeven op het tabblad Vaardigheden in de opbouwfunctie voor subagenten. De agent kan de vaardigheid nu automatisch gebruiken wanneer deze een relevante situatie tegenkomt.

De vaardigheid testen

De hoofdagent kan standaard vaardigheden gebruiken, zodat u ze rechtstreeks in chat kunt testen zonder eerst een subagent te maken.

Testen in een nieuwe chat

Gebruik een nieuwe chat-thread om te controleren of de agent uw vaardigheid activeert.

1. Selecteer Nieuwe chat-thread in de zijbalk.
2. Typ een prompt die uw vaardigheid moet activeren. Bijvoorbeeld: 'We zien een hoog CPU-gebruik van onze container-app, kunt u dit onderzoeken?'
3. Controleer of de agent de vaardigheid activeert en de procedures volgt die u hebt gedefinieerd.

Testen in de speeltuin

Gebruik de speeltuin om de vaardigheid te testen via een subagent.

1. Maak een subagent en wijs deze vaardigheid eraan toe.
2. Selecteer op de subagentenbouwer-werkbalk de schakelknop voor de Test Playground-weergave.
3. Selecteer de subagent, typ een testprompt en controleer of deze de vaardigheid correct gebruikt.

Zie Agent playground voor meer informatie.

Een vaardigheid bewerken

U kunt een bestaande vaardigheid wijzigen om de instructies, hulpprogramma's of ondersteunende bestanden bij te werken.

1. Selecteer op het tabblad Vaardigheden de naam van de vaardigheid of selecteer deze en kies Bewerken.

2. Het dialoogvenster voor bewerkingen wordt geopend met alle huidige waarden vooraf ingevuld. Wijzig de velden die u nodig hebt:

   Wat u moet wijzigen	Waar moet ik bijwerken?
   Wanneer de agent deze gebruikt	Beschrijving en SKILL.md instructies
   Welke procedures u moet volgen	inhoud SKILL.md in de editor
   Welke hulpprogramma's beschikbaar zijn	Tools> Hulpprogramma's kiezen
   Verwijzingsgegevens	Bestanden> bestanden toevoegen, bewerken of verwijderen

3. Selecteer Opslaan.

Tips voor het schrijven van effectieve vaardigheden

Gebruik de volgende richtlijnen om vaardigheden te creëren die uw agent effectief kan gebruiken.

• Wees specifiek over wanneer u deze wilt gebruiken. De agent leest de beschrijving en instructies om de relevantie te bepalen.
• Voeg stapsgewijze procedures toe. Genummerde stappen geven de agent een duidelijk playbook.
• Geef de verwachte uitvoer op. Laat de agent weten wat de indeling van de resultaten moet zijn.
• Voeg referentiegegevens toe. Upload querysjablonen, configuratiebasislijnen of bekende goede waarden als ondersteunende bestanden.
• Wijs relevante hulpprogramma's toe. Als de vaardigheid specifieke hulpprogramma's nodig heeft, zoals Kusto-query's of Azure-acties, voegt u deze toe.

Volgende stap

Verwante inhoud

• Vaardigheden
• Kennisdocumenten uploaden
• Subagents
• Agentspeelplaats
• Gereedschappen
• Een Kusto-hulpprogramma maken
• Een Python-hulpprogramma maken
• Geplande taken maken
• Een gereedschap testen in de speeltuin