Benutzerdefinierte Agenten in Azure SRE-Agent

Benutzerdefinierte Agenten sind Spezialagenten, die Sie nach Bedarf aufrufen. Geben Sie /agent im Chat ein, wählen Sie Ihren Spezialisten aus und stellen Sie Ihre Frage. Dieser Prozess bietet Ihnen Zugriff auf einen Datenbankexperten für SQL-Probleme und einen Sicherheitsprüfer zur Bedrohungsuntersuchung.

Im Gegensatz zu Fähigkeiten (die immer verfügbar sind), erfordern benutzerdefinierte Agents expliziten Aufruf. Diese Anforderung bezieht sich auf ihre Expertise auf bestimmte Aufgaben.

Wie angepasste Agents arbeiten

Rufen Sie einen benutzerdefinierten Agent mithilfe des /agent Schrägstrichbefehls im Chat auf. Der benutzerdefinierte Agent erhält den vollständigen Unterhaltungskontext und arbeitet mit fokussierter Expertise.

Das folgende Beispiel zeigt eine grundlegende definition des benutzerdefinierten Agents:

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise

Zu den wichtigsten Eigenschaften gehören:

• system_prompt: Die Experten-Persona und Anweisungen.
• handoff_description: Was der Orchestrator sieht, wenn er entscheidet, zu delegieren.
• tools: Verfügbare Funktionen.
• enable_skills: Wenn Sie diese Eigenschaft verwenden, kann der benutzerdefinierte Agent dynamisch auf Fähigkeiten zugreifen.

Tipp

Fähigkeiten sind automatisch. Ihr Agent verwendet sie, wann immer relevant. Benutzerdefinierte Agenten sind explizit – Sie rufen sie auf, wenn /agent fokussiertes Fachwissen benötigt wird.

Gründe für die Verwendung von benutzerdefinierten Agents

Mit benutzerdefinierten Agents können Sie Domänenkenntnisse, Tools und Kenntnisse für die Wiederverwendung verpacken. Statt dass Ihr Hauptagent versucht, alles zu verarbeiten, delegiert er an Spezialisten.

Erwägen Sie ein Datenbankproblem: Ohne benutzerdefinierte Agents versucht Ihr Haupt-Agent eine generische Problembehandlung. Mit einem benutzerdefinierten Agent "Datenbankexperte" erhalten Sie fokussierte SQL-Expertise, datenbankspezifische Runbooks und Tools, die für die Abfrageanalyse optimiert sind.

Individuelle Agenten ermöglichen auch Handoff-Ketten. Ihr benutzerdefinierter Agent zur Vorfall-Triage klassifiziert ein Problem, übergibt das Problem an den entsprechenden Domänenexperten, der es untersucht und es dann an einen Benachrichtigungsrouter übergibt. Jeder Schritt ist spezialisiert.

Einen benutzerdefinierten Agent erstellen

Erstellen Sie benutzerdefinierte Agents im Builder-Agent-Canvas>.

1. Wechseln Sie im Azure-Portal zu Ihrem Azure SRE-Agent.

2. Wählen Sie die Registerkarte " Agent Canvas " aus.

3. Wählen Sie "Erstellen" aus.

4. Wählen Sie "Benutzerdefinierter Agent" aus.

5. Geben Sie Werte für die folgenden Einstellungen an:

   Eigentum	Wert
   Name	Geben Sie einen beschreibenden Namen für Ihren benutzerdefinierten Agent ein.
   Anweisungen	Stellen Sie klare, benutzerdefinierte Anweisungen bereit, die definieren, wie sich der benutzerdefinierte Agent verhalten soll.
   Beschreibung der Übergabe	Erläutern Sie die Szenarien, in den andere benutzerdefinierte Agents die Verarbeitung an diesen benutzerdefinierten Agent übertragen sollten und warum.
   Benutzerdefinierte Tools (optional)	Wählen Sie ein oder mehrere benutzerdefinierte Tools für den benutzerdefinierten Agent aus, der während seiner Vorgänge verwendet werden soll.
   Integrierte Tools (optional)	Wählen Sie alle integrierten Systemtools aus, auf die der benutzerdefinierte Agent Zugriff haben soll.
   Übergabe-Agents (optional)	Geben Sie an, welcher benutzerdefinierte Agent die Verarbeitung übernehmen soll, nachdem dieser benutzerdefinierte Agent seine Aufgaben abgeschlossen hat.

   Optional können Sie das Knowledge Base-Feature aktivieren. Mit dieser Option können Sie Dateien hochladen, die Ihr benutzerdefinierter Agent beim Beantworten von Abfragen als Referenzmaterial verwenden kann.

Verwaltung der Wissensdatenbank

Verbessern Sie das Wissen Ihrer benutzerdefinierten Agents, indem Sie Dokumentation, Runbooks und Verfahrenshandbücher hochladen.

