Prise en main du serveur MCP distant Power BI (préversion)

Le serveur MCP distant Power BI est un point de terminaison hébergé à distance qui permet aux agents IA de discuter avec des données dans Power BI modèles sémantiques à l’aide du langage naturel. Basé sur le protocole MCP (Model Context Protocol), il traduit vos invites en opérations Power BI : générer des requêtes DAX et les exécuter tout en respectant vos autorisations et stratégies de sécurité.

Cet article vous montre comment :

• Se connecter au serveur Power BI MCP distant dans Visual Studio Code
• Connecter GitHub Copilot à vos modèles sémantiques Power BI
• Valider la connexion avec des requêtes de test

Prerequisites

Avant de commencer, vérifiez que vous disposez des points suivants :

• Approbation de l’administrateur - Votre administrateur Power BI doit activer le paramètre de locataire : « Les utilisateurs peuvent utiliser le point de terminaison du serveur du protocole de contexte du modèle Power BI (aperçu) »
• Visual Studio Code - Télécharger VS Code
• GitHub Copilot - Activer GitHub Copilot dans VS Code
• Accès au modèle sémantique - Générer des autorisations sur au moins un modèle sémantique Power BI
• (Recommandé) Modèles - optimisésPréparer vos modèles sémantiques pour l’IA afin d’améliorer la qualité de génération des requêtes

Configurer dans VS Code

Le serveur POWER BI MCP distant est disponible à l’adresse suivante :

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

Installation rapide (recommandé)

Le moyen le plus simple de configurer le serveur consiste à utiliser le programme d’installation en un clic :

Cela configure automatiquement le serveur MCP dans vos paramètres VS Code.

Installation manuelle

Pour configurer manuellement le serveur, ajoutez ce qui suit à votre fichier de configuration MCP :

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

En savoir plus :Serveurs MCP dans VS Code

Tester votre connexion

Une fois configuré, vérifiez que le programme d’installation fonctionne :

1. Démarrer le serveur MCP dans VS Code

   • Ouvrir le panneau serveurs MCP
   • Vérifier que le serveur MCP Power BI s’affiche comme connecté

2. Ouvrir GitHub Copilot

   1. Lancer la fenêtre de conversation dans VS Code
   2. Activer le mode agent

3. Fournir votre ID de modèle sémantique

   1. Obtenir votre ID de modèle sémantique à partir du service Power BI (voir Rechercher votre ID de modèle sémantique)
   2. Partager l’ID avec Copilot dans votre conversation

4. Poser une question

   • Exemple : « Quelles tables se trouvent dans ce modèle sémantique ? »
   • Exemple : « Afficher les 10 premiers produits par ventes »

5. Autoriser l’outil

   1. Lorsque vous y êtes invité, autorisez Copilot à utiliser l’outil serveur MCP
   2. S’authentifier avec vos informations d’identification Microsoft si nécessaire

6. Passer en revue la réponse

   • Copilot interroge votre modèle et retourne les résultats

Résolution des problèmes :Gérer les serveurs MCP dans VS Code

Outils disponibles

Le serveur MCP fournit les outils suivants que les agents IA peuvent appeler.

Exécuter une requête

Exécute une requête DAX sur un modèle sémantique et retourne les résultats à l’agent IA.

Entrées requises :

• ID de modèle sémantique
• Expression de requête DAX

Autorisations :

• Les utilisateurs doivent disposer au moins d’autorisations de génération sur le modèle sémantique
• Les requêtes s’exécutent dans le contexte de l’utilisateur authentifié

Considérations relatives à la sécurité :

• La sécurité au niveau des lignes (RLS) est appliquée pour l’authentification utilisateur
• RLS n’est actuellement pas pris en charge lors de l’utilisation de l’authentification du principal de service

Voir aussi :Exécuter des requêtes REST API

Obtenir le schéma du modèle sémantique

Récupère des métadonnées complètes pour un modèle sémantique Power BI, notamment les tables, les colonnes, les mesures, les relations et toutes les métadonnées optimisées par l’IA configurées par l’auteur du modèle. Utilisez cet outil pour baser la génération de requêtes DAX dans la structure du modèle et pour exposer des instructions fournies par l’auteur qui améliore la précision des requêtes.

Entrée requise : ID de modèle sémantique

Ce qui est inclus :

• Tables, colonnes, mesures et relations
• Types de données et hiérarchies
• Les métadonnées d’outils de Copilot, lorsqu’elles sont configurées, fournissent davantage de contexte sur votre modèle, aident Copilot à accéder aux bonnes données dans le modèle et contribuent à améliorer la qualité des résultats de Copilot.

