pac model

Kommandoer for å jobbe med modelldrevne apper.

Kommandoer

Kommando Beskrivelse
pac model create Lager en ny modelldrevet app.
pac model genpage add Legg ved én eller flere eksisterende generative sider i nettstedskartet for en modelldrevet app (ingen ny opplasting). Bruk «pac model genpage upload» til å opprette eller oppdatere selve siden. Bruk dette verbet til å vise en side som allerede er lastet opp, i en annen app.
pac model genpage download Hent genererte sider fra en modelldrevet app.
pac model genpage generate-types Genererer TypeScript-skjemadefinisjoner for datakilder
pac model genpage list Listegenererte sider – env-wide som standard, eller for én app når --app-ID leveres. Send --include-unpublished to also list draft pages.
pac model genpage remove Koble fra eksisterende generative AI-sider fra nettstedskartet til en modelldrevet app. Sideraden i Dataverse bevares (det kan fremdeles refereres til fra andre apper).
pac model genpage transpile Transpilerer en TypeScript-fil med kjøretidstyper for testing og feilsøking
pac model genpage upload Last opp en generert side til Datavers og publiser den. Oppretter en ny side når --side-ID utelates. oppdaterer den eksisterende siden når --side-ID er angitt. Hvis du vil legge ved en side som allerede finnes i miljøet, til en annen apps nettstedskart uten å laste opp på nytt, bruker du «pac model genpage add» i stedet.
pac model list Lister opp alle modelldrevne apper i miljøet.
pac model list-languages Lister aktiverte språk i Dataverse-miljøet.
pac model list-tables List opp Dataverse-tabeller i det tilkoblede miljøet.

pac model create

Lager en ny modelldrevet app.

Obligatoriske parametere for model create

--name -n

Visningsnavnet for den nye modelldrevne appen.

Valgfrie parametere for model create

--description -d

Beskrivelse for den nye modelldrevne appen.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--publish

Publiser appen etter oppretting.

Denne parameteren krever ingen verdi. Det er en bryter.

--solution

Unikt løsningsnavn som appen skal legges til i. Standard er standard hvis det ikke er angitt.

pac model create Eksempler

Eksemplene nedenfor viser vanlige måter å bruke kommandoen på pac model create .

Opprett en ny modelldrevet app i det aktive miljøet

pac model create --name "Contoso Sales Hub"

Opprett en app med en beskrivelse og legg den til i en løsning, og publiser den umiddelbart

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

Opprette en app i et bestemt miljø ved å oppgi nettadressen for miljøet

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

Tip

Bruk pac model list denne til å bekrefte at appen ble opprettet og hente app-ID-en for bruk med andre kommandoer, for eksempel pac model genpage upload.

pac model genpage add

Legg ved én eller flere eksisterende generative sider i nettstedskartet for en modelldrevet app (ingen ny opplasting). Bruk «pac model genpage upload» til å opprette eller oppdatere selve siden. Bruk dette verbet til å vise en side som allerede er lastet opp, i en annen app.

Obligatoriske parametere for model genpage add

--page-id

Kommadelte generative side-ID-er (GUIDer) som skal legges til i appen.

Valgfrie parametere for model genpage add

--app-id

ID-en for den modelldrevne appen (GUID). Gjensidig utelukkende med --app-name.

--app-name

Den modelldrevne appens unike navn. Gjensidig utelukkende med --app-id.

--area

Valgfri område-ID i områdekartet for å plassere siden under. Standarder til det første området.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--group

Valgfri gruppe-ID i områdekartet for å plassere siden under. Standarder til den første gruppen i det valgte området.

--language-code

Språkkode (LCID) for Underområde-tittelen. Standarder til 1033 (en-US).

--publish

Publiser den modelldrevne appen etter at du har lagt til siden(e).

Denne parameteren krever ingen verdi. Det er en bryter.

--solution

Unikt navn på datavers løsningskonteksten for områdekartoppdateringen. Standard er standard.

pac model genpage download

Hent genererte sider fra en modelldrevet app.

Obligatoriske parametere for model genpage download

--app-id

