Créez une application de modélisation sémantique avec GitHub Copilot

Utilisez cette recette pour créer une application analytique connectée à un modèle sémantique avec le mode GitHub assistant Copilot. Copilot génère la structure de base du modèle d’application de données, ajoute un connecteur au modèle sémantique Fabric, crée des requêtes DAX et des visualisations, puis valide l’application.

Le modèle d’application de données fournit l’authentification Fabric, des conseils pour la génération DAX, des composants visuels et la validation du navigateur. Le connecteur fournit un accès sémantique délégué au modèle via le client Fabric Apps. Pour plus d’informations, consultez Créer une application connectée à un modèle sémantique.

Dans ce tutoriel, vous allez :

  • Préparez GitHub Copilot pour le développement piloté par agent.
  • Demandez à Copilot de générer le modèle d’application de données.
  • Connectez l’application à un modèle sémantique.
  • Construisez un explorateur interactif de performance commerciale.
  • Examinez et validez les modifications générées.
  • Déploie l’application sur Fabric.
  • Vérifiez le déploiement et ouvrez l’application.

Prerequisites

  • Node.js 20 ou version ultérieure.
  • Visual Studio Code.
  • GitHub Copilot dans Visual Studio Code avec le mode agent disponible.
  • Un compte GitHub ayant accès à GitHub Copilot.
  • Un compte Microsoft avec accès à Fabric.
  • Un espace de travail Fabric où vous disposez des autorisations Contributeur, Membre ou Administrateur.
  • La charge de travail Fabric Apps activée pour votre locataire.
  • Le paramètre client de l’API REST Exécuter des requêtes du modèle sémantique est activé.
  • Autorisations de compilation et de lecture sur un modèle sémantique hébergé sur Fabric ou Power BI Capacity.
  • L’ID de l’espace de travail et l’ID d’élément pour le modèle sémantique.

Note

Copilot demande l’approbation avant d’exécuter les commandes terminales. Vous devez également effectuer la connexion interactive du navigateur lorsque le CLI Rayfin le demande.

Ouvre le mode assistant Copilot de GitHub

  1. Ouvrez Visual Studio Code.
  2. Ouvrez le dossier parent où vous souhaitez que Copilot crée le projet.
  3. Ouvrez Chat.
  4. Sélectionnez le mode Agent .
  5. Confirmez que l’agent a accès au terminal et à l’espace de travail.

N'ouvrez pas un dossier contenant des fichiers sans rapport que vous ne voulez pas que Copilot inspecte ou modifie.

Échafaudez l’application de données

Copiez la consigne suivante dans Copilot Chat :

Set up a new Fabric data app for me, end to end.

Create the project in a folder named sales-insights. Before changing code, read any
copilot-instructions.md files and agent guidance included in the scaffolded project.

Do the work yourself instead of only printing instructions:
1. Run `npm create @microsoft/rayfin@latest -- "sales-insights" --template dataapp --workspace <workspace-name>`.
2. In the scaffolded project, run `npx rayfin connector add --type fabric-semanticmodel --workspace-id <workspace-id> --item-id <semantic-model-item-id> --name salesModel --operations executeQuery`.
3. Run the version-matched npm install command printed by the connector command.
4. Open and inspect the scaffolded project. Explain the data app template's DAX query,
   visualization, data grid, theme, and browser-validation patterns.
5. Configure the template to use ConnectorsRayfinClient, the generated salesModel
   schema, and the fabricSemanticModel() runtime. Don't retain or add a direct
   Execute Queries REST API client.
6. If authentication is required, run `npx rayfin login` and pause while I complete
   sign-in.
7. Run the existing build and report any errors.
8. Summarize the scaffolded app and wait for my semantic model requirements.

Ask before making a destructive change or using a force option.

Remplacez <workspace-name>, <workspace-id>, et <semantic-model-item-id> par des valeurs pour votre espace de travail Fabric et votre modèle sémantique. Approuvez les commandes au fur et à mesure que Copilot les exécute, et terminez le processus de connexion à Rayfin lorsque vous y êtes invité.

Demander à Copilot de créer ton application

Décrivez l’audience de l’application, ses questions, ses interactions et ses visualisations. Le salesModel connecteur identifie déjà le modèle sémantique.

Utilisez la consigne suivante comme recette de départ pour un explorateur de performance commerciale. Adaptez les exigences métier aux champs disponibles dans votre modèle.

Use the existing salesModel connector to build a sales performance explorer for
sales managers.

Requirements:
- Inspect the generated connector schema and semantic model metadata before editing.
  Use actual table, measure, and column names instead of guessing them.
- Show KPI callouts for the model's revenue, order volume, and margin measures when
  those measures are available.
- Add a time-series chart for sales performance, a bar chart that compares a useful
  business category, and a detailed data grid.
- Add date and category filters, and use the template's cross-highlighting behavior.
- Use the template's DAX generation patterns and visual primitives. Minimize the
  number of DAX queries and don't duplicate queries for the same data.
- Submit DAX with client.connectors.salesModel.executeQuery(), check the returned
  status, and handle success and error results.
- Apply the semantic model's format strings consistently to cards, charts, tooltips,
  and the data grid.
- Include loading, empty, and error states.
- Don't add mock data, embed credentials, or implement a separate authentication flow.
- Preserve the template's Fabric authentication and the semantic model connector.
- Don't add dependencies unless they're necessary.

