Crie uma aplicação de modelos semânticos com o GitHub Copilot

Use esta receita para criar uma aplicação analítica ligada a um modelo semântico com o modo agente do Copilot do GitHub. O Copilot estrutura o modelo da aplicação de dados, adiciona um conector de modelo semântico Fabric, cria consultas e visualizações DAX, e valida a aplicação.

O modelo da aplicação de dados fornece autenticação Fabric, orientação para geração de DAX, componentes visuais e validação do navegador. O conector fornece acesso semântico delegado ao modelo através do cliente Fabric Apps. Para mais informações, consulte Criar uma aplicação ligada a um modelo semântico.

Neste tutorial, irá aprender a:

  • Prepare o GitHub Copilot para desenvolvimento orientado por agentes.
  • Peça ao Copilot para gerar a estrutura do modelo da aplicação de dados.
  • Liga a aplicação a um modelo semântico.
  • Construa um explorador interativo de desempenho de vendas.
  • Revise e valide as alterações geradas.
  • Implementa a aplicação no Fabric.
  • Verifica a implementação e abre a aplicação.

Pré-requisitos

  • Node.js 20 ou posterior.
  • Visual Studio Code.
  • GitHub Copilot em Visual Studio Code com modo agente disponível.
  • Uma conta no GitHub com acesso ao GitHub Copilot.
  • Uma conta Microsoft com acesso ao Fabric.
  • Um espaço de trabalho Fabric onde tens permissões de Contribuidor, Membro ou Administrador.
  • A carga de trabalho do Fabric Apps ativada para o seu inquilino.
  • A definição de tenant da API REST para Executar Modelos Semânticos (SEMANTIC Model Execute Queries) está ativada.
  • Permissões de construção e leitura num modelo semântico alojado em capacidade de Fabric ou Power BI.
  • O ID do espaço de trabalho e o ID do item para o modelo semântico.

Note

O Copilot pede aprovação antes de executar comandos de terminal. Deve também completar o login interativo do navegador quando o CLI Rayfin o solicita.

Abrir o modo de agente do GitHub Copilot

  1. Abre Visual Studio Code.
  2. Abre a pasta pai onde queres que o Copilot crie o projeto.
  3. Abra Chat.
  4. Selecione o Modo de agente .
  5. Confirme que o agente tem acesso ao terminal e ao espaço de trabalho.

Não abra uma pasta que contenha ficheiros não relacionados que não quer que o Copilot inspecione ou modifique.

Crie a estrutura base da aplicação de dados

Copie o seguinte prompt para o 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.

Substitua <workspace-name>, <workspace-id>, e <semantic-model-item-id> por valores para o seu espaço de trabalho Fabric e modelo semântico. Aprove os comandos à medida que o Copilot os executa e complete o fluxo de início de sessão do Rayfin quando solicitado.

Peça ao Copilot para criar a sua aplicação

Descreva o público da aplicação, perguntas, interações e visualizações. O salesModel conector já identifica o modelo semântico.

Use o seguinte prompt como receita inicial para um explorador de desempenho de vendas. Adapte os requisitos de negócio aos campos disponíveis no seu modelo.

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.

Revise o plano do Copilot antes de editar o projeto. Se o plano não corresponder aos seus requisitos, corrija-o no chat antes de aprovar a implementação.

Revise as alterações geradas

Depois de o Copilot terminar, peça-lhe para rever o seu trabalho:

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.

Inspecione as diferenças no controlo de código-fonte no Visual Studio Code. Preste especial atenção a:

  • A configuração do conector salesModel, o esquema gerado e as consultas DAX.
  • Configuração do serviço em rayfin/rayfin.yml.
  • Novas dependências em package.json.
  • Alterações de autenticação ou chamadas REST diretas que contornam o conector.
  • Segredos ou credenciais que não deve comprometer.

Implementar e verificar a ligação do modelo semântico

Pede ao Copilot para implementar a aplicação e verificar a ligação da aplicação:

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.

Abra a aplicação a partir do portal Fabric para testar consultas semânticas de modelos em tempo real.

Validar a aplicação

Peça ao Copilot para executar a validação existente do projeto:

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.

No portal Fabric, verifica os critérios de aceitação que deste ao Copilot. Teste a autenticação, os filtros, o realce cruzado, a formatação de dados, os estados vazios, o tratamento de erros e os resultados de cada visual.

Implementar a aplicação finalizada

Depois de rever as alterações e testar a aplicação, peça ao Copilot para a implementar:

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.

O mesmo comando npx rayfin up atualiza uma implantação existente à medida que continua a desenvolver a aplicação.

Continue a iterar com o Copilot

Utilize instruções específicas para alterações posteriores. Inclua o comportamento desejado, utilizadores afetados, restrições e passos de validação.

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.

Mantenha cada pedido pequeno o suficiente para ser analisado. Faça um commit de um estado funcional antes de pedir ao Copilot para fazer uma alteração significativa ou potencialmente destrutiva.

Resolver problemas no fluxo de trabalho do Copilot

O Copilot apenas imprime comandos

Diga ao Copilot para executar ele próprio os comandos e apresentar os resultados. Confirme que o Chat está em modo Agente e que o acesso ao terminal está ativado.

Um comando espera por iniciar sessão

Complete o fluxo de início de sessão do navegador. Depois diz ao Copilot que o login está concluído para que possa continuar.

O Copilot edita a pasta errada

Pare o agente, abra a pasta do projeto estruturado no Visual Studio Code e inicie um novo Chat a partir desse espaço de trabalho.

A implementação é bem-sucedida, mas as consultas semânticas ao modelo falham

Peça ao Copilot para verificar o espaço de trabalho e os IDs do modelo do conector, a configuração de inquilino da API REST Semantic Model Execute Queries, as suas permissões de Build e de leitura, o DAX gerado, o resultado do erro do conector e a consola do navegador. Não substitua consultas falhadas por dados simulados.

Copilot propõe --force

Exigir que o Copilot mostre primeiro as operações de esquema potencialmente destrutivas. Aceitar --force apenas quando compreender e aceitar a possível perda de dados.

Para outras questões, consulte Resolução de Problemas de Aplicações Fabric.

Conteúdo relacionado

  • Última atualização a