Condividi tramite


pac model

(Anteprima) Comandi per l'uso di app basate su modello.

Commands

Command Description
pac model genpage download (Anteprima) Eseguire il pull delle pagine generate da un'app basata su modello.
pac model genpage generate-types (Anteprima) Genera definizioni dello schema TypeScript per le origini dati
pac model genpage list (Anteprima) Elenca tutte le pagine generate nell'app basata su modello specificata.
pac model genpage transpile (Anteprima) Transpila un file TypeScript con tipi di runtime per il test e il debug
pac model genpage upload (Anteprima) Caricare e pubblicare una pagina generata in un'app basata su modello.
pac model list (Anteprima) Elenca tutte le app basate su modello nell'ambiente.
pac model list-languages (Anteprima) Elenca le lingue abilitate nell'ambiente Dataverse.

pac model genpage download

(Anteprima) Eseguire il pull delle pagine generate da un'app basata su modello.

Parametri obbligatori per model genpage download

--app-id

ID dell'app basata su modello.

Parametri facoltativi per model genpage download

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-directory -o

Directory per salvare le pagine estratte. Il valore predefinito è la directory corrente.

--page-id

Elenco delimitato da virgole di ID di pagina da estrarre.

Examples

Scaricare una singola pagina generativa in base al relativo ID pagina in una cartella locale per la modifica:

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

Scaricare tutte le pagine generative in un'app contemporaneamente:

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

Il comando crea una sottodirectory denominata dopo l'ID pagina e scrive i file seguenti:

./pages/account-dashboard/
  e5f6a7b8-abcd-ef01-2345-000000000010/
    page.tsx          ← TypeScript source code
    page.js           ← Transpiled JavaScript
    RuntimeTypes.ts   ← Dataverse type definitions
    config.json       ← Page metadata
    prompt.txt        ← Original generation prompt

pac model genpage generate-types

(Anteprima) Genera definizioni dello schema TypeScript per le origini dati

Parametri obbligatori per model genpage generate-types

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

Parametri facoltativi per model genpage generate-types

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-file -o

Percorso per salvare il file di schema TypeScript generato (impostazione predefinita per RuntimeTypes.ts)

Examples

Generare tipi TypeScript per le account tabelle e contact e scriverli in ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

Generare tipi per una singola tabella in una directory di output specifica:

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Annotazioni

Eseguire generate-types sempre prima di scrivere codice di pagina che esegue query sulle tabelle Dataverse. Il file generato contiene nomi di colonna fortemente tipizzati, campi chiave esterna ed enumerazione per ogni tabella. La relying on the generated types impedisce errori di runtime causati da nomi di colonna non digitati o inesistenti.

pac model genpage list

(Anteprima) Elenca tutte le pagine generate nell'app basata su modello specificata.

Parametri obbligatori per model genpage list

--app-id

ID dell'app basata su modello.

Parametri facoltativi per model genpage list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Examples

Elencare tutte le pagine generative nell'app Contoso Sales Hub usando il relativo ID app:

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

Elencare le pagine generative in base al nome dell'app (l'interfaccia della riga di comando cerca automaticamente l'ID app):

pac model genpage list --app-id "Contoso Sales Hub"

Output di esempio:

Found 2 generated page(s):

  Account Dashboard
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
    Description: Created: 2026-01-15T10:22:00Z

  Opportunity Tracker
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
    Description: Created: 2026-02-03T14:05:00Z

pac model genpage transpile

(Anteprima) Transpila un file TypeScript con tipi di runtime per il test e il debug

Parametri obbligatori per model genpage transpile

--code-file

Percorso del file contenente il codice della pagina.

Parametri facoltativi per model genpage transpile

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-file

Percorso per salvare l'output JavaScript transpiled (il valore predefinito è [code-file].compiled.js)

pac model genpage upload

(Anteprima) Caricare e pubblicare una pagina generata in un'app basata su modello.

Parametri obbligatori per model genpage upload

--app-id

ID dell'app basata su modello.

--code-file

