MCP-server voor Power BI-verbruik (preview)

De Power BI Consumption MCP-server is een extern gehost eindpunt waar AI-agents chatten met gegevens in Power BI semantische modellen met behulp van natuurlijke taal. Op basis van het MCP (Model Context Protocol) worden uw prompts omgezet in Power BI bewerkingen, het genereren van DAX-query's en het uitvoeren ervan, terwijl uw machtigingen en beveiligingsbeleid worden gerespecteerd.

Als u semantische modellen wilt maken of wijzigen in plaats van ze te queryen, zie Power BI Authoring MCP-server.

In dit artikel leest u hoe u het volgende kunt doen:

  • Verbinding maken met de externe Power BI MCP-server in Visual Studio Code
  • GitHub Copilot verbinden met uw semantische Power BI-modellen
  • De verbinding met testquery's valideren

Important

Voor semantisch modelverbruik gebruikt u de Fabric IQ MCP-server. Fabric IQ is de primaire MCP-server voor het brengen van vertrouwde bedrijfsgegevens en context van Power BI semantische modellen en rapporten in AI-clients. In dit artikel wordt het eerdere Power BI MCP-verbruikseindpunt behandeld. Dit is een preview-versie.

Vereiste voorwaarden

  • Goedkeuring door de beheerder : uw Power BI-beheerder moet de tenantinstelling inschakelen: 'Gebruikers kunnen het Power BI Model Context Protocol-servereindpunt gebruiken (preview)'
  • Visual Studio Code - VS Code downloaden
  • GitHub Copilot - GitHub Copilot inschakelen in VS Code
  • nl-NL: Semantische modeltoegang - Ontwerpautorisaties voor ten minste één Power BI-sematisch model
  • (Aanbevolen) Geoptimaliseerde modellen - Uw semantische modellen voorbereiden voor AI om de kwaliteit van het genereren van query's te verbeteren

Configureren in VS Code

De externe Power BI MCP-server is beschikbaar op:

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

De eenvoudigste manier om de server te configureren, is met behulp van het installatieprogramma met één klik:

Installatie van Power BI MCP-server (extern)

Dit installatieprogramma configureert automatisch de MCP-server in uw VS Code-instellingen.

Handmatige installatie

Als u de server handmatig wilt configureren, voegt u de volgende code toe aan uw MCP-configuratiebestand:

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

Meer informatie:MCP-servers in VS Code

Uw Power BI MCP-serververbinding testen

Controleer na de configuratie of de installatie werkt:

  1. De MCP-server starten in VS Code

    • Het paneel MCP-servers openen
    • Zorg ervoor dat de Power BI MCP-server wordt weergegeven als verbonden

  2. GitHub Copilot openen

    1. Het chatvenster starten in VS Code
    2. Agentmodus inschakelen

  3. Geef uw semantische model-id op

    1. Haal uw semantische model-id op uit de Power BI-service (zie Uw semantische model-id zoeken)
    2. Deel de id met Copilot in uw gesprek

  4. Een vraag stellen

    • Voorbeeld: 'Welke tabellen bevinden zich in dit semantische model?'
    • Voorbeeld: 'Toon me de top 10 producten per verkoop'

  5. Het hulpprogramma autoriseren

    1. Wanneer u hierom wordt gevraagd, verleent u Copilot toestemming om de MCP-servertool te gebruiken.
    2. Verifiëren met uw Microsoft-referenties indien aangevraagd

  6. Het antwoord controleren

    • Copilot query's op uw model uitvoeren en resultaten retourneren

Aanbeveling

Voor de beste queryresultaten bereidt u uw semantische modellen voor AI voor door AI-instructies en gecontroleerde antwoorden toe te voegen.

Problemen oplossen:MCP-servers beheren in VS Code

Beschikbare hulpmiddelen voor de Power BI MCP-server

De externe Power BI MCP-server biedt de volgende hulpprogramma's voor AI-agents die kunnen worden aangeroepen: Query uitvoeren, Semantisch modelschema ophalen, Metagegevens van rapporten ophalen en Query genereren. In de volgende secties worden alle hulpprogramma's beschreven.

Query-hulpprogramma uitvoeren

Het hulpprogramma Query uitvoeren voert een DAX-query uit op een Power BI semantisch model en retourneert de resultaten naar de AI-agent.

Vereiste invoer:

  • Semantische model-ID
  • DAX-queryexpressie

Machtigingen:

  • U moet ten minste Machtigingen voor bouwen hebben voor het semantische model
  • Query's worden uitgevoerd in de context van de geverifieerde gebruiker

Beveiligingsoverwegingen:

  • Beveiliging op rijniveau (RLS) is van toepassing op gebruikersverificatie
  • Service-principalauthenticatie ondersteunt momenteel geen beveiliging op rijniveau

Zie ook:Execute Queries REST API

Hulpprogramma voor het ophalen van het semantische modelschema

Met het hulpprogramma Semantisch modelschema ophalen worden uitgebreide metagegevens opgehaald voor een Power BI semantisch model, waaronder tabellen, kolommen, metingen, relaties en metagegevens die zijn geoptimaliseerd voor AI die door de auteur van het model zijn geconfigureerd. Gebruik dit hulpmiddel om het genereren van DAX-query's te baseren op de structuur van het model en om door de auteur verstrekte richtlijnen zichtbaar te maken die de nauwkeurigheid van query's verbeteren.

