Dela via


pac model

(Förhandsversion) Kommandon för att arbeta med modelldrivna appar.

Commands

Befallning Description
pac model create (Förhandsversion) Skapar en ny modelldriven app.
pac model genpage download (Förhandsversion) Hämta genererade sidor från en modelldriven app.
pac model genpage generate-types (Förhandsversion) Genererar TypeScript-schemadefinitioner för datakällor
pac model genpage list (Förhandsversion) Visar en lista över alla genererade sidor i den angivna modelldrivna appen.
pac model genpage transpile (Förhandsversion) Transpilerar en TypeScript-fil med körningstyper för testning och felsökning
pac model genpage upload (Förhandsversion) Ladda upp och publicera en genererad sida till en modelldriven app.
pac model list (Förhandsversion) Visar en lista över alla modelldrivna appar i miljön.
pac model list-languages (Förhandsversion) Visar en lista över aktiverade språk i Dataverse-miljön.

pac model create

(Förhandsversion) Skapar en ny modelldriven app.

Obligatoriska parametrar för model create

--name -n

Visningsnamnet för den nya modelldrivna appen.

Valfria parametrar för model create

--description -d

Beskrivning för den nya modelldrivna appen.

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--publish

Publicera appen när den har skapats.

Den här parametern kräver inget värde. Det är en växel.

--solution

Unikt namn för lösningen som appen ska läggas till i. Standardvärdet är den aktiva lösningen.

pac model create exempel

I följande exempel visas vanliga sätt att använda pac model create kommandot.

Skapa en ny modelldriven app i den aktiva miljön

pac model create --name "Contoso Sales Hub"

Skapa en app med en beskrivning och lägg till den i en lösning och publicera sedan omedelbart

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

Skapa en app i en specifik miljö genom att ange miljö-URL:en

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

Tips/Råd

Använd pac model list för att kontrollera att appen har skapats och hämta dess app-ID för användning med andra kommandon som pac model genpage upload.

pac model genpage download

(Förhandsversion) Hämta genererade sidor från en modelldriven app.

Obligatoriska parametrar för model genpage download

--app-id

ID för den modelldrivna appen.

Valfria parametrar för model genpage download

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--output-directory -o

Katalog för att spara hämtade sidor. Standardvärdet är aktuell katalog.

--page-id

Kommaavgränsad lista över sid-ID:t som ska hämtas.

pac model genpage download exempel

I följande exempel visas vanliga sätt att använda pac model genpage download kommandot.

Ladda ned en enda generativ sida efter dess sid-ID till en lokal mapp för redigering

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

Ladda ned alla generativa sidor i en app samtidigt

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

Skapa en underkatalog med namnet efter sid-ID:t och skriv följande filer

./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

(Förhandsversion) Genererar TypeScript-schemadefinitioner för datakällor

Obligatoriska parametrar för model genpage generate-types

--data-sources

Kommaavgränsad lista över datakällor som används (t.ex. "konto, lead, kontakt").

Valfria parametrar för model genpage generate-types

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--output-file -o

Sökväg för att spara den genererade TypeScript-schemafilen (standardinställningen är RuntimeTypes.ts)

pac model genpage generate-types exempel

I följande exempel visas vanliga sätt att använda pac model genpage generate-types kommandot.

Generera TypeScript-typer

Generera TypeScript-typer för tabellerna account och contact och skriv dem till ./src/RuntimeTypes.ts:

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

Generera typer för en enskild tabell till en specifik utdatakatalog

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

Anmärkning

Kör generate-types alltid innan du skriver sidkod som kör frågor mot Dataverse-tabeller. Den genererade filen innehåller starkt skrivna kolumnnamn, sekundärnyckelfält och uppräkningsvärden för varje tabell. Om du förlitar dig på de genererade typerna förhindrar du körningsfel som orsakas av felstavade eller obefintlig kolumnnamn.

pac model genpage list

(Förhandsversion) Visar en lista över alla genererade sidor i den angivna modelldrivna appen.

Obligatoriska parametrar för model genpage list

--app-id

ID för den modelldrivna appen.

Valfria parametrar för model genpage list

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac model genpage list exempel

I följande exempel visas vanliga sätt att använda pac model genpage list kommandot.

Visa en lista över sidor med app-ID

Visa en lista över alla generativa sidor i Contoso Sales Hub-appen med dess app-ID:

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