Before editing, inspect the relevant files and give me a short implementation plan.
Ask me to clarify any model fields that are ambiguous. Then make the changes, run
the existing build, and use the template's browser validation workflow to check the
layout at desktop and mobile sizes. Explain any errors you fix.

Examinez le plan de Copilot avant de modifier le projet. Si le plan ne correspond pas à vos besoins, corrigez-le dans le chat avant d’approuver la mise en œuvre.

Passer en revue les modifications générées

Après la fin de Copilot, demandez-lui de revoir son travail :

Review the changes you made against every requirement in my previous prompt.

Check for:
- DAX queries that reference fields that aren't in the semantic model.
- Duplicate or unnecessary DAX queries.
- Hard-coded sample data, credentials, access tokens, or a second sign-in flow.
- Formatting that ignores the semantic model's format strings.
- Charts, filters, cross-highlighting, or data grid interactions that don't work.
- Missing loading, empty, or error states.
- TypeScript or build errors.

Fix confirmed issues, run the existing build and browser validation, and summarize
the final behavior.

Inspectez le diff du contrôle de code source dans Visual Studio Code. Portez une attention particulière aux éléments suivants :

  • La salesModel configuration du connecteur, le schéma généré et les requêtes DAX.
  • Configuration de service dans rayfin/rayfin.yml.
  • Nouvelles dépendances dans package.json.
  • Modifications d’authentification ou appels REST directs qui contournent le connecteur.
  • Des secrets ou des identifiants que vous ne devez pas valider.

Déploie et vérifie la connexion du modèle sémantique

Demandez à Copilot de déployer l’application et de vérifier sa connexion :

Deploy the app with `npx rayfin up`, then run `npx rayfin up status` and confirm
that the deployment is healthy. Give me the Fabric portal link from the command
output.

Don't add mock data if a semantic model query fails. Check the workspace and model
IDs in the connector configuration, the Semantic Model Execute Queries REST API
tenant setting, my Build and Read permissions, the DAX query, the connector error
result, and the browser console. Report the exact failure and the corrective action.

Ouvrez l’application depuis le portail Fabric pour tester les requêtes sémantiques en temps réel.

Validez l’application

Demandez à Copilot de lancer la validation existante du projet :

Validate the app without adding new tools.

1. Run the existing build and type-check commands from package.json.
2. Run the template's browser validation at desktop and mobile sizes.
3. Check for clipped charts, unreadable labels, empty visuals, and console errors.
4. Tell me which semantic model queries and user interactions I must verify in the
    Fabric portal.
5. Fix confirmed build, type, or layout errors, and rerun the failed check.

Dans le portail Fabric, vérifiez les critères d’acceptation que vous avez donnés à Copilot. Authentification des tests, filtres, surlignage croisé, formatage des données, états vides, gestion des erreurs, et les résultats de chaque visuel.

Déploie l’application terminée

Après avoir examiné les changements et testé l’application, demandez à Copilot de la déployer :

Deploy the reviewed app to Fabric.

1. Show me the current git diff and summarize what will be deployed.
2. Run `npx rayfin up`.
3. Run `npx rayfin up status`.
4. Confirm that the deployment is healthy.
5. Give me the hosted app URL and Fabric portal link from the command output.

Stop and explain the issue if deployment or verification fails.

La même npx rayfin up commande met à jour un déploiement existant lorsque vous continuez à développer l’application.

Continuez à itérer avec Copilot

Utilisez des consignes ciblées pour les changements ultérieurs. Incluez le comportement souhaité, les utilisateurs concernés, les contraintes et les étapes de validation.

Add a product detail view to the sales performance explorer.

Open the view when a user selects a product in the data grid. Use fields and measures
that exist in the semantic model, reuse existing query results where practical, and
preserve filters and formatting. Run the existing build and browser validation, then
list the interactions and DAX results I should verify in the Fabric portal.

Gardez chaque demande assez petite pour qu’elle soit examinée. Validez un état fonctionnel avant de demander à Copilot d’effectuer une modification importante ou potentiellement destructrice.

Résoudre les problèmes liés au flux de travail de Copilot

Copilot n’imprime que les commandes

Dis à Copilot d’exécuter les commandes lui-même et de rapporter les résultats. Confirmez que le chat est en mode Agent et que l’accès au terminal est activé.

Une commande attend la connexion

Terminez la procédure de connexion dans le navigateur. Ensuite, informez Copilot que la connexion est terminée pour que cela puisse continuer.

Copilot modifie le mauvais dossier

Arrêtez l’agent, ouvrez le dossier projet structuré dans Visual Studio Code, et lancez un nouveau chat depuis cet espace de travail.

Le déploiement réussit mais les requêtes sémantiques du modèle échouent

Demander à Copilot pour vérifier l’espace de travail et les ID de modèle du connecteur, le paramètre de locataire de l’API REST Semantic Model Execute Queries, vos autorisations Build et Read, le DAX généré, le message d’erreur du connecteur et la console du navigateur. Ne remplacez pas les requêtes ratées par des données fictives.

Copilot propose --force

Exigez que Copilot montre d’abord les opérations de schéma potentiellement destructrices. N’acceptez --force que lorsque vous comprenez et approuvez la possible perte de données.

Pour d’autres problèmes, voir Dépannage des applications Fabric.

Contenu connexe

  • Dernière mise à jour :