Vytvorte aplikáciu na sémantický model pomocou GitHub Copilot

Použite tento recept na vytvorenie analytickej aplikácie prepojenej so sémantickým modelom v režime GitHub agent Copilota. Copilot vytvára šablónu dátovej aplikácie, pridáva Fabric sémantický modelový konektor, vytvára DAX dotazy a vizualizácie a overuje aplikáciu.

Šablóna dátovej aplikácie poskytuje autentifikáciu Fabric, pokyny na generovanie DAX, vizuálne komponenty a overenie prehliadača. Konektor poskytuje delegovaný prístup k sémantickým modelom prostredníctvom klienta Fabric Apps. Ďalšie informácie nájdete v téme Vytvorenie aplikácie pripojenej k sémantickému modelu.

V tomto kurze:

Pripravte GitHub Copilot na vývoj riadený agentmi.
Spýtať sa Copilota, aby vytvoril šablónu dátovej aplikácie.
Pripojte aplikáciu k sémantickému modelu.
Vytvorte interaktívny prieskumník predajnej výkonnosti.
Skontrolujte a overte vygenerované zmeny.
Nainštalujte aplikáciu do Fabric.
Overte nasadenie a otvorte aplikáciu.

Požiadavky

Node.js 20 alebo neskôr.
Visual Studio Code.
GitHub Copilot vo Visual Studio Code s dostupným agentovým režimom.
Účet na GitHub s prístupom k GitHub Copilot.
Konto Microsoft s prístupom k Fabric.
Fabric pracovný priestor, kde máte oprávnenia prispievateľa, člena alebo administrátora.
Záťaž Fabric Apps je zapnutá pre vášho tenanta.
Nastavenie nájomcu SEMANTIC Model Execute Queries REST API je zapnuté.
Build and Read oprávnenia na sémantický model hostovaný na kapacite Fabric alebo Power BI.
Workspace ID a item ID pre sémantický model.

Poznámka

Copilot žiada o schválenie predtým, než spustí terminálne príkazy. Musíte tiež vykonať interaktívne prihlásenie do prehliadača, keď to vyžaduje Rayfin CLI.

Otvorte GitHub agent Copilota mode

Otvorte Visual Studio Code.
Otvorte rodičovský priečinok, kde chcete, aby Copilot vytvoril projekt.
Otvorte chat.
Vyberte režim agenta .
Potvrďte, že agent má prístup k terminálu a pracoviskám.

Neotvárajte priečinok, ktorý obsahuje nesúvisiace súbory, ktoré nechcete, aby Copilot kontroloval alebo upravoval.

Scaffol dátovú aplikáciu

Skopírujte nasledujúci prompt do 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.

Nahraďte <workspace-name>, <workspace-id>, a <semantic-model-item-id> hodnotami pre váš Fabric workspace a sémantický model. Schvaľujte príkazy, keď ich Copilot spúšťa, a dokončujte prihlasovací proces Rayfin, keď je to vyzvané.

Spýtať sa Copilota, aby vytvoril vašu aplikáciu

Opíšte publikum, otázky, interakcie a vizualizácie aplikácie. Konektor salesModel už identifikuje sémantický model.

Použite nasledujúci prompt ako štartovací recept na prieskum predajnej výkonnosti. Prispôsobte obchodné požiadavky oblastiam dostupným vo vašom modeli.

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.

Preštudujte si plán Copilot predtým, než projekt upraví. Ak plán nespĺňa vaše požiadavky, opravte ho v Chate pred schválením implementácie.

Skontrolujte generované zmeny

Keď Copilot skončí, požiadajte ho, aby zhodnotil svoju prácu:

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.

Skontrolujte rozdiel správy zdrojového kódu vo Visual Studio Code. Venujte osobitnú pozornosť:

Konfigurácia salesModel konektora, generovaná schéma a DAX dotazy.
Konfigurácia služby v rayfin/rayfin.yml.
Nové závislosti v package.json.
Autentifikačné zmeny alebo priame REST volania, ktoré obchádzajú konektor.
Tajomstvá alebo poverenia, ktoré nesmiete prezradiť.

Nasadenie a overenie spojenia sémantického modelu

Spýtať sa Copilota, aby aplikáciu nasadil a overil jej pripojenie:

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.

Otvorte aplikáciu cez portál Fabric a otestujte živé dotazy na sémantické modely.

Overte aplikáciu

Spýtať sa Copilota, aby spustil existujúcu validáciu projektu:

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.

V portáli Fabric overte kritériá prijatia, ktoré ste dali Copilot. Testujte autentifikáciu, filtre, krížové zvýrazňovanie, formátovanie dát, prázdne stavy, spracovanie chýb a výsledky každého vizuálu.

Nasadiť hotovú aplikáciu

Po preštudovaní zmien a otestovaní aplikácie požiadajte Copilot, aby ju nasadil:

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.

Ten istý npx rayfin up príkaz aktualizuje existujúce nasadenie, keď pokračujete vo vývoji aplikácie.

Pokračovať v iterácii s Copilot

Používajte zamerané prompty na neskoršie zmeny. Zahrňte požadované správanie, postihnutých používateľov, obmedzenia a validačné kroky.

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.

Udržujte každú požiadavku dostatočne malú na preštudovanie. Zaveďte funkčný stav skôr, než požiadate Copilot o veľkú alebo potenciálne deštruktívnu zmenu.

Riešenie problémov s pracovným postupom Copilot

Copilot tlačí iba príkazy

Povedz Copilot, aby sám spustil príkazy a nahlásil výsledky. Potvrď, že chat je v agentnom režime a že je povolený prístup k terminálu.

Dokončite prihlasovací proces prehliadača. Potom povedz Copilot, že prihlásenie je dokončené, aby mohol pokračovať.

Copilot upravuje nesprávny priečinok

Zastavte agenta, otvorte scaffolded priečinok projektu vo Visual Studio Code a začnite nový chat z tohto pracovného priestoru.

Nasadenie je úspešné, ale sémantické modelové dotazy zlyhajú

Spýtať sa Copilota, aby skontroloval pracovný priestor konektora a ID modelov, nastavenie nájomcu SEMANTIC Model Execute Queries REST API, vaše Build and Read oprávnenia, vygenerovaný DAX, výsledok chyby konektora a konzolu prehliadača. Nenahrádzajte neúspešné dotazy mock dátami.

Copilot navrhuje`--force`

Vyžaduj, aby Copilot najprv ukázal potenciálne deštruktívne schémové operácie. Prijmite --force len vtedy, keď pochopíte a schválite možnú stratu dát.

Pre ďalšie problémy pozri Troubleshoot Fabric Apps.

Pripomienky

Bola táto stránka užitočná?

Naposledy aktualizované: 2026-09-29