Vereiste invoer: Semantische model-id

Wat is inbegrepen:

  • Tabellen, kolommen, metingen en relaties
  • Gegevenstypen en hiërarchieën
  • Metagegevens voor Copilot-hulpprogramma's, indien geconfigureerd, bieden meer context over uw model, helpen Copilot naar de juiste gegevens in het model te leiden en helpen de kwaliteit van de uitvoer van Copilot te verbeteren.

Hulpmiddel voor het ophalen van metagegevens van rapporten

Het hulpprogramma Metagegevens van rapport ophalen haalt het schema op hoog niveau van een Power BI rapport op, inclusief werkruimtegegevens, semantische modeldetails, pagina's, visuele informatie en filters. Rapporten laten zien hoe een rapport in de praktijk gebruikmaakt van het semantische model en de beoogde context, relaties en filterlogica kan verduidelijken waarmee DAX-query's kunnen worden gegenereerd. Gebruik dit hulpprogramma om DAX-query's te genereren in de structuur van het modelschema dat door het rapport wordt gebruikt en om door de auteur verstrekte richtlijnen weer te geven waarmee de nauwkeurigheid van query's wordt verbeterd.

Vereiste invoer: Rapport-id

Wat is inbegrepen:

  • Pagina's in het rapport, ongeacht of ze verborgen zijn
  • Visuals met geldige modelschemaverwijzingen, waaronder grafieken, tabellen, matrices, slicers en kaarten. Het hulpprogramma sluit niet-gegevensvisuals uit, zoals actieknoppen, vormen, afbeeldingen en rechthoeken.
  • Verborgen kolommen en metingen wanneer visuele elementen ernaar verwijzen
  • Visuele bindingen die velden toewijzen aan visuele rollen, zoals Categorie, Waarden, Legenda en Knopinfo
  • Inhoud van tekstvak op elke pagina

Grenzen:

  • Aanvragen mislukken wanneer de metagegevens van het rapport de maximale ondersteunde grootte overschrijden.

Hulpprogramma Query genereren

Het hulpprogramma Query genereren maakt gebruik van Copilot in Power BI om geoptimaliseerde DAX-query's te maken op basis van prompts in natuurlijke taal. Het hulpprogramma maakt gebruik van dezelfde DAX-generatie-engine als Copilot voor Power BI om query's te maken die de aanbevolen procedures volgen.

Vereiste invoer:

  • Semantische model-ID
  • Vraag of prompt in natuurlijke taal
  • Relevante schemacontext die door de agent wordt bepaald (tabellen, kolommen, meetwaarden)

Vereisten:

Note

Als u liever geen Copilot-capaciteit verbruikt, schakelt u dit hulpprogramma uit in de MCP-clientconfiguratie en vertrouwt u op de LLM van uw client om DAX rechtstreeks te genereren.

Uw semantische model-id zoeken

Een semantische model-id ophalen uit de Power BI-service:

  1. Aanmelden bij Power BI
  2. Navigeer naar de werkruimte met uw semantische model
  3. Selecteer het semantische model om de detailpagina te openen
  4. Kopieer de semantische model-id uit de URL

Semantische model-URL's volgen deze indeling:

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

Aanbeveling

  • Sla veelgebruikte model-id's op waar uw agent toegang heeft tot deze id's, zoals een semantic-model-ids.json lokaal bestand of agentinstructiebestanden.
  • U kunt ook programmatisch semantische model-id's ophalen met behulp van de Power BI REST API.

Beperkingen en overwegingen

Verificatie en beveiliging

  • Beveiliging op rijniveau (RLS): Power BI past RLS niet toe wanneer u service-principalauthenticatie gebruikt. Wanneer een service-principal query's uitvoert, heeft deze toegang tot alle gegevens waartoe de principal toegang heeft. Controleer de gevolgen van de beveiliging zorgvuldig voordat u door de service-principal geverifieerde agents beschikbaar maakt voor eindgebruikers.
  • Tenantinstellingen: Beheerders moeten "Gebruikers kunnen het eindpunt van de Power BI Modelcontextprotocol-server (preview) gebruiken" voor uw organisatie inschakelen.

Query genereren

  • Complexe DAX: Zeer complexe berekeningen of geneste logica worden mogelijk niet perfect vertaald vanuit prompts voor natuurlijke taal.
  • Modeloptimalisatie: De kwaliteit van het genereren van query's verbetert aanzienlijk wanneer u uw gegevens voorbereidt op AI.

Performance

  • Impact van modelontwerp: Prestaties van queryuitvoering zijn afhankelijk van het ontwerp, de grootte en optimalisatie van het semantische model.
  • Grote schema's: Modellen met honderden tabellen of duizenden kolommen kunnen leiden tot grote nettoladingen van schema's.
  • Querycomplexiteit: Het genereren en uitvoeren van complexe DAX-query's kan langer duren.

Context en gesprek

  • Beperkingen van het contextvenster: Het AI-model dat uw MCP-client gebruikt, beperkt hoeveel context het over meerdere gespreksbeurten heen kan vasthouden.
  • Stateless queries: Elke query wordt onafhankelijk uitgevoerd. De server onderhoudt de querystatus niet tussen aanvragen.

Verwante inhoud

  • Laatst bijgewerkt om