Percorso del file contenente il codice della pagina.

Parametri facoltativi per model genpage upload

--add-to-sitemap

Aggiungere la pagina alla navigazione della mappa della mappa dell'app.

Questo parametro non richiede alcun valore. È un cambio.

--agent-message

Messaggio di risposta dell'agente.

--agent-message-file

Percorso di un file contenente il messaggio di risposta dell'agente.

--compiled-code-file

Percorso del file contenente il codice JavaScript compilato. Se non specificato, TypeScript verrà automaticamente traspilato in JavaScript.

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--model

Modello di intelligenza artificiale usato per generare la pagina ,ad esempio 'claude-3-5-sonnet-20241022'.

--name -n

Nome della pagina.

--page-id

ID della pagina da aggiornare. Se non specificato, verrà creata una nuova pagina.

--prompt

Richiesta dell'utente che ha generato questa pagina.

--prompt-file

Percorso di un file contenente il prompt dell'utente che ha generato questa pagina.

Examples

Pubblicare una nuova pagina generativa nell'app Contoso Sales Hub e aggiungerla alla mappa dell'app:

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --code-file ./pages/account-dashboard.tsx \
  --name "Account Dashboard" \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
  --add-to-sitemap

Aggiornare una pagina generativa esistente specificando il relativo ID pagina (omettere --add-to-sitemap per evitare di creare una voce della mappa duplicata):

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --code-file ./pages/account-dashboard.tsx \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."

Pubblicare una pagina che usa dati fittizi (nessuna tabella dataverse - omettere --data-sources):

pac model genpage upload \
  --app-id "Contoso Sales Hub" \
  --code-file ./pages/welcome-screen.tsx \
  --name "Welcome" \
  --prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
  --model "claude-sonnet-4-6" \
  --agent-message "Welcome page with static mock data. No Dataverse queries." \
  --add-to-sitemap

Suggerimento

Il --app-id parametro accetta il GUID dell'app o il relativo nome visualizzato. Se più app condividono lo stesso nome visualizzato, usare il GUID per evitare ambiguità. Eseguire pac model list per cercare gli ID app.

Riferimento rapido ai parametri

Parametro Obbligatorio Description
--app-id GUID dell'app o nome visualizzato. Esegui pac model list per trovarlo.
--code-file Percorso del .tsx file di origine da distribuire.
--name Solo nuove pagine Nome visualizzato visualizzato nella mappa dell'app.
--page-id Solo aggiornamenti GUID della pagina esistente da sostituire.
--data-sources Pagine di dataverse Elenco delimitato da virgole di nomi logici di tabella dataverse (ad esempio "account,contact").
--prompt Raccomandato Riepilogo del linguaggio naturale delle operazioni della pagina. Archiviato per il contesto di rigenerazione.
--model Raccomandato ID modello usato per generare la pagina , ad esempio claude-sonnet-4-6.
--agent-message Raccomandato Descrizione di ciò che è stato creato o modificato. Archiviato come cronologia delle modifiche.
--add-to-sitemap Solo nuove pagine Aggiunge automaticamente la pagina allo spostamento dell'app. Omettere durante l'aggiornamento.

pac model list

(Anteprima) Elenca tutte le app basate su modello nell'ambiente.

Parametri facoltativi per model list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Examples

Elencare tutte le app basate su modello nell'ambiente attualmente attivo:

pac model list

Output di esempio:

Found 3 model-driven app(s):

  Contoso Sales Hub
    App ID: a1b2c3d4-1234-5678-abcd-000000000001
    Unique Name: contoso_SalesHub

  Contoso Field Service
    App ID: a1b2c3d4-1234-5678-abcd-000000000002
    Unique Name: contoso_FieldService

  Contoso Customer Portal
    App ID: a1b2c3d4-1234-5678-abcd-000000000003
    Unique Name: contoso_CustomerPortal

pac model list-languages

(Anteprima) Elenca le lingue abilitate nell'ambiente Dataverse.

Parametri facoltativi per model list-languages

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform