Aan de slag met externe Power BI MCP-server (preview)

Important

Deze functie is beschikbaar als preview-versie.

De externe Power BI MCP-server is een extern gehost eindpunt waarmee AI-agents kunnen 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, waarmee DAX-query's worden gegenereerd en uitgevoerd terwijl uw machtigingen en beveiligingsbeleid worden gerespecteerd.

Important

  • De externe Power BI MCP-server is in preview. Hulpprogrammadefinities, aanvraagindelingen en antwoordschema's kunnen veranderen naarmate we de mogelijkheden verbeteren.
  • De externe Power BI MCP-server is geen traditionele REST API. Open deze via MCP-compatibele agents en frameworks in plaats van directe HTTP-aanroepen te maken. De server implementeert de specificatie van het Model Context Protocol, die een gestandaardiseerde interface biedt voor AI-agents om hulpprogramma's te detecteren en aan te roepen.

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

Vereiste voorwaarden

Voordat u begint, moet u ervoor zorgen dat u het volgende hebt:

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

Hiermee configureert u automatisch de MCP-server in uw VS Code-instellingen.

Handmatige installatie

Als u de server handmatig wilt configureren, voegt u het volgende 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 verbinding testen

Nadat de configuratie is geconfigureerd, controleert u 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 voert een query uit op uw model en retourneert resultaten

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

De MCP-server biedt de volgende hulpprogramma's waarmee AI-agents kunnen worden aangeroepen.

Query uitvoeren

Voert een DAX-query uit op een semantisch model en retourneert de resultaten naar de AI-agent.

Vereiste invoer:

  • Semantische model-ID
  • DAX-queryexpressie

Machtigingen:

  • Gebruikers moeten ten minste samenstellingsmachtigingen hebben voor het semantische model
  • Query's worden uitgevoerd in de context van de geverifieerde gebruiker

Beveiligingsoverwegingen:

  • Beveiliging op rijeniveau (RLS) wordt toegepast voor gebruikersauthenticatie
  • RLS wordt momenteel niet ondersteund bij het gebruik van service-principal-verificatie

Zie ook:Execute Queries REST API

Semantisch modelschema ophalen

Haalt uitgebreide metagegevens op voor een Power BI semantisch model, waaronder tabellen, kolommen, metingen, relaties en metagegevens die door AI zijn geoptimaliseerd en 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 van Copilot-hulpprogramma's, wanneer deze zijn geconfigureerd, die meer context bieden over uw model, Copilot helpen de juiste gegevens in het model te vinden en de kwaliteit van de uitvoer van Copilot helpen te verbeteren.

Rapportmetagegevens 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 het semantische model in de praktijk wordt gebruikt en kunnen de beoogde context, relaties en filterlogica verduidelijken die het genereren van DAX-query's moeten helpen. Gebruik dit hulpprogramma om DAX-query's te genereren in de structuur van het modelschema dat in 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. Niet-gegevensvisuals, zoals actieknoppen, vormen, afbeeldingen en rechthoeken, worden uitgesloten.
  • Verborgen kolommen en metingen waarnaar wordt verwezen in visualisaties
  • 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.

Query genereren

Hiermee worden geoptimaliseerde DAX-query's gegenereerd op basis van prompts in natuurlijke taal met behulp van Copilot in Power BI. 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 zoals bepaald door de agent (tabellen, kolommen, metingen)

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): Momenteel niet afgedwongen bij het gebruik van Service Principal authenticatie. Wanneer een service-principal query's uitvoert, heeft deze toegang tot alle gegevens die de principal mag openen. Controleer de gevolgen van de beveiliging zorgvuldig voordat geverifieerde agents van de service-principal beschikbaar worden gesteld aan 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 kunnen mogelijk niet perfect worden vertaald vanuit prompts in 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 het schema.
  • Querycomplexiteit: Complexe DAX-query's kunnen langer duren om te genereren en uit te voeren.

Context en gesprek

  • Limieten voor contextvensters: Er zijn limieten voor de hoeveelheid context die kan worden onderhouden in gesprekken, afhankelijk van het AI-model dat wordt gebruikt door uw MCP-client.
  • Stateless queries: Elke query wordt onafhankelijk uitgevoerd. De server onderhoudt de querystatus niet tussen aanvragen.

Verwante inhoud

  • Last updated on