Server MCP di consumo di Power BI (anteprima)

Il server MCP Power BI Consumption è un endpoint ospitato in remoto in cui gli agenti di intelligenza artificiale interagiscono con i dati nei modelli semantici di Power BI utilizzando il linguaggio naturale. Basato sul protocollo MCP (Model Context Protocol), converte le richieste in operazioni Power BI, generando query DAX ed eseguendole rispettando le autorizzazioni e i criteri di sicurezza.

Per creare o modificare modelli semantici anziché interrogarli, vedi server MCP per la creazione in Power BI.

Questo articolo illustra come:

• Connettersi al server MCP di Power BI remoto in Visual Studio Code
• Connettere GitHub Copilot ai modelli semantici di Power BI
• Convalidare la connessione con le query di test

Prerequisiti

• Approvazione dell'amministratore: l'amministratore di Power BI deve abilitare l'impostazione del tenant: "Gli utenti possono usare l'endpoint server del protocollo di contesto del modello di Power BI (anteprima)"
• Visual Studio Code - Scaricare VS Code
• GitHub Copilot - Abilitare GitHub Copilot in VS Code
• Accesso semantico al modello - Creare autorizzazioni per almeno un modello semantico di Power BI
• (Scelta consigliata) Modelli - ottimizzatiPreparare i modelli semantici per l'intelligenza artificiale per migliorare la qualità della generazione di query

Configurazione in VS Code

Il server MCP di Power BI remoto è disponibile all'indirizzo:

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

Installazione rapida (scelta consigliata)

Il modo più semplice per configurare il server consiste nell'usare il programma di installazione con un clic:

Questo programma di installazione configura automaticamente il server MCP nelle impostazioni di VS Code.

Installazione manuale

Per configurare manualmente il server, aggiungere il codice seguente al file di configurazione MCP:

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

Altre informazioni:Server MCP in VS Code

Testare la connessione al server MCP Power BI

Dopo la configurazione, verificare che l'installazione funzioni:

1. Avviare il server MCP in VS Code

   • Aprire il pannello server MCP
   • Verificare che il server MCP di Power BI sia visualizzato come connesso

2. Aprire GitHub Copilot

   1. Avviare la finestra di chat in VS Code
   2. Abilitare la modalità agente

3. Specificare l'ID del modello semantico

   1. Ottenere l'ID del modello semantico dal servizio Power BI (vedere Trovare l'ID del modello semantico)
   2. Condividere l'ID con Copilot nella conversazione

4. Fai una domanda

   • Esempio: "Quali tabelle si trovano in questo modello semantico?"
   • Esempio: "Mostra i primi 10 prodotti per vendita"

5. Autorizzare lo strumento

   1. Quando richiesto, consentire a Copilot di usare lo strumento server MCP
   2. Eseguire l'autenticazione con le credenziali Microsoft, se richiesto

6. Esaminare la risposta

   • Copilot esegue una query sul modello e restituisce i risultati

Risoluzione dei problemi:Gestire i server MCP in VS Code

Strumenti disponibili del server MCP di Power BI

Il server MCP Power BI remoto offre gli strumenti seguenti per gli agenti di intelligenza artificiale da richiamare: Esegui query, Recupera schema del modello semantico, Recupera metadati report e Genera query. Le sezioni seguenti descrivono ogni strumento.

Strumento per eseguire query

Lo strumento Esegui query esegue una query DAX su un modello semantico Power BI e restituisce i risultati all'agente di intelligenza artificiale.

Input obbligatori:

• ID modello semantico
• Espressione di query DAX

Autorizzazioni:

• È necessario disporre almeno delle autorizzazioni di compilazione per il modello semantico
• Le query vengono eseguite nel contesto dell'utente autenticato

Considerazioni relative alla sicurezza:

• La sicurezza a livello di riga si applica all'autenticazione utente
• L'autenticazione tramite entità servizio attualmente non supporta RLS

Vedi anche:API REST di esecuzione delle query

Strumento per ottenere lo schema del modello semantico

Lo strumento Get Semantic Model Schema recupera metadati completi per un modello semantico Power BI, tra cui tabelle, colonne, misure, relazioni ed eventuali metadati ottimizzati per intelligenza artificiale configurati dall'autore del modello. Usa questo strumento per basare la generazione di query DAX sulla struttura del modello e per mettere in evidenza le linee guida fornite dall'autore che migliorano l'accuratezza delle query.

Input obbligatorio: ID modello semantico

Elementi inclusi:

