Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Power BI Consumption MCP -palvelin on etäyhteydessä isännöity päätepiste, jossa tekoälyagentit keskustelevat Power BI semanttisten mallien tietojen kanssa luonnollisen kielen avulla. McP-protokollan (Model Context Protocol) pohjalta se kääntää kehotteet Power BI toimintoihin, luo DAX-kyselyitä ja suorittaa niitä noudattaen samalla käyttöoikeuksiasi ja suojauskäytäntöjäsi.
Jos haluat luoda tai muuttaa semanttisia malleja kyselyjen sijaan, katso Power BI MCP-palvelimen luominen.
Tässä artikkelissa opit:
- Yhdistä etä-Power BI MCP -palvelimeen Visual Studio Codessa
- Yhdistä GitHub Copilot Power BI -semanttisiin malleihisi
- Validoi yhteys testikyselyillä
Important
Käytä semanttista mallin kulutusta varten mieluummin Fabric IQ MCP -palvelinta. Fabric-älykkyysosamäärä on ensisijainen MCP-palvelin luotettujen yritystietojen ja kontekstin tuomiseen Power BI semanttisista malleista ja raporteista tekoälyasiakkaiksi. Tässä artikkelissa käsitellään aiemmin Power BI MCP-kulutuksen päätepistettä, joka on esikatselussa.
Edellytykset
- 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
Nopea asennus (suositeltava)
Helpoin tapa määrittää palvelin on käyttää yhden napsautuksen asennusohjelmaa:
Tämä asennusohjelma määrittää MCP-palvelimen automaattisesti VS Code -asetuksissa.
Manuaalinen asennus
Määritä palvelin manuaalisesti lisäämällä seuraava koodi MCP-määritystiedostoon:
{
"servers": {
"powerbi-remote": {
"type": "http",
"url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
}
}
}
Lue lisää:MCP-palvelimet VS Codessa
Power BI MCP -palvelinyhteyden testaaminen
Tarkista määrityksen jälkeen, että määritykset toimivat:
Käynnistä MCP-palvelin VS-koodilla
- Avaa MCP-palvelinpaneeli
- Varmista, että Power BI MCP -palvelin näkyy yhdistettynä
Avaa GitHub Copilot
- Avaa chat-ikkuna VS Code -ohjelmassa
- Ota agenttimoodi käyttöön
Anna semanttinen mallin tunnus
- Hanki semanttinen malli-ID Power BI -palvelusta (katso Etsi semanttinen malli-ID)
- Jaa ID Copilotin kanssa keskustelussasi
Esitä kysymys
- Esimerkki: "Mitä taulukoita tässä semanttisessa mallissa on?"
- Esimerkki: "Näytä minulle myynnin mukaan 10 parasta tuotetta"
Valtuuta työkalu
- Kun pyydetään, anna Copilotin käyttää MCP-palvelintyökalua
- Varmista todennus Microsoft-tunnuksillasi, jos pyydät
Tarkista vastaus
- Copilot suorittaa kyselyjä mallissasi 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 Power BI MCP-palvelintyökalut
MCP Power BI etäpalvelin tarjoaa tekoälyagenteille seuraavat kutsutyökalut: Suorita kysely, Hae semanttisen mallin rakenne, Hae raportin metatiedot ja Luo kysely. Seuraavat osiot kuvaavat kutakin työkalua.
Suorita kyselytyökalu
Suorita kysely -työkalu suorittaa DAX-kyselyn semanttista Power BI mallia vasten ja palauttaa tulokset tekoälyagentille.
Vaaditut syötteet:
- Semanttinen mallin tunnus
- DAX-kyselylauseke
Käyttöoikeudet:
- Sinulla on oltava vähintään muodostamisoikeudet semanttiseen malliin
- Kyselyt suoritetaan todennuksen saaneen käyttäjän kontekstissa
Turvallisuusnäkökohdat:
- Rivitason suojaus (RLS) koskee käyttäjän todentamista
- Palvelun päänimen todentaminen ei tällä hetkellä tue rivitason suojausta
Katso myös:Suorita kyselyt REST API
Hae semanttisen mallin rakennetyökalu
Hae semanttisen mallin rakenne -työkalu hakee kattavat metatiedot Power BI semanttisesta mallista, mukaan lukien taulukot, sarakkeet, mittarit, suhteet ja kaikki mallin tekijän määrittämät tekoälyoptimoidut metatiedot. 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 metatietojen työkalut, kun ne on määritetty, mikä antaa malliin lisää kontekstia, auttaa ohjaamaan Copilot mallin oikeiden tietojen luonteeseen ja parantamaan Copilot tulosteen laatua.
Hanki raportin metatietotyökalu
Hae raportin metatiedot -työkalu hakee Power BI raportin korkean tason rakenteen, mukaan lukien työtilan tiedot, semanttisen mallin tiedot, sivut, visuaaliset tiedot ja suodattimet. Raportit paljastavat, miten raportti käyttää semanttista mallia käytännössä, ja ne voivat selventää aiottua kontekstia, suhteita ja suodatuslogiikkaa, jonka pitäisi ohjata DAX-kyselyn luontia. Tämän työkalun avulla voit luoda DAX-kyselyitä sen mallirakenteen rakenteessa, jota raportti käyttää, ja näyttää annettuja ohjeita, jotka parantavat kyselyn 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. Työkalu jättää pois muut kuin tietovisualisoinnit, kuten toimintopainikkeet, muodot, kuvat ja suorakulmiot.
- Piilotetut sarakkeet ja mittarit, kun visualisoinnit viittaavat niihin
- 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.
Luo kyselytyökalu
Luo kysely -työkalu käyttää Copilot-Power BI optimoitujen DAX-kyselyiden luomiseen luonnollisen kielen kehotteiden avulla. 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
- Agentin määrittämä asianmukainen rakennekonteksti (taulukot, sarakkeet, mittarit)
Vaatimukset:
- Copilot käyttöoikeus sinulle tai organisaatiollesi
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:
- Kirjaudu Power BI:hin
- Siirry työtilaan, jossa on semanttinen mallisi
- Valitse semanttinen malli avataksesi sen tiedot-sivun
- 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.jsontiedostot tai agentin ohjetiedostot. - Voit myös noutaa semanttiset mallitunnukset ohjelmallisesti käyttämällä Power BI REST-ohjelmointirajapintaa.
Rajoitukset ja huomioitavat seikat
Todentaminen ja suojaus
- Rivitason suojaus (RLS): Power BI ei pakota rivitason suojausta, kun käytät palvelun päänimen todentamista. Kun palvelun päänimi suorittaa kyselyjä, se voi käyttää kaikkia tietoja, joihin päänimillä on käyttöoikeus. Tarkista tietoturvavaikutukset huolellisesti ennen kuin altistat palvelun päänimeksi todennetut 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 laskutoimitukset tai sisäkkäinen logiikka eivät välttämättä vastaa täydellisesti luonnollisen kielen kehotteita.
- 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 rakenteet: Mallit, joissa on satoja taulukoita tai tuhansia sarakkeita, saattavat aiheuttaa suuria rakennekuormituksia.
- Kyselyn monimutkaisuus: Monimutkaisten DAX-kyselyiden luominen ja suorittaminen voi kestää kauemmin.
Konteksti ja keskustelu
- Kontekstiikkunan rajoitukset: MCP-asiakkaasi käyttämä tekoälymalli rajoittaa sitä, kuinka paljon kontekstia se voi ylläpitää keskustelun käännöksissä.
- Valtiottomat kyselyt: Jokainen kysely suoritetaan itsenäisesti. Palvelin ei ylläpidä kyselytilaa pyyntöjen välillä.