Introdução ao servidor MCP remoto para Ativador (versão prévia)

Usando o servidor Activator MCP (Protocolo de Contexto de Modelo), os assistentes de IA podem interagir com Fabric Activator para criar regras de monitoramento, gerenciar alertas e disparar ações, tudo por meio da linguagem natural.

Introdução

Para começar a usar a integração remota do MCP do Activator, siga estas etapas:

  1. Conecte-se ao servidor Activator MCP remoto através do Visual Studio Code ou GitHub Copilot CLI.
  2. Configure o cliente MCP com a URL e a autenticação do servidor.
  3. Use GitHub Copilot para criar regras de monitoramento, gerenciar alertas e disparar ações usando linguagem natural.
  4. Valide a conexão usando prompts de teste.

Pré-requisitos

Antes de configurar e consultar o servidor MCP, verifique se você tem:

  • Código do Visual Studio.
  • GitHub Copilot em Visual Studio Code.
  • Uma conexão de fonte de dados.
  • Um item Activator criado no espaço de trabalho Fabric.
    • Observe o ID do artefato Workspace e do Activator da URL do item Fabric para configuração.
    • O formato de URL é https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact
  • Examine as dicas.

Autenticação

O servidor usa OAuth. Seu cliente MCP deve ser configurado para adquirir e passar um token de Microsoft Entra ID válido. GitHub Copilot dá suporte automaticamente a esse gerenciamento de tokens.

Conectar-se ao servidor MCP do Ativador

O servidor MCP do ativador remoto funciona 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 O ID do espaço de trabalho Fabric (UUID)
Artifact ID A ID do artefato do Ativador (reflexo) (UUID).

Configuração do cliente MCP

Adicione a definição remota do servidor MCP do Ativador ao arquivo de configuração do cliente MCP (por exemplo, mcp.json, configurações de Visual Studio Code Copilot etc.). Atualmente, há suporte apenas para a configuração manual.

{
  "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 Ativador expõe um conjunto de ferramentas que os agentes de IA podem usar para interagir com o Activator. Essas ferramentas permitem criar regras de monitoramento, gerenciar alertas e disparar ações com base em dados em tempo real.

Gerenciamento de regras

Tool Descrição
create_rule Crie uma regra de monitoramento que observe um fluxo de dados e dispare ações (email, mensagem do Teams) quando as condições forem atendidas. Dá suporte a funções de detecção numérica, de texto, booliana e de pulsação com modificadores de ocorrência configuráveis. A regra inicia automaticamente.
list_rules Listar todas as regras definidas em um artefato do Ativador.
start_rule Inicie (habilite) uma regra para que ela comece a monitorar.
stop_rule Pare (desabilite) uma regra em execução.

Estrutura de regras

Cada regra de monitoramento tem três partes principais:

  • Fluxo: Define quais dados monitorar.

    • splitColumn: agrupar por uma coluna para monitoramento por entidade ou deixar vazio para monitoramento global.
    • filters: restringir dados antes da detecção (por exemplo, somente linhas em que Region == "EU").

  • Detecção: define quando disparar.

    • condition: a condição de monitoramento (por exemplo, a temperatura aumenta acima de 100).
    • occurrence: com que frequência a condição deve ser atendida (por exemplo, toda vez, permanece por 5 minutos, três vezes em 10 minutos).

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

IDs de espaço de trabalho e artefato

Ao criar regras, forneça o ID do espaço de trabalho e o ID do artefato do item do Activator no seu prompt. Essas IDs são as mesmas usadas na URL do servidor MCP. O assistente precisa deles para direcionar o artefato Activator correto.

Conexão de fonte de dados

As regras precisam de uma fonte de dados. Você pode especificar a conexão de duas maneiras:

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

  • Fabric Eventhouse: forneça a ID do item do Banco de Dados KQL e a ID do workspace em vez de uma URL.

Exemplos: Criar regras

Exemplo de prompt:

Crie uma regra que monitore a tabela Metrics no meu banco de dados Eventhouse TelemetryDB (cluster: https://mycluster.kusto.windows.net). Me envie um e-mail quando o uso da CPU exceder 90% alice@contoso.com."

Resposta:

Conecta-se à URL de cluster do ADX e estabelece uma condição increasesAbove na coluna da CPU com uma ação de envio de e-mail.

Exemplo de prompt:

"Conecte-se ao banco de dados KQL do Eventhouse (ID do item: aabbccdd-1234-5678-abcd-ef0123456789, workspace: 7855032f-a096-4a01-b6de-806aa26ecb00). Monitore a tabela SensorReadings. Para cada computador, se o espaço em disco cair abaixo de 10 GB e permanecer assim por 15 minutos, envie uma mensagem do Teams para bob@contoso.com."

Resposta:

Conecta-se por meio de IDs do Eventhouse Fabric, utiliza splitColumn para rastreamento por máquina com uma detecção de decreasesBelow / andStays.

Exemplo de prompt:

Usando a Heartbeat tabela no meu banco de dados Eventhouse MonitoringDB (cluster: https://monitoring.kusto.windows.net), avise-me se não houver dados por 10 minutos.

Resposta:

Conecta-se por meio da URL do cluster do ADX e cria uma regra de pulsação usando noPresenceOfData(600).

Exemplo de prompt:

Monitore a tabela AppLogs na minha Casa de Eventos Fabric (ID do item: 11223344-aabb-ccdd-eeff-556677889900, espaço de trabalho: 7855032f-a096-4a01-b6de-806aa26ecb00). Se a coluna de status for alterada para 'Erro' mais de três vezes em cinco minutos, envie um email oncall@contoso.com."

Resposta:

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

Exemplos: Gerenciando regras

Prompts de exemplo:

  • Liste todas as regras neste artefato

  • "Interrompa a regra chamada 'Alerta de CPU Alta'"

  • "Inicie todas as regras que estão paradas no momento"

Limitações

  • fontes de dados do KQL somente: você só pode criar regras contra bancos de dados KQL do Kusto (ADX) ou do Fabric Eventhouse. Atualmente, não há suporte para outros tipos de fonte de dados.

  • Configuração por item: a URL do servidor MCP se aplica a um único artefato do Ativador. Para trabalhar com vários artefatos, você deve configurar uma entrada de servidor MCP separada para cada um deles.

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

  • Nenhum gatilho multievento: Cada regra monitora um único fluxo de eventos. Não há suporte para gatilhos correlacionados em vários fluxos de eventos ou tabelas.

  • Nenhuma agregação ou resumo: as condições de detecção operam em eventos individuais. Não há suporte para funções de agregação, como média, soma ou contagem em uma janela.

Dicas

  • Conecte o servidor MCP do Eventhouse também. Se a fonte de dados for uma Fabric Eventhouse, conectar o servidor MCP Eventhouse juntamente com o Activator melhorará significativamente os resultados. Em seguida, seu agente pode inspecionar seu esquema de banco de dados, dados de exemplo e validar consultas KQL antes de criar regras.

  • Seja específico sobre colunas. O assistente precisa saber qual coluna de dados deve ser monitorada. Se você não tiver certeza, peça para ele listar o esquema primeiro (o que é mais fácil com o servidor MCP do Eventhouse conectado).

  • Estado versus mudança é importante. Use "rises above" ou "drops below" para alertas de transição únicos. Use "está acima" ou "está abaixo" para alertas repetidos para cada evento correspondente.

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

Conteúdo relacionado

  • Last updated on