Creare un'app connessa a un modello semantico

Usa il modello di app per i dati quando vuoi analizzare e visualizzare i dati in Fabric Apps. Questo modello contiene un set di primitive riutilizzabili e funzionalità dell'agente che semplificano la connettività dei dati, l'analisi assistita dall'intelligenza artificiale e la generazione di visualizzazioni.

Le app create con il modello includono:

• Autenticazione di Fabric e connettività ai modelli semantici
• Generazione di DAX (Data Analysis Expressions) di qualità più elevata
• Componenti visivi pronti per l'organizzazione progettati per applicazioni analitiche

Perché usare il modello di app dati?

Senza queste funzionalità predefinite, un agente di intelligenza artificiale deve risolvere l'autenticazione, la generazione DAX e la progettazione della visualizzazione da zero in ogni sessione. Questo porta a:

• Altri errori e oggetti visivi interrotti o vuoti
• Comportamento incoerente del grafico
• Query DAX non necessarie durante lo sviluppo e il runtime

La codifica di questi modelli direttamente nel modello migliora l'affidabilità, produce oggetti visivi più coesi allineati alle procedure consigliate per la creazione di report e riduce l'overhead delle query.

Prerequisiti

• Accesso a Fabric.
• Un'area di lavoro Fabric in cui si dispone di autorizzazioni di collaboratore o amministratore.
• Il carico di lavoro di Fabric Apps abilitato nel tenant. Vedi Abilita l'app Fabric nelle impostazioni di amministrazione del tenant.
• Impostazione del tenant dell'API REST Execute Queries (Esegui query) dell'API REST del modello semantico abilitata. Le app per i dati usano l'API Esegui query DAX per eseguire query su modelli semantici. Nel portale di amministrazione di Fabric, passa a Impostazioni di integrazione e abilita l'impostazione API REST per l'esecuzione di query del modello semantico.
• Compilare e leggere le autorizzazioni per il modello semantico a cui connettersi.
• Modello semantico ospitato in una capacità di Fabric o di Power BI.

Passaggi per iniziare

Per creare un'app connessa ai dati Fabric usando il modello di app dati:

1. Seguire i passaggi da 1 a 3 in Creare la prima app Fabric per creare una nuova app Fabric nell'area di lavoro.

2. Attualmente, l'interfaccia della riga di comando di Rayfin è il modo supportato per creare app usando il modello di app dati. Usare il comando seguente per iniziare.

   npm create @microsoft/rayfin@latest -- "<appitemname>" --template dataapp --workspace <workspacename>
   

3. Aprire l'agente di codifica e incollare il prompt.

   È consigliabile:

   • Apertura di VS Code e apertura del riquadro Copilot facendo clic sull'icona Copilot chat sul lato destro della casella di ricerca nella parte superiore della finestra di VS Code
   • Aprire un terminale e digitare copilot e quindi premere INVIO.

   Entrambe le opzioni aprono GitHub Copilot, solo in interfacce diverse (chat e terminale). Usa quello che preferisci!

   

4. Chiedi a Copilot di creare la tua app.

   Dopo aver inviato il prompt precedente, Copilot genererà la struttura di base della tua app e ti chiederà quali modifiche o aggiornamenti desideri apportare alla tua app.

   Qui è possibile spiegare l'app che si vuole compilare e connetterla a un modello semantico. Usare un collegamento di condivisione per il modello per indicare il modello che si vuole usare (il collegamento contiene l'ID area di lavoro e l'ID modello).

   Ad esempio: "Usa il mio modello di vendita in https://app.powerbi.com/groups/workspace-id/modeling/model-id/modelView per generare un'applicazione di fatturazione."

5. Distribuisci l'applicazione.

   Quando si è pronti per distribuire l'app, indicare Copilot di distribuirla in Fabric con il comando npx rayfin up.

Funzionalità predefinite

Le funzionalità riportate di seguito rappresentano le aree in cui abbiamo investito in componenti di base riutilizzabili, integrazioni integrate e flussi di lavoro ottimizzati per gli agenti per rendere lo sviluppo più fluido fin da subito.

Le funzionalità esterne a questo elenco sono ancora possibili perché le app Fabric sono applicazioni Web standard compilate con codice, ma potrebbero richiedere più iterazioni o progettazione personalizzata.

Autenticazione e connettività del modello semantico

Quando si indica Copilot di connettere l'app a un modello semantico, funziona semplicemente, è sufficiente fornire un collegamento di condivisione dal servizio Power BI e il modello gestisce il resto.

Dietro le quinte, l'autenticazione all'interno del portale Fabric richiede una specifica procedura di scambio di token che sarebbe difficile per un agente implementare correttamente ogni volta partendo da zero. Il modello codifica l'intero flusso, quindi Copilot non deve risolvere affatto l'autenticazione, ma si connette semplicemente ai dati.

