Partilhar via

Ferramentas remotas de servidor Power BI MCP

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.

Importante

O servidor remoto do Power BI MCP está em pré-visualização. Definições de ferramentas, formatos de pedido e esquemas de resposta podem mudar à medida que aumentamos as capacidades.

Observação

O servidor remoto do Power BI MCP não é uma API REST tradicional. Acede através de agentes e frameworks compatíveis com MCP em vez de fazer chamadas HTTP diretas. O servidor implementa a especificação Model Context Protocol, que fornece uma interface padronizada para agentes de IA descobrirem e invocarem ferramentas.

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.

Obtenha o Esquema do Modelo Semântico

Recupera metadados abrangentes para um modelo semântico, incluindo:

  • Tabelas, colunas, medidas e relações
  • Tipos de dados e hierarquias
  • Metadados otimizados para IA quando configurados pelo autor do modelo:

Entrada necessária: ID do modelo semântico

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:

Observação

Se preferir não consumir capacidade do Copilot, desative esta ferramenta na configuração do seu cliente MCP e confie no LLM do seu cliente para gerar DAX diretamente.

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:

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

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

  • Last updated on