Servidor MCP de consumo do Power BI (pré-visualização)

O servidor Power BI Consumption MCP é um endpoint alojado remotamente onde agentes de IA conversam com dados em modelos semânticos Power BI usando linguagem natural. Construído com base no Model Context Protocol (MCP), traduz os seus prompts em operações Power BI, gerando consultas DAX e executando-as, respeitando as suas permissões e políticas de segurança.

Para criar ou alterar modelos semânticos em vez de os consultar, veja Power BI Authoring MCP server.

Este artigo mostra-lhe como:

• Liga-te ao servidor remoto do Power BI MCP no Visual Studio Code
• Ligue o GitHub Copilot aos seus modelos semânticos Power BI
• Valide a ligação com consultas de teste

Pré-requisitos

• Aprovação do administrador - O administrador do Power BI deve ativar a definição de inquilino: "Os utilizadores podem usar o endpoint do servidor Power BI Model Model Context Protocol (pré-visualização)"
• Código - Descarregar VS Code
• GitHub Copilot - Ativar o GitHub Copilot no VS Code
• Acesso a modelos semânticos - Permissões de construção em pelo menos um modelo semântico Power BI
• (Recomendado) Modelos - Prepare os seus modelos semânticos para IA para melhorar a qualidade da geração de consultas

Configuração em VS Code

O servidor remoto Power BI MCP está disponível em:

https://api.fabric.microsoft.com/v1/mcp/powerbi

Instalação rápida (recomendado)

A forma mais fácil de configurar o servidor é usando o instalador de um clique:

Este instalador configura automaticamente o servidor MCP nas definições do teu VS Code.

Instalação manual

Para configurar manualmente o servidor, adicione o seguinte código ao seu ficheiro de configuração MCP:

{
    "servers": {
        "powerbi-remote": {
            "type": "http",
            "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
        }
    }
}

Saiba mais:Servidores MCP no VS Code

Teste a sua ligação ao servidor Power BI MCP

Após a configuração, verifique se a configuração funciona:

1. Iniciar o servidor MCP no VS Code

   • Abra o painel de servidores MCP
   • Garantir que o servidor MCP do Power BI aparece como ligado

2. Open GitHub Copilot

   1. Lance a janela de bate-papo no VS Code
   2. Ativar o modo de agente

3. Forneça o seu ID semântico do modelo

   1. Obtenha o seu ID de modelo semântico do serviço Power BI (veja Encontrar o ID do seu modelo semântico)
   2. Partilha o ID com o Copilot na tua conversa

4. Fazer uma pergunta

   • Exemplo: "Que tabelas estão neste modelo semântico?"
   • Exemplo: "Mostre-me os 10 melhores produtos por vendas"

5. Autorizar a ferramenta

   1. Quando solicitado, permita que o Copilot use a ferramenta de servidor MCP
   2. Autentique-se com as suas credenciais da Microsoft, se solicitado

6. Revise a resposta

   • O Copilot consulta o seu modelo e devolve resultados

Resolução de Problemas:Gerir servidores MCP no VS Code

Ferramentas disponíveis para servidores Power BI MCP

O servidor remoto Power BI MCP fornece as seguintes ferramentas para os agentes de IA invocarem: Executar Consulta, Obter Esquema do Modelo Semântico, Obter Metadados de Relatórios e Gerar Consultas. As secções seguintes descrevem cada ferramenta.

Ferramenta de Execução de Consulta

A ferramenta Executar Consulta executa uma consulta DAX contra um modelo semântico do Power BI e devolve os resultados ao agente de IA.

Entradas obrigatórias:

• ID do modelo semântico
• Expressão de consulta DAX

Permissões:

• Deves ter pelo menos permissões de construção no modelo semântico
• As consultas são executadas no contexto do utilizador autenticado

Considerações de segurança:

• A segurança ao nível da linha (RLS) aplica-se à autenticação do utilizador
• A autenticação do principal de serviço atualmente não suporta RLS

Ver também:API REST para execução de consultas

Obtenha a ferramenta Semantic Model Schema

A ferramenta Get Semantic Model Schema recupera metadados abrangentes para um modelo semântico do Power BI, incluindo tabelas, colunas, medidas, relações e quaisquer metadados otimizados para IA que o autor do modelo tenha configurado. Use esta ferramenta para fundamentar a geração de consultas DAX na estrutura do modelo e para destacar orientações fornecidas pelo autor que melhorem a precisão das consultas.

Entrada necessária: ID do modelo semântico

O que está incluído:

• Tabelas, colunas, medidas e relações
• Tipos de dados e hierarquias
• Os metadados das ferramentas do Copilot, quando configurados, fornecem mais contexto sobre o seu modelo, ajudam a orientar o Copilot para os dados corretos no modelo e aumentam a qualidade da saída do Copilot.

Ferramenta de Obter Metadados de Relatórios

A ferramenta Get Report Metadata recupera o esquema de alto nível de um relatório Power BI, incluindo informação do espaço de trabalho, detalhes semânticos do modelo, páginas, informação visual e filtros. Os relatórios revelam como um relatório utiliza o modelo semântico na prática e podem clarificar o contexto pretendido, as relações e a lógica de filtragem que devem orientar a geração de consultas DAX. Use esta ferramenta para fundamentar a geração de consultas DAX na estrutura do esquema do modelo que o relatório utiliza e para destacar orientações fornecidas pelo autor que melhorem a precisão das consultas.

Entrada necessária: ID do Relatório

O que está incluído:

• Páginas no relatório, independentemente do estado oculto
• Visuais com referências válidas a esquemas de modelo, incluindo gráficos, tabelas, matrizes, segmentações e cartões. A ferramenta exclui visuais não relacionados com dados, como botões de ação, formas, imagens e retângulos.
• Colunas e medidas ocultas quando os visuais fazem referência a estas
• Ligações visuais que mapeiam campos para funções visuais como Categoria, Valores, Legenda e Tooltips
• Conteúdo das caixas de texto de cada página

Limites:

• Os pedidos falham quando os metadados do relatório ultrapassam o tamanho máximo suportado.

Ferramenta de Geração de Consultas

A ferramenta Generate Query utiliza o Copilot no Power BI para criar consultas DAX otimizadas a partir de prompts em linguagem natural. A ferramenta utiliza o mesmo motor de geração DAX que o Copilot para Power BI para criar consultas que seguem as melhores práticas.

Entradas obrigatórias:

• ID do modelo semântico
• Pergunta ou enunciado em linguagem natural
• Contexto de esquema relevante que o agente determina (tabelas, colunas, medidas)

Requisitos:

• Licença de Copilot para si ou para a sua organização

Encontre o ID do seu modelo semântico

Para obter um ID semântico do modelo a partir do serviço Power BI:

1. Iniciar sessão no Power BI
2. Navegue até ao espaço de trabalho que contém o seu modelo semântico
3. Selecione o modelo semântico para abrir a sua página de detalhes
4. Copie o ID semântico do modelo a partir da URL

Os URLs semânticos dos modelos seguem este formato:

https://app.powerbi.com/groups/{workspaceId}/datasets/{semanticModelId}

Limitações e considerações

Autenticação e segurança

• Segurança ao nível de linha (RLS): O Power BI não aplica RLS quando usa autenticação de principal de serviço. Quando um principal de serviço executa consultas, pode aceder a todos os dados a que o principal está autorizado a aceder. Analise cuidadosamente as implicações de segurança antes de expor agentes autenticados como principal de serviço aos utilizadores finais.
• Definições do locatário: Os administradores devem ativar "Os utilizadores podem usar o endpoint do servidor do Power BI Model Context Protocol (versão preliminar)" para a sua organização.

Geração de consultas

• DAX complexo: Cálculos muito complexos ou lógica aninhada poderão não ser traduzidos na perfeição a partir de pedidos em linguagem natural.
• Otimização de modelos: A qualidade da geração de consultas melhora significativamente quando prepara os seus dados para IA.

Performance

• Impacto no design do modelo: O desempenho da execução das consultas depende do design semântico, tamanho e otimização do modelo.
• Esquemas grandes: Modelos com centenas de tabelas ou milhares de colunas podem resultar em grandes cargas úteis de esquema.
• Complexidade da consulta: Consultas DAX complexas podem demorar mais tempo a ser geradas e executadas.

Contexto e diálogo

• Limites de janelas de contexto: O modelo de IA que o seu cliente MCP usa limita a quantidade de contexto que consegue manter entre as conversas.
• Consultas sem Estado: Cada consulta é executada de forma independente. O servidor não mantém o estado de consulta entre pedidos.

Conteúdo relacionado

• Servidores MCP para Power BI
• O que é Fabric QI?
• Servidor MCP de criação do Power BI
• Prepare seus dados para IA
• Servidores MCP no VS Code
• Power BI APIs REST
• Referência DAX
• Especificação do Protocolo de Contexto do Modelo