Lista sidor med appnamn

Lista generativa sidor efter appnamn (CLI söker automatiskt upp app-ID:t):

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

pac model genpage-exempelutdata

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

(Förhandsversion) Transpilerar en TypeScript-fil med körningstyper för testning och felsökning

Obligatoriska parametrar för model genpage transpile

--code-file

Sökväg till filen som innehåller sidkoden.

Valfria parametrar för model genpage transpile

--data-sources

Kommaavgränsad lista över datakällor som används (t.ex. "konto, lead, kontakt").

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--output-file

Sökväg för att spara de transpilerade JavaScript-utdata (standardvärdet [code-file].compiled.js)

pac model genpage upload

(Förhandsversion) Ladda upp och publicera en genererad sida till en modelldriven app.

Obligatoriska parametrar för model genpage upload

--app-id

ID för den modelldrivna appen.

--code-file

Sökväg till filen som innehåller sidkoden.

Valfria parametrar för model genpage upload

--add-to-sitemap

Lägg till sidan i appens webbplatskartnavigering.

Den här parametern kräver inget värde. Det är en växel.

--agent-message

Agentens svarsmeddelande.

--agent-message-file

Sökväg till en fil som innehåller agentens svarsmeddelande.

--compiled-code-file

Sökväg till filen som innehåller den kompilerade JavaScript-koden. Om det inte anges överförs TypeScript automatiskt till JavaScript.

--data-sources

Kommaavgränsad lista över datakällor som används (t.ex. "konto, lead, kontakt").

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--model

AI-modellen som används för att generera sidan (t.ex. "claude-3-5-sonnet-20241022").

--name -n

Namnet på sidan.

--page-id

ID:t för sidan som ska uppdateras. Om det inte anges skapas en ny sida.

--prompt

Användarens uppmaning som genererade den här sidan.

--prompt-file

Sökväg till en fil som innehåller användarens uppmaning som genererade den här sidan.

pac model genpage upload exempel

I följande exempel visas vanliga sätt att använda pac model genpage upload kommandot.

Publicera en ny generativ sida

Publicera en ny generativ sida i Contoso Sales Hub-appen och lägg till den i appwebbplatskartan:

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

Uppdatera en befintlig generativ sida

Uppdatera en befintlig generativ sida genom att ange dess sid-ID (utelämna --add-to-sitemap för att undvika att skapa en dubblettpost för webbplatskartan):

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."

Publicera en sida som använder falska data

Publicera en sida som använder falska data (inga Dataverse-tabeller – utelämna --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

Tips/Råd

Parametern --app-id accepterar antingen appens GUID eller dess visningsnamn. Om flera appar delar samma visningsnamn använder du GUID för att undvika tvetydighet. Kör pac model list för att leta upp app-ID:t.

pac model genpage upload parameter-snabbreferens

Parameter Obligatoriskt Description
--app-id Ja App-GUID eller visningsnamn. Kör pac model list för att hitta den.
--code-file Ja Sökväg till källfilen som .tsx ska distribueras.
--name Endast nya sidor Visningsnamn som visas i appens webbplatskarta.
--page-id Endast uppdateringar GUID för den befintliga sidan som ska ersättas.
--data-sources Dataverse-sidor Kommaavgränsad lista över logiska namn i Dataverse-tabellen (till exempel "account,contact").
--prompt Rekommenderad Sammanfattning av naturligt språk av vad sidan gör. Lagras för regenereringskontext.
--model Rekommenderad Modell-ID som används för att generera sidan (till exempel claude-sonnet-4-6).
--agent-message Rekommenderad Beskrivning av vad som har skapats eller ändrats. Lagras som ändringshistorik.
--add-to-sitemap Endast nya sidor Lägger till sidan i appnavigering automatiskt. Utelämna vid uppdatering.

pac model list

(Förhandsversion) Visar en lista över alla modelldrivna appar i miljön.

Valfria parametrar för model list

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac model list exempel

Visa en lista över alla modelldrivna appar i den aktiva miljön:

pac model list

Exempel på utdata:

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

(Förhandsversion) Visar en lista över aktiverade språk i Dataverse-miljön.

Valfria parametrar för model list-languages

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

Se även

Microsoft Power Platform CLI-kommandogrupper
Översikt över Microsoft Power Platform CLI