• Tabelle, colonne, misure e relazioni
• Tipi di dati e gerarchie
• I metadati degli strumenti di Copilot, se configurati, forniscono maggiore contesto sul modello, aiutano a indirizzare Copilot verso i dati corretti nel modello e contribuiscono ad aumentare la qualità dell'output di Copilot.

Strumento Recupero metadati del report

Lo strumento Recupera metadati report recupera lo schema generale di un report Power BI, incluse informazioni sull'area di lavoro, dettagli del modello semantico, pagine, informazioni visive e filtri. I report rivelano in che modo un report usa il modello semantico in pratica e può chiarire il contesto, le relazioni e la logica di filtro previsti che deve guidare la generazione di query DAX. Usare questo strumento per basare la generazione di query DAX sulla struttura dello schema del modello utilizzato dal report e per mostrare le indicazioni fornite dall'autore che migliorano l'accuratezza delle query.

Input obbligatorio: Report ID

Elementi inclusi:

• Pagine nel report, a prescindere dal fatto che siano nascoste
• Oggetti visivi con riferimenti validi allo schema del modello, inclusi grafici, tabelle, matrici, filtri dei dati e schede. Lo strumento esclude oggetti visivi non dati, ad esempio pulsanti di azione, forme, immagini e rettangoli.
• Colonne nascoste e misure quando gli oggetti visivi fanno riferimento a esse
• Associazioni visive che associano i campi a ruoli visivi come Categoria, Valori, Legenda e Suggerimenti
• Contenuto della casella di testo da ogni pagina

Limiti:

• Le richieste hanno esito negativo quando i metadati del report superano le dimensioni massime supportate.

Strumento di generazione query

Lo strumento Genera query usa Copilot in Power BI per creare query DAX ottimizzate dai prompt del linguaggio naturale. Lo strumento usa lo stesso motore di generazione DAX di Copilot per Power BI per creare query che seguono le procedure consigliate.

Input obbligatori:

• ID modello semantico
• Domanda o richiesta di linguaggio naturale
• Contesto dello schema rilevante determinato dall'agente (tabelle, colonne, misure)

Requirements:

• Licenza Copilot per te o per la tua organizzazione

Trovare l'ID del modello semantico

Per ottenere un ID modello semantico dal servizio Power BI:

1. Accedere a Power BI
2. Passare all'area di lavoro contenente il modello semantico
3. Selezionare il modello semantico per aprire la relativa pagina dei dettagli
4. Copiare l'ID del modello semantico dall'URL

Gli URL del modello semantico seguono questo formato:

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

Limitazioni e considerazioni

Autenticazione e sicurezza

• Sicurezza a livello di riga (RLS): Power BI non applica la sicurezza a livello di riga quando si utilizza l'autenticazione dell'entità servizio. Quando un'entità servizio esegue query, può accedere a tutti i dati a cui l'entità è autorizzata ad accedere. Esaminare attentamente le implicazioni di sicurezza prima di esporre gli agenti autenticati dall'entità servizio agli utenti finali.
• Impostazioni del tenant: Gli amministratori devono abilitare "Gli utenti possono usare l'endpoint server del protocollo di contesto del modello di Power BI (anteprima)" per l'organizzazione.

Generazione di query

• DAX complesso: Calcoli molto complessi o logiche nidificate potrebbero non essere tradotti perfettamente a partire da prompt in linguaggio naturale.
• Ottimizzazione del modello: La qualità della generazione delle query migliora significativamente quando si preparano i dati per l'intelligenza artificiale.

Performance

• Impatto sulla progettazione del modello: Le prestazioni di esecuzione delle query dipendono dalla progettazione, dalle dimensioni e dall'ottimizzazione del modello semantico.
• Schemi di grandi dimensioni: I modelli con centinaia di tabelle o migliaia di colonne possono comportare payload di schema di grandi dimensioni.
• Complessità delle query: Le query DAX complesse potrebbero richiedere più tempo per generare ed eseguire.

Contesto e conversazione

• Limiti delle finestre di contesto: Il modello di intelligenza artificiale usato dal client MCP limita il contesto che può gestire tra turni di conversazione.
• Query senza stato: Ogni query viene eseguita in modo indipendente. Il server non mantiene lo stato della query tra le richieste.

Contenuti correlati

• Server MCP per Power BI
• Che cos'è Fabric IQ?
• Server MCP di creazione di Power BI
• Preparare i dati per l'intelligenza artificiale
• Server MCP in VS Code
• API REST di Power BI
• Informazioni di riferimento su DAX
• Specifica del protocollo del contesto del modello