ID-en til den modelldrevne appen.

Valgfrie parametere for model genpage download

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--output-directory -o

Katalog for å lagre sider som er trukket. Standarder for gjeldende katalog.

--page-id

Kommadelt liste over side-ID-er som skal trekkes.

pac model genpage download Eksempler

Eksemplene nedenfor viser vanlige måter å bruke kommandoen på pac model genpage download .

Last ned én enkelt generativ side etter side-ID-en til en lokal mappe for redigering

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

Last ned alle generative sider i en app samtidig

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

Opprette en undermappe oppkalt etter side-ID-en og skrive følgende 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

Genererer TypeScript-skjemadefinisjoner for datakilder

Obligatoriske parametere for model genpage generate-types

--data-sources

Kommadelt liste over datakilder som brukes (for eksempel konto, kundeemne, kontakt).

Valgfrie parametere for model genpage generate-types

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--output-file -o

Bane til å lagre den genererte TypeScript-skjemafilen (standarder for RuntimeTypes.ts)

pac model genpage generate-types Eksempler

Eksemplene nedenfor viser vanlige måter å bruke kommandoen på pac model genpage generate-types .

Generer TypeScript-typer

Generer TypeScript-typer for tabellene account og contact skriv dem til ./src/RuntimeTypes.ts:

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

Generer typer for én enkelt tabell i en bestemt utdatakatalog

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

Note

Kjør generate-types alltid før du skriver sidekode som spør dataverse tabeller. Den genererte filen inneholder kolonnenavn med stor skrift, sekundærnøkkelfelt og opplistingsverdier for hver tabell. Avhengig av de genererte typene forhindrer kjøretidsfeil forårsaket av feilstavede eller ikke-eksisterende kolonnenavn.

pac model genpage list

Listegenererte sider – env-wide som standard, eller for én app når --app-ID leveres. Send --include-unpublished to also list draft pages.

Valgfrie parametere for model genpage list

--app-id

ID-en til den modelldrevne appen.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--include-unpublished

Inkluder upubliserte generative sider i listen (standard: bare publisert).

Denne parameteren krever ingen verdi. Det er en bryter.

pac model genpage list Eksempler

Eksemplene nedenfor viser vanlige måter å bruke kommandoen på pac model genpage list .

Listesider som bruker app-ID

Vis alle generative sider i Contoso Sales Hub-appen ved hjelp av app-ID-en:

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

Listesider som bruker appnavn

Liste over generative sider etter appnavn (CLI slår opp app-ID-en automatisk):

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

pac model eksempelutdata for genpage

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 remove

Koble fra eksisterende generative AI-sider fra nettstedskartet til en modelldrevet app. Sideraden i Dataverse bevares (det kan fremdeles refereres til fra andre apper).

Obligatoriske parametere for model genpage remove

--page-id

Én eller flere uxagentproject-ID-er som skal fjernes (kommadelt).

Valgfrie parametere for model genpage remove

--app-id

Modelldrevet app-ID (uniqueid) for å fjerne side(er) fra. Gjensidig utelukkende med --app-name.

--app-name

Unikt navn på modelldrevet app for å fjerne siden(e) fra. Gjensidig utelukkende med --app-id.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--publish

Publiser den modelldrevne appen etter redigering av nettstedskartet, slik at endringene sendes direkte umiddelbart.

Denne parameteren krever ingen verdi. Det er en bryter.

--solution

Unikt navn på dataversløsning for oppdateringen av områdekartet. Standard er standard.

pac model genpage transpile

Transpilerer en TypeScript-fil med kjøretidstyper for testing og feilsøking

Obligatoriske parametere for model genpage transpile

--code-file

Bane til filen som inneholder sidekoden.

Valgfrie parametere for model genpage transpile

--data-sources

Kommadelt liste over datakilder som brukes (for eksempel konto, kundeemne, kontakt).

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--output-file

Bane til å lagre de transpilerte JavaScript-utdataene (standardinnstillingene for [kodefil].compiled.js)

pac model genpage upload

