Comece com o servidor MCP remoto para o Ativador (pré-visualização)

Ao utilizar o servidor Activator MCP (Model Context Protocol), os assistentes de IA podem interagir com o Fabric Activator para criar regras de monitorização, gerir alertas e desencadear ações — tudo através de linguagem natural.

Introdução

Para começar com a integração remota MCP do Activator, siga estes passos:

  1. Ligue-se ao servidor remoto Activator MCP a partir do Visual Studio Code ou GitHub Copilot CLI.
  2. Configure o cliente MCP com a URL do servidor e a autenticação.
  3. Use o GitHub Copilot para criar regras de monitorização, gerir alertas e desencadear ações usando linguagem natural.
  4. Valida a ligação usando prompts de teste.

Pré-requisitos

Antes de configurar e consultar o servidor MCP, certifique-se de que tem:

  • Visual Studio Code.
  • GitHub Copilot em Visual Studio Code.
  • Uma ligação de fonte de dados.
  • Um item Ativador criado no espaço de trabalho Fabric.
    • Note o ID do artefacto do Workspace e do Ativador a partir da URL do item Fabric para configuração.
    • O formato URL é https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact
  • Veja as dicas.

Authentication

O servidor usa o OAuth. O seu cliente MCP deve estar configurado para adquirir e passar um token Microsoft Entra ID válido. O GitHub Copilot suporta automaticamente este tratamento de tokens.

Liga-te ao Servidor MCP do Ativador

O servidor MCP remoto Activator atua como um endpoint MCP baseado em HTTP.

URL do servidor

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>
Parâmetro Descrição
Workspace ID ID do espaço de trabalho Fabric (UUID)
Artifact ID O ID de artefacto do Ativador (reflexo) (UUID).

Configuração do Cliente MCP

Adicione a definição remota do servidor MCP do Ativador ao ficheiro de configuração do cliente MCP (por exemplo, mcp.json, as definições do Visual Studio Code Copilot, etc.). Atualmente, apenas a configuração manual é suportada.

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

Ferramentas disponíveis

O servidor MCP do Activator expõe um conjunto de ferramentas que os agentes de IA podem usar para interagir com o Activator. Estas ferramentas permitem criar regras de monitorização, gerir alertas e desencadear ações com base em dados em tempo real.

Gestão de regras

Tool Descrição
create_rule Crie uma regra de monitorização que observe um fluxo de dados e desencadeie ações (email, mensagem do Teams) quando as condições são cumpridas. Suporta funções numéricas, de texto, booleanas e de deteção de batimentos cardíacos com modificadores de ocorrência configuráveis. A regra começa automaticamente.
list_rules Liste todas as regras definidas num artefacto Ativador.
start_rule Comece (ativa) uma regra para que comece a monitorizar.
stop_rule Desativar (parar) uma regra em execução.

Estrutura das regras

Cada regra de monitorização tem três partes principais:

  • Stream: Define quais dados monitorizar.

    • splitColumn: Agrupar por uma coluna para monitorização por entidade, ou deixar vazio para monitorização global.
    • filters: Dados estreitos antes da deteção (por exemplo, apenas linhas onde Region == "EU").

  • Deteção: Define quando ser acionado.

    • condition: A condição de monitorização (por exemplo, aumento de temperatura acima de 100).
    • occurrence: Com que frequência a condição deve ser cumprida (por exemplo, todas as vezes, permanece durante 5 minutos, três vezes em 10 minutos).

  • Ação: Define o que fazer quando a condição é ativada (email ou mensagem Teams).

Identificadores de espaço de trabalho e artefactos

Quando criares regras, fornece o ID do espaço de trabalho e o ID do artefacto do item Ativador no teu prompt. Estes IDs são os mesmos usados na URL do servidor MCP. O assistente precisa que eles alvejem o artefacto Ativador correto.

Ligação à fonte de dados

