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.
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
Nopea asennus (suositeltava)
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:
Käynnistä MCP-palvelin VS-koodilla
- Avaa MCP-palvelinpaneeli
- Varmista, että Power BI MCP -palvelin näkyy yhdistettynä
Open 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 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:
- Copilot-lisenssi käyttäjälle tai organisaatiolle
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 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ä.