Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo argomento fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Questo articolo descrive come usare gli strumenti di generazione del codice di intelligenza artificiale, ad esempio l'interfaccia della riga di comando di GitHub Copilot e Claude Code, per creare e modificare pagine generative per le app basate su modello in Power Apps. Questo approccio consente di integrare funzionalità avanzate di generazione del codice direttamente nel flusso di lavoro di sviluppo, consentendo di creare nuove pagine generative o di scorrere su quelle esistenti usando istruzioni in linguaggio naturale.
Importante
- Si tratta di una funzionalità di anteprima.
- Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Vengono rese disponibili prima di una versione ufficiale in modo che i clienti possano accedervi con anticipo e fornire i loro commenti.
L'uso degli strumenti di generazione del codice di intelligenza artificiale con pagine generative offre un approccio di sviluppo alternativo che integra l'esperienza basata sull'interfaccia utente in Power Apps (make.powerapps.com). Questo approccio code-first è progettato per sviluppatori e tecnici che preferiscono lavorare con gli strumenti di sviluppo locali e i flussi di lavoro basati sull'interfaccia della riga di comando.
Operazioni che è possibile eseguire con gli strumenti di generazione del codice
- Creare nuove pagine generative usando i requisiti in linguaggio normale
- Aggiornare le pagine generative esistenti richiedendo modifiche o miglioramenti tramite lo strumento di intelligenza artificiale
- Distribuire direttamente nell'ambiente Power Apps utilizzando i comandi PAC CLI
- Usare localmente l'IDE e gli strumenti di sviluppo preferiti
Come funziona
- Descrivere ciò che si vuole creare in linguaggio naturale, ad esempio "Creare un dashboard di pagina generativa che mostra i principali account in base ai ricavi".
- Lo strumento di generazione del codice di intelligenza artificiale usa competenze di pagina generative installate o altri contesti relativi alle pagine generative per porre domande chiare sui requisiti.
- Lo strumento genera codice TypeScript e React pronto per la produzione per la pagina generativa.
- Lo strumento distribuisce il codice nel tuo ambiente utilizzando i comandi PAC CLI della pagina generativa.
- La tua pagina generativa appare nella tua app basata su modello.
Prerequisiti
Prima di iniziare, assicurarsi di disporre del software e delle autorizzazioni necessarie descritte qui.
Requisiti software
| Componente | Versione minima | Maggiori informazioni |
|---|---|---|
| Node.js | 18.0 o versione successiva | Scarica Node.js |
| Interfaccia della riga di comando di Power Platform (PAC CLI) | Più recente | Installare PAC CLI |
| CLI di GitHub Copilot, Claude Code o altri strumenti di generazione del codice | Più recente | CLI di GitHub Copilot o Claude Code |
Requisiti aggiuntivi
- Un ambiente Power Platform con un'app basata su modello per distribuire le pagine.
- Sessione autenticata della CLI PAC connessa all'ambiente di destinazione.
- Vai a Autenticare Power Platform CLI per ulteriori dettagli su come connettersi.
Annotazioni
L'ambiente Power Platform deve trovarsi nell'area degli Stati Uniti. Questa funzionalità verrà presto disponibile in altre aree.
Installare il plug-in
Eseguire il programma di installazione per configurare tutti i plug-in Power Platform in PowerShell o in una finestra di comando di Windows.
iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js
curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node
Il programma di installazione viene eseguito automaticamente:
- Rileva gli strumenti disponibili (Claude Code, interfaccia della riga di comando di GitHub Copilot)
- Registra il marketplace dei plug-in e installa tutti i plug-in
- Abilita l'aggiornamento automatico in modo che i plug-in rimangano aggiornati
Dopo l'installazione, riavviare lo strumento di intelligenza artificiale, se necessario.
Installare solo il plug-in di pagina generativa
Per installare solo il plug-in di pagina generativo per l'interfaccia della riga di comando di GitHub Copilot o Claude Code:
- Aggiungere il plug-in Power Platform Skills Marketplace:
/plugin marketplace add microsoft/power-platform-skills - Installare il plug-in Power Apps:
/plugin install model-apps@power-platform-skills
Annotazioni
Per Claude Code, è possibile installare il plug-in con ambiti diversi, ad esempio globale, locale o utente. A seconda dell'ambito, è necessario trovarsi nella directory corretta per Claude Code per usare il plug-in. Vai a Amplia Claude con competenze
Dopo l'installazione, è possibile usare il plug-in:
- Esecuzione del
/genpagecomando in modo esplicito. - Descrizione della pagina da creare. Lo strumento rileva e usa automaticamente il plug-in.
Suggerimento
Attivare l'aggiornamento automatico per ricevere automaticamente gli aggiornamenti al marketplace e alle competenze. Usare il /plugin comando , passare a Marketplace, scegliere il marketplace e attivare l'aggiornamento automatico.
Uso di altri strumenti di generazione del codice di intelligenza artificiale
Per altri strumenti di generazione del codice di intelligenza artificiale, assicurarsi che lo strumento abbia accesso alle risorse della pagina generativa dal repository GitHub delle competenze di Power Platform. La cartella del plug-in model-apps include la documentazione dei componenti, il codice di esempio, il riferimento ai comandi dell'interfaccia della riga di comando pac e le istruzioni del flusso di lavoro necessarie per creare codice in base ai requisiti generativi della pagina. Consultare il file README del repository per informazioni sull'accesso e l'uso di queste risorse con il proprio strumento preferito.
Panoramica delle competenze
Il plug-in Power Apps offre questa competenza per l'uso delle pagine generative.
| Competenza | Comando | Descrzione |
|---|---|---|
| Pagine generative di contenuti | /genpage |
Creare codice per le pagine generative (per scenari di creazione o modifica) |
Questa competenza consente di descrivere cosa si vuole compilare e usare lo strumento di intelligenza artificiale per generare codice TypeScript e React completo per la pagina generativa, quindi distribuirlo direttamente nell'ambiente di Power Apps.
Creare una nuova pagina generativa
Seguire questo flusso di lavoro durante la creazione di una nuova pagina da zero.
Avviare una conversazione con lo strumento di intelligenza artificiale. Descrivere gli elementi da creare, inclusi i dati da includere (quali tabelle dataverse o se creare dati fittizi di esempio). Sii specifico quanto desideri—più sei vago nella richiesta, più dettagli l'agente tenta di aggiungere da sé. È anche possibile allegare o fornire un'immagine o altri materiali per guidare gli oggetti visivi, gli elementi di tema e il layout. Per esempio:
- "Creare un dashboard della pagina generativa che mostra i primi 10 account in base ai ricavi usando la tabella Account"
- "Creare un modulo di pagina generativo per la creazione e la modifica di record di contatto con dati di esempio"
- "Creare una pagina generativa per visualizzare i report degli eventi imprevisti su una mappa usando la tabella Evento imprevisto"
- "Creare una pagina generativa per una visualizzazione della pipeline di vendita con opportunità usando il tema blu moderno"
Rispondere a domande chiare. Lo strumento di intelligenza artificiale pone domande per comprendere i requisiti. Essere specifici delle esigenze aziendali e dei requisiti dei dati, identificare i requisiti per dispositivi mobili in anticipo e menzionare eventuali componenti o preferenze di layout specifici dell'interfaccia utente.
Esaminare il piano di implementazione. Lo strumento di intelligenza artificiale presenta un piano che descrive i componenti da compilare, le tabelle e le colonne di Dataverse da usare, le funzionalità chiave e le interazioni e l'approccio al recupero dei dati. Conferma che il piano soddisfi i tuoi requisiti o richiedi modifiche.
Esaminare il codice e la distribuzione. Lo strumento di intelligenza artificiale genera codice TypeScript completo. Chiedere allo strumento di pubblicare o distribuire la pagina quando si è pronti, specificando facoltativamente un nome della mappa di pagina (lo strumento genera un nome significativo per impostazione predefinita).
Testare e iterare. Apri la tua app basata su modello in Power Apps e naviga alla nuova pagina usando la sitemap. Se è necessario apportare modifiche, tornare allo strumento di intelligenza artificiale e descrivere gli aggiornamenti usando il linguaggio naturale.
Annotazioni
È possibile modificare il nome o la posizione della pagina generativa nella mappa del sito in qualsiasi momento dalla finestra di progettazione delle app basate su modello.
Modificare una pagina generativa esistente
Usare questo flusso di lavoro per aggiornare una pagina già esistente nell'ambiente.
Recuperare la pagina esistente. Nello strumento di generazione del codice di intelligenza artificiale richiedere di recuperare la pagina generativa esistente specificando l'ID pagina (GUID) o il nome della pagina nella mappa del sito e l'app in cui si trova. Ad esempio, "Voglio aggiornare la pagina generativa per l'adozione di animali domestici dall'app Demo".
Descrivere gli aggiornamenti. Indicare allo strumento di intelligenza artificiale quali modifiche si desidera apportare. Per esempio:
- "Aggiungere un filtro per visualizzare solo i record attivi"
- "Modificare il layout per visualizzare le schede in una griglia invece di un elenco"
- "Aggiungere un grafico che mostra le tendenze di adozione nel tempo"
- "Aggiornare il modulo per includere il nuovo campo personalizzato per il temperamento animale domestico"
Esaminare, pubblicare, testare e iterare. Lo strumento di intelligenza artificiale genera codice TypeScript aggiornato in base alle modifiche richieste. Seguire la stessa revisione, pubblicare e testare il processo descritto nella sezione "Creare una nuova pagina generativa". Continuare a iterare con istruzioni in linguaggio naturale fino a quando la pagina non soddisfa i requisiti.
Risoluzione dei problemi
La pagina non viene caricata in Power Apps
Se si passa alla pagina generativa e si osserva un messaggio di errore o una schermata vuota:
Aprire gli strumenti di sviluppo del browser (F12 nella maggior parte dei browser).
Selezionare la scheda Console .
Copiare il messaggio di errore completo, inclusa la traccia dello stack.
Tornare allo strumento di generazione del codice di intelligenza artificiale e incollare l'errore con il contesto:
"Viene visualizzato questo errore durante l'apertura della pagina: [incolla errore qui]. Risolvere il problema."
Lo strumento di intelligenza artificiale analizza l'errore, identifica la causa radice e genera una correzione.
Esaminare la correzione e chiedere allo strumento di ripubblicare la pagina.
Ripristino di una versione funzionante
Se le modifiche recenti hanno interrotto la pagina o sono peggiorati i problemi, è possibile chiedere allo strumento di intelligenza artificiale di eseguire il rollback a una versione funzionante precedente:
Le recenti modifiche hanno danneggiato la pagina. Ripristina alla versione funzionante più recente.
Lo strumento AI quindi:
- Identifica le modifiche apportate
- Ripristina il codice di lavoro precedente
- Ridistribuisce la versione stabile
Procedure consigliate
- Iniziare in modo semplice. Iniziare con una versione di base della pagina e iterare man mano che aggiungi complessità.
- Testare frequentemente. Distribuire e testare la tua pagina dopo ogni modifica significativa.
- Essere specifici. Fornire requisiti dettagliati per ottenere risultati iniziali migliori.
- Usare modelli esistenti. Fare riferimento a pagine o modelli di interfaccia utente simili durante la descrizione dei requisiti.
- Convalidare il codice generato. Esaminare sempre il codice generato per assicurarsi che soddisfi gli standard e i requisiti di conformità dell'organizzazione.
Importante
Anche se gli strumenti di generazione del codice di intelligenza artificiale tentano di generare codice completo e pronto per la produzione con procedure consigliate per l'accessibilità e la sicurezza, si è responsabili della convalida del codice. Assicurarsi che il codice generato soddisfi gli standard, i criteri e i requisiti di conformità dell'organizzazione.
Limitazioni
Le limitazioni per le pagine generative create con gli strumenti di generazione del codice di intelligenza artificiale sono identiche a quelle per le pagine generative create nel portale di Power Apps Maker:
- La pagina può connettersi solo alle tabelle dataverse.
- Attualmente è supportato solo l'inglese degli Stati Uniti.
- La collaborazione non è supportata. Assicurarsi che un solo autore stia lavorando a una pagina generativa alla volta.
- Sono supportati solo questi tipi di dati: Scelta, Valuta, Cliente, Data e ora, Solo data, Numero decimale, Numero in virgola mobile, Immagine, Ricerca, Testo su più linee, Stato, Motivo dello stato, Testo, Numero intero, Sì/No, Identificatore univoco.