Lernprogramm: Erstellen einer Fähigkeit in Azure SRE Agent

In diesem Lernprogramm erstellen Sie eine benutzerdefinierte Fähigkeit, die Ihrem Agenten Domänenwissen und Aufgaben-Leitfäden hinzufügt. Fähigkeiten sind modulare Funktionen, die Ihr Agent automatisch lädt, wenn sie relevant sind, z. B. die Problembehandlung für einen bestimmten Dienst oder das Ausführen eines Diagnoseverfahrens.

In diesem Tutorial erfahren Sie, wie:

  • Erstellen einer Fähigkeit im Subagent-Generator
  • Skill-Anweisungen in SKILL.md schreiben
  • Hinzufügen von unterstützenden Dateien und Tools
  • Testen Sie die Fähigkeit in einem Chat oder im Spielplatz
  • Bearbeiten einer vorhandenen Fähigkeit

Geschätzte Zeit: 10 Minuten

Tipp

Fähigkeiten und Wissensdokumente arbeiten zusammen. Eine Fähigkeit lehrt Ihren Agenten , wie man etwas tut (Verfahren, Playbooks, Schrittweise Anleitungen). Ein Wissensdokument lehrt Ihren Agenten , was er wissen muss (Referenzdaten, Architekturdokumente, Runbooks). Sie können auch Referenzdokumente direkt als unterstützende Dateien an einen Skill anfügen. Informationen zum Wissensupload finden Sie unter Hochladen von Wissensdokumenten.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über die folgenden Voraussetzungen verfügen:

  • Ein Agent, der im Azure SRE-Agent-Portal erstellt wurde.
  • Ein klares Verständnis des Verfahrens oder des Domänenwissens, das Sie codieren möchten.

Öffnen Sie den Subagent-Generator, in dem Sie Fähigkeiten erstellen und verwalten.

  1. Öffnen Sie das SRE-Agent-Portal.
  2. Wähle einen Agenten.
  3. Wählen Sie im linken Navigationsbereich den Generator aus.
  4. Wählen Sie den Subagent-Generator aus.

Fähigkeitserstellung starten

Starten Sie den Fähigkeitserstellungsprozess über die Symbolleiste.

  1. Wählen Sie die Dropdownliste "Erstellen" in der Symbolleiste aus.
  2. Wählen Sie "Fertigkeit" aus.

Das Dialogfeld zum Erstellen von Fähigkeiten wird mit einem zweispaltigen Layout geöffnet. Formularfelder auf der einen Seite und ein Code-Editor auf der anderen Seite, der SKILL.md anzeigt.

Geben Sie Namen und Beschreibung ein.

Geben Sie einen Namen und eine Beschreibung an, die dem Agenten helfen, zu entscheiden, wann diese Fähigkeit verwendet werden soll.

Feld Beispielwert
Name high-cpu-troubleshooting
Beschreibung "Problembehandlungsverfahren für hohe CPU-Warnungen in Container-Apps. Überprüft vorgelagerte Abhängigkeiten, Verbindungspools und aktuelle Bereitstellungen."

Der Name muss in Ihren Skills eindeutig sein. Die Beschreibung wird in der Liste der Fähigkeiten angezeigt und hilft dem Agenten zu entscheiden, wann diese Fähigkeit verwendet werden soll.

Tipp

Wählen Sie "Bearbeiten" neben dem Beschreibungstext aus, um zum Bearbeitungsmodus zu wechseln. Wählen Sie Speichern aus, wenn Sie fertig sind.

Skill-Anweisungen schreiben

Der Center-Editor zeigt SKILL.md, der die Anweisungen des Skills enthält. Die Datei beginnt mit einer Standardvorlage.

---
name:
description:
---

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

Die YAML-Front-Materie (name, description, tools) bleibt mit den Formularfeldern auf der linken Seite synchronisiert. Schreiben Sie Ihre Anweisungen in Markdown unter dem einleitenden Teil:

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

Hinzufügen von Unterstützenden Dateien

Im Abschnitt "Dateien " auf einer Seite wird ein Dateibrowser angezeigt. Über die Standardeinstellung SKILL.mdhinaus können Sie Verweisdaten, Vorlagen und Beispielabfragen hinzufügen.

  • Wählen Sie das Symbol "Neue Datei " aus, um Dateien hinzuzufügen.
  • Wählen Sie das Symbol "Neuer Ordner " aus, um Dateien in Verzeichnissen zu organisieren.
  • Ziehen Sie einen Ordner in den Ablagebereich und legen Sie ihn ab, oder wählen Sie den Link "Ordner hochladen" aus, um eine gesamte Ordnerstruktur hochzuladen.

Wählen Sie eine beliebige Datei im Browser aus, um sie im Code-Editor zu bearbeiten. Der Editor unterstützt Syntaxheraushebungen für Markdown-, JSON-, YAML-, KQL-, Python- und Shellskripts.

Auswählen von Tools

Fügen Sie optional Tools an, die die Fähigkeit während der Ausführung verwendet.

  1. Wählen Sie Tools auswählen im Abschnitt Tools aus.
  2. Stöbern oder suchen Sie nach Tools. Filtern Sie nach Typ (Benutzerdefiniertes Tool, MCP-Tool) oder nach Namen.
  3. Überprüfen Sie die Werkzeuge, die für diese Fähigkeiten benötigt werden (z. B. kusto_query oder azure_resource_health).
  4. Schließen Sie den Bereich.

Ausgewählte Tools werden als herausnehmbare Pillen angezeigt. Diese Tools sind dynamisch verfügbar, wenn die Fähigkeit aktiviert wird.

Hinweis

Tools, die zu einer Fähigkeit hinzugefügt werden, sind dynamisch verfügbar, wenn die Fähigkeit aktiviert wird. Um ein konsistenteres Verhalten zu erfahren, konfigurieren Sie stattdessen Tools direkt im Subagent.

Informationen zum Erstellen benutzerdefinierter Tools finden Sie unter Erstellen eines Kusto-Tools oder Erstellen eines Python-Tools. Weitere Informationen zu Tools finden Sie unter Tools.

Erstellen Sie das Skill

Wählen Sie "Erstellen" aus, um Ihre Fähigkeiten zu speichern.

Ihre Fähigkeiten werden auf der Registerkarte " Fähigkeiten " im Subagent-Generator angezeigt. Der Agent kann die Fähigkeit jetzt automatisch verwenden, wenn es auf eine relevante Situation trifft.

Die Fähigkeit testen

Der Hauptagent kann standardmäßig Fähigkeiten verwenden, sodass Sie sie direkt im Chat testen können, ohne zuerst einen Subagent zu erstellen.

Testen in einem neuen Chat

Verwenden Sie einen neuen Chatthread, um zu überprüfen, ob der Agent Ihre Fähigkeiten aktiviert.

  1. Wählen Sie in der Randleiste " Neuer Chatthread " aus.
  2. Geben Sie eine Eingabeaufforderung ein, die Ihre Fähigkeiten auslösen soll. Beispiel: "Wir sehen eine hohe CPU-Auslastung auf unserer Container-App, können Sie das überprüfen?"
  3. Überprüfen Sie, ob der Agent die Fähigkeit aktiviert und die von Ihnen definierten Verfahren befolgt.

Testen im Spielplatz

Verwenden Sie den Spielplatz, um die Fähigkeit durch einen Subagenten zu testen.

  1. Erstellen Sie einen Subagent , und weisen Sie ihm diese Fähigkeit zu.
  2. Wählen Sie in der Symbolleiste des Subagent Builders die Ansicht Test Playground aus, um die Ansicht umzuschalten.
  3. Wählen Sie den Subagent aus, geben Sie eine Testaufforderung ein, und überprüfen Sie, ob er die Fähigkeit richtig verwendet.

Weitere Informationen finden Sie im Agent-Playground.

Fähigkeit bearbeiten

Sie können eine vorhandene Fähigkeit ändern, um ihre Anweisungen, Tools oder unterstützenden Dateien zu aktualisieren.

  1. Wählen Sie auf der Registerkarte "Fähigkeiten " den Namen der Fähigkeiten aus, oder wählen Sie ihn aus, und wählen Sie "Bearbeiten" aus.

  2. Das Dialogfeld "Bearbeiten" wird geöffnet, wobei alle aktuellen Werte vorab aufgefüllt wurden. Ändern Sie die benötigten Felder:

    Was zu ändern ist Wo aktualisiert werden soll
    Wenn der Agent ihn verwendet Beschreibung und SKILL.md Anweisungen
    Zu befolgende Verfahren SKILL.md Inhalt im Editor
    Welche Tools verfügbar sind Werkzeuge> Auswählen von Tools
    Referenzdaten Dateien> Hinzufügen, Bearbeiten oder Entfernen von Dateien

  3. Wählen Sie Speichern aus.

Tipps zum Schreiben effektiver Skills

Verwenden Sie die folgenden Richtlinien, um Fähigkeiten zu erstellen, die Ihr Agent effektiv nutzen kann.

  • Geben Sie an, wann sie verwendet werden soll. Der Agent liest die Beschreibung und Anweisungen, um die Relevanz zu entscheiden.
  • Schließen Sie schrittweise Verfahren ein. Nummerierte Schritte geben dem Agent ein klares Playbook.
  • Geben Sie die erwartete Ausgabe an. Teilen Sie dem Agent mit, welches Format die Ergebnisse annehmen sollen.
  • Fügen Sie Referenzdaten hinzu. Laden Sie Abfragevorlagen, Konfigurationsbaselines oder bekannte werte als unterstützende Dateien hoch.
  • Weisen Sie relevante Tools zu. Wenn die Qualifikation bestimmte Tools wie Kusto-Abfragen oder Azure-Aktionen benötigt, fügen Sie sie hinzu.

Nächster Schritt

Erfahren Sie mehr über Fähigkeiten

Verwandte Inhalte

  • Last updated on