Vytvořte aplikaci pro sémantický model pomocí GitHub Copilot

Použijte tento recept k vytvoření analytické aplikace propojené se sémantickým modelem v režimu GitHub agent Copilota. Copilot vytváří šablonu datové aplikace, přidává konektor Fabric pro sémantické modely, vytváří DAX dotazy a vizualizace a ověřuje aplikaci.

Šablona datové aplikace poskytuje autentizaci Fabric, pokyny k generování DAX, vizuální komponenty a ověřování prohlížeče. Konektor poskytuje delegovaný přístup k sémantickým modelům prostřednictvím klienta Fabric Apps. Další informace najdete v tématu Vytvoření aplikace připojené k sémantickému modelu.

V tomto kurzu se naučíte:

  • Připravte GitHub Copilot pro vývoj řízený agenty.
  • Požádejte Copilota o vygenerování šablony datové aplikace.
  • Připojte aplikaci k sémantickému modelu.
  • Vytvořte interaktivní průzkumník prodejního výkonu.
  • Zkontrolujte a ověřte generované změny.
  • Nasadit aplikaci do Fabric.
  • Ověřte nasazení a otevřete aplikaci.

Předpoklady

  • Node.js 20 nebo novější.
  • Visual Studio Code.
  • GitHub Copilot ve Visual Studio Code s dostupným agentním režimem.
  • Účet GitHub s přístupem k GitHub Copilot.
  • účet Microsoft s přístupem k Fabric.
  • Pracovní prostor Fabric, kde máte oprávnění přispěvatele, člena nebo správce.
  • Pracovní zátěž Fabric Apps byla zapnuta pro vašeho tenanta.
  • Sémantický model spouští dotazy s povoleným nastavením tenanta rozhraní REST API.
  • Oprávnění pro tvorbu a čtení na sémantickém modelu hostovaném na kapacitě Fabric nebo Power BI.
  • ID pracovního prostoru a ID položky pro sémantický model.

Poznámka:

Copilot žádá o schválení před vykonáním terminálních příkazů. Musíte také provést interaktivní přihlášení do prohlížeče, když o to požaduje příkaz Rayfin CLI.

Otevřít režim agenta GitHub Copilot

  1. Otevřete Visual Studio Code.
  2. Otevřete nadřazenou složku, kde chcete, aby Copilot vytvořil projekt.
  3. Otevřete chat.
  4. Vyberte režim agenta .
  5. Ověřte, že agent má přístup k terminálu a pracovnímu prostoru.

Neotevírejte složku, která obsahuje nesouvisející soubory, které nechcete, aby Copilot kontroloval nebo upravoval.

Vytvořte kostru datové aplikace

Zkopírujte následující 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 pro váš pracovní prostor Fabric a sémantický model. Schvalte příkazy tak, jak je Copilot spouští, a až k tomu budete vyzváni, dokončete proces přihlášení ke službě Rayfin.

Zeptejte se Copilota, aby vytvořil vaši aplikaci

Popište publikum, otázky, interakce a vizualizace aplikace. Konektor salesModel již identifikuje sémantický model.

Použijte následující prompt jako výchozí šablonu pro průzkumník výkonu prodeje. Přizpůsobte obchodní požadavky oborům dostupným ve vašem modelu.

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.

Než Copilot upraví projekt, projděte si jeho plán. Pokud plán neodpovídá vašim požadavkům, opravte ho v chatu před schválením implementace.

Kontrola vygenerovaných změn

Až Copilot dokončí práci, požádejte ho, aby zkontroloval svou vlastní práci:

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.

Prohlédněte si rozdíly ve správě zdrojového kódu ve Visual Studio Code. Věnujte zvláštní pozornost:

  • Konfigurace salesModel konektoru, generované schéma a dotazy DAX.
  • Konfigurace služby v rayfin/rayfin.yml.
  • Nové závislosti v package.json.
  • Autentizační změny nebo přímé REST hovory, které obcházejí konektor.
  • Tajemství nebo pověření, která nesmíte prozradit.

Nasadit a ověřit spojení se sémantickým modelem

Zeptejte se Copilota, aby aplikaci nasadil a ověřil její připojení:

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.

Otevřete aplikaci z portálu Fabric a otestujte živé dotazy na sémantické modely.

Ověření aplikace

Požádejte Copilot, aby spustil stávající ověření 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álu Fabric ověřte kritéria přijetí, která jste dali Copilot. Testujte autentizaci, filtry, křížové zvýrazňování, formátování dat, prázdné stavy, zpracování chyb a výsledky každého vizuálu.

Nasadit hotovou aplikaci

Po zhodnocení změn a otestování aplikace požádejte Copilot, aby ji 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.

Stejný npx rayfin up příkaz aktualizuje existující nasazení, když pokračujete ve vývoji aplikace.

Pokračujte v iteraci s Copilot

Používejte zaměřené výzvy pro pozdější změny. Zahrňte požadované chování, postižené uživatele, omezení 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.

Každý požadavek udržujte dostatečně malý, aby ho bylo možné zkontrolovat. Než požádáte Copilot o velkou nebo potenciálně destruktivní změnu, zajistěte funkční stav.

Řešení problémů s workflow Copilot

Copilot tiskne pouze příkazy

Řekněte Copilot, aby sám spustil příkazy a nahlásil výsledky. Ověřte, že chat je v agentním režimu a že je povolen přístup na terminál.

Na přihlášení čeká příkaz

Dokončete přihlašovací proces prohlížeče. Pak řekněte Copilot, že přihlášení je dokončeno, aby mohl pokračovat.

Copilot upravuje špatnou složku

Zastavte agenta, otevřete složku vygenerovaného projektu ve Visual Studio Code a v tomto pracovním prostoru zahajte nový chat.

Nasazení uspěje, ale sémantické modelové dotazy selžou

Požádejte Copilota, aby zkontroloval ID pracovního prostoru a modelu konektoru, nastavení tenanta pro REST API Semantic Model Execute Queries, vaše oprávnění Build a Read, vygenerovaný kód DAX, chybový výstup konektoru a konzoli prohlížeče. Nenahrazujte neúspěšné dotazy fiktivními daty.

Copilot navrhuje--force

Vyžadovat, aby Copilot nejprve ukázal potenciálně destruktivní operace schématu. Přijímejte --force pouze tehdy, když pochopíte a schválíte možnou ztrátu dat.

Pro další problémy viz Troubleshoot Fabric Apps.

Související obsah

  • Poslední aktualizace v