Share via

Externe Power BI MCP-serverhulpprogramma's

De externe Power BI MCP-server biedt hulpprogramma's waarmee AI-agents kunnen chatten met gegevens in semantische Power BI-modellen met behulp van natuurlijke taal. Met deze hulpprogramma's kunnen AI-assistenten modelschema's ophalen, DAX-query's genereren en query's uitvoeren om inzichten uit uw gegevens te leveren.

Belangrijk

De externe Power BI MCP-server is in preview. Hulpprogrammadefinities, aanvraagindelingen en antwoordschema's kunnen veranderen naarmate we de mogelijkheden verbeteren.

Opmerking

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.

Beschikbare hulpmiddelen

De MCP-server biedt de volgende hulpprogramma's waarmee AI-agents kunnen worden aangeroepen. Zie Aan de slag met de externe Power BI MCP-server voor verbindingsgegevens.

Semantisch modelschema ophalen

Haalt uitgebreide metagegevens voor een semantisch model op, waaronder:

  • Tabellen, kolommen, metingen en relaties
  • Gegevenstypen en hiërarchieën
  • Door AI geoptimaliseerde metagegevens wanneer deze zijn geconfigureerd door de auteur van het model:

Vereiste invoer: Semantische model-id

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:

Opmerking

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.

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

Beste praktijken

Semantische model-id's opslaan voor hergebruik

Voor elk hulpprogramma is een semantische model-id vereist. In plaats van gebruikers te vragen om de id in elke chatsessie op te geven, slaat u veelgebruikte model-id's op waar uw agent toegang tot deze id's heeft. Voorbeeld:

  • VS Code:semantic-model-ids.json Een bestand maken in uw werkruimte
  • Aangepaste agents: ID's opslaan in omgevingsvariabelen of configuratiebestanden
  • Scenario's met meerdere modellen: Een catalogus bijhouden die vriendelijke namen aan model-ID's toewijst.

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}

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