Kom i gang med den eksterne MCP-server til Eventhouse (forhåndsvisning)

Lær at bruge en fjern Model Context Protocol (MCP) til eventhouse til at udføre KQL-forespørgsler. Eventhouse-fjern-MCP-serveren tillader AI-agenter at forespørge, ræsonnere og handle på realtidsdata i RTI-eventhuset. Dette er en hosted MCP, hvor du konfigurerer en URL, der peger til Eventhouse. Der er ikke behov for at installere eller udrulle noget.

Eventhouse fjern-MCP gør det muligt for AI-agenter at forespørge Eventhouse ved hjælp af naturligt sprog. Gennem Model Context Protocol (MCP) kan AI-assistenter:

• Opdag KQL-databaseskemaer og metadata dynamisk.
• Generer KQL-forespørgsler for at forespørge og analysere data i KQL-databaser.
• Brug naturlige sprogforespørgsler, der bliver oversat til KQL-forespørgsler.
• Returner indsigter via realtids- og historiske data.
• Eksempeldata.

Denne funktion gør det muligt for Copilot og brugerdefinerede AI-agenter at interagere sikkert med dit eventhouse. Cloud-agentplatforme kan forbruge disse agenter.

Kom i gang

For at komme i gang med den fjernbaserede Eventhouse MCP-integration, følg disse trin:

1. Forbind til Eventhouse MCP Server fra Visual Studio Code eller GitHub Copilot CLI.

2. Start Eventhouse MCP-serveren.

3. Brug GitHub Copilot til at køre forespørgsler

Forudsætninger

• Visual Studio Code.

• GitHub Copilot i VS Code.

• En workspace med en Microsoft Fabric-aktiveret kapacitet.

• Aktiver Copilot i Fabric for at gøre det muligt for MCP-serveren at hente databaseskemaet. Ellers kan den kun udføre KQL-forespørgsler.

• Et Eventhouse med KQL-databasetabeller.

  • Læse- eller forespørgselstilladelser til KQL-databasen.
  • MCP Server URI til konfiguration. Se Find MCP-serverens URI.

Forbind til Eventhouse MCP-serveren

Eventhouse MCP-serveren fungerer som et HTTP-baseret MCP-endpoint. Tilføj den eksterne MCP-serverdefinition til MCP-klientens konfigurationsfil. I øjeblikket understøttes kun manuel konfiguration.

1. Åbn MCP-klientens konfigurationsfil.

   I VS Code er konfigurationsfilen typisk placeret på .vscode/mcp.json, eller i din brugerprofil. For mere information, se VS Code MCP-konfigurationsreference.

2. Tilføj Eventhouse MCP-serverens URL til MCP-klientens konfigurationsfil. Find MCP-serverens URI og se eksempelkonfigurationen af MCP-klienten.

Find MCP-serverens URI

1. Log ind på Fabric-portalen.

2. Navigér til arbejdsområdet, der indeholder dit Eventhouse.

3. Vælg KQL-databasen.

4. Fra sektionenOversigt over > vælg Kopier URI ved siden af MCP Server URI.

   

Eksempel på MCP-klientkonfiguration

{
  "servers": {
    "eventhouse-remote": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/11112222-bbbb-3333-cccc-4444dddd5555/items/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/kqlEndpoint"
    },
    "kql-global": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/kqlEndpoint"
    }
  }
}

Tilgængelige værktøjer

Eventhouse MCP-serveren eksponerer et sæt værktøjer, som AI-agenter kan bruge til at interagere med Eventhouse og dets KQL-databaser. Disse værktøjer gør det muligt for agenter at opdage KQL-databaseskemaer, generere KQL-forespørgsler fra naturligt sprog, udføre forespørgsler og sample data.

Når du bruger det globale endepunkt (som vist i eksemplet kql-global ovenfor), skal du give både workspaceId og itemId i hvert værktøjskald.

Værktøjer i Public MCP Server understøtter valgfrie clusterUrl og databaseName parametre. Når begge parametre er angivet, kører anmodningen mod den specificerede Azure Data Explorer-klynge og database, og Fabric-elementet bruges kun til at måle AI-forbrug mod din Fabric-kapacitet.

Test forbindelsen

Når det er konfigureret, skal du tjekke at opsætningen virker.

Start Eventhouse MCP-serveren

1. Start Eventhouse MCP-serveren i Visual Studio Code.

2. Autentificér til MCP-serveren med en legitimationsoplysninger, der har adgang til Eventhouse.

3. Sørg for, at Eventhouse MCP-serverens status vises som Kørende.

Brug GitHub Copilot til at køre forespørgsler

1. Åbn GitHub Copilot Chat vindue i VS Code.

2. Aktiver agenttilstand.

3. Stil for eksempel et spørgsmål:

   • Hvilke borde er der i #eventhouse-remote? (brug det fjernnavn, du har angivet i mcp.json-filen).
   • Analyser dataene i StormEvents-tabellen og vis de mest skadelige stormbegivenheder

4. Gennemgå svaret fra Copilot.

Lokalisere fejl

Hvis du støder på problemer:

• Kontroller at MCP-serveren er forbundet i Visual Studio Code eller GitHub Copilot CLI.
• Sørg for, at din MCP-vært understøtter fjern-HTTP MCP-servere.
• Bekræft, at du har tilstrækkelige tilladelser i Eventhouse-databasen. Se Forudsætninger.
• Godkend igen, hvis du bliver bedt om det.

Eksempel: Analyser dine data

Eksempelprompt:

'Jeg har data om brugerudførte kommandoer i ProcessEvents-tabellen. Tag et par rækker og klassificer de udførte kommandoer med en trusselstolerance på lav/middel/høj, og giv et tabelagtigt overblik over det samlede resumé.'

Svar:

Relateret indhold

• Hvad er den Fabric RTI MCP Server (preview)?
• Kom i gang med den fjernbesluttede MCP-server til Activator (forhåndsvisning)
• Lær mere om at bruge Brug af MCP-servere i Visual Studio Code.
• Tilføjelse af MCP-servere til GitHub Copilot CLI.