Kom i gang med ekstern Power BI MCP-server (forhåndsvisning)

Den eksterne Power BI MCP-serveren er et eksternt hostet endepunkt som gjør det mulig for AI-agenter å chatte med data i Power BI-semantiske modeller ved bruk av naturlig språk. Bygget på Model Context Protocol (MCP), oversetter den promptene dine til Power BI-operasjoner – genererer DAX-spørringer og kjører dem samtidig som den respekterer dine tillatelser og sikkerhetspolicyer.

Denne artikkelen viser deg hvordan du gjør følgende:

• Koble til den eksterne Power BI MCP-serveren i Visual Studio Code
• Koble GitHub Copilot til dine Power BI-semantiske modeller
• Valider forbindelsen med testspørringer

Forutsetninger

Før du begynner, må du sørge for at du har:

• Administratorgodkjenning – Din Power BI-administrator må aktivere leietakerinnstillingen: «Brukere kan bruke Power BI Model Context Protocol-serverens endepunkt (forhåndsvisning)»
• Visual Studio Code - Last ned VS Code
• GitHub Copilot - Aktiver GitHub Copilot i VS Code
• Semantisk modelltilgang – Byggetillatelser på minst én Power BI semantisk modell
• (Anbefalt) Optimaliserte modeller - Forbered dine semantiske modeller for AI for å forbedre kvaliteten på spørringsgenerering

Oppsett i VS Code

Den eksterne Power BI MCP-serveren er tilgjengelig på:

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

Rask installasjon (anbefalt)

Den enkleste måten å konfigurere serveren på er å bruke ett-klikk-installasjonsprogrammet:

Dette konfigurerer automatisk MCP-serveren i VS Code-innstillingene dine.

Manuell installasjon

For å konfigurere serveren manuelt, legg til følgende i MCP-konfigurasjonsfilen din:

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

Lær mer:MCP-servere i VS Code

Test tilkoblingen

Når det er konfigurert, sjekk at oppsettet fungerer:

1. Start MCP-serveren i VS Code

   • Åpne MCP-serverpanelet
   • Sørg for at Power BI MCP-serveren vises som tilkoblet

2. Åpne GitHub Copilot

   1. Start chatvinduet i VS Code
   2. Aktiver agentmodus

3. Oppgi din semantiske modell-ID

   1. Få din semantiske modell-ID fra Power BI-tjenesten (se Finn din semantiske modell-ID)
   2. Del ID-en med Copilot i samtalen din

4. Still et spørsmål

   • Eksempel: «Hvilke tabeller finnes i denne semantiske modellen?»
   • Eksempel: «Vis meg de 10 beste produktene etter salg»

5. Autoriser verktøyet

   1. Når du blir bedt om det, la Copilot bruke MCP-serververktøyet
   2. Autentiser deg med Microsoft-opplysningene dine hvis det blir bedt om det

6. Gå gjennom svaret

   • Copilot vil spørre modellen din og returnere resultater

Feilsøking:Administrer MCP-servere i VS Code

Tilgjengelige verktøy

MCP-serveren tilbyr følgende verktøy for AI-agenter å kalle på.

Kjør spørring

Utfører en DAX-forespørsel mot en semantisk modell og returnerer resultatene til AI-agenten.

Påkrevde input:

• Semantisk modell-ID
• DAX-spørringsuttrykk

Tillatelser:

• Brukere må ha minst byggetillatelser på den semantiske modellen
• Spørringer kjøres i konteksten til den autentiserte brukeren

Sikkerhetshensyn:

• Sikkerhet på radnivå (RLS) håndheves for brukerautentisering
• RLS støttes for øyeblikket ikke ved bruk av Service Principal-autentisering

Se også:Execute Queries REST API

Få Semantic Model Schema

Henter omfattende metadata for en Power BI-semantisk modell, inkludert tabeller, kolonner, målinger, relasjoner og all AI-optimalisert metadata som modellforfatteren har konfigurert. Bruk dette verktøyet for å forankre DAX-spørringsgenerering i modellens struktur og for å fremheve veiledning fra forfatteren som forbedrer spørringsnøyaktigheten.

Påkrevd innspill: Semantisk modell-ID

Hva som inkluderes:

• Tabeller, kolonner, mål og relasjoner
• Datatyper og hierarkier
• Copilot verktøymetadata, når de er konfigurert, gir mer kontekst om modellen din, hjelper Copilot å finne riktige data i modellen, og bidrar til å øke kvaliteten på Copilot output.

