pac model

Príkazy na prácu s modelovo riadenými aplikáciami.

Commands

Command Description
pac model create Vytvára novú modelovo riadenú aplikáciu.
pac model genpage download Stiahnite generované stránky z aplikácie riadenej modelmi.
pac model genpage generate-types Generuje definície schémy TypeScript pre dátové zdroje
pac model genpage list Zobrazuje všetky generované stránky v špecifikovanej modelovo riadenej aplikácii.
pac model genpage transpile Transpiluje súbor TypeScript s runtime typmi na testovanie a ladenie
pac model genpage upload Nahrajte a zverejnite vygenerovanú stránku do aplikácie riadenej modelom.
pac model list Uvádza všetky modelovo riadené aplikácie v prostredí.
pac model list-languages Zoznam povolených jazykov v prostredí Dataverse.
pac model list-tables Zoznam Dataverse tabuliek v prepojenom prostredí.

pac model create

Vytvára novú modelovo riadenú aplikáciu.

Povinné parametre pre model create

--name -n

Zobrazovaný názov novej modelom riadenej aplikácie.

Voliteľné parametre pre model create

--description -d

Popis novej modelom riadenej aplikácie.

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--publish

Publikovanie aplikácie po vytvorení.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--solution

Jedinečný názov riešenia, do čoho sa má pridať aplikácia. Predvolené nastavenie aktívneho riešenia.

pac model create Príklady

Nasledujúce príklady zobrazujú bežné spôsoby použitia pac model create príkazu.

Vytvorenie novej modelom riadenej aplikácie v aktívnom prostredí

pac model create --name "Contoso Sales Hub"

Vytvorte aplikáciu s popisom a pridajte ju do riešenia a potom ju okamžite publikujte.

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

Vytvorenie aplikácie v konkrétnom prostredí pomocou URL adresy prostredia

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

Pomocou overte pac model list , či bola aplikácia vytvorená a načítajte jej ID aplikácie na použitie s inými príkazmi, ako pac model genpage uploadje .

pac model genpage download

Stiahnite generované stránky z aplikácie riadenej modelmi.

Povinné parametre pre model genpage download

--app-id

ID modelom riadenej aplikácie.

Voliteľné parametre pre model genpage download

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--output-directory -o

Adresár na uloženie vytiahnutých strán. Predvolene sa nastaví na aktuálny adresár.

--page-id

Zoznam ID stránok oddelených čiarkou, ktoré sa majú načítať.

pac model genpage download Príklady

Nasledujúce príklady zobrazujú bežné spôsoby použitia pac model genpage download príkazu.

Stiahnite si jednu generativnú stránku pomocou ID stránky do miestneho priečinka na úpravu

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

Stiahnuť všetky generatívne stránky v aplikácii naraz

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

Vytvorte podadresár s názvom podľa ID strany a zapíše nasledujúce súbory.

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

Generuje definície schémy TypeScript pre dátové zdroje

Povinné parametre pre model genpage generate-types

--data-sources

Zoznam používaných zdrojov údajov oddelených čiarkou (napr. konto, potenciálny zákazník, kontakt).

Voliteľné parametre pre model genpage generate-types

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--output-file -o

Cesta k uloženiu vygenerovaného súboru schémy TypeScript (predvolené nastavenie na RuntimeTypes.ts)

pac model genpage generate-types Príklady

Nasledujúce príklady zobrazujú bežné spôsoby použitia pac model genpage generate-types príkazu.

Generovať typy TypeScript

Vygenerujte typy TypeScript pre account tabuľky a contact a napíšte ich do ./src/RuntimeTypes.ts:

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

Generovanie typov pre jednu tabuľku do konkrétneho výstupného adresára

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

Note

Pred napísaním kódu stránky, ktorý dotazuje tabuľky Dataverse, vždy ho spustite generate-types . Vygenerovaný súbor obsahuje silné názvy stĺpcov, polia cudzieho kľúča a hodnoty enuum pre každú tabuľku. Spoliehanie sa na vygenerované typy zabraňuje chybám režimu runtime spôsobeným nesprávne napísanými alebo neexistujúcimi názvami stĺpcov.

pac model genpage list

Zobrazuje všetky generované stránky v špecifikovanej modelovo riadenej aplikácii.

Povinné parametre pre model genpage list

--app-id

ID modelom riadenej aplikácie.

Voliteľné parametre pre model genpage list

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

pac model genpage list Príklady

Nasledujúce príklady zobrazujú bežné spôsoby použitia pac model genpage list príkazu.

Zobrazenie zoznamu stránok pomocou ID aplikácie

Pomocou ID svojej aplikácie môžete zobraziť zoznam všetkých generattívnych stránok v aplikácii Contoso Sales Hub :

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

Zoznam stránok s názvom aplikácie

List generative pages by app name (CLI automaticky vyhľadá ID aplikácie):

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

pac model výstup ukážky stránky 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 transpile

Transpiluje súbor TypeScript s runtime typmi na testovanie a ladenie

Povinné parametre pre model genpage transpile

--code-file

Cesta k súboru obsahujúcemu kód strany.

Voliteľné parametre pre model genpage transpile

--data-sources

Zoznam používaných zdrojov údajov oddelených čiarkou (napr. konto, potenciálny zákazník, kontakt).

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--output-file

Cesta k uloženiu transpilovaného výstupu JavaScriptu (predvolene na [kód-súbor].compiled.js)

pac model genpage upload

Nahrajte a zverejnite vygenerovanú stránku do aplikácie riadenej modelom.

Povinné parametre pre model genpage upload

--app-id

ID modelom riadenej aplikácie.

--code-file

Cesta k súboru obsahujúcemu kód strany.

Voliteľné parametre pre model genpage upload

--add-to-sitemap

Pridajte stránku do navigácie mapy lokality aplikácie.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--agent-message

Hlásenie o odpovedi agenta.

--agent-message-file

Cesta k súboru obsahujúcemu správu o odpovedi agenta.

--compiled-code-file

Cesta k súboru obsahujúcemu kompilovaný kód Jazyka JavaScript. Ak nie je zadaný, TypeScript sa automaticky preloží do JavaScriptu.

--data-sources

Zoznam používaných zdrojov údajov oddelených čiarkou (napr. konto, potenciálny zákazník, kontakt).

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--model

Model AI, ktorý sa používa na generovanie stránky (napr. claude-3-5-sonnet-20241022).

--name -n

Názov strany.

--page-id

ID stránky, ktorá sa má aktualizovať. Ak nie je zadaná, vytvorí sa nová strana.

--prompt

Výzva používateľa, ktorá vygenerovala túto stránku.

--prompt-file

Cesta k súboru obsahujúcemu výzvu používateľa, ktorá vygenerovala túto stránku.

pac model genpage upload Príklady

Nasledujúce príklady zobrazujú bežné spôsoby použitia pac model genpage upload príkazu.

Publikovanie novej generativnej stránky

Publikujte novú generatatívnu stránku do aplikácie Contoso Sales Hub a pridajte ju na mapu lokality aplikácie:

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

Aktualizácia existujúcej generativnej stránky

Aktualizujte existujúcu generatatívnu stránku zadaním ID jej stránky (vynechať --add-to-sitemap , aby ste nevytvorili duplicitnú položku mapy lokality):

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

Publikovanie stránky, ktorá používa zosmiešňovanie údajov

Publikujte stránku, ktorá používa zosmiešňovanie údajov (žiadne tabuľky Dataverse – vynechať --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

Parameter --app-id akceptuje buď identifikátor GUID aplikácie, alebo jeho zobrazovaný názov. Ak viaceré aplikácie zdieľajú rovnaký zobrazovaný názov, použite identifikátor GUID, aby ste sa vyhli nejednoznačnosti. Spustite a pac model list vyhľadajte ID aplikácií.

pac model genpage upload rýchly odkaz na parameter

Parameter Required Description
--app-id Yes Identifikátor GUID aplikácie alebo zobrazovaný názov. Spustite pac model list ho a vyhľadajte ho.
--code-file Yes Cesta k zdrojového .tsx súboru na nasadenie.
--name Len nové strany Zobrazovaný názov zobrazený na mape lokality aplikácie.
--page-id Updates only Identifikátor GUID existujúcej stránky, ktorý sa má nahradiť.
--data-sources Dataverse pages Zoznam logických názvov tabuliek s hodnotami oddelenými čiarkou (napríklad "account,contact").
--prompt Recommended Súhrn toho, čo stránka robí v prirodzenom jazyku. Uložené na regeneráciu v kontexte.
--model Recommended ID modelu použité na generovanie stránky (napríklad claude-sonnet-4-6).
--agent-message Recommended Popis toho, čo bolo vytvorené alebo zmenené. Uložené ako história zmien.
--add-to-sitemap Len nové strany Pridá stránku do navigácie aplikácie automaticky. Pri aktualizácii sa vynechať.

pac model list

Uvádza všetky modelovo riadené aplikácie v prostredí.

Voliteľné parametre pre model list

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

pac model list príklad

Zobrazenie zoznamu všetkých modelom riadených aplikácií v aktuálne aktívnom prostredí:

pac model list

Sample output:

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

Zoznam povolených jazykov v prostredí Dataverse.

Voliteľné parametre pre model list-languages

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

pac model list-tables

Zoznam Dataverse tabuliek v prepojenom prostredí.

Voliteľné parametre pre model list-tables

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--search -s

Zoznam mien oddelených čiarkami, ktoré treba vyhľadávať (zodpovedá logickému názvu, názvu schémy alebo zobrazovanému názvu).

--type -t

Filtrujte podľa typu tabuľky: 'vlastné', 'štandardné' alebo 'všetky' (predvolené: všetky).

See also

príkazové skupiny rozhrania Microsoft Power Platform CLI
prehľad rozhrania Microsoft Power Platform CLI

  • Last updated on