Beispiele für Dateien, die Sie Ihrem Agent hinzufügen können:

• Architektur oder Systementwurf: Diagramme und Dokumentationen, die Systemkomponenten und Datenflüsse erläutern.
• Anleitungen zur Problembehandlung: Schrittweise Anleitungen zum Diagnostizieren und Beheben häufiger oder wiederkehrender Probleme.
• Runbooks und SOPs: Detaillierte Workflows für Routinevorgänge, Wartung und Reaktion auf Vorfälle.
• Vorfallberichte und Postmorteme: Dokumentation vergangener Ausfälle, einschließlich Ursachenanalyse und Erkenntnisse.
• Versionshinweise und Änderungsprotokolle: Zusammenfassungen von Produkt- oder Dienstupdates, einschließlich neuer Features, Fehlerbehebungen und Änderungen.

Unterstützte Dateitypen

Betriebsabläufe im Markdown- (.md) oder Textformat (.txt).

Dateiverwaltungsworkflow

1. Greifen Sie auf die Wissensdatenbank zu, indem Sie zur Registerkarte Einstellungen > Wissensdatenbank > Dateien gehen.
2. Laden Sie Dateien hoch, indem Sie Ihre Dateien ziehen und ablegen oder zum Auswählen von Dateien navigieren (maximal 50 MB pro Datei).
3. Organisieren Sie Inhalte, indem Sie Kategorien und Beschreibungen hinzufügen, um die Suchbarkeit zu verbessern.
4. Aktivieren Sie den Zugriff auf benutzerdefinierte Agents, indem Sie konfigurieren, welche benutzerdefinierten Agents auf bestimmte Wissensquellen zugreifen können.
5. Überwachen Sie die Verwendung, indem Sie nachverfolgen, wie benutzerdefinierte Agents hochgeladene Kenntnisse in ihren Antworten verwenden.

Hinweis

Ihre benutzerdefinierten Agents indizieren automatisch und machen die von Ihnen hochgeladenen Dateien durchsuchbar. Das System unterstützt bis zu 1.000 Dateien pro benutzerdefinierter Agentinstanz.

Agent Canvas-Ansichten

Erstellen Sie benutzerdefinierte Agents im Builder>Agent Canvas. Die folgenden Ansichten stehen zur Verfügung:

Sicht	Purpose
Canvasansicht	Visuelles Diagramm mit benutzerdefinierten Agents, Tools und Triggerverbindungen
Tabellenansicht	Liste aller benutzerdefinierten Agents mit schnellem Zugriff
Testumgebung	Interaktive Testumgebung

Wann man benutzerdefinierte Agents verwenden sollte

In der folgenden Tabelle können Sie ermitteln, wann benutzerdefinierte Agents die richtige Wahl sind:

Szenario	Möchten Sie einen benutzerdefinierten Agenten verwenden?	Warum
Tiefes Fachwissen in der Domäne erforderlich	Ja	Verpacken von SQL-Know-how, Netzwerkwissen, bewährte Methoden für Sicherheit
Mehrstufige Workflows	Ja	Vorfall-Triage, Bereitstellungsüberprüfung, Sicherungsüberprüfung
Spezialisierte Toolsätze	Ja	Datenbankspezifische Tools, Kostenoptimierungstools
Einfache einzelne Vorgänge	No	Verwenden Sie stattdessen Fähigkeiten für einfache, wiederholbare Aktionen
Schreibgeschützte Abfragen	No	Der Hauptagent kann ohne Delegierung umgehen.

Für eine vollständige Einrichtung eines benutzerdefinierten Agents, siehe Vorfallreaktion zur Automatisierung der Reaktionsprozesse.

Übergabe eines benutzerdefinierten Agents

Wenn Ihr Hauptagent an einen benutzerdefinierten Agenten übergibt, teilen sie sich einen einzelnen Unterhaltungskontext. Der empfangende Spezialagent sieht:

• Vollständiger Unterhaltungsverlauf: alle vorherigen Nachrichten, Toolaufrufe und Ergebnisse.
• Teilvorgangsgrund: Was die Übergabe an diesen benutzerdefinierten Agent erfordert, um dies zu erreichen.
• Ursprüngliche Frage des Benutzers: in der Übergabekette bewahrt.

Hinweis

Benutzerdefinierte Agenten erhalten keinen "reinen Tisch". Sie setzen den gleichen Konversationsthread fort. Dieser Ansatz ermöglicht Handoffketten, bei denen jeder Spezialist auf der Arbeit des vorherigen Agenten aufbaut.

Nach Abschluss der Arbeit übergibt der benutzerdefinierte Agent an den nächsten Agenten oder gibt die Steuerung an den Orchestrator zurück. Der Unterhaltungskontext sammelt sich im Laufe der Kette weiter an.

Benutzerdefinierte Agentmuster

In der folgenden Tabelle werden allgemeine benutzerdefinierte Agentmuster beschrieben:

Schema	Beispiele	Anwendungsfall
Domänenexperte	VM Expert, AKS Expert, Netzwerkexperte	Umfassende Expertise in einer Technologie (alle VM-Probleme, Kubernetes-Problembehandlung, VNet/NSG/Lastenausgleich)
Aufgabenspezialist	Log Analyzer, Kostenoptimierer, Sicherheitsscanner	Fokussiert auf bestimmte Aufgaben (Analysieren von Protokollen, Auffinden von Einsparungen, Identifizieren von Sicherheitsrisiken)
Workflow-Ausführungsprogramm	Sichtung von Incidents, Validierung der Bereitstellung, Verifizierung der Sicherung	Mehrstufige Verfahren (Klassifizieren von Vorfällen, Überprüfungen nach der Bereitstellung, Testen der Sicherungsintegrität)

Vergleichen von Fähigkeiten, benutzerdefinierten Agents und Wissensdateien

In der folgenden Tabelle werden die einzelnen Erweiterbarkeitskonzepte verglichen:

Funktion	Fähigkeiten	Benutzerdefinierte Agents	Wissensdateien
Access	Automatisch	/agent-Befehl	Über das KB-Abfragetool
Werkzeuge	Kann anfügen	Verfügt über Tools	Keine Tools
Zusammenhang	Verwendet Threadkontext	Teilt den Gesprächskontext	Nur Referenz
Am besten geeignet für	Prozeduren	Domänenspezialisten	Runbooks, Dokumentationen

Verwenden Sie die folgenden Anleitungen, um den richtigen Ansatz auszuwählen:

• Kompetenz: Teamweites Verfahren mit optionaler Ausführung (AKS-Fehlerbehebungsleitfaden + Azure CLI)
• Benutzerdefinierter Agent: Fachspezialist mit bestimmtem Einsatzbereich, auf Abruf verfügbar (PostgreSQL-Experte)
• Wissensdatei: Referenzinhalte für Kontext (Architekturdokumente)

Verbinden von benutzerdefinierten Agents mit Triggern

Vorfälle oder geplante Vorgänge können automatisch benutzerdefinierte Agents auslösen. Die Canvasansicht zeigt diese Verbindungen visuell an: Trigger werden als Knoten angezeigt, die mit benutzerdefinierten Agents verbunden sind, Tools werden mit ihrem übergeordneten benutzerdefinierten Agent gruppiert, und Statussignale zeigen den aktiven oder inaktiven Zustand an.

Details zur Einrichtung finden Sie unter "Vorfallreaktion ", um benutzerdefinierte Agents mit Vorfällen zu verbinden, oder geplante Aufgaben für die wiederkehrende Automatisierung.

Benutzerdefinierte Agentmodi

Jeder benutzerdefinierte Agent wird in einem Modus ausgeführt, der steuert, wie viel Autonomie er hat. Legen Sie den Modus für jeden Antwortplan oder einen geplanten Vorgang fest.

Modus	Beschreibung
Bewertung	Schlägt Aktionen vor, wartet auf genehmigung
Autonome	Handlungen ohne menschliche Genehmigung

Wählen Sie den Modus basierend auf Dem Risiko aus:

• Empfehlungen zur Kostenoptimierung? Verwenden Sie Überprüfung (Menschliche Genehmigung erforderlich).
• Gut getestete Automatisierung? Verwenden Sie Autonomous (für vertrauenswürdige Vorgänge).

Konfigurieren Sie Modi für jeden Antwortplan oder einen geplanten Vorgang. Legen Sie in der YAML-Definition des benutzerdefinierten Agents keine Modi fest. Weitere Informationen finden Sie unter "Ausführungsmodi".

Testen und Entwickeln von benutzerdefinierten Agents

Testen Sie benutzerdefinierte Agents im Test-Playground vor der Bereitstellung. Wechseln Sie zu Builder-Agent-Canvas und wählen Sie Test playground in der Ansichtsauswahl. Mit dem Geteilten Bildschirmlayout können Sie Anweisungen auf der linken Seite bearbeiten und in einem Livechat auf der rechten Seite testen, mit KI-basierter Auswertung, um Ihre Konfiguration zu bewerten.

Für VS Code-Benutzer können Sie mit der SRE Agent MCP-Servererweiterung benutzerdefinierte Agent-YAML in Ihrem Editor mit Änderungen bearbeiten, die mit Ihrem Agent synchronisiert werden.

Ausführliche Informationen finden Sie im Agent-Playground.

Verwandte Inhalte

Ressource	Beschreibung
Fähigkeiten	Wiederverwendbare Verfahren und Tools für Ihren Agent
Senden von Benachrichtigungen	Senden von Untersuchungsergebnissen an Teams, Outlook und mehr
Chatten Sie über Ihre Tools	Interagieren mit Ihrem Agent aus Teams, Webhooks und mehr