Hozz létre egy szemantikai modellalkalmazást a GitHub Copilot-szal

Ezt a receptet használd egy analitikus alkalmazáshoz, amely egy szemantikai modellhez kapcsolódik GitHub Copilot-ügynök móddal. A Copilot megerősíti az adatalkalmazás sablonját, hozzáad egy Fabric szemantikai modellcsatlakozót, DAX lekérdezéseket és vizualizációkat hoz létre, valamint validálja az alkalmazást.

Az adatalkalmazás sablon Fabric hitelesítést, DAX generálási útmutatást, vizuális komponenseket és böngésző validációt biztosít. A csatlakozó a Fabric Apps kliensen keresztül biztosít delegált szemantikai modell-hozzáférést. További információ: Szemantikai modellhez csatlakoztatott alkalmazás létrehozása.

Ebben az oktatóanyagban a következőket fogja megtanulni:

  • Készítsd elő a GitHub Copilot-t ügynökvezérelt fejlesztésre.
  • Kérje meg a Copilotot, hogy hozza létre az adatalkalmazás-sablont.
  • Kapcsold az alkalmazást egy szemantikai modellhez.
  • Építs egy interaktív értékesítési teljesítménykutatót.
  • Nézze át és validálja a generált változtatásokat.
  • Telepítsd az alkalmazást a Fabric-re.
  • Ellenőrizd a telepítést, és nyisd meg az alkalmazást.

Prerequisites

  • Node.js 20 vagy újabb.
  • Visual Studio Code.
  • GitHub Copilot Visual Studio Code-ban, ügynök móddal elérhető.
  • GitHub Copilot hozzáféréssel rendelkező GitHub fiók.
  • Egy Fabric hozzáféréssel rendelkező Microsoft-fiók.
  • Egy Fabric munkaterület, ahol közreműködői, tagi vagy rendszergazdai engedélyekkel rendelkezik.
  • A Fabric Apps munkaterhelése engedélyezve a bérlő számára.
  • A szemantikai modell lekérdezések végrehajtása REST API-bérlőbeállítás engedélyezve van.
  • Építsd és olvasd el a jogosultságokat egy szemantikai modellen, amely Fabric vagy Power BI kapacitáson hosztozott.
  • A szemantikai modell munkaterület azonosítója és elemazonosítója.

Megjegyzés:

Copilot jóváhagyást kér, mielőtt végállomásparancsokat indítana. Az interaktív böngészőbejelentkezést is be kell fejezni, amikor a Rayfin CLI kéri.

Nyissa meg a GitHub Copilot ügynökmódját

  1. Nyissa meg Visual Studio kódot.
  2. Nyisd meg a szülőmappát, ahol a Copilot létrehozza a projektet.
  3. Nyissa meg a Csevegést.
  4. Ügynök mód kiválasztása.
  5. Erősítse meg, hogy az ügynök hozzáfér a terminálhoz és a munkaterülethez.

Ne nyiss meg olyan mappát, amely nem kapcsolódó fájlokat tartalmaz, amelyeket nem szeretnél, hogy a Copilot átvizsgálja vagy módosítson.

Az adatalkalmazás vázának létrehozása

Másold le az alábbi promptot a Copilot Chat-be:

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.

Cseréld le a(z) <workspace-name>, <workspace-id> és <semantic-model-item-id> elemeket a Fabric-munkaterületedhez és a szemantikai modelledhez tartozó értékekre. Hagyd jóvá a parancsokat, miközben a Copilot futtatja őket, és fejezd be a Rayfin bejelentkezési folyamatot, ha kérik.

A Copilot megkérdezése-t, hogy készítse el az alkalmazásodat

Írja le az alkalmazás közönségét, kérdéseit, interakcióit és vizualizációit. A salesModel csatlakozó már azonosítja a szemantikai modellt.

Használd a következő promptot kezdőreceptként egy értékesítési teljesítmény felfedezőhöz. Igazítsd az üzleti követelményeket a modelled területeihez.

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.

Nézze át a Copilot tervét, mielőtt szerkeszti a projektet. Ha a terv nem felel meg az igényeidnek, javítsd ki a Chatben, mielőtt jóváhagynád a megvalósítást.

A létrehozott módosítások áttekintése

Miután a Copilot befejezte, kérd meg, hogy tekintse át a munkáját:

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.

Vizsgáld meg a forrásvezérlő diff-et a Visual Studio Code-ban. Különös figyelmet fordítsunk arra:

  • A salesModel csatlakozó konfigurációja, generált séma és DAX lekérdezések.
  • A szolgáltatás konfigurációja itt: rayfin/rayfin.yml.
  • Új függőségek itt: package.json.
  • Hitelesítési változások vagy közvetlen REST hívások, amelyek megkerülik a csatlakozót.
  • Titkos adatokat vagy bejelentkezési adatokat, amelyeket nem szabad véglegesítened.

Telepítsd és ellenőrizd a szemantikai modell kapcsolatot

Kérd meg a Copilotot, hogy telepítse az alkalmazást, és ellenőrizze annak kapcsolódását:

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.

Nyisd meg az alkalmazást a Fabric portálról, hogy teszteld az élő szemantikai modell lekérdezéseket.

Az alkalmazás ellenőrzése

A Copilot megkérdezése-t, hogy végezze el a projekt meglévő validációját:

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.

A Fabric portálon ellenőrizd a Copilot-nak megadott elfogadási feltételeket. Tesztelje a hitelesítést, a szűrőket, a keresztkiemelést, az adatformázást, az üres állapotokat, a hibakezelést és az egyes vizualizációk eredményeit.

Telepítsd a kész alkalmazást

Miután átnézted a változtatásokat és tesztelted az alkalmazást, kérd meg a Copilot-t, hogy telepítse azt:

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.

Ugyanaz npx rayfin up a parancs frissíti a meglévő telepítést, amikor folytatod az alkalmazás fejlesztését.

Folytasd az iterációt a Copilot-szal

Használj fókuszált promptokat a későbbi változtatásokhoz. Tartalmazza a kívánt viselkedést, az érintett felhasználókat, a korlátozásokat és az érvényesítési lépéseket.

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.

Minden kérést elég kicsinek tartsd átnézéshez. Kötelezz el egy működő állapotot, mielőtt megkérnéd a Copilot-t, hogy hajtson végre nagy vagy potenciálisan romboló változást.

Hibakeresés a Copilot munkafolyamatában

A Copilot csak parancsokat nyomtat

Mondd meg a Copilot-nak, hogy maga futtatja a parancsokat, és jelentse az eredményeket. Erősítsd meg, hogy a Chat ügynök módban van, és a terminálhozzáférés engedélyezve van.

Egy parancs vár a bejelentkezésre

Fejezd be a böngésző bejelentkezési folyamatát. Ezután mondd meg a Copilot-nak, hogy a bejelentkezés befejeződött, hogy folytathashasd.

A Copilot rossz mappát szerkeszt

Állítsd meg az ügynököt, nyisd meg a projektmappát a Visual Studio Code-ban, és indíts egy új chatet abból a munkatérből.

A telepítés sikerrel jár, de szemantikai modell lekérdezések hibáznak

Kérje meg a Copilotot, hogy ellenőrizze az összekötő munkaterületét és modellazonosítóit, a Semantic Model Execute Queries REST API bérlői beállítását, a Build és Read engedélyeit, a generált DAX-ot, az összekötő hibaeredményét és a böngészőkonzolt. Ne cseréld a sikertelen lekérdezéseket mock adatokkal.

Copilot javasolja--force

Követelje meg, hogy a Copilot először a potenciálisan roncsoló sémaműveleteket jelenítse meg. Csak akkor fogadd el --force , ha megérted és jóváhagyod az esetleges adatvesztést.

Egyéb problémákért lásd: Troubleshoot Fabric Apps.

Kapcsolódó tartalom

  • Utolsó frissítés időpontja: