Connectoren im Azure SRE-Agent

Ihr Agent verfügt über integrierten Zugriff auf Azure-Dienste. Sie kann Azure Monitor, Application Insights, Log Analytics und Azure Resource Graph abfragen. Connectors erweitern die Reichweite an externe Systeme: Ihre Kusto-Cluster, Quellcoderepositorys, Tools für die Zusammenarbeit und benutzerdefinierte APIs.

Was Ihr Agent ohne Connectors tun kann

Selbst wenn keine Connectors eingerichtet sind, verfügt Ihr Agent über integrierte Funktionen über die verwaltete Identität und Azure rollenbasierte Zugriffssteuerungsberechtigungen (Azure RBAC):

Ressourcendiagramm- und Resource Manager Vorgänge funktionieren mit jedem Azure Ressourcentyp, einschließlich Azure App Service, Azure Container Apps, virtuellen Computern, Netzwerk und Speicher. Wenn Ihre Protokolle und Metriken in Azure Monitor und Application Insights leben, kann Ihr Agent sofort mit der Untersuchung von Problemen beginnen, ohne dass eine Connectoreinrichtung erforderlich ist. Connectors werden nützlich, wenn Sie den Agent benötigen, um Systeme outside Azure zu erreichen.

Welche Funktionen bieten Connectors?

Connectors werden in vier Kategorien unterteilt, je nachdem, was sie Ihrem Agent geben: Datenquellen, Quellcode und Wissen, Tools für die Zusammenarbeit und benutzerdefinierte Connectors.

Datenquellen

Diese Quellen können Abfrageprotokolle, Metriken und Telemetrie aus Ihren Datenspeichern sein.

Quellcode und Wissen

Geben Sie Ihrem Agent Kontext zu Ihren Systemen – Code, Wikis und Dokumentation.

Mit diesen Connectors kann Ihr Agent Code nach Fehlermustern durchsuchen und wiki-Dokumentation lesen. Ihr Agent kann auch während der Problembehandlung auf API-Dokumente verweisen und Vorfälle mit verwandten Pullanforderungen verbinden.

Tools für die Zusammenarbeit

Lassen Sie Ihren Agenten Ergebnisse über die Kanäle kommunizieren, die Ihr Team bereits verwendet.

Benutzerdefinierte Connectors (MCP-Server)

Mit MCP-Servern (Model Context Protocol) können Sie Ihren Agent mit jedem System verbinden, einschließlich Observability-Plattformen, Quellcoderepositorys, Ticketingsystemen und benutzerdefinierten APIs. Ihr Agent erkennt automatisch Tools auf verbundenen Servern, überwacht den Verbindungsstatus mithilfe von Heartbeats im 60-Sekunden-Takt und erholt sich automatisch von vorübergehenden Fehlern.

Zwei Transporttypen decken jedes Bereitstellungsmodell ab: Streamable-HTTP für Remoteclouddienste und Stdio für lokale Prozesse, die zusammen mit Ihrem Agent ausgeführt werden. Vorkonfigurierte Partner-Konnektoren für Ressourcen wie GitHub, Datadog, Splunk und New Relic ermöglichen eine Einrichtung mit einem Klick.

Eine vollständige Anleitung zur MCP-Architektur, zu Transporttypen, Partnerkonnektoren, Zustandsüberwachung und Toolverwaltung finden Sie unter MCP-Konnektoren und -Tools.

Informationen zum Einrichten Ihres ersten MCP-Connectors finden Sie unter Einrichten des MCP-Connectors.

Konnektoren durchsuchen und verwalten

Um Ihre Connectors in einklappbaren Kategoriegruppen anzuzeigen, gehen Sie zu Builder>Connectors. Auf dieser Seite werden alle Gruppen standardmäßig erweitert.

Jeder Kategorieheader zeigt die Anzahl der Verbinder in dieser Gruppe an. Wenn Sie eine Kategorie reduzieren, wird ein rotes Signal angezeigt, wenn ein Connector in dieser Gruppe ein Verbindungsproblem aufweist. Sie können Probleme auf einen Blick erkennen, ohne jeden Abschnitt zu erweitern.

Verwenden Sie die Steuerelemente der Symbolleiste, um Ihre Ansicht zu steuern.

• Erweitern Sie alle/reduzieren Sie alle , um alle Kategoriegruppen gleichzeitig umzuschalten.
• Kategoriefilter , um nur Connectors in einer bestimmten Kategorie anzuzeigen.
• Suchen Sie nach Verbindern nach Namen (wechselt zu einer flachen Liste für die Stichwortsuche).