Obtenir les métadonnées du rapport

Récupère le schéma de haut niveau d’un rapport Power BI, y compris les informations de l’espace de travail, les détails du modèle sémantique, les pages, les informations visuelles et les filtres. Les rapports révèlent comment le modèle sémantique est utilisé dans la pratique et peuvent clarifier le contexte, les relations et la logique de filtrage prévus qui doivent guider la génération de requêtes DAX. Utilisez cet outil pour baser la génération de requêtes DAX dans la structure du schéma de modèle utilisé dans le rapport et pour afficher des instructions fournies par l’auteur qui améliorent la précision des requêtes.

Entrée requise : ID de rapport

Ce qui est inclus :

• Pages du rapport, qu’elles soient masquées ou non
• Visuels avec des références valides au schéma du modèle, notamment des graphiques, des tableaux, des matrices, des segments et des cartes. Les éléments visuels ne représentant pas de données, comme les boutons d’action, les formes, les images et les rectangles, sont exclus.
• Colonnes et mesures masquées lorsqu’elles sont référencées dans des visuels
• Liaisons visuelles qui mappent des champs à des rôles visuels tels que Catégorie, Valeurs, Légende et info-bulles
• Contenu de zone de texte de chaque page

Limites:

• Les requêtes échouent lorsque les métadonnées du rapport dépassent la taille maximale prise en charge.

Générer une requête

Génère des requêtes DAX optimisées à partir d’invites en langage naturel à l’aide de Copilot dans Power BI. L’outil utilise le même moteur de génération DAX que Copilot pour Power BI pour créer des requêtes qui suivent les meilleures pratiques.

Entrées requises :

• ID de modèle sémantique
• Question ou invite en langage naturel
• Contexte de schéma pertinent tel que déterminé par l’agent (tables, colonnes, mesures)

Exigences:

• Licence Copilot pour l’utilisateur ou l’organisation

Rechercher votre ID de modèle sémantique

Pour obtenir un ID de modèle sémantique à partir du service Power BI :

1. Se connecter à Power BI
2. Accédez à l’espace de travail contenant votre modèle sémantique
3. Sélectionnez le modèle sémantique pour ouvrir sa page de détails
4. Copier l’ID de modèle sémantique à partir de l’URL

Les URL de modèle sémantique suivent ce format :

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

Limitations et considérations

Authentification et sécurité

• Sécurité au niveau des lignes (RLS) : Actuellement, il n’est pas appliqué lors de l’utilisation de l’authentification du principal de service. Lorsqu’un principal de service exécute des requêtes, il a accès à toutes les données que le principal est autorisé à accéder. Examinez attentivement les implications de sécurité avant d’exposer des agents authentifiés par le principal de service aux utilisateurs finaux.
• Paramètres du locataire : Les administrateurs doivent activer « Les utilisateurs peuvent utiliser le point de terminaison serveur de protocole de contexte du modèle Power BI (préversion) » pour votre organisation.

Génération de requêtes

• DAX complexe : Les calculs très complexes ou la logique imbriquée peuvent ne pas se traduire parfaitement à partir d'instructions basées sur le langage naturel.
• Optimisation du modèle : La qualité de génération de requêtes s’améliore considérablement lorsque vous préparez vos données pour l’IA.

Performances

• Impact de la conception du modèle : Les performances d’exécution des requêtes dépendent de la conception, de la taille et de l’optimisation du modèle sémantique.
• Schémas volumineux : Les modèles avec des centaines de tables ou des milliers de colonnes peuvent entraîner des charges utiles de schéma volumineuses.
• Complexité des requêtes : Les requêtes DAX complexes peuvent prendre plus de temps pour générer et exécuter.

Contexte et conversation

• Limites de fenêtre de contexte : Il existe des limites à la durée de maintenance du contexte entre les tours de conversation, en fonction du modèle IA utilisé par votre client MCP.
• Requêtes sans état : Chaque requête s’exécute indépendamment. Le serveur ne conserve pas l’état de requête entre les requêtes.

Contenu connexe

• Qu’est-ce que les serveurs MCP Power BI ?
• Serveur MCP de modélisation Power BI sur GitHub
• Préparer vos données pour l’IA
• Serveurs MCP dans VS Code
• API REST Power BI
• Référence DAX
• Spécification du protocole de contexte de modèle