A condizione che gli utenti dispongano delle stesse autorizzazioni di compilazione e lettura necessarie per eseguire query sul modello in Power BI, l'app recupera automaticamente i dati in tempo reale senza schermata di accesso o configurazione manuale.

Elementi grafici

Il modello include potenti funzionalità di interattività come l'evidenziazione incrociata incorporata. Gli oggetti visivi seguenti hanno primitive preconfigurate nel modello di app dati:

• Grafici a barre (verticale e orizzontale, raggruppati, in pila)

• Grafici a linee (con indicatori facoltativi)

• Grafici ad area

• Grafici a dispersione

• Grafici a torta e ad anello

• Heatmap

• Grafici a bolle

• Grafici a cascata

• Schede a valore unico (indicatori KPI)

• Oggetti visivi a più livelli/compositi (ad esempio barre con etichette dati, grafici a linee a doppio asse)

Naturalmente, puoi comunque chiedere a Copilot di generare altri elementi visivi; potrebbe però essere necessario più di un ciclo di iterazioni per raggiungere i tuoi obiettivi. L'elenco di oggetti visivi preconfigurati dovrebbe crescere nel tempo.

Funzionalità della griglia dei dati

Il modello include anche un componente predefinito della griglia dati per la visualizzazione di dati tabulari. Sono stati preconfigurate le funzionalità seguenti per funzionare senza problemi.

• Intestazioni di colonna derivate automaticamente dai metadati del modello semantico

• Formattazione dei numeri e delle date applicata a ogni colonna tramite stringhe di formato

• Ordinamento

• Righe scorrevoli con gestione dell'overflow

• Supporto del tema chiaro e scuro

• Renderer di celle personalizzati per scenari avanzati, tra cui:

  • Barre dei dati (visualizzazione a barre di avanzamento per i valori numerici)

  • Indicatori booleani (icone check/cross)

  • URL cliccabili

  • Celle di immagine con overlay lightbox

  • Celle con più campi (ad esempio, che combinano nome e ruolo in una colonna)

Anche in questo caso, è comunque possibile chiedere Copilot di generare altre funzionalità della griglia dei dati, ma potrebbero essere necessarie altre iterazioni per raggiungere gli obiettivi. Verrà aggiunto a questo elenco di funzionalità nel corso del tempo.

Tematizzazione

Per fare in modo che la tua app rispecchi il look and feel che desideri, ti basta condividere con Copilot il tuo branding o i tuoi requisiti di stile e Copilot potrà apportare facilmente queste modifiche.

Quando si indica Copilot di apportare aggiornamenti di stile, ad esempio "rendere blu scuro con angoli arrotondati" o "usare un tipo di carattere sans-serif moderno", aggiorna un file di stile centrale e tali modifiche vengono propagate automaticamente a ogni parte dell'app: schede, pulsanti, grafici, griglie di dati e descrizioni comando.

Questo approccio centralizzato significa che l'agente non deve ricomponere ogni componente singolarmente, evitando i colori non corrispondenti, i tipi di carattere incoerenti e i layout interrotti che in genere si verificano quando un agente stili elementi per pezzo.

Stringhe di formato

Quando si indica Copilot di visualizzare i ricavi come valuta o visualizzare le percentuali in un grafico, definisce la formattazione una volta per colonna e il modello lo applica automaticamente ovunque venga visualizzata la colonna, ovvero assi del grafico, descrizioni comando, etichette dati e celle della griglia di dati.

Senza questo, l'agente deve formattare i numeri separatamente in ogni oggetto visivo, che porta a incoerenze (ad esempio, $1.500.50 in un grafico e 1500,5 in un altro) o la formattazione non viene eseguita completamente.

Il modello garantisce che 1500,5 sia sempre visualizzato come $1.500.50 e 0,25 viene sempre visualizzato come 25%, in modo coerente nell'intera app.

Validazione del browser Playwright

Prima di pubblicare l'app, è stato creato un passaggio in cui l'agente lo apre in un browser reale e verifica che tutto sia corretto, simile a come si visualizza manualmente un report in anteprima, ma automatizzato usando la convalida del browser Playwright.

L'agente verifica che:

• Gli elementi visivi vengono visualizzati correttamente
• I grafici non risultano tagliati o schiacciati
• Il testo è leggibile
• Non sono presenti errori in background

Questo rileva i problemi di layout e rendering prima che gli utenti li visualizzino.

Limitazioni note

Attualmente, Fabric Le app connesse ai modelli semantici non possono essere aperte nella propria finestra del browser all'esterno del portale di Fabric. Se si seleziona il pulsante Apri , le query visive generano errori.

Si tratta di una limitazione temporanea e verrà risolta in una versione futura.

Contenuti correlati

• Che cos'è Fabric Apps?
• Creare la prima app
• Eseguire l'API query DAX