Introduzione al server MCP remoto per Activator (anteprima)

Usando il server MCP (Remote Model Context Protocol) per Microsoft Fabric Activator, è possibile abilitare gli assistenti di intelligenza artificiale per interagire con Activator e creare regole di monitoraggio, gestire avvisi e attivare azioni, tutto attraverso il linguaggio naturale.

Per iniziare a usare il server MCP remoto per Activator, seguire questa procedura:

  1. Connetti Activator al server MCP remoto da Visual Studio Code o dalla CLI di GitHub Copilot.
  2. Configurare il client MCP con l'URL del server e l'autenticazione.
  3. Usare GitHub Copilot per creare regole di monitoraggio, gestire avvisi e attivare azioni usando il linguaggio naturale.
  4. Convalidare la connessione usando richieste di test.

Prerequisiti

Prima di configurare ed eseguire una query sul server MCP, assicurarsi di disporre di:

  • Codice di Visual Studio.

  • GitHub Copilot in Visual Studio Code.

  • Connessione all'origine dati.

  • Elemento Activator creato nell'area di lavoro Fabric.

    Prendere nota dell'ID dell'Area di lavoro e dell'Activator dall'URL dell'oggetto Fabric per la configurazione. Il formato dell'URL è https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact.

Autenticazione

Il server usa OAuth. Il client MCP deve essere configurato per acquisire e passare un token di Microsoft Entra ID valido. GitHub Copilot supporta automaticamente questa gestione dei token.

Connessione al server MCP di Activator

Il server MCP remoto per Activator funge da endpoint MCP basato su HTTP.

URL del server

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>
Parametro Descrizione
Workspace ID ID dell'area di lavoro Fabric (UUID)
Artifact ID ID dell'artefatto Activator (reflex) (UUID)

Configurazione del client MCP

Aggiungere la definizione del server MCP remoto di Activator al file di configurazione del client MCP, ad esempio mcp.json e le impostazioni di Copilot di Visual Studio Code. Attualmente è supportata solo la configurazione manuale.

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

Strumenti disponibili

Il server MCP Activator espone un set di strumenti che gli agenti di intelligenza artificiale possono usare per interagire con Activator. Questi strumenti usano agenti per creare regole di monitoraggio, gestire gli avvisi e attivare azioni in base ai dati in tempo reale.

Gestione regole

Strumento Descrizione
create_rule Creare una regola di monitoraggio che controlla un flusso di dati e attiva azioni (posta elettronica, Microsoft Teams messaggio) quando vengono soddisfatte le condizioni. La regola supporta funzioni di rilevamento numerico, testuale, booleano e heartbeat con modificatori di occorrenza configurabili. Viene avviato automaticamente.
list_rules Elencare tutte le regole definite in un artefatto Activator.
start_rule Avviare (abilitare) una regola in modo che inizi il monitoraggio.
stop_rule Sospendere (disabilitare) una regola in esecuzione.

Struttura delle regole

Ogni regola di monitoraggio ha tre parti principali:

  • Stream: definisce i dati da monitorare.

    • splitColumn: raggruppare in base a una colonna per il monitoraggio per entità o lasciare vuoto per il monitoraggio globale.
    • filters: restringere i dati prima del rilevamento (ad esempio, solo le righe in cui Region == "EU").

  • Rilevamento: definisce quando attivare.

    • condition: condizione di monitoraggio (ad esempio, "la temperatura aumenta oltre 100").
    • occurrence: frequenza con cui deve essere soddisfatta la condizione (ad esempio, "ogni volta", "rimane per 5 minuti", "tre volte in 10 minuti").

  • Azione: definisce le operazioni da eseguire quando la condizione viene attivata (messaggio di posta elettronica o di Teams).

ID degli spazi di lavoro e degli artefatti

Quando si creano regole, specificare l'ID dell'area di lavoro e l'ID artefatto dell'elemento Activator nel prompt. Questi ID sono gli stessi usati nell'URL del server MCP. L'assistente deve avere come destinazione l'artefatto Activator corretto.

Connessione all'origine dati

Le regole necessitano di un'origine dati. È possibile specificare la connessione in due modi:

  • URL del cluster di Esplora dati di Azure e Kusto: specifica il nome host del cluster e il nome del database, ad esempio, nome host https://mycluster.kusto.windows.net e database TelemetryDB.

  • Fabric eventhouse: specificare l'ID elemento del database KQL e l'ID dell'area di lavoro anziché un URL.

Esempi: Creare regole

Richiesta di esempio:

Crea una regola che monitora la tabella Metrics nel mio database eventhouse TelemetryDB (cluster: https://mycluster.kusto.windows.net). Inviami un messaggio di posta elettronica quando alice@contoso.com l'utilizzo della CPU aumenta oltre i 90%".

Risposta:

Si connette tramite l'URL del cluster Esplora dati di Azure e crea una condizione increasesAbove sulla colonna CPU con un'azione e-mail.

Richiesta di esempio:

"Connettersi al database KQL dell'eventhouse (ID elemento: aabbccdd-1234-5678-abcd-ef0123456789, area di lavoro: 7855032f-a096-4a01-b6de-806aa26ecb00). Monitorare la SensorReadings tabella. Per ogni computer, se lo spazio su disco scende al di sotto di 10 GB e rimane così per 15 minuti, inviare un messaggio di Teams a bob@contoso.com".

Risposta:

Si collega tramite gli ID di Eventhouse di Fabric e usa splitColumn per il monitoraggio per macchina con rilevamento decreasesBelow/andStays.

Richiesta di esempio:

Utilizzando la tabella Heartbeat nel mio database eventhouse MonitoringDB (cluster: https://monitoring.kusto.windows.net), avvisami se non ci sono dati per 10 minuti.

Risposta:

Si connette tramite l'URL del cluster Esplora dati di Azure e crea una regola heartbeat usando noPresenceOfData(600).

Richiesta di esempio:

Monitora la tabella AppLogs nel mio Eventhouse di Fabric (ID elemento: 11223344-aabb-ccdd-eeff-556677889900, area di lavoro: 7855032f-a096-4a01-b6de-806aa26ecb00). Se la colonna di stato passa a Error più di tre volte in 5 minuti, inviare un messaggio di posta elettronica oncall@contoso.com".

Risposta:

Si connette tramite gli ID di Fabric Eventhouse e usa changesTo con un modificatore di occorrenza everyNthTime(3, 300).

Esempi: Gestire le regole

Ecco alcuni prompt di esempio:

  • "Elencare tutte le regole in questo artefatto".

  • "Arrestare la regola denominata High CPU Alert".

  • Avvia tutte le regole attualmente fermate.

Limitazioni

  • Solo le origini dati KQL: è possibile creare regole solo per i database KQL di Kusto (Esplora dati di Azure) o per gli eventhouse di Fabric. Altri tipi di origini dati non sono attualmente supportati.

  • Configurazione per elemento: l'URL del server MCP si applica a un singolo elemento Activator. Per usare più artefatti, è necessario configurare una voce di configurazione separata del server MCP per ciascuno di essi.

  • Solo azioni di Teams e posta elettronica: le regole possono attivare messaggi o messaggi di posta elettronica di Teams. Altri tipi di azione, ad esempio webhook o flussi di Power Automate, non sono disponibili tramite il server MCP.

  • Nessun trigger multievento: Ogni regola monitora un singolo flusso di eventi. I trigger correlati tra più flussi di eventi o tabelle non sono supportati.

  • Nessuna aggregazione o riepilogo: le condizioni di rilevamento operano su singoli eventi. Le funzioni di aggregazione, ad esempio media, somma o conteggio in una finestra, non sono supportate.

Suggerimenti

  • Connettere anche il server MCP dell'eventhouse: se l'origine dati è una Fabric eventhouse, connettere il server MCP dell'eventhouse insieme a Activator migliora significativamente i risultati. L'agente può quindi esaminare lo schema del database, i dati di esempio e convalidare le query KQL prima di creare regole.

  • Specificare le colonne: l'assistente deve conoscere la colonna di dati da monitorare. Se non sei sicuro, chiedigli prima di elencare lo schema (operazione più semplice con il server MCP di Eventhouse connesso).

  • Lo stato e le modifiche sono importanti: usare "aumenta al di sopra" o "scende sotto" per gli avvisi di transizione una tantum. Utilizzare "è sopra" o "è sotto" per avvisi ripetuti ad ogni evento corrispondente.

  • Usare i valori dinamici nelle azioni: usare {columnName} nei corpi dei messaggi di Posta elettronica o Teams per inserire valori di dati in tempo reale. Ad esempio, usa "La CPU è a {cpuPercent}%."

Contenuti correlati

  • Last updated on