pac model

Komandas darbam ar modeļa vadītām programmām.

Komandas

Komanda Apraksts
pac model create Izveido jaunu modeļa vadītu programmu.
pac model genpage add Pievienojiet vienu vai vairākas esošas ģeneratīvās lapas modeļa vadītas lietotnes vietnes kartei (bez atkārtotas augšupielādes). Izmantojiet 'pac model genpage upload', lai izveidotu vai atjauninātu pašu lapu; izmantojiet šo darbības vārdu, lai jau augšupielādēta lapa tiktu rādīta citā lietotnē.
pac model genpage download Izvelciet ģenerētas lapas no modeļa vadītas programmas.
pac model genpage generate-types Ģenerē TypeScript shēmas definīcijas datu avotiem
pac model genpage list Uzskaitiet ģenerētās lapas — pēc noklusējuma visā env vai vienai lietotnei, ja tiek piegādāts --app-id. Pass --include-unpublished, lai uzskaitītu arī melnraksta lapas.
pac model genpage remove Atvienojiet esošās ģeneratīvā mākslīgā intelekta lapas no modeļa vadītas lietotnes vietnes kartes. Dataverse lapas rinda tiek saglabāta (uz to joprojām var būt atsauce no citām programmām).
pac model genpage transpile Pārveido TypeScript failu ar izpildlaika tipiem testēšanai un atkļūdošanai
pac model genpage upload Augšupielādējiet ģenerētu lapu Dataverse un publicējiet to. Izveido jaunu lapu, ja --page-id ir izlaists; Atjaunina esošo lapu, kad tiek piegādāts --page-id. Lai pievienotu vidē jau esošu lapu citas programmas vietnes kartei bez atkārtotas augšupielādes, izmantojiet "pac model genpage add".
pac model list Uzskaita visas modeļa vadītās programmas vidē.
pac model list-languages Uzskaita iespējotās valodas Dataverse vidē.
pac model list-tables Uzskaitiet Dataverse tabulas savienotajā vidē.

pac model create

Izveido jaunu modeļa vadītu programmu.

Nepieciešamie parametri model create

--name -n

Jaunās modeļa vadītās programmas parādāmais nosaukums.

Neobligātie parametri model create

--description -d

Jaunās modeļa vadītās programmas apraksts.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--publish

Publicējiet lietotni pēc izveides.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--solution

Risinājuma unikālais nosaukums, kuram pievienot programmu. Noklusējums ir "Noklusējums", ja tas nav norādīts.

pac model create Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model create veidi.

Jaunas modeļa vadītas programmas izveide aktīvajā vidē

pac model create --name "Contoso Sales Hub"

Izveidojiet programmu ar aprakstu un pievienojiet to risinājumam, pēc tam nekavējoties publicējiet

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

Programmas izveide noteiktā vidē, norādot vides URL

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

Padoms

Izmantojiet pac model list , lai pārbaudītu, vai programma ir izveidota, un izgūtu tās programmas ID, lai to izmantotu ar citām komandām, piemēram, pac model genpage upload.

pac model genpage add

Pievienojiet vienu vai vairākas esošas ģeneratīvās lapas modeļa vadītas lietotnes vietnes kartei (bez atkārtotas augšupielādes). Izmantojiet 'pac model genpage upload', lai izveidotu vai atjauninātu pašu lapu; izmantojiet šo darbības vārdu, lai jau augšupielādēta lapa tiktu rādīta citā lietotnē.

Nepieciešamie parametri model genpage add

--page-id

Ar komatiem atdalīti ģeneratīvie lapu ID (GUID), ko pievienot lietotnei.

Neobligātie parametri model genpage add

--app-id

Modeļa vadītas programmas ID (GUID). Savstarpēji izslēdzošs ar --app-name.

--app-name

Modeļa vadītas programmas unikālais nosaukums. Savstarpēji izslēdzošs ar --app-id.

--area

Neobligāts apgabala ID vietnes kartē, zem kuras novietot lapu. Noklusējums ir pirmais apgabals.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--group

Neobligāts grupas ID vietnes kartē, zem kura novietot lapu. Noklusējums ir izvēlētā apgabala pirmā grupa.

--language-code

Apakšapgabala nosaukuma valodas kods (LCID). Noklusējuma vērtība ir 1033 (en-US).

--publish

Publicējiet modeļa vadītu programmu pēc lapas(-u) pievienošanas.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--solution

Vietnes kartes atjauninājuma Dataverse risinājuma konteksta unikālais nosaukums. Noklusējuma vērtība ir "Noklusējums".

