Comece com o servidor remoto Power BI MCP (pré-visualização)

O servidor remoto Power BI MCP é um endpoint alojado remotamente que permite aos agentes de IA conversar com dados em modelos semânticos do Power BI usando linguagem natural. Baseado 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.

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

Antes de começar, certifique-se de que tem:

• 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:

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

Instalação manual

Para configurar manualmente o servidor, adicione o seguinte 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

Depois de configurado, verifique se a configuração está a funcionar:

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 irá consultar o seu modelo e devolver os resultados

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

Ferramentas disponíveis

O servidor MCP fornece as seguintes ferramentas para os agentes de IA invocarem.

Executar Consulta

Executa uma consulta DAX contra um modelo semântico e devolve os resultados ao agente de IA.

Entradas obrigatórias:

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

Permissões:

• Os utilizadores devem 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) é aplicada para a autenticação do utilizador
• Atualmente, o RLS não é suportado quando se utiliza autenticação por Service Principal

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

Obtenha o Esquema do Modelo Semântico

Recupera metadados abrangentes para um modelo semântico do Power BI, incluindo tabelas, colunas, medidas, relações e quaisquer metadados otimizados para IA configurados pelo autor do modelo. 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
• Metadados das ferramentas do Copilot, que, quando configurados, fornecem mais contexto sobre o seu modelo, ajudam a orientar o Copilot para os dados certos no modelo e contribuem para melhorar a qualidade dos resultados do Copilot.

Obtenha Metadados de Relatórios

Recupera o esquema de alto nível de um relatório Power BI, incluindo informações do espaço de trabalho, detalhes semânticos do modelo, páginas, informação visual e filtros. Os relatórios revelam como o modelo semântico é utilizado 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 usado no relatório 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. Visuais não relacionados com dados, como botões de ação, formas, imagens e retângulos, são excluídos.
• Colunas e medidas ocultas quando são referenciadas em elementos visuais
• 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.

Gerar consulta

Gera consultas DAX otimizadas a partir de prompts em linguagem natural usando o Copilot no Power BI. 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 determinado pelo agente (tabelas, colunas, medidas)

Requisitos:

• Licença Copilot para o utilizador ou 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): Atualmente não é aplicado quando se utiliza autenticação do Service Principal. Quando um principal de serviço executa consultas, tem acesso a todos os dados a que o principal está autorizado a aceder. Reveja 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 altamente complexos ou lógica aninhada podem não ser traduzidos perfeitamente a partir de sugestões 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.
• Grandes esquemas: 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 das janelas de contexto: Existem limites para a quantidade de contexto que pode ser mantido entre as conversas, dependendo do modelo de IA usado pelo seu cliente MCP.
• Consultas sem Estado: Cada consulta é executada de forma independente. O servidor não mantém o estado de consulta entre pedidos.

Conteúdo relacionado

• O que são os servidores MCP do Power BI?
• Servidor MCP do Power BI Modeling no GitHub
• 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