Es werden nur Kategorien angezeigt, die mindestens einen Verbinder enthalten. Wenn Sie nach einem Connector anhand des Namens suchen, wechselt die Seite zu einer flachen Listenansicht, um eine schnellere Filterung zu ermöglichen.

Wer Konnektoren konfigurieren kann

Zum Verwalten eines Konnektors benötigen Sie Schreibberechtigungen für den Agent. Die folgende Tabelle zeigt, welche Rolle über diese Berechtigung verfügt:

Während des Setups erfordern einige Connectors OAuth-Zustimmung von einem Benutzer, der über die richtigen Berechtigungen im externen System verfügt (z. B. ein GitHub Organisationsmitglied für GitHub Connectors). Diese Zustimmung betrifft Berechtigungen im externen Dienst, nicht SRE-Agent-Rollen.

Für Connectors, die die verwaltete Identität des Agents verwenden (z. B. Azure Data Explorer), muss ein Administrator des externen Systems die Identität als zulässig auflisten.

Wenn Sie Connectors konfigurieren, profitieren alle Agentbenutzer automatisch von ihnen. Sie stellen dem Agenten einfach Fragen, und der Agent nutzt die verfügbaren Konnektoren im Hintergrund.

Connectors und benutzerdefinierte Agenten

Sie können spezielle MCP-Tools speziellen benutzerdefinierten Agents zuweisen. Ein benutzerdefinierter Problembehandlungs-Agent für Datenbanken erhält möglicherweise Kusto-Tools, während ein benutzerdefinierter Bereitstellungs-Agent Zugriff auf GitHub erhält. Dieser Ansatz hält jeden benutzerdefinierten Agenten konzentriert und verhindert, dass er mit zu vielen Tools überfordert wird.

Weisen Sie Tools einzeln in der Portaltoolauswahl zu, oder verwenden Sie in YAML Wildcardmuster (connection-id/*), um alle Tools von einem Server gleichzeitig hinzuzufügen. Ausführliche Informationen zur Toolzuweisung und zur Syntax von Wildcards finden Sie unter MCP-Connectors und -Tools.

Wechseln Sie im Portal zu Builder>Benutzerdefinierter Agent-Builder. Erstellen oder bearbeiten Sie einen benutzerdefinierten Agent, und wählen Sie unter "Erweiterte Einstellungen" die Option "Tools auswählen" aus. Die Toolauswahl zeigt Tools an, die nach MCP-Verbindung gruppiert sind. Wählen Sie diejenigen aus, die Ihr benutzerdefinierter Agent benötigt.

Listen Sie in YAML jedes Tool anhand des vollständigen Namens auf:

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

Hinzufügen aller Tools von einem MCP-Server (Wildcard)

Wenn ein MCP-Server viele Tools verfügbar macht und ihr benutzerdefinierter Agent alle benötigt, verwenden Sie das Wildcardmuster, anstatt jedes Tool einzeln aufzulisten:

mcp_tools:
  - azure-data-explorer/*

Das {connection-id}/* Muster fügt jedes Tool aus dieser MCP-Verbindung hinzu. Ihr Agent erweitert den Wildcard beim Start. Beispielsweise löst azure-data-explorer/* zu allen Tools auf, die unter einer Verbindung namens azure-data-explorer registriert sind (der vorausgefüllte Standardwert für den Azure MCP mit Kusto-Connector ab der Version 26.4.16.0). Ersetzen Sie den Namen, den Sie Ihrem Connector gegeben haben.

Sie können Wildcards mit einzelnen Toolnamen kombinieren:

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

In der folgenden Tabelle werden die Auswahl einzelner Tools und der Wildcard-Ansatz verglichen.

Warum wird der Wildcard verwendet? Wenn ein MCP-Server neue Tools hinzufügt, nimmt der Wildcard diese automatisch auf, ohne den benutzerdefinierten Agent neu zu konfigurieren. Individuelle Werkzeugauswahl bietet Ihnen präzise Kontrolle. Der Wildcard bietet Ihnen eine automatische Deckung.

Wenn MCP-Tools noch nicht bereit sind

Wenn ein MCP-Server nicht bereit ist, wenn Ihr Agent gestartet wird, kann Ihr Agent nicht auf Tools von diesem Server zugreifen. Ihr Agent behandelt diese Bedingung ordnungsgemäß. Es verzögert benutzerdefinierte Agents mit nicht aufgelösten Wildcards oder fehlenden Tools und lädt sie automatisch, nachdem Ihr Agent die MCP-Verbindung hergestellt hat. Sie müssen keine manuellen Maßnahmen ergreifen.

Weitere Informationen finden Sie unter "Benutzerdefinierte Agents".

Nächster Schritt

Verwandte Inhalte