pac model genpage download

Izvelciet ģenerētas lapas no modeļa vadītas programmas.

Nepieciešamie parametri model genpage download

--app-id

Modeļa vadītās programmas ID.

Neobligātie parametri model genpage download

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-directory -o

Direktorijs, lai saglabātu izvilktās lapas. Noklusējums ir pašreizējais direktorijs.

--page-id

Ar komatiem atdalīts lapu ID saraksts, kas jāizvelk.

pac model genpage download Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage download veidi.

Lejupielādējiet vienu ģeneratīvo lapu pēc tās lapas ID lokālajā mapē rediģēšanai

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

Lejupielādējiet visas ģeneratīvās lapas lietotnē uzreiz

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

Izveidojiet apakšdirektoriju, kas nosaukta pēc lapas ID, un ieraksta šādus failus

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

Ģenerē TypeScript shēmas definīcijas datu avotiem

Nepieciešamie parametri model genpage generate-types

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

Neobligātie parametri model genpage generate-types

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-file -o

Ģenerētā TypeScript shēmas faila saglabāšanas ceļš (noklusējuma vērtība ir RuntimeTypes.ts)

pac model genpage generate-types Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage generate-types veidi.

TypeScript tipu ģenerēšana

Ģenerējiet TypeScript tipus un tabulām account un ierakstiet tos uzcontact:./src/RuntimeTypes.ts

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

Ģenerējiet tipus vienai tabulai noteiktā izvades direktorijā

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

Piezīme

Vienmēr palaidiet generate-types pirms lapas koda rakstīšanas, kas vaicā Dataverse tabulās. Ģenerētajā failā ir izteikti ierakstīti kolonnu nosaukumi, ārējās atslēgas lauki un uzskaitījuma vērtības katrai tabulai. Paļaušanās uz ģenerētajiem tipiem novērš izpildlaika kļūdas, ko izraisa nepareizi uzrakstīti vai neesoši kolonnu nosaukumi.

pac model genpage list

Uzskaitiet ģenerētās lapas — pēc noklusējuma visā env vai vienai lietotnei, ja tiek piegādāts --app-id. Pass --include-unpublished, lai uzskaitītu arī melnraksta lapas.

Neobligātie parametri model genpage list

--app-id

Modeļa vadītās programmas ID.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--include-unpublished

Sarakstā iekļaut nepublicētas ģeneratīvās lapas (noklusējums: tikai publicētas).

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

pac model genpage list Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage list veidi.

Lapu saraksts, izmantojot lietotnes ID

Uzskaitiet visas ģeneratīvās lapas programmā Contoso pārdošanas centrmezgls , izmantojot tās programmas ID:

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

Lapu saraksts, izmantojot programmas nosaukumu

Uzskaitiet ģeneratīvās lapas pēc programmas nosaukuma (CLI automātiski uzmeklē programmas ID):

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

pac model GenPage parauga izvade

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

Atvienojiet esošās ģeneratīvā mākslīgā intelekta lapas no modeļa vadītas lietotnes vietnes kartes. Dataverse lapas rinda tiek saglabāta (uz to joprojām var būt atsauce no citām programmām).

Nepieciešamie parametri model genpage remove

--page-id

Viens vai vairāki uxagentproject ID, kas jānoņem (atdalīti ar komatiem).

Neobligātie parametri model genpage remove

--app-id

Modeļa vadītas programmas ID (uniqueid), no kura noņemt lapu(-as). Savstarpēji izslēdzošs ar --app-name.

--app-name

Modeļa vadītas programmas unikālais nosaukums, no kura noņemt lapu(-as). Savstarpēji izslēdzošs ar --app-id.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--publish

Publicējiet modeļa vadītu programmu pēc vietnes kartes rediģēšanas, lai izmaiņas tiktu publicētas nekavējoties.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--solution

Dataverse risinājuma unikālais nosaukums vietnes kartes atjauninājumam. Noklusējuma vērtība ir "Noklusējums".

pac model genpage transpile

Pārveido TypeScript failu ar izpildlaika tipiem testēšanai un atkļūdošanai

Nepieciešamie parametri model genpage transpile

--code-file

Ceļš uz failu, kurā ir lappuses kods.

Neobligātie parametri model genpage transpile

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-file

Ceļš, lai saglabātu transpilēto JavaScript izvadi (noklusējuma vērtība ir [koda fails].compiled.js)

pac model genpage upload

Augšupielādējiet ģenerētu lapu Dataverse un publicējiet to. Izveido jaunu lapu, ja --page-id ir izlaists; Atjaunina esošo lapu, kad tiek piegādāts --page-id. Lai pievienotu vidē jau esošu lapu citas programmas vietnes kartei bez atkārtotas augšupielādes, izmantojiet "pac model genpage add".

Nepieciešamie parametri model genpage upload

--app-id

Modeļa vadītās programmas ID.

--code-file

Ceļš uz failu, kurā ir lappuses kods.

Neobligātie parametri model genpage upload

--add-to-sitemap

Pievienojiet lapu lietotnes vietnes kartes navigācijai.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--agent-message

Aģenta atbildes ziņojums.

--agent-message-file

Ceļš uz failu, kurā ir aģenta atbildes ziņojums.

--compiled-code-file

Ceļš uz failu, kas satur kompilēto JavaScript kodu. Ja tas nav norādīts, TypeScript tiks automātiski pārveidots uz JavaScript.

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--model

Lapas ģenerēšanai izmantotais AI modelis (piemēram, "claude-3-5-sonnet-20241022").

--name -n

Lapas nosaukums.

--page-id

Atjaunināmās lapas ID. Ja tas netiek sniegts, tiks izveidota jauna lapa.

--prompt

Lietotāja uzvedne, kas ģenerēja šo lapu.

--prompt-file

Ceļš uz failu, kurā ir lietotāja uzvedne, kas ģenerēja šo lapu.

pac model genpage upload Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage upload veidi.

Jaunas ģeneratīvās lapas publicēšana

Publicējiet jaunu ģeneratīvo lapu programmā Contoso pārdošanas centrmezgls un pievienojiet to programmas vietnes kartei:

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

Esošas ģeneratīvās lapas atjaunināšana

Atjauniniet esošu ģeneratīvo lapu, norādot tās lapas ID (izlaidiet --add-to-sitemap , lai izvairītos no vietnes kartes ieraksta dublikāta izveides):

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

Publicēt lapu, kurā tiek izmantoti fiktīvi dati

Publicējiet lapu, kurā tiek izmantoti fiktīvi dati (bez Dataverse tabulām — izlaidiet --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

Padoms

Parametrs --app-id akceptē programmas GUID vai parādāmo nosaukumu. Ja vairākām programmām ir vienāds parādāmais vārds, izmantojiet GUID, lai izvairītos no neskaidrībām. Skrieniet pac model list , lai meklētu programmu ID.

pac model genpage upload Parametru ātrā uzziņa

Parametrs Obligāts Apraksts
--app-id Programmas GUID vai parādāmais vārds. Skrieniet pac model list , lai to atrastu.
--code-file Ceļš uz izvietojamo avota .tsx failu.
--name Tikai jaunas lapas Parādāmais nosaukums, kas redzams programmas vietnes kartē.
--page-id Tikai atjauninājumi Esošās lapas GUID, kas jāaizstāj.
--data-sources Dataverse lapas Ar komatiem atdalīts Dataverse tabulas loģisko nosaukumu saraksts (piemēram, "account,contact").
--prompt Ieteicams Kopsavilkums par lapas darbību dabiskā valodā. Saglabāts reģenerācijas kontekstam.
--model Ieteicams Modeļa ID, kas izmantots lapas ģenerēšanai (piemēram, claude-sonnet-4-6).
--agent-message Ieteicams Uzbūvētā vai mainītā apraksts. Tiek saglabāta kā izmaiņu vēsture.
--add-to-sitemap Tikai jaunas lapas Automātiski pievieno lapu lietotnes navigācijai. Izlaist, atjauninot.

pac model list

Uzskaita visas modeļa vadītās programmas vidē.

Neobligātie parametri model list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac model list piemērs

Uzskaitiet visas modeļa vadītās programmas pašlaik aktīvajā vidē:

pac model list

Parauga izvade.

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

Uzskaita iespējotās valodas Dataverse vidē.

Neobligātie parametri model list-languages

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac model list-tables

Uzskaitiet Dataverse tabulas savienotajā vidē.

Neobligātie parametri model list-tables

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--search -s

Ar komatiem atdalīts meklējamo nosaukumu saraksts (atbilst loģiskajam nosaukumam, shēmas nosaukumam vai parādāmajam nosaukumam).

--type -t

Filtrējiet pēc tabulas veida: "pielāgots", "standarta" vai "viss" (noklusējums: visi).

Skatiet arī

Microsoft Power Platform CLI komandgrupas
Microsoft Power Platform CLI pārskats