Compartilhar via

Ferramentas remotas do servidor MCP do Power BI

O servidor mcp remoto do Power BI fornece ferramentas que permitem que os agentes de IA conversem com dados em modelos semânticos do Power BI usando linguagem natural. Por meio dessas ferramentas, os assistentes de IA podem recuperar esquemas de modelo, gerar consultas DAX e executar consultas para fornecer insights de seus dados.

Importante

O servidor MCP remoto do Power BI está em versão prévia. Definições de ferramenta, formatos de solicitação e esquemas de resposta podem mudar à medida que aprimoramos os recursos.

Observação

O servidor MCP remoto do Power BI não é uma API REST tradicional. Acesse-o por meio de agentes e estruturas compatíveis com MCP em vez de fazer chamadas HTTP diretas. O servidor implementa a especificação protocolo de contexto de modelo, que fornece uma interface padronizada para os agentes de IA descobrirem e invocarem ferramentas.

Ferramentas disponíveis

O servidor MCP fornece as seguintes ferramentas para os agentes de IA invocarem. Para obter detalhes da conexão, consulte Introdução ao servidor remoto do MCP do Power BI.

Obter esquema de 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 de linguagem natural usando o Copilot no Power BI. A ferramenta usa o mesmo mecanismo de geração DAX que o Copilot para Power BI para criar consultas que seguem as melhores práticas.

Entradas necessárias:

  • ID do modelo semântico
  • Pergunta ou prompt de linguagem natural
  • Contexto de esquema relevante, conforme determinado pelo agente (tabelas, colunas, medidas)

Requisitos:

Observação

Se você preferir não consumir a capacidade do Copilot, desabilite essa ferramenta na configuração do cliente MCP e dependa da LLM do cliente para gerar o DAX diretamente.

Executar Consulta

Executa uma consulta DAX em um modelo semântico e retorna os resultados para o agente de IA.

Entradas necessárias:

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

Permissões:

  • Os usuários devem ter pelo menos permissões de Build no modelo semântico
  • Consultas são executadas no contexto do usuário autenticado

Considerações de segurança:

Consulte também:Executar consultas da API REST

Práticas recomendadas

Armazenar IDs de modelo semântico para reutilização

Cada ferramenta requer uma ID de modelo semântico. Em vez de pedir aos usuários que forneçam a ID em cada sessão de chat, armazene IDs de modelo usadas com frequência em que seu agente possa acessá-las. Por exemplo:

  • VS Code: Criar um semantic-model-ids.json arquivo em seu workspace
  • Agentes personalizados: Armazenar IDs em variáveis de ambiente ou arquivos de configuração
  • Cenários de vários modelos: Manter um catálogo mapeando nomes amigáveis para IDs de modelo

Localizar a ID do modelo semântico

Para obter uma ID de modelo semântico do serviço do Power BI:

  1. Entrar no Power BI
  2. Navegue até o workspace que contém seu modelo semântico
  3. Selecione o modelo semântico para abrir sua página de detalhes
  4. Copiar a ID do modelo semântico da URL

As URLs de modelo semântico seguem este formato:

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

Você também pode recuperar IDs de modelo semântico programaticamente usando a API REST do Power BI.

Limitações e considerações

Autenticação e segurança

  • RLS (segurança em nível de linha): Atualmente, não é aplicada ao usar a autenticação do Principal do Serviço. Quando uma entidade de serviço executa consultas, ela tem acesso a todos os dados que está autorizada a acessar. Examine cuidadosamente as implicações de segurança antes de expor agentes autenticados pela entidade de serviço aos usuários finais.
  • Configurações de locatário: Os administradores devem habilitar "Os usuários podem usar o ponto de extremidade do servidor do Protocolo de Contexto do Modelo do Power BI (versão prévia)" para sua organização.

Geração de consulta

  • DAX complexo: Cálculos altamente complexos ou lógica aninhada podem não se traduzir perfeitamente a partir de sugestões de linguagem natural.
  • Otimização de modelo: A qualidade da geração de consulta melhora significativamente quando você prepara seus dados para IA.

Performance

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

Contexto e diálogo

  • Limites da janela de contexto: Há limites para a quantidade de contexto que pode ser mantida entre as rodadas de conversa, dependendo do modelo de IA usado pelo cliente MCP.
  • Consultas sem estado: Cada consulta é executada de forma independente. O servidor não mantém o estado de consulta entre solicitações.

Conteúdo relacionado

  • Last updated on