Få rapportmetadata

Henter det overordnede skjemaet til en Power BI-rapport, inkludert arbeidsområdeinformasjon, detaljer om semantiske modeller, sider, visuell informasjon og filtre. Rapporter viser hvordan den semantiske modellen brukes i praksis og kan klargjøre den tiltenkte konteksten, relasjonene og filtreringslogikken som bør veilede DAX-spørringsgenerering. Bruk dette verktøyet for å forankre DAX-spørringsgenerering i strukturen til modellskjemaet som brukes i rapporten, og for å fremheve veiledning fra forfatteren som forbedrer spørringsnøyaktigheten.

Påkrevd innspill: Rapport-ID

Hva som inkluderes:

• Sider i rapporten, uavhengig av skjult tilstand
• Visuelle elementer med gyldige modellskjemareferanser, inkludert diagrammer, tabeller, matriser, slicere og kort. Ikke-data-visuelle elementer som handlingsknapper, former, bilder og rektangler er utelukket.
• Skjulte kolonner og målinger når de refereres til i visuelle effekter
• Visuelle bindings som kartlegger felt til visuelle roller som Kategori, Verdier, Forklaring og Verktøytips
• Tekstboksinnhold fra hver side

Grenser:

• Forespørsler mislykkes når rapportmetadataene overstiger maksimal støttet størrelse.

Generer spørring

Genererer optimaliserte DAX-spørringer fra naturlige språkprompter ved hjelp av Copilot i Power BI. Verktøyet bruker samme DAX-genereringsmotor som Copilot for Power BI for å lage spørringer som følger beste praksis.

Påkrevde input:

• Semantisk modell-ID
• Spørsmål eller prompt på naturlig språk
• Relevant skjema-kontekst bestemt av agenten (tabeller, kolonner, mål)

Krav:

• Copilot-lisens for brukeren eller organisasjonen

Finn din semantiske modell-ID

For å få en semantisk modell-ID fra Power BI-tjenesten:

1. Logg inn på Power BI
2. Naviger til arbeidsområdet som inneholder din semantiske modell
3. Velg den semantiske modellen for å åpne detaljsiden dens
4. Kopier den semantiske modell-ID-en fra URL-en

Semantiske modell-URL-er følger dette formatet:

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

Begrensninger og hensyn

Godkjenning og sikkerhet

• Sikkerhet på radnivå (RLS): For øyeblikket håndheves det ikke når man bruker Service Principal-autentisering. Når en tjenesteprincipal utfører spørringer, har den tilgang til all data principalen har tillatelse til å få tilgang til. Gå nøye gjennom sikkerhetsimplikasjoner før du eksponerer agenter som er autentisert for sluttbrukere.
• Leietakerinnstillinger: Administratorer må aktivere "Brukere kan bruke Power BI Model Context Protocol serverendepunkt (forhåndsvisning)" for din organisasjon.

Spørringsgenerering

• Kompleks DAX: Svært komplekse beregninger eller nestet logikk oversettes kanskje ikke perfekt fra naturlige språklige prompter.
• Modelloptimalisering: Kvaliteten på spørringsgenerering forbedres betydelig når du forbereder dataene dine for AI.

Performance

• Modelldesignets innvirkning: Ytelsen for spørringsutførelse avhenger av semantisk modelldesign, størrelse og optimalisering.
• Store skjemaer: Modeller med hundrevis av tabeller eller tusenvis av kolonner kan resultere i store skjema-nyttelaster.
• Spørringskompleksitet: Komplekse DAX-spørringer kan ta lengre tid å generere og kjøre.

Kontekst og samtale

• Begrensninger for kontekstvinduet: Det finnes grenser for hvor mye kontekst som kan opprettholdes på tvers av samtalerunder, avhengig av hvilken AI-modell MCP-klienten din bruker.
• Statsløse spørringer: Hver spørring kjøres uavhengig. Serveren opprettholder ikke forespørselsstatus mellom forespørsler.

Relatert innhold

• Hva er Power BI MCP-serverne?
• Power BI Modeling MCP-server på GitHub
• Klargjør dataene dine for kunstig intelligens
• MCP-servere i VS Code
• REST-API-er for Power BI
• DAX-referanse
• Spesifikasjonen for modellkontekstprotokoll