Ferramentas de servidor Power BI MCP (remotas)

O servidor remoto Power BI MCP fornece ferramentas que permitem aos agentes de IA conversar com dados em modelos semânticos Power BI usando linguagem natural. Através destas ferramentas, os assistentes de IA podem recuperar esquemas de modelos, gerar consultas DAX e executar consultas para fornecer insights a partir dos seus dados.

Ferramentas disponíveis

O servidor MCP fornece as seguintes ferramentas para os agentes de IA invocarem. Para detalhes de ligação, consulte Começar com o servidor remoto Power BI MCP.

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

Melhores práticas

Armazenar IDs semânticos de modelos para reutilização

Cada ferramenta requer um ID semântico do modelo. Em vez de pedir aos utilizadores que forneçam o ID em todas as sessões de chat, armazene os IDs de modelos frequentemente usados onde o seu agente possa aceder a eles. Por exemplo:

• Código VS: Crie um semantic-model-ids.json ficheiro no seu espaço de trabalho
• Agentes personalizados: Armazenar IDs em variáveis de ambiente ou ficheiros de configuração
• Cenários multi-modelos: Mantenha um catálogo que relacione nomes amigáveis a IDs de modelo

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}

Também pode recuperar IDs de modelos semânticos programaticamente usando a API REST do Power BI.

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?
• Comece com o servidor remoto Power BI MCP
• Prepare seus dados para IA
• Power BI APIs REST
• Referência DAX
• Especificação do Protocolo de Contexto do Modelo