Erste Schritte mit dem Remote-MCP-Server für Aktivierer (Vorschau)

Mithilfe des Remotemodellkontextprotokollservers (MCP) für Microsoft Fabric Aktivator können Sie KI-Assistenten für die Interaktion mit dem Aktivator aktivieren und Überwachungsregeln erstellen, Warnungen verwalten und Aktionen auslösen – alles über natürliche Sprache.

Führen Sie die folgenden Schritte aus, um mit der Verwendung des Remote-MCP-Servers für aktivator zu beginnen:

  1. Stellen Sie aus Visual Studio Code oder der GitHub Copilot CLI eine Verbindung mit dem Remote-MCP-Server für Activator her.
  2. Konfigurieren Sie den MCP-Client mit der Server-URL und Authentifizierung.
  3. Verwenden Sie GitHub Copilot, um Überwachungsregeln zu erstellen, Warnungen zu verwalten und Aktionen mithilfe natürlicher Sprache auszulösen.
  4. Überprüfen Sie die Verbindung mithilfe von Testaufforderungen.

Voraussetzungen

Bevor Sie den MCP-Server einrichten und abfragen, stellen Sie sicher, dass Sie folgendes haben:

  • Visual Studio Code.

  • GitHub Copilot in Visual Studio Code.

  • Eine Datenquellenverbindung.

  • Ein Aktivatorelement, das im Fabric Arbeitsbereich erstellt wurde.

    Beachten Sie die Arbeitsbereichs- und Aktivatorartefakt-ID aus der Fabric Element-URL für die Konfiguration. Das URL-Format ist https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact.

Authentifizierung

Der Server verwendet OAuth. Ihr MCP-Client muss so konfiguriert sein, dass ein gültiges Microsoft Entra ID-Token abgerufen und übergeben wird. GitHub Copilot unterstützt diese Tokenbehandlung automatisch.

Verbindung mit dem Aktivator MCP-Server

Der Remote-MCP-Server für Aktivator fungiert als HTTP-basierter MCP-Endpunkt.

Server-URL

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>
Parameter Beschreibung
Workspace ID Die Fabric-Arbeitsbereichs-ID (UUID)
Artifact ID Die Aktivatorartefakt-ID (Reflex-ID) (UUID)

MCP-Clientkonfiguration

Fügen Sie die Definition für den Remote-MCP-Server für Activator in der Konfigurationsdatei für den MCP-Client hinzu (zum Beispiel mcp.json und die Einstellungen von Visual Studio Code Copilot). Derzeit wird nur die manuelle Konfiguration unterstützt.

{
  "servers": {
    "activator": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>"
    }
  }
}

Verfügbare Tools

Der Aktivator-MCP-Server macht eine Reihe von Tools verfügbar, mit denen KI-Agents mit Aktivator interagieren können. Diese Tools verwenden Agents, um Überwachungsregeln zu erstellen, Warnungen zu verwalten und Aktionen basierend auf Echtzeitdaten auszulösen.

Regelverwaltung

Werkzeug Beschreibung
create_rule Erstellen Sie eine Überwachungsregel, die einen Datenstrom überwacht und Aktionen (E-Mail, Microsoft Teams Nachricht) auslöst, wenn Bedingungen erfüllt sind. Die Regel unterstützt numerische Funktionen, Textfunktionen, boolesche Funktionen und Heartbeat-Erkennungsfunktionen mit konfigurierbaren Auftretensmodifikatoren. Wird automatisch gestartet.
list_rules Listet alle Regeln auf, die in einem Aktivatorartefakt definiert sind.
start_rule Starten (aktivieren) Sie eine Regel, sodass sie mit der Überwachung beginnt.
stop_rule Beenden (Deaktivieren) einer ausgeführten Regel.

Regelstruktur

Jede Überwachungsregel weist drei Kernkomponenten auf:

  • Stream: Definiert , welche Daten überwacht werden sollen.

    • splitColumn: Gruppieren Sie nach einer Spalte für die Überwachung pro Entität oder lassen Sie das Feld leer für die globale Überwachung.
    • filters: Schmale Daten vor der Erkennung (z. B. nur Zeilen, bei denen Region == "EU").

  • Erkennung: Definiert , wann ausgelöst werden soll.

    • condition: Die Überwachungsbedingung (zum Beispiel „die Temperatur steigt über 100“).
    • occurrence: Wie oft die Bedingung erfüllt werden muss (z. B. "jedes Mal", "bleibt für 5 Minuten", "dreimal in 10 Minuten").

  • Aktion: Definiert , was zu tun ist, wenn die Bedingung ausgelöst wird (E-Mail- oder Teams-Nachricht).

Arbeitsbereichs- und Artefakt-IDs

Wenn Sie Regeln erstellen, geben Sie die Arbeitsbereichs-ID und Artefakt-ID des Aktivatorelements in Ihrer Eingabeaufforderung an. Diese IDs sind dieselben, die in der MCP-Server-URL verwendet werden. Der Assistent benötigt sie, um das richtige Aktivierungsartefakt ins Visier zu nehmen.

Datenquellenverbindung

Regeln benötigen eine Datenquelle. Sie können die Verbindung auf zwei Arten angeben:

  • Cluster-URL für Azure Data Explorer und Kusto: Geben Sie den Hostnamen und den Datenbanknamen des Clusters an (z. B. Hostname https://mycluster.kusto.windows.net und DatenbankTelemetryDB).

  • Fabric Eventhouse: Geben Sie anstelle einer URL die KQL-Datenbankelement-ID und die Arbeitsbereichs-ID an.

Beispiele: Erstellen von Regeln

Beispiel-Prompt:

"Erstellen Sie eine Regel, die die Metrics Tabelle in meiner Eventhouse-Datenbank TelemetryDB überwacht (Cluster: https://mycluster.kusto.windows.net). Senden Sie mir eine E-Mail an alice@contoso.com, wenn die CPU-Auslastung über 90% steigt.

Antwort:

Stellt über die Cluster-URL von Azure Data Explorer eine Verbindung her und erstellt eine increasesAbove Bedingung für die CPU-Spalte mit einer E-Mail-Aktion.

Beispiel-Prompt:

"Stellen Sie eine Verbindung mit der KQL-Datenbank des Eventhouse her (Element-ID: aabbccdd-1234-5678-abcd-ef0123456789, Arbeitsbereich: 7855032f-a096-4a01-b6de-806aa26ecb00). Überwachen Sie die SensorReadings Tabelle. Wenn der Speicherplatz für jeden Computer unter 10 GB fällt und für 15 Minuten auf diese Weise bleibt, senden Sie eine Teams-Nachricht an bob@contoso.com."

Antwort:

Stellt über Fabric Eventhouse-IDs eine Verbindung her und verwendet splitColumn für die Nachverfolgung pro Maschine mit einer decreasesBelow/andStays-Erkennung.

Beispiel-Prompt:

Mithilfe der Heartbeat Tabelle in meiner eventhouse-Datenbank MonitoringDB (Cluster: https://monitoring.kusto.windows.net), benachrichtige mich, wenn 10 Minuten lang keine Daten vorhanden sind.

Antwort:

Stellt über die Azure Data Explorer-Cluster-URL eine Verbindung her und erstellt mithilfe von noPresenceOfData(600) eine Heartbeat-Regel.

Beispiel-Prompt:

"Überwachen Sie die AppLogs Tabelle in meinem Fabric Eventhouse (Element-ID: 11223344-aabb-ccdd-eeff-556677889900, Arbeitsbereich: 7855032f-a096-4a01-b6de-806aa26ecb00). Wenn sich die Statusspalte innerhalb von 5 Minuten mehr als dreimal in Error ändert, senden Sie eine E-Mail an oncall@contoso.com.

Antwort:

Verbindet sich über Fabric Eventhouse-IDs und verwendet changesTo mit einem everyNthTime(3, 300) Auftretensmodifikator.

Beispiele: Verwalten von Regeln

Hier sind einige Beispielaufforderungen:

  • "Alle Regeln in diesem Artefakt auflisten."

  • "Beenden Sie die Regel mit dem Namen "Hohe CPU-Warnung".

  • "Alle Regeln starten, die zurzeit beendet sind."

Einschränkungen

  • Nur KQL-Datenquellen: Sie können Regeln nur für KQL-Datenbanken für Kusto (Azure Data Explorer) oder Fabric Eventhouses erstellen. Andere Arten von Datenquellen werden derzeit nicht unterstützt.

  • Konfiguration pro Element: Die MCP-Server-URL gilt für ein einzelnes Aktivatorartefakt. Um mit mehreren Artefakten zu arbeiten, müssen Sie einen separaten MCP-Servereintrag für jeden konfigurieren.

  • Nur Teams- und E-Mail-Aktionen: Regeln können Teams-Nachrichten oder E-Mails auslösen. Andere Aktionstypen, wie Webhooks oder Power Automate-Flows, sind nicht über den MCP-Server verfügbar.

  • Keine Multievent-Trigger: Jede Regel überwacht einen einzelnen Ereignisstream. Trigger, die über mehrere Ereignisdatenströme oder Tabellen korrelieren, werden nicht unterstützt.

  • Keine Aggregation oder Zusammenfassung: Erkennungsbedingungen funktionieren für einzelne Ereignisse. Aggregatfunktionen wie Mittelwert, Summe oder Anzahl über einem Fenster werden nicht unterstützt.

Tipps

  • Verbinden Sie auch den Eventhouse MCP-Server: Wenn Es sich bei Ihrer Datenquelle um ein Fabric Eventhouse handelt, verbessert die Verbindung des Eventhouse MCP-Servers zusammen mit Activator die Ergebnisse erheblich. Ihr Agent kann dann Ihr Datenbankschema, Beispieldaten und KQL-Abfragen überprüfen, bevor Regeln erstellt werden.

  • Achten Sie auf Spalten: Der Assistent muss wissen, welche Datenspalte überwacht werden soll. Wenn Sie sich nicht sicher sind, bitten Sie das System, zunächst das Schema aufzulisten (was einfacher ist, wenn der Eventhouse-MCP-Server verbunden ist).

  • Status im Vergleich zu Änderungsfragen: Verwenden Sie "steigt über" oder "fällt unten" für einmalige Übergangswarnungen. Verwenden Sie "is above" oder "is below" für wiederholte Warnungen für jedes übereinstimmende Ereignis.

  • Verwenden Sie dynamische Werte in Aktionen: Verwenden Sie{columnName} in E-Mail- oder Teams-Nachrichtentexten, um Livedatenwerte einzufügen. Verwenden Sie z. B. „CPU liegt bei {cpuPercent}%.“

Verwandte Inhalte

  • Last updated on