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

Mithilfe des Aktivator-MCP-Servers (Model Context Protocol) können KI-Assistenten mit Fabric Aktivator interagieren, um Überwachungsregeln zu erstellen, Warnungen zu verwalten und Aktionen auszulösen – alles über natürliche Sprache.

Erste Schritte

Führen Sie die folgenden Schritte aus, um mit der MCP-Fernintegration mit dem Aktivator zu starten:

1. Verbinden Sie sich mit dem Remote-Activator-MCP-Server über Visual Studio Code oder GitHub Copilot CLI.
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
• Überprüfen Sie die Tipps.

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.

Verbinden mit dem Aktivator-MCP-Server

Der Remoteaktivator-MCP-Server fungiert als HTTP-basierter MCP-Endpunkt.

Server-URL

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>

MCP-Clientkonfiguration

Fügen Sie der MCP-Clientkonfigurationsdatei (z. B. mcp.json, Visual Studio Code Copilot Einstellungen usw.) die MCP-Serverdefinition des Remoteaktivators hinzu. 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-Agents können Überwachungsregeln erstellen, Warnungen verwalten und Aktionen basierend auf Echtzeitdaten auslösen.

Regelverwaltung

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: Der Überwachungszustand (z. B. erhöht sich die Temperatur ü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:

• ADX/Kusto-Cluster-URL: Geben Sie den Clusterhostnamen und den Datenbanknamen an (z https://mycluster.kusto.windows.net. B. , Datenbank TelemetryDB).

• 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 eine Verbindung über die ADX-Cluster-URL her und erstellt eine increasesAbove Bedingung in der CPU-Spalte mit einer E-Mail-Aktion.

Beispiel-Prompt:

"Herstellen einer Verbindung mit der Eventhouse-KQL-Datenbank (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 eine Verbindung über Fabric Eventhouse-IDs her, verwendet splitColumn für die Nachverfolgung pro Gerät mit einer decreasesBelow / andStays Erkennung.

Beispiel-Prompt:

Verwenden Sie die Heartbeat-Tabelle in meiner Eventhouse-Datenbank MonitoringDB (Cluster: https://monitoring.kusto.windows.net) und benachrichtigen Sie mich, wenn für 10 Minuten keine Daten vorliegen.

Antwort:

Stellt eine Verbindung mithilfe der ADX-Cluster-URL her und erstellt eine Herzschlagregel mithilfe von noPresenceOfData(600).

Beispiel-Prompt:

"Überwachen Sie die Tabelle AppLogs in meinem Fabric Eventhouse (Element-ID: 11223344-aabb-ccdd-eeff-556677889900, Arbeitsbereich: 7855032f-a096-4a01-b6de-806aa26ecb00). Wenn sich die Statusspalte mehr als dreimal innerhalb von 5 Minuten in "Fehler" ä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) Vorkommensmodifikator.

Beispiele: Verwalten von Regeln

Beispielaufforderungen:

• "Alle Regeln in diesem Artefakt auflisten"

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

• Starten Sie alle Regeln, die derzeit gestoppt sind

Einschränkungen

• KQL-Datenquellen nur: Sie können nur Regeln für Kusto(ADX)- oder Fabric Eventhouse-KQL-Datenbanken erstellen. Andere Datenquellentypen 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 Microsoft-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 Ihre Datenquelle ein Fabric Eventhouse ist, verbessert das Verbinden des Eventhouse MCP-Servers zusammen mit Aktivator die Ergebnisse erheblich. Ihr Agent kann dann Ihr Datenbankschema, Beispieldaten und KQL-Abfragen überprüfen, bevor Regeln erstellt werden.

• Seien Sie präzise bei den Angaben zu den Spalten. Der Assistent muss wissen, welche Datenspalte überwacht werden soll. Wenn Sie sich nicht sicher sind, bitten Sie es, zuerst das Schema aufzulisten (was mit dem mit dem Eventhouse MCP-Server verbundenen Server einfacher ist).

• Zustand versus Veränderung. Verwenden Sie "steigt über" oder "fällt unter" für einmalige Übergangsalarme. Verwenden Sie "is above" oder "is below" für wiederholte Warnungen für jedes übereinstimmende Ereignis.

• Dynamische Werte in Aktionen. Verwenden Sie {columnName} in E-Mail- oder Teams-Nachrichtentexten, um Livedatenwerte einzufügen. Beispiel: "CPU is at {cpuPercent}%".

Verwandte Inhalte

• Eventhouse MCP-Server
• Was ist Fabric Aktivator? Transformieren von Datenströmen in automatisierte Aktionen
• Erfahren Sie mehr über die Nutzung von MCP-Servern in Visual Studio Code.
• Hinzufügen von MCP-Servern für GitHub Copilot CLI.