Kom i gang med den fjernbesluttede MCP-server til Activator (forhåndsvisning)

Ved at bruge den eksterne Model Context Protocol (MCP)-server til Microsoft Fabric Activator kan du gøre det muligt for AI-assistenter at interagere med Activator og oprette overvågningsregler, håndtere advarsler og udløse handlinger – alt sammen gennem naturligt sprog.

For at komme i gang med at bruge den eksterne MCP-server til Activator, følg disse trin:

1. Forbind til den eksterne MCP-server for Activator fra Visual Studio Code eller GitHub Copilot CLI.
2. Konfigurer MCP-klienten med serverens URL og autentificering.
3. Brug GitHub Copilot til at oprette overvågningsregler, håndtere advarsler og udløse handlinger ved hjælp af naturligt sprog.
4. Valider forbindelsen ved at bruge testprompts.

Forudsætninger

Før du opsætter og forespørger MCP-serveren, skal du sikre dig, at du har:

• Visual Studio Code.

• GitHub Copilot i Visual Studio Code.

• En datakildeforbindelse.

• Et Activator-element oprettet i Fabric-arbejdsområdet.

  Bemærk Workspace- og Activator-artefakt-ID'et fra Fabric-objektets URL til konfiguration. URL-formatet er https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact.

Godkendelse

Serveren bruger OAuth. Din MCP-klient skal konfigureres til at erhverve og videregive en gyldig Microsoft Entra ID-token. GitHub Copilot understøtter automatisk denne tokenhåndtering.

Forbindelse til Activator MCP-serveren

Den eksterne MCP-server for Activator fungerer som et HTTP-baseret MCP-endpoint.

URL-adresse til server

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

MCP-klientkonfiguration

Tilføj definitionen for den eksterne MCP-server for Activator til konfigurationsfilen for MCP-klienten (for eksempel mcp.json og Visual Studio Code Copilot indstillinger). I øjeblikket understøttes kun manuel konfiguration.

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

Tilgængelige værktøjer

Activator MCP-serveren eksponerer et sæt værktøjer, som AI-agenter kan bruge til at interagere med Activator. Disse værktøjer bruger agenter til at skabe overvågningsregler, håndtere advarsler og udløse handlinger baseret på realtidsdata.

Regelstyring

Regelstruktur

Hver overvågningsregel har tre kernedele:

• Stream: Definerer , hvilke data der skal overvåges.

  • splitColumn: Gruppering med en kolonne for overvågning pr. enhed, eller lad det stå tomt for global overvågning.
  • filters: Indsnævrer data før detektion (for eksempel kun rækker hvor Region == "EU").

• Detektion: Definerer , hvornår der skal udløses.

  • condition: Overvågningsbetingelsen (for eksempel "temperaturen stiger over 100").
  • occurrence: Hvor ofte betingelsen skal opfyldes (for eksempel "hver gang," "bliver i 5 minutter," "tre gange på 10 minutter").

• Handling: Definerer , hvad der skal gøres, når tilstanden aktiveres (e-mail eller Teams-besked).

Arbejdsområde- og artefakt-ID'er

Når du opretter regler, skal du angive arbejdsområde-ID og artefakt-ID for Aktivator-elementet i din prompt. Disse ID'er er de samme, som bruges i MCP-serverens URL. Assistenten har brug for, at de målretter det korrekte Aktivator-artefakt.

Datakildeforbindelse

Regler har brug for en datakilde. Du kan specificere forbindelsen på to måder:

• Klynge-URL til Azure Data Explorer og Kusto: Angiv klyngens værtsnavn og databasenavn (for eksempel værtsnavn https://mycluster.kusto.windows.net og databaseTelemetryDB).

• Fabric eventhouse: Angiv KQL-database-item-ID og workspace-ID i stedet for en URL.

Eksempler: Opret regler

Eksempelprompt:

"Opret en regel, der overvåger Metrics tabellen i min eventhouse-database TelemetryDB (klynge: https://mycluster.kusto.windows.net). Send mig en e-mail, når alice@contoso.com CPU-forbruget overstiger 90%."

svar:

Forbinder via URL'en til Azure Data Explorer-klyngen og opretter en increasesAbove betingelse i CPU-kolonnen med en e-mailhandling.

Eksempelprompt:

"Forbind til eventhouse KQL-databasen (item ID: aabbccdd-1234-5678-abcd-ef0123456789, workspace: 7855032f-a096-4a01-b6de-806aa26ecb00). Hold øje med SensorReadings bordet. For hver maskine, hvis diskpladsen falder under 10 GB og forbliver sådan i 15 minutter, send en Teams-besked til bob@contoso.com."

svar:

Forbinder via Fabric eventhouse ID'er og bruges splitColumn til per-maskine sporing med en decreasesBelow/andStays detektion.

Eksempelprompt:

"Ved at bruge Heartbeat tabellen i min eventhouse-database MonitoringDB (klynge: https://monitoring.kusto.windows.net), giv mig besked, hvis der ikke er data i 10 minutter."

svar:

Forbinder via Azure Data Explorer-klyngens URL og opretter en heartbeat-regel ved at bruge noPresenceOfData(600).

Eksempelprompt:

"Overvåg AppLogs bordet i mit Fabric eventhouse (item ID: 11223344-aabb-ccdd-eeff-556677889900, arbejdsområde: 7855032f-a096-4a01-b6de-806aa26ecb00). Hvis statuskolonnen ændrer sig til Error mere end tre gange på 5 minutter, så send en e-mail oncall@contoso.com."

svar:

Forbinder via Fabric eventhouse ID'er og bruger changesTo med en everyNthTime(3, 300) occurrence-modifikator.

Eksempler: Administrer regler

Her er nogle eksempler på prompts:

• "Skriv alle reglerne i denne artefakt op."

• "Stop reglen kaldet High CPU Alert."

• "Start alle regler, der i øjeblikket er stoppet."

Begrænsninger

• Kun KQL-datakilder: Du kan oprette regler kun mod KQL-databaser for Kusto (Azure Data Explorer) eller Fabric eventhouses. Andre typer datakilder understøttes ikke i øjeblikket.

• Konfiguration pr. element: MCP-serverens URL gælder for et enkelt Activator-artefakt. For at arbejde med flere artefakter skal du konfigurere en separat MCP-serverpost for hver enkelt.

• Kun Teams og e-mailhandlinger: Regler kan udløse Teams-beskeder eller -mails. Andre handlingstyper, såsom webhooks eller Power Automate flows, er ikke tilgængelige via MCP-serveren.

• Ingen multievent-triggere: Hver regel overvåger en enkelt eventstream. Triggere, der korrelerer på tværs af flere hændelsesstrømme eller tabeller, understøttes ikke.

• Ingen aggregering eller opsummering: Detektionsbetingelser virker på individuelle hændelser. Aggregerede funktioner, såsom gennemsnit, sum eller antal over et vindue, understøttes ikke.

Tip

• Forbind også eventhouse MCP-serveren: Hvis din datakilde er en Fabric eventhouse, forbedrer det resultaterne betydeligt at forbinde eventhouse MCP-serveren sammen med Activator. Din agent kan derefter inspicere dit databaseskema, sample data og validere KQL-forespørgsler, før reglerne oprettes.

• Vær specifik med kolonner: Assistenten skal vide, hvilken datakolonne der skal overvåges. Hvis du er i tvivl, så bed den om at liste skemaet først (hvilket er nemmere med eventhouse MCP-serveren tilsluttet).

• Tilstand versus forandring betyder noget: Brug "stiger over" eller "sænker sig" til engangs overgangsadvarsler. Brug "er over" eller "er under" til gentagne advarsler ved hver matchende begivenhed.

• Brug dynamiske værdier i handlinger: Brug {columnName} i e-mail eller Teams-beskeder til at indsætte live dataværdier. For eksempel kan du bruge "CPU er ved {cpuPercent}%."

Relateret indhold

• Kom i gang med den eksterne MCP-server til eventhouses
• Hvad er Fabric Aktivator?
• Tilføj og administrer MCP-servere i VS Code
• Tilføjelse af MCP-servere til GitHub Copilot CLI