As regras precisam de uma fonte de dados. Pode especificar a ligação de duas formas:

  • URL do cluster ADX / Kusto: forneça o nome do host do cluster e o nome da base de dados (por exemplo, https://mycluster.kusto.windows.net, base de dados TelemetryDB).

  • Fabric Eventhouse: forneça o ID do item da base de dados KQL e o ID do espaço de trabalho em vez de um URL.

Exemplos: Criar regras

Pedido de exemplo:

"Crie uma regra que monitorize a Metrics tabela na minha base de dados TelemetryDB Eventhouse (cluster: https://mycluster.kusto.windows.net). Envia-me um e-mail quando o uso da CPU ultrapassar os 90%.

Resposta:

Liga-se através do URL do cluster ADX e cria uma condição increasesAbove na coluna da CPU com uma ação de e-mail.

Pedido de exemplo:

"Liga-te à base de dados Eventhouse KQL (ID do item: aabbccdd-1234-5678-abcd-ef0123456789, espaço de trabalho: 7855032f-a096-4a01-b6de-806aa26ecb00). Monitoriza a SensorReadings tabela. Para cada máquina, se o espaço em disco cair abaixo dos 10 GB e permanecer assim durante 15 minutos, envie uma mensagem do Teams para bob@contoso.com."

Resposta:

Liga-se através de ID's do Fabric Eventhouse e usa splitColumn para rastreamento por máquina com uma deteção decreasesBelow / andStays.

Pedido de exemplo:

Usando a tabela Heartbeat na minha base de dados Eventhouse MonitoringDB (cluster: https://monitoring.kusto.windows.net), avisa-me se não houver dados por 10 minutos.

Resposta:

Liga-se através do URL do cluster ADX e cria uma regra heartbeat usando noPresenceOfData(600).

Pedido de exemplo:

"Monitorizar a tabela AppLogs no meu Fabric Eventhouse (ID do item: 11223344-aabb-ccdd-eeff-556677889900, espaço de trabalho: 7855032f-a096-4a01-b6de-806aa26ecb00). Se a coluna de estado mudar para 'Erro' mais de três vezes em 5 minutos, envie um email oncall@contoso.com."

Resposta:

Liga-se por meio de IDs Fabric Eventhouse e usa changesTo com um modificador de ocorrência everyNthTime(3, 300).

Exemplos: Regras de gestão

Exemplos de prompts:

  • "Lista todas as regras deste artefacto"

  • Pare a regra chamada 'Alerta de CPU Alta'

  • Inicie todas as regras que estão atualmente paradas

Limitações

  • Apenas fontes de dados KQL: Só pode criar regras contra bases de dados KQL do Kusto (ADX) ou do Fabric Eventhouse. Outros tipos de fontes de dados não são atualmente suportados.

  • Configuração por item: A URL do servidor MCP aplica-se a um único artefacto Ativador. Para trabalhar com múltiplos artefactos, tens de configurar uma entrada separada do servidor MCP para cada um.

  • Apenas Teams e ações de email: As regras podem ativar mensagens do Microsoft Teams ou emails. Outros tipos de ação, como webhooks ou fluxos do Power Automate, não estão disponíveis através do servidor MCP.

  • Sem gatilhos multievento: Cada regra monitoriza um único fluxo de eventos. Não são suportados gatilhos que se correlacionem com vários fluxos de eventos ou tabelas.

  • Sem agregação ou resumo: As condições de deteção aplicam em eventos individuais. Funções agregadas, como média, soma ou contagem sobre uma janela, não são suportadas.

Sugestões

  • Liga também o servidor MCP da Eventhouse. Se a sua fonte de dados for uma Fabric Eventhouse, ligar o servidor MCP Eventhouse juntamente com o Ativador melhora significativamente os resultados. O seu agente pode então inspecionar o esquema da sua base de dados, amostrar dados e validar consultas KQL antes de criar regras.

  • Seja específico quanto às colunas. O assistente precisa de saber que coluna de dados deve monitorizar. Se tiveres dúvidas, pede-lhe para listar primeiro o esquema (o que é mais fácil com o servidor MCP do Eventhouse ligado).

  • Estado vs. mudança importam. Use "sobe acima" ou "desce abaixo" para alertas de transição pontuais. Use "está acima" ou "está abaixo" para alertas repetidos em cada evento correspondente.

  • Valores dinâmicos nas ações. Utilize {columnName} nos corpos das mensagens de email ou do Teams para inserir valores de dados em tempo real. Por exemplo, "CPU is at {cpuPercent}%".

Conteúdo relacionado

  • Last updated on