Luo semanttinen mallisovellus GitHub Copilot -ohjelmalla

Käytä tätä reseptiä luodaksesi analyyttisen sovelluksen, joka on yhdistetty semanttiseen malliin GitHub Copilot-agentti -tilassa. Copilot tukee datasovelluksen mallipohjaa, lisää Fabric-semanttisen malliliittimen, luo DAX-kyselyitä ja visualisointeja sekä validoi sovelluksen.

Datasovelluspohja tarjoaa Fabric-tunnistautumisen, DAX-generoinnin ohjeistuksen, visuaaliset komponentit ja selaimen validoinnin. Liitin tarjoaa delegoidun semanttisen mallin pääsyn Fabric Apps -asiakasohjelman kautta. Lisätietoja on artikkelissa Semanttiseen malliin yhdistetyn sovelluksen luominen.

Tässä opetusohjelmassa:

  • Valmistele GitHub Copilot agenttivetoiseen kehitykseen.
  • Kysy Copilotilta tukemaan datasovelluksen pohjaa.
  • Yhdistä sovellus semanttiseen malliin.
  • Rakenna interaktiivinen myynnin suorituskykytutkija.
  • Tarkista ja validoi luodut muutokset.
  • Ota sovellus käyttöön Fabric-palvelussa.
  • Vahvista käyttöönotto ja avaa sovellus.

Edellytykset

  • Node.js 20 vuotta tai vanhempia.
  • Visual Studio Code.
  • GitHub Copilot Visual Studio Code -tilassa, agenttitila saatavilla.
  • GitHub tili, jolla on GitHub Copilot käyttöoikeus.
  • Microsoft-tili, jolla on pääsy Fabric-palveluun.
  • Fabric-työtila, jossa sinulla on Contributor-, Member- tai Admin-oikeudet.
  • Fabric Appsin työkuorma on käytössä vuokralaisellesi.
  • Semantic Model Execute Queries REST API -vuokralaisen asetus käytössä.
  • Rakenna ja lue oikeudet semanttiseen malliin, joka on isännöity Fabric- tai Power BI-kapasiteetissa.
  • Työtilan ID ja semanttisen mallin kohde-ID.

Note

Copilot pyytää hyväksyntää ennen terminaalikomentojen suorittamista. Sinun täytyy myös suorittaa interaktiivinen selaimen kirjautuminen, kun Rayfin CLI sitä pyytää.

Open GitHub Copilot-agentti mode

  1. Avaa Visual Studio Code.
  2. Avaa vanhempikansio, johon haluat Copilot'n luovan projektin.
  3. Avaa chat.
  4. Valitse agenttitila .
  5. Varmista, että agentilla on pääsy terminaaliin ja työtilaan.

Älä avaa kansiota, joka sisältää toisistaan riippumattomia tiedostoja, joita et halua Copilot'n tarkastavan tai muokkaavan.

Scaffold-datasovellus

Kopioi seuraava kehote Copilot Chat:iin:

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.

Korvaa <workspace-name>, <workspace-id>, ja <semantic-model-item-id> arvoilla Fabric-työtilallesi ja semanttisille malleillesi. Hyväksy komennot, kun Copilot suorittaa ne, ja suorita Rayfin-kirjautumisprosessi loppuun pyydettäessä.

Kysy Copilotilta tekemään sovelluksesi

Kuvaile sovelluksen yleisöä, kysymyksiä, vuorovaikutuksia ja visualisointeja. Liitin salesModel tunnistaa jo semanttisen mallin.

Käytä seuraavaa kehotetta aloitusreseptinä myyntisuorituskyvyn tarkastelijalle. Mukauta liiketoimintavaatimukset mallisi tarjolla oleviin aloihin.

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.

Tarkista Copilot'n suunnitelma ennen kuin se muokkaa projektia. Jos suunnitelma ei vastaa vaatimuksiasi, korjaa se chatissa ennen toteutuksen hyväksymistä.

Tarkastele luotuja muutoksia

Kun Copilot on valmis, pyydä sitä arvioimaan työnsä:

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.

Tutki version hallinta-ero Visual Studio Code:ssa. Kiinnitä erityistä huomiota:

  • Liittimen salesModel konfiguraatio, generoitu skeema ja DAX-kyselyt.
  • Palvelukonfiguraatio .rayfin/rayfin.yml
  • Uudet riippuvuudet .package.json
  • Tunnistautumisen muutokset tai suorat REST-kutsut, jotka ohittavat liittimen.
  • Salaisuuksia tai pätevyyksiä, joita ei saa sitoa.

Ota käyttöön ja varmista semanttinen malliyhteys

Kysy Copilotilta ottamaan sovelluksen käyttöön ja varmista sen yhteys:

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.

Avaa sovellus Fabric-portaalista testataksesi reaaliaikaisia semanttisia mallikyselyjä.

Vahvista sovellus

Kysy Copilotilta suorittamaan projektin olemassa oleva validointi:

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.

Fabric-portaalissa tarkista hyväksymiskriteerit, jotka annoit Copilotille. Testien todennus, suodattimet, ristiinkorostus, datan muotoilu, tyhjät tilat, virheenkäsittely ja jokaisen visuaalin tulokset.

Ota valmis sovellus käyttöön

Kun olet tarkistanut muutokset ja testannut sovelluksen, pyydä Copilot ottamaan se käyttöön:

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.

Sama npx rayfin up komento päivittää olemassa olevan käyttöönoton, kun jatkat sovelluksen kehittämistä.

Jatka iterointia Copilotin kanssa

Käytä kohdennettuja kehotuksia myöhempiin muutoksiin. Sisällytä haluttu käyttäytyminen, vaikuttaneet käyttäjät, rajoitteet ja validointivaiheet.

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.

Pidä jokainen pyyntö tarpeeksi pienenä tarkistettavaksi. Sitoudu toimivaan tilaan ennen kuin pyydät Copilotia tekemään suuren tai mahdollisesti tuhoisan muutoksen.

Vianetsintä Copilot-työnkulussa

Copilot tulostaa vain komentoja

Käskekää Copilotia suorittamaan komennot itse ja raportoimaan tulokset. Varmista, että Chat on agenttitilassa ja terminaalikäyttö on käytössä.

Komento odottaa kirjautumista

Viimeistele selaimen kirjautumisprosessi. Sitten kerro Copilotille, että kirjautuminen on valmis, jotta se voi jatkua.

Copilot muokkaa väärää kansiota

Pysäytä agentti, avaa telineinen projektikansio Visual Studio Code:ssa ja käynnistä uusi Chat kyseisestä työtilasta.

Käyttöönotto onnistuu, mutta semanttiset mallikyselyt epäonnistuvat

Kysy Copilotilta tarkistamaan liittimen työtilan ja mallin ID:t, Semantic Model Execute Queries REST API -vuokralaisen asetuksen, Build and Read -oikeudet, generoidun DAX:n, connector-virheen tuloksen sekä selainkonsolin. Älä korvaa epäonnistuneita kyselyjä mock-datalla.

Copilot ehdottaa--force

Vaaditaan, että Copilot näyttää ensin mahdollisesti tuhoisat skeemaoperaatiot. Hyväksy --force vasta, kun ymmärrät ja hyväksyt mahdollisen tiedonkatoamisen.

Muita ongelmia varten katso Troubleshoot Fabric Apps.

Liittyvä sisältö

  • Viimeksi päivitetty