Aloita etä-Power BI MCP -palvelimen käyttö (esikatselu)

Important

Tämä toiminto on esiversio.

Etä-Power BI MCP -palvelin on etäisännöity päätelaite, jonka avulla tekoälyagentit voivat keskustella datan kanssa Power BI:n semanttisissa malleissa luonnollisen kielen avulla. Model Context Protocolin (MCP) pohjalta rakennettu järjestelmä muuntaa kehotuksesi Power BI-operaatioiksi – tuottaen DAX-kyselyitä ja suorittaen ne kunnioittaen oikeuksiasi ja tietoturvakäytäntöjäsi.

Important

  • Etä-Power BI MCP -palvelin on esikatseluvaiheessa. Työkalujen määrittelyt, pyyntömuodot ja vastausskeemat voivat muuttua kyvykkyyksiä parantaessamme.
  • Etä-Power BI MCP -palvelin ei ole perinteinen REST-rajapinta. Käytä sitä MCP-yhteensopivien agenttien ja kehysten kautta sen sijaan, että tekisit suoria HTTP-kutsuja. Palvelin toteuttaa Model Context Protocol -määrittelyn, joka tarjoaa standardoidun käyttöliittymän tekoälyagenteille työkalujen löytämiseen ja käyttöönottoon.

Tässä artikkelissa opit:

  • Yhdistä etä-Power BI MCP -palvelimeen Visual Studio Codessa
  • Yhdistä GitHub Copilot Power BI -semanttisiin malleihisi
  • Validoi yhteys testikyselyillä

Edellytykset

Varmista ennen aloittamista, että sinulla on:

  • Ylläpitäjän hyväksyntä – Power BI:n ylläpitäjän on otettava käyttöön tenant-asetus: "Käyttäjät voivat käyttää Power BI Model Context Protocol -palvelimen päätepistettä (preview)"
  • Visual Studio Code - Lataa VS-koodi
  • GitHub Copilot - Ota GitHub Copilot käyttöön VS Codessa
  • Semanttisen mallin käyttöoikeus – Rakentaa käyttöoikeudet vähintään yhteen Power BI:n semanttiseen malliin
  • (Suositeltava) Optimoidut mallit - Valmistele semanttiset mallisi tekoälylle parantaaksesi kyselyjen generoinnin laatua

Asetettu VS-koodissa

Etä-Power BI MCP -palvelin on saatavilla osoitteessa:

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

Helpoin tapa konfiguroida palvelin on käyttää yhden klikkauksen asennusohjelmaa:

Tämä määrittää automaattisesti MCP-palvelimen VS Code -asetuksissa.

Manuaalinen asennus

Jos haluat konfiguroida palvelimen manuaalisesti, lisää seuraavat tiedot MCP-konfiguraatiotiedostoosi:

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

Lue lisää:MCP-palvelimet VS Codessa

Testaa yhteyttäsi

Kun asetukset on konfiguroitu, varmista, että asennus toimii:

  1. Käynnistä MCP-palvelin VS-koodilla

    • Avaa MCP-palvelinpaneeli
    • Varmista, että Power BI MCP -palvelin näkyy yhdistettynä
  2. Open GitHub Copilot

    1. Avaa chat-ikkuna VS Code -ohjelmassa
    2. Ota agenttimoodi käyttöön
  3. Anna semanttinen mallin tunnus

    1. Hanki semanttinen malli-ID Power BI -palvelusta (katso Etsi semanttinen malli-ID)
    2. Jaa ID Copilotin kanssa keskustelussasi
  4. Esitä kysymys

    • Esimerkki: "Mitä taulukoita tässä semanttisessa mallissa on?"
    • Esimerkki: "Näytä minulle myynnin mukaan 10 parasta tuotetta"
  5. Valtuuta työkalu

    1. Kun pyydetään, anna Copilotin käyttää MCP-palvelintyökalua
    2. Varmista todennus Microsoft-tunnuksillasi, jos pyydät
  6. Tarkista vastaus

    • Copilot kysyy mallistasi ja palauttaa tulokset

Tippi

Parhaiden kyselytulosten saavuttamiseksi valmistele semanttiset mallit tekoälylle lisäämällä tekoälyohjeita ja vahvistettuja vastauksia.

Vianetsintä:Hallinnoi MCP-palvelimia VS Codessa

Käytettävissä olevat työkalut

MCP-palvelin tarjoaa seuraavat työkalut, joita tekoälyagentit voivat kutsua.

Suorita kysely

Suorittaa DAX-kyselyn semanttista mallia vastaan ja palauttaa tulokset tekoälyagentille.

Vaaditut syötteet:

  • Semanttinen mallin tunnus
  • DAX-kyselylauseke

Käyttöoikeudet:

  • Käyttäjillä on oltava vähintään Build-oikeudet semanttiseen malliin
  • Kyselyt suoritetaan todennuksen saaneen käyttäjän kontekstissa

Turvallisuusnäkökohdat:

  • Rivitason turvallisuus (RLS) on käyttäjän todennuksessa voimassa
  • RLS ei tällä hetkellä ole tuettu, kun käytetään Service Principal -tunnistautumista

Katso myös:Suorita kyselyt REST API

Hanki semanttinen malliskeema

Hae kattavat metatiedot Power BI:n semanttisesta mallista, mukaan lukien taulukot, sarakkeet, mittarit, suhteet ja kaikki tekoälyoptimoidut metatiedot, jotka mallin tekijä on konfiguroinut. Käytä tätä työkalua DAX-kyselyjen generoinnin juurruttamiseen mallin rakenteeseen ja esiin tuomaan esiin tekijän antamat ohjeet, jotka parantavat kyselyjen tarkkuutta.

Vaaditut syötteet: Semanttinen mallin tunnus

Mitä sisältyy:

  • Taulukot, sarakkeet, mittaukset ja suhteet
  • Tietotyypit ja hierarkiat
  • Copilot työkalujen metatiedot, kun ne on konfiguroitu, antaa lisää kontekstia mallistasi, auttaa Copilot oikeaan dataan mallissa ja parantaa Copilot tuloksen laatua.

Hanki raportin metatiedot

Hae Power BI-raportin korkean tason skeeman, mukaan lukien työtilan tiedot, semanttisen mallin tiedot, sivut, visuaaliset tiedot ja suodattimet. Raportit paljastavat, miten semanttista mallia käytetään käytännössä ja voivat selkeyttää tarkoitettua kontekstia, suhteita ja suodatuslogiikkaa, joiden tulisi ohjata DAX-kyselyjen generointia. Käytä tätä työkalua perustamaan DAX-kyselyjen generointi raportissa käytetyn malliskeeman rakenteeseen ja tuomaan esiin tekijän antamat ohjeet, jotka parantavat kyselyjen tarkkuutta.

Vaaditut syötteet: Raportin tunnus

Mitä sisältyy:

  • Raportin sivut, riippumatta piilotetusta tilasta
  • Visuaalit, joissa on pätevät malliskeemaviittaukset, mukaan lukien kaaviot, taulukot, matriisit, viipalointityökalut ja kortit. Ei-datavisuaalit, kuten toimintopainikkeet, muodot, kuvat ja suorakulmiot, jätetään pois.
  • Piilotetut sarakkeet ja mittaukset, kun niihin viitataan visuaaleissa
  • Visuaaliset sidokset, jotka yhdistävät kentät visuaalisiin rooleihin, kuten Kategoria, Arvot, Legenda ja Työkaluvihjeet
  • Tekstilaatikon sisältö jokaiselta sivulta

Rajoitukset:

  • Pyynnöt epäonnistuvat, kun raportin metatiedot ylittävät tuetun maksimikoon.

Generoi kysely

Tuottaa optimoituja DAX-kyselyitä luonnollisen kielen kehotteista Copilotilla Power BI:ssä. Työkalu käyttää samaa DAX-generaattorimoottoria kuin Copilot for Power BI luodakseen kyselyitä, jotka noudattavat parhaita käytäntöjä.

Vaaditut syötteet:

  • Semanttinen mallin tunnus
  • Luonnollisen kielen kysymys tai kehotus
  • Asiaankuuluva skeemakonteksti agentin määrittämänä (taulukot, sarakkeet, mittarit)

Vaatimukset:

Muistio

Jos et halua kuluttaa Copilotin kapasiteettia, poista tämä työkalu käytöstä MCP-asiakaskonfiguraatiossa ja luota asiakkaan LLM:ään DAX:n tuottamiseen suoraan.

Löydä semanttinen malli-ID

Semanttisen mallin ID:n saamiseksi Power BI -palvelusta:

  1. Kirjaudu Power BI:hin
  2. Siirry työtilaan, jossa on semanttinen mallisi
  3. Valitse semanttinen malli avataksesi sen tiedot-sivun
  4. Kopioi semanttinen mallin ID URL-osoitteesta

Semanttiset mallin URL-osoitteet noudattavat tätä muotoa:

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

Tippi

  • Tallenna usein käytetyt malli-ID:t, joihin agenttisi pääsee käsiksi, kuten paikalliset semantic-model-ids.json tiedostot tai agentin ohjetiedostot.
  • Voit myös hakea semanttisia malli-ID:itä ohjelmallisesti Power BI REST API:n avulla.

Rajoitukset ja huomioitavat seikat

Todentaminen ja suojaus

  • Rivitason turvallisuus (RLS): Tällä hetkellä ei ole voimassa Service Principal -tunnistautumista käytettäessä. Kun palvelupäähenkilö suorittaa kyselyitä, sillä on pääsy kaikkiin tietoihin, joihin päähenkilöllä on oikeus päästä. Tarkista huolellisesti turvallisuusvaikutukset ennen kuin paljastat palvelun päähenkilön tunnistamat agentit loppukäyttäjille.
  • Vuokralaisasetukset: Järjestelmänvalvojan on otettava käyttöön "Käyttäjät voivat käyttää Power BI Model Context Protocol -palvelimen päätepistettä (preview)" organisaatiollesi.

Kyselyjen generointi

  • Monimutkainen DAX: Erittäin monimutkaiset laskelmat tai sisäkkäinen logiikka eivät välttämättä käänny täydellisesti luonnollisen kielen kehotteista.
  • Mallin optimointi: Kyselyjen generoinnin laatu paranee merkittävästi, kun valmistelet datasi tekoälyä varten.

Performance

  • Mallin suunnittelun vaikutus: Kyselyn suorituskyvyn suorituskyky riippuu semanttisesta mallin suunnittelusta, koosta ja optimoinnista.
  • Suuret skeemat: Mallit, joissa on satoja taulukoita tai tuhansia sarakkeita, voivat johtaa suuriin skeemahyötykuormiin.
  • Kyselyn monimutkaisuus: Monimutkaisten DAX-kyselyjen luominen ja suorittaminen voi kestää kauemmin.

Konteksti ja keskustelu

  • Kontekstiikkunan rajoitukset: Keskustelujen välillä on rajoituksia sille, kuinka paljon kontekstia voidaan ylläpitää keskustelukierrosten välillä riippuen siitä, millaista tekoälymallia MCP-asiakkaasi käyttää.
  • Valtiottomat kyselyt: Jokainen kysely suoritetaan itsenäisesti. Palvelin ei ylläpidä kyselytilaa pyyntöjen välillä.