Last opp en generert side til Datavers og publiser den. Oppretter en ny side når --side-ID utelates. oppdaterer den eksisterende siden når --side-ID er angitt. Hvis du vil legge ved en side som allerede finnes i miljøet, til en annen apps nettstedskart uten å laste opp på nytt, bruker du «pac model genpage add» i stedet.

Obligatoriske parametere for model genpage upload

--app-id

ID-en til den modelldrevne appen.

--code-file

Bane til filen som inneholder sidekoden.

Valgfrie parametere for model genpage upload

--add-to-sitemap

Legg til siden i appens områdekartnavigasjon.

Denne parameteren krever ingen verdi. Det er en bryter.

--agent-message

Agentens svarmelding.

--agent-message-file

Bane til en fil som inneholder agentens svarmelding.

--compiled-code-file

Bane til filen som inneholder den kompilerte JavaScript-koden. Hvis det ikke er angitt, overføres TypeScript automatisk til JavaScript.

--data-sources

Kommadelt liste over datakilder som brukes (for eksempel konto, kundeemne, kontakt).

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--model

AI-modellen som brukes til å generere siden (f.eks. claude-3-5-sonnet-20241022).

--name -n

Navnet på siden.

--page-id

ID-en for siden som skal oppdateres. Hvis den ikke er angitt, opprettes en ny side.

--prompt

Brukerledeteksten som genererte denne siden.

--prompt-file

Bane til en fil som inneholder brukerledeteksten som genererte denne siden.

pac model genpage upload Eksempler

Eksemplene nedenfor viser vanlige måter å bruke kommandoen på pac model genpage upload .

Publiser en ny generativ side

Publiser en ny generativ side i Contoso Sales Hub-appen, og legg den til i appområdekartet:

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

Oppdatere en eksisterende generativ side

Oppdater en eksisterende generativ side ved å oppgi side-ID-en (utelate --add-to-sitemap for å unngå å opprette en kopi av områdekartoppføring):

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

Publiser en side som bruker mock-data

Publiser en side som bruker mock-data (ingen dataverse tabeller – utelate --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

Tip

Parameteren --app-id godtar enten GUID-en for appen eller visningsnavnet. Hvis flere apper deler samme visningsnavn, bruker du GUID-en for å unngå tvetydighet. Kjør pac model list for å slå opp app-ID-er.

pac model genpage upload hurtigreferanse for parameter

Parameteren Påkrevd Beskrivelse
--app-id Yes App-GUID eller visningsnavn. Kjør pac model list for å finne den.
--code-file Yes Bane til .tsx kildefilen som skal distribueres.
--name Bare nye sider Visningsnavn som vises i appområdekartet.
--page-id Bare oppdateringer GUID for den eksisterende siden som skal erstattes.
--data-sources Dataverse sider Kommadelt liste over logiske dataverse tabellnavn (for eksempel "account,contact").
--prompt Anbefalt Naturlig språksammendrag av hva siden gjør. Lagret for regenereringskontekst.
--model Anbefalt Modell-ID som brukes til å generere siden (for eksempel claude-sonnet-4-6).
--agent-message Anbefalt Beskrivelse av hva som ble bygget eller endret. Lagret som endringslogg.
--add-to-sitemap Bare nye sider Legger til siden i appnavigasjonen automatisk. Utelate når du oppdaterer.

pac model list

Lister opp alle modelldrevne apper i miljøet.

Valgfrie parametere for model list

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac model list-eksempel

Vis alle modelldrevne apper i det aktive miljøet:

pac model list

Eksempel 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

Lister aktiverte språk i Dataverse-miljøet.

Valgfrie parametere for model list-languages

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac model list-tables

List opp Dataverse-tabeller i det tilkoblede miljøet.

Valgfrie parametere for model list-tables

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--search -s

Komma-separert liste over navn å søke etter (matcher logisk navn, skjemanavn eller visningsnavn).

--type -t

Filtrer etter tabelltype: 'egendefinert', 'standard' eller 'alle' (standard: alle).

Se også

Microsoft Power Platform CLI-kommandogrupper
Microsoft Power Platform CLI-oversikt

  • Last updated on