Lag en semantisk modellapp med GitHub Copilot

Bruk denne oppskriften for å lage en analytisk app koblet til en semantisk modell med GitHub Copilot-agent-modus. Copilot støtter dataapp-malen, legger til en Fabric semantisk modellkobling, lager DAX-spørringer og visualiseringer, og validerer appen.

Dataapp-malen gir Fabric-autentisering, veiledning for DAX-generering, visuelle komponenter og nettleservalidering. Koblingen gir delegert semantisk modelltilgang gjennom Fabric Apps-klienten. Hvis du vil ha mer informasjon, kan du se Opprette en app som er koblet til en semantisk modell.

I denne opplæringen:

Forbered GitHub Copilot for agentdrevet utvikling.
Spør Copilot om å sette opp malen for dataappen.
Koble appen til en semantisk modell.
Bygg en interaktiv salgsytelsesutforsker.
Gå gjennom og godkjenn de genererte endringene.
Distribuer appen til Fabric.
Bekreft distribusjonen og åpne appen.

Forutsetninger

Node.js 20 eller senere.
Visual Studio Code.
GitHub Copilot i Visual Studio Code med agentmodus tilgjengelig.
En GitHub konto med tilgang til GitHub Copilot.
En Microsoft-konto med tilgang til Fabric.
Et Fabric-arbeidsområde hvor du har tillatelser som bidragsyter, medlem eller administrator.
Fabric Apps-arbeidsbelastningen er aktivert for din leietaker.
Leietakerinnstillingen Semantic Model Model Execute Queries REST API aktivert.
Bygge- og lesetillatelser på en semantisk modell hostet på Fabric- eller Power BI-kapasitet.
Workspace-ID og item-ID for den semantiske modellen.

Bemerkning

Copilot ber om godkjenning før den kjører terminalkommandoer. Du må også fullføre interaktiv nettleserpålogging når Rayfin CLI ber om det.

Open GitHub Copilot-agent-modus

Åpne Visual Studio Code.
Åpne foreldremappen der du vil at Copilot skal opprette prosjektet.
Åpne chat.
Velg Agentmodus .
Bekreft at agenten har tilgang til terminalen og arbeidsområdet.

Ikke åpne en mappe som inneholder urelaterte filer du ikke vil at Copilot skal inspisere eller endre.

Stilas dataappen

Kopier følgende prompt inn i 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.

Erstatt <workspace-name>, <workspace-id>, og <semantic-model-item-id> med verdier for din Fabric-arbeidsplass og semantiske modell. Godkjenn kommandoene mens Copilot kjører dem, og fullfør Rayfin-innloggingsflyten når du blir bedt om det.

Spør Copilot om å bygge appen din

Beskriv appens målgruppe, spørsmål, interaksjoner og visualiseringer. Koblingen salesModel identifiserer allerede den semantiske modellen.

Bruk følgende prompt som en startoppskrift for en salgsytelsesutforsker. Tilpass forretningskravene til feltene som er tilgjengelige i modellen din.

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.

Gå gjennom Copilot sin plan før den redigerer prosjektet. Hvis planen ikke samsvarer med kravene dine, korriger den i Chat før du godkjenner gjennomføringen.

Gå gjennom de genererte endringene

Etter at Copilot er ferdig, be den om å gjennomgå arbeidet sitt:

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.

Inspiser kildekontroll-differensialen i Visual Studio Code. Vær spesielt oppmerksom på:

Koblingskonfigurasjonen salesModel , genererte skjema og DAX-spørringer.
Tjenestekonfigurasjon i rayfin/rayfin.yml.
Nye avhengigheter i package.json.
Autentisering endres eller direkte REST-kall som omgår koblingen.
Hemmeligheter eller kvalifikasjoner du ikke må forplikte.

Distribuer og verifiser forbindelsen til den semantiske modellen

Spør Copilot om å installere appen og verifisere tilkoblingen:

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.

Åpne appen fra Fabric-portalen for å teste live semantiske modellspørringer.

Valider appen

Spør Copilot om å kjøre prosjektets eksisterende validering:

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.

I Fabric-portalen, verifiser akseptkriteriene du ga Copilot. Testautentisering, filtre, kryssmarkering, dataformatering, tomme tilstander, feilhåndtering og resultatene fra hvert visuelt objekt.

Distribuer den ferdige appen

Etter at du har gjennomgått endringene og testet appen, be Copilot om å rulle den ut:

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.

Den samme npx rayfin up kommandoen oppdaterer en eksisterende distribusjon når du fortsetter å utvikle appen.

Fortsett å iterere med Copilot

Bruk fokuserte prompts for senere endringer. Inkluder ønsket atferd, berørte brukere, begrensninger og valideringstrinn.

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.

Hold hver forespørsel liten nok til å kunne gjennomgås. Forplikt deg til en fungerende tilstand før du ber Copilot om å gjøre en stor eller potensielt ødeleggende endring.

Feilsøk Copilot-arbeidsflyten

Copilot skriver bare ut kommandoer

Si til Copilot at han skal kjøre kommandoene selv og rapportere resultatene. Bekreft at chatten er i agentmodus og at terminaltilgangen er aktivert.

Fullfør nettleserens innloggingsflyt. Fortell deretter Copilot at innloggingen er fullført slik at det kan fortsette.

Copilot redigerer feil mappe

Stopp agenten, åpne den stillasbaserte prosjektmappen i Visual Studio Code, og start en ny chat fra det arbeidsområdet.

Distribusjon lykkes, men semantiske modell-spørringer feiler

Spør Copilot om å sjekke connectorens arbeidsområde og modell-IDer, Semantic Model Execute Queies REST API-leietakerinnstillingen, dine Build- og Read-tillatelser, generert DAX, koblingsfeilresultatet og nettleserkonsollen. Ikke bytt ut mislykkede spørringer med mock-data.

Copilot foreslår`--force`

Krev at Copilot viser de potensielt ødeleggende skjemaoperasjonene først. Aksepter --force kun når du forstår og godkjenner mulig datatap.

For andre problemer, se Troubleshoot Fabric Apps.

Tilbakemeldinger

Var denne siden nyttig?

Sist oppdatert 2026-09-29