GitHub Copilot ile bir semantik model uygulaması oluşturun

Bu tarifi kullanarak GitHub Copilot aracısı modunda bir anlamsal modele bağlı bir analitik uygulama oluşturun. Copilot, veri uygulaması şablonunu destekler, bir Fabric anlamsal model bağlayıcısı ekler, DAX sorguları ve görselleştirmeleri oluşturur ve uygulamayı doğrular.

Veri uygulaması şablonu, Fabric kimlik doğrulama, DAX oluşturma rehberliği, görsel bileşenler ve tarayıcı doğrulaması sağlar. Bağlayıcı, Fabric Apps istemcisi aracılığıyla delege edilmiş anlamsal model erişimi sağlar. Daha fazla bilgi için bkz. Anlam modeline bağlı bir uygulama oluşturma.

Bu eğitimde şunları yapacaksınız:

  • GitHub Copilot'u ajan odaklı geliştirmeye hazırlayın.
  • Copilot’tan veri uygulaması şablonunu oluşturmasını isteyin.
  • Uygulamayı bir semantik modele bağlayın.
  • Etkileşimli bir satış performans keşfeticisi oluşturun.
  • Oluşturulan değişiklikleri gözden geçirin ve doğrulayın.
  • Uygulamayı Fabric'e dağıtın.
  • Dağıtımı doğrulayın ve uygulamayı açın.

Prerequisites

  • Node.js 20 veya üzeri.
  • Visual Studio Code.
  • GitHub Copilot in Visual Studio Code ile agent modu mevcut.
  • GitHub Copilot erişimi olan bir GitHub hesabı.
  • Fabric'e erişimi olan bir Microsoft hesabı.
  • Katkıda Bulunan, Üye veya Yönetici izinlerine sahip olduğunuz bir Fabric çalışma alanı.
  • Fabric Apps iş yükü kiracınız için etkinleştirildi.
  • Semantik Model Sorgu Yürütme REST API kiracı ayarı etkinleştirildi.
  • Fabric veya Power BI kapasitesinde barındırılan bir semantik model üzerindeki Oluşturma ve Okuma izinleri.
  • Çalışma alanı kimliği ve anlamsal model için öğe kimliği.

Uyarı

Copilot, terminal komutları çalıştırmadan önce onay ister. Ayrıca Rayfin CLI istediğinde etkileşimli tarayıcı girişini tamamlamanız gerekir.

GitHub Copilot aracı modunu açın

  1. Visual Studio Code'u açın.
  2. Copilot'un projeyi oluşturmasını istediğiniz ana klasörü açın.
  3. Sohbet'i açın.
  4. Aracı modunu seçin.
  5. Temsilcinin terminal ve çalışma alanına erişimi olduğunu doğrulayın.

Copilot'un incelemesini veya değiştirmesini istemediğiniz alakasız dosyalar içeren bir klasörü açmayın.

Veri uygulamasını iskele yapın

Aşağıdaki öneriyi Copilot Chat'e kopyalayın:

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.

<workspace-name>, <workspace-id>, ve <semantic-model-item-id> yerine Fabric çalışma alanı ve anlamsal modeliniz için değerler ekleyin. Copilot komutları çalıştırırken komutları onaylayın ve istendiğinde Rayfin oturum açma akışını tamamlayın.

Copilot'a Sor'a uygulamanızı oluşturmasını söyleyin

Uygulamanın hedef kitlesini, sorularını, etkileşimlerini ve görselleştirmelerini tanımlayın. Bağlantı salesModel zaten anlamsal modeli tanımlıyor.

Aşağıdaki promptu, bir satış performans keşfeticisi için başlangıç tarifi olarak kullanın. İş gereksinimlerini modelinizdeki alanlara göre uyarlayın.

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.

Copilot'un planını proje düzenlemeden önce gözden geçirin. Plan gereksinimlerinizle uyuşmuyorsa, uygulamayı onaylamadan önce Sohbet'te düzeltin.

Oluşturulan değişiklikleri gözden geçirme

Copilot bitirdikten sonra, çalışmalarını gözden geçirmesini iste:

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.

Visual Studio Code'ta kaynak kontrol farkını inceleyin. Özellikle şunlara dikkat edin:

  • Konnektör salesModel konfigürasyonu, oluşturulan şema ve DAX sorguları.
  • rayfin/rayfin.yml içinde hizmet yapılandırması.
  • package.json içindeki yeni bağımlılıklar.
  • Kimlik doğrulama değişiklikleri veya bağlayıcıyı atlayan doğrudan REST çağrıları.
  • Commit etmemeniz gereken sırlar veya kimlik bilgileri.

Anlamsal model bağlantısını dağıtın ve doğrulayın

Copilot'a Sor'a uygulamayı dağıtmasını ve bağlantısını doğrulamasını söyleyin:

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.

Uygulamayı Fabric portalından açın ve canlı anlamsal model sorgularını test edin.

Uygulamayı doğrulama

Copilot'tan projenin mevcut doğrulamasını çalıştırmasını isteyin:

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 portalında, Copilot'a verdiğiniz kabul kriterlerini doğrulayın. Kimlik doğrulamayı, filtreleri, çapraz vurgulamayı, veri biçimlendirmeyi, boş durumları, hata işlemeyi ve her görselin sonuçlarını test edin.

Bitmiş uygulamayı dağıtın

Değişiklikleri gözden geçirip uygulamayı test ettikten sonra, Copilot'tan uygulamayı dağıtmasını iste:

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.

Aynı npx rayfin up komut, uygulamayı geliştirmeye devam ettiğinizde mevcut bir dağıtımı güncelliyor.

Copilot ile yinelemeye devam edin

Daha sonraki değişiklikler için odaklanmış istemler kullanın. İstenen davranışı, etkilenen kullanıcıları, kısıtlamaları ve doğrulama adımlarını dahil edin.

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.

Her talebi gözden geçirebileceğiniz kadar küçük tutun. Copilot'tan büyük veya potansiyel olarak yıkıcı bir değişiklik yapmasını istemeden önce çalışır durumdaki hâli commit edin.

Copilot iş akışındaki sorunları giderin

Copilot sadece komutları yazdırır

Copilot'a komutları kendisi çalıştırmasını ve sonuçları raporlamasını söyle. Chat'in Ajan modunda olduğunu ve terminal erişiminin etkin olduğunu doğrulayın.

Bir komut giriş için bekliyor

Tarayıcı giriş akışını tamamla. Sonra Copilot'a giriş tamamlandığını söyleyin ki devam edebilsin.

Copilot yanlış klasörü düzenliyor

Ajanı durdurun, Visual Studio Code'ta iskele proje klasörünü açın ve o çalışma alanından yeni bir Sohbet başlatın.

Dağıtım başarılı olur ancak semantik model sorguları başarısız olur

Copilot'a Sor'a bağlayıcının çalışma alanı ve model kimliklerini, Semantic Model Execute Queries REST API kiracı ayarlarını, Build and Read izinlerinizi, oluşturulan DAX'ı, konnektör hata sonucunu ve tarayıcı konsolunu kontrol etmesini iste. Başarısız sorguları sahte veriyle değiştirmeyin.

Copilot öneriyor--force

Copilot'un önce potansiyel yıkıcı şema operasyonlarını göstermesini iste. Yalnızca olası veri kaybını anladığınızda ve onayladığınızda kabul --force edin.

Diğer sorunlar için Troubleshoot Fabric Apps'a bakınız.

İlgili içerik

  • Son güncelleştirme: