Δημιουργία εφαρμογής μοντέλου σημασιολογίας με το GitHub Copilot

Χρησιμοποιήστε αυτήν τη συνταγή για να δημιουργήσετε μια εφαρμογή ανάλυσης συνδεδεμένη σε ένα μοντέλο σημασιολογίας με τη λειτουργία GitHub παράγοντας Copilot. Το Copilot υποστηρίζει το πρότυπο εφαρμογής δεδομένων, προσθέτει μια σύνδεση μοντέλου σημασιολογίας Fabric, δημιουργεί ερωτήματα και απεικονίσεις DAX και επικυρώνει την εφαρμογή.

Το πρότυπο εφαρμογής δεδομένων παρέχει έλεγχο ταυτότητας Fabric, οδηγίες δημιουργίας DAX, οπτικά στοιχεία και επικύρωση προγράμματος περιήγησης. Η σύνδεση παρέχει πρόσβαση σε σημασιολογικό μοντέλο με ανάθεση μέσω του προγράμματος-πελάτη Fabric Apps. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία εφαρμογής που είναι συνδεδεμένη με ένα μοντέλο σημασιολογίας.

Σε αυτό το πρόγραμμα εκμάθησης:

Προετοιμάστε το GitHub Copilot για ανάπτυξη βάσει εκπροσώπου.
Ρωτήστε το Copilot να υποστηρίξει το πρότυπο εφαρμογής δεδομένων.
Συνδέστε την εφαρμογή σε ένα μοντέλο σημασιολογίας.
Δημιουργήστε έναν διαδραστικό εξερευνητή απόδοσης πωλήσεων.
Ελέγξτε και επικυρώστε τις αλλαγές που δημιουργούνται.
Αναπτύξτε την εφαρμογή στο Fabric.
Επαληθεύστε την ανάπτυξη και ανοίξτε την εφαρμογή.

Προϋποθέσεις

Node.js 20 ή μεταγενέστερη έκδοση.
Visual Studio Code.
GitHub Copilot στον κώδικα του Visual Studio Code με διαθέσιμη λειτουργία παράγοντα.
Ένας λογαριασμός GitHub με πρόσβαση στο GitHub Copilot.
Ένας λογαριασμός Λογαριασμός Microsoft με πρόσβαση στο Fabric.
Ένας χώρος εργασίας Fabric όπου έχετε δικαιώματα συμβάλλου, μέλους ή διαχειριστή.
Ο φόρτος εργασίας Fabric Apps είναι ενεργοποιημένος για τον μισθωτή σας.
Ενεργοποιήθηκε η ρύθμιση μισθωτή REST API εκτέλεσης ερωτημάτων σημασιολογικού μοντέλου.
Δικαιώματα δημιουργίας και ανάγνωσης σε ένα σημασιολογικό μοντέλο που φιλοξενείται σε εκχωρημένους πόρους Fabric ή Power BI.
Το αναγνωριστικό χώρου εργασίας και το αναγνωριστικό στοιχείου για το μοντέλο σημασιολογίας.

Σημείωμα

Το Copilot ζητά έγκριση πριν εκτελέσει εντολές τερματικού. Πρέπει επίσης να ολοκληρώσετε τη διαδραστική σύνδεση στο πρόγραμμα περιήγησης όταν το ζητήσει το Rayfin CLI.

Ανοίξτε τη λειτουργία GitHub παράγοντας Copilot

Ανοίξτε Visual Studio Code.
Ανοίξτε τον γονικό φάκελο όπου θέλετε το Copilot να δημιουργήσει το έργο.
Ανοίξτε το Chat.
Επιλέξτε Λειτουργία παράγοντα.
Επιβεβαιώστε ότι ο εκπρόσωπος έχει πρόσβαση στο τερματικό και στο χώρο εργασίας.

Μην ανοίγετε ένα φάκελο που περιέχει άσχετα αρχεία που δεν θέλετε να επιθεωρήσει ή να τροποποιήσει το Copilot.

Σκαλωσιά της εφαρμογής δεδομένων

Αντιγράψτε την ακόλουθη προτροπή στο 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.

Αντικαταστήστε <workspace-name>τις τιμές , <workspace-id>και <semantic-model-item-id> με τιμές για τον χώρο εργασίας και το σημασιολογικό μοντέλο Fabric. Εγκρίνετε τις εντολές καθώς τις εκτελεί το Copilot και ολοκληρώστε τη ροή εισόδου Rayfin όταν σας ζητηθεί.

Ρωτήστε το Copilot να δημιουργήσει την εφαρμογή σας

Περιγράψτε το κοινό, τις ερωτήσεις, τις αλληλεπιδράσεις και τις απεικονίσεις της εφαρμογής. Η salesModel σύνδεση προσδιορίζει ήδη το σημασιολογικό μοντέλο.

Χρησιμοποιήστε την παρακάτω προτροπή ως αρχική συνταγή για έναν εξερευνητή απόδοσης πωλήσεων. Προσαρμόστε τις επιχειρηματικές απαιτήσεις στα πεδία που είναι διαθέσιμα στο μοντέλο σας.

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 προτού επεξεργαστεί το έργο. Εάν το σχέδιο δεν ανταποκρίνεται στις απαιτήσεις σας, διορθώστε το στο Chat πριν εγκρίνετε την υλοποίηση.

Ελέγξτε τις αλλαγές που δημιουργήθηκαν

Αφού τελειώσει το Copilot, ζητήστε του να ελέγξει την εργασία του:

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. Δώστε ιδιαίτερη προσοχή στα εξής:

Η ρύθμιση παραμέτρων σύνδεσης, το σχήμα που δημιουργήθηκε και τα salesModel ερωτήματα DAX.
Διαμόρφωση υπηρεσίας σε rayfin/rayfin.yml.
Νέες εξαρτήσεις στο package.json.
Αλλαγές ελέγχου ταυτότητας ή άμεσες κλήσεις REST που παρακάμπτουν τη σύνδεση.
Μυστικά ή διαπιστευτήρια που δεν πρέπει να δεσμεύσετε.

Ανάπτυξη και επαλήθευση της σύνδεσης μοντέλου σημασιολογίας

Ρωτήστε το Copilot να αναπτύξει την εφαρμογή και να επαληθεύσει τη σύνδεσή της:

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.

Ανοίξτε την εφαρμογή από την πύλη Fabric για να δοκιμάσετε ζωντανά ερωτήματα σημασιολογικού μοντέλου.

Επικύρωση της εφαρμογής

Ρωτήστε το Copilot να εκτελέσει την υπάρχουσα επικύρωση του έργου:

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, επαληθεύστε τα κριτήρια αποδοχής που δώσατε στο Copilot. Δοκιμάστε τον έλεγχο ταυτότητας, τα φίλτρα, τη διασταυρούμενη επισήμανση, τη μορφοποίηση δεδομένων, τις κενές καταστάσεις, τον χειρισμό σφαλμάτων και τα αποτελέσματα κάθε απεικόνισης.

Ανάπτυξη της ολοκληρωμένης εφαρμογής

Αφού ελέγξετε τις αλλαγές και δοκιμάσετε την εφαρμογή, ζητήστε από το Copilot να την αναπτύξει:

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.

Η ίδια npx rayfin up εντολή ενημερώνει μια υπάρχουσα ανάπτυξη όταν συνεχίζετε την ανάπτυξη της εφαρμογής.

Συνεχίστε την επανάληψη με το Copilot

Χρησιμοποιήστε εστιασμένες προτροπές για μεταγενέστερες αλλαγές. Συμπεριλάβετε την επιθυμητή συμπεριφορά, τους επηρεαζόμενους χρήστες, τους περιορισμούς και τα βήματα επικύρωσης.

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.

Κρατήστε κάθε αίτημα αρκετά μικρό για να το ελέγξετε. Δεσμεύστε μια κατάσταση λειτουργίας προτού ζητήσετε από το Copilot να κάνει μια μεγάλη ή δυνητικά καταστροφική αλλαγή.

Αντιμετώπιση προβλημάτων της ροής εργασιών Copilot

Το Copilot εκτυπώνει μόνο εντολές

Πείτε στο Copilot να εκτελέσει το ίδιο τις εντολές και να αναφέρει τα αποτελέσματα. Επιβεβαιώστε ότι το Chat βρίσκεται σε λειτουργία παράγοντα και ότι η πρόσβαση στο τερματικό είναι ενεργοποιημένη.

Ολοκληρώστε τη ροή εισόδου στο πρόγραμμα περιήγησης. Στη συνέχεια, πείτε στο Copilot ότι η είσοδος έχει ολοκληρωθεί, ώστε να μπορεί να συνεχιστεί.

Το Copilot επεξεργάζεται λάθος φάκελο

Διακόψτε τον εκπρόσωπο, ανοίξτε τον φάκελο έργου με σκαλωσιές στον κώδικα του Visual Studio Code και ξεκινήστε μια νέα συνομιλία από αυτόν τον χώρο εργασίας.

Η ανάπτυξη είναι επιτυχής, αλλά τα ερωτήματα μοντέλου σημασιολογίας αποτυγχάνουν

Ρωτήστε το Copilot να ελέγξει τον χώρο εργασίας και τα αναγνωριστικά μοντέλου της σύνδεσης, τη ρύθμιση μισθωτή REST API εκτέλεσης μοντέλου σημασιολογίας, τα δικαιώματα δημιουργίας και ανάγνωσης, το DAX που δημιουργήθηκε, το αποτέλεσμα σφάλματος σύνδεσης και την κονσόλα του προγράμματος περιήγησης. Μην αντικαθιστάτε τα αποτυχημένα ερωτήματα με εικονικά δεδομένα.

Το Copilot προτείνει`--force`

Απαιτήστε από το Copilot να εμφανίσει πρώτα τις δυνητικά καταστροφικές λειτουργίες σχήματος. Αποδεχτείτε --force μόνο όταν κατανοήσετε και εγκρίνετε την πιθανή απώλεια δεδομένων.

Για άλλα θέματα, ανατρέξτε στο θέμα Αντιμετώπιση προβλημάτων εφαρμογών Fabric.

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Τελευταία ενημέρωση στις 2026-09-29