Создайте приложение для семантической модели с помощью 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 Execute Queries для семантической модели.
  • Разрешения на построение и чтение для семантической модели, размещённой на мощностях Fabric или Power BI.
  • Идентификатор рабочего пространства и идентификатор элемента для семантической модели.

Замечание

Copilot запрашивает одобрение перед запуском терминальных команд. Также необходимо пройти интерактивный вход в браузер, когда Rayfin CLI этого запросит.

Откройте режим агент Copilot на GitHub

  1. Откройте код Visual Studio.
  2. Откройте родительскую папку, где хотите, чтобы Copilot создал проект.
  3. Откройте чат.
  4. Выберите режим агента.
  5. Убедитесь, что агент имеет доступ к терминалу и рабочему пространству.

Не открывайте папку с нерелевантными файлами, которые вы не хотите, чтобы Copilot проверял или изменял.

Scaffold — приложение для данных

Скопируйте следующий запрос в 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 перед тем, как он будет редактировать проект. Если план не соответствует вашим требованиям, исправьте его в чате перед одобрением внедрения.

Просмотрите созданные изменения

После завершения работы 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, чтобы он сам запускал команды и сообщал о результатах. Убедитесь, что чат в режиме агента и доступ к терминалу включён.

Команда ожидает входа в систему

Завершите процесс входа в браузер. Затем скажите Copilot, что вход завершён, чтобы продолжить процесс.

Copilot редактирует не ту папку

Остановите агента, откройте папку проекта с каркасами в Visual Studio Code и начните новый чат из этого рабочего пространства.

Развертывание выполняется успешно, но запросы семантической модели завершаются сбоем

Попросите Copilot проверить рабочую область и идентификаторы модели соединителя, параметр клиента REST API Semantic Model Execute Queries, разрешения Build и Read, сгенерированный DAX, результат ошибки соединителя и консоль браузера. Не заменяйте неудачные запросы на имитационные данные.

Copilot предлагает --force

Требуйте, чтобы Copilot сначала показал потенциально разрушительные операции схемы. Принимайте --force только тогда, когда понимаете и одобряете возможную потерю данных.

Для других вопросов см. раздел «Устранение неполадок Fabric Apps».

Связанные материалы

  • Последнее обновление: