Fähigkeiten im Azure SRE-Agent

Fähigkeiten erweitern Ihren Agenten durch Verfahren und Ausführungsfähigkeiten. Sie können einen Leitfaden zur Problembehandlung hinzufügen, Tools wie Azure CLI, Kusto-Abfragen, Python-Skripts oder MCP-Connectors hinzufügen, und Ihr Agent lädt sie, wenn sie für die Frage des Benutzers relevant sind. Der Agent benötigt keinen expliziten /skill Befehl.

Sie können auch Wissensdokumente wie Runbooks, Architekturhandbücher und Referenzmaterial hochladen, um eine Wissensbasis zu erstellen, die Ihr Agent automatisch durchsucht. Weitere Informationen finden Sie unter "Speicher und Wissen".

Fähigkeiten, benutzerdefinierte Agents und Wissensdateien

Diese drei Konzepte arbeiten zusammen, dienen jedoch unterschiedlichen Zwecken:

Funktion	Fähigkeiten	Benutzerdefinierte Agents	Wissensdateien
Access	Der Agent wird automatisch geladen, wenn relevant.	Explizit mit dem Befehl /agent aufrufen	Automatische Suchvorgänge durch Agenten, wenn dies relevant ist.
Werkzeuge	Kann Tools anfügen	Verfügt über eigene Tools	Keine Tools
Purpose	Wiederverwendbare Prozeduren und Ausführung	Spezialisten für spezialisierte Gebiete	Referenzinhalt
Am besten geeignet für	Teamweite Anleitungen zur Problembehandlung	Datenbankexperten, Sicherheitsprüfer	Runbooks, Architekturdokumente

Sowohl Ihr Haupt-Agent als auch Ihre benutzerdefinierten Agents können Fähigkeiten verwenden. Wenn Sie einen benutzerdefinierten Agent imGenerator-Agent-Canvas> erstellen, wählen Sie die Fähigkeiten aus, auf die er zugreifen kann. Wählen Sie die Fähigkeiten direkt im Bereich " Fähigkeiten auswählen " im Dialogfeld "Benutzerdefinierte Agent-Erstellung" aus.

Verwenden Sie allowed_skills in YAML, um anzugeben, auf welche Fähigkeiten ein benutzerdefinierter Agent zugreifen kann. Das Festlegen allowed_skills aktiviert automatisch Fähigkeiten für diesen Agenten.

name: database_expert
system_prompt: |
  You are a database specialist.
allowed_skills:
  - postgres-troubleshooting
  - connection-pool-guide
tools:
  - execute_kusto_query

Funktionsweise von Fähigkeiten

Eine Fähigkeit kombiniert Wissen mit optionalen Tools.

Bestandteil	Purpose
SKILL.md	Verfahrensanleitungen, die der Agent folgt
Werkzeuge	Azure CLI, Kusto-Abfragen, Python-Skripts, die die Fähigkeit ausführen kann
Unterstützende Dateien	Runbooks, Architekturdokumente, Referenzmaterial

Ihr Agent entscheidet, welche Fähigkeit auf der Grundlage der Beschreibung und Ihrer Frage geladen werden soll. Der Agent liest die Beschreibungen der Fähigkeiten in seiner Systemaufforderung und lädt automatisch die relevantesten Fähigkeiten, indem er seine SKILL.md Datei liest. Der Agent benötigt keinen expliziten Befehl.

Gründe für die Verwendung von Fähigkeiten

Wenn Ihr Agent keine Kompetenzen hat, verlässt er sich auf sein integriertes Wissen. Dieser Ansatz funktioniert für allgemeine Azure-Vorgänge, aber es fehlen die spezifischen Verfahren Ihres Teams.

Mithilfe von Fähigkeiten können Sie Folgendes hinzufügen:

• Ihre Workflows zur Problembehandlung: schrittweise Anleitungen für Ihre Systeme
• Ausführungsfunktion: Tools zum Ausführen von Befehlen, nicht nur beschreiben sie
• Organisationskontext: Architekturdokumente, Benennungskonventionen, Eskalationspfade

Fähigkeiten verwandeln Ihren Agenten von einem allgemeinen Assistenten in ein Teammitglied, das weiß, wie Sie arbeiten.

Fähigkeiten erstellen

Erstellen Sie Fähigkeiten in Builder Skills>. Eine Skill umfasst eine Datei mit prozeduraler SKILL.md Anleitung und optionalen Werkzeuganhängen für die Ausführung.

Das folgende Beispiel zeigt eine typische Qualifikationsstruktur:

name: aks-troubleshooting-guide
description: Use when investigating AKS or Kubernetes issues
files:
  - SKILL.md
tools:
  - RunAzCliReadCommands

Ihr Agent wendet automatisch Anleitungen an, wenn es auf relevante Probleme stößt und angefügte Tools ausführt, um Informationen zu sammeln.

Anfügen von Tools

Fähigkeiten verwenden dieselbe Toolauswahl wie benutzerdefinierte Agenten. Sie können eine beliebige Kombination der folgenden Tooltypen anfügen:

Tooltyp	Beispiele
Azure CLI	RunAzCliReadCommands, RunAzCliWriteCommandsGetAzCliHelp
Kusto/Log Analytics	Benutzerdefinierte Kusto-Abfragen für ADX oder Log Analytics
Python	Benutzerdefinierte Python-Skripts für datenverarbeitung oder API-Aufrufe
MCP	Werkzeuge der verbundenen MCP-Server
Verbinden	URL-Vorlagen für externe Systeme

Wenn Sie RunAzCliReadCommands an einen AKS-Skill für die Fehlerbehebung anfügen, weiß der Agent nicht nur, wie Probleme behoben werden können. Sie kann die Befehle tatsächlich ausführen.

Grenzen und Einschränkungen

In der folgenden Tabelle werden die Einschränkungen beschrieben, die für Fähigkeiten gelten:

Constraint	Wert
Aktive Fähigkeiten	Maximal fünf gleichzeitige Verbindungen
Qualifikationslebenszyklus	Älteste automatisch entladen, wenn der Grenzwert überschritten wird
Kontextzurücksetzung	Aktive Funktionen bei der Kommunikationskomprimierung
Toolzugriff	Nur verfügbar, während Qualifikation aktiv ist

Wenn Sie die Werkzeuge einer Fähigkeit nach dem Entladen benötigen, liest der Agent die SKILL.md Datei erneut, um die Fähigkeit zu reaktivieren.

Verwandte Inhalte

Ressource	Beschreibung
Benutzerdefinierte Agents	Erstellen Sie spezielle Agents, die Fähigkeiten verwenden können.
Werkzeuge	Erfahren Sie mehr über die Tools, die Sie anfügen können.
Kusto Tools	Kusto-Abfragetools, die Fähigkeiten verwenden können.
Python-Codeausführung	Python-Tools, die Entwicklern zur Verfügung stehen.