pac model

Příkazy pro práci s aplikacemi řízenými modely.

Commands

Command Description
pac model create Vytváří novou aplikaci řízenou modely.
pac model genpage download Stahujte generované stránky z aplikace řízené modelem.
pac model genpage generate-types Generuje definice schémat TypeScript pro datové zdroje
pac model genpage list Uvádí všechny generované stránky ve specifikované modelově řízené aplikaci.
pac model genpage transpile Transpiluje soubor TypeScript s runtime typy pro testování a ladění
pac model genpage upload Nahrajte a publikujte vygenerovanou stránku do aplikace řízené modelem.
pac model list Uvádí všechny modelově řízené aplikace v prostředí.
pac model list-languages Seznamy povolených jazyků v prostředí Dataverse.
pac model list-tables Seznam Dataverse tabulek v propojeném prostředí.

pac model create

Vytváří novou aplikaci řízenou modely.

Požadované parametry pro model create

--name -n

Zobrazovaný název nové modelem řízené aplikace

Volitelné parametry pro model create

--description -d

Popis nové modelem řízené aplikace

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--publish

Po vytvoření publikujte aplikaci.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--solution

Jedinečný název řešení pro přidání aplikace Výchozí hodnota je aktivní řešení.

příklady pac model create

Následující příklady ukazují běžné způsoby použití pac model create příkazu.

Vytvoření nové modelem řízené aplikace v aktivním prostředí

pac model create --name "Contoso Sales Hub"

Vytvořte aplikaci s popisem a přidejte ji do řešení a pak ji okamžitě publikujte.

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

Vytvoření aplikace v konkrétním prostředí zadáním adresy URL prostředí

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

Slouží pac model list k ověření vytvoření aplikace a načtení ID aplikace pro použití s jinými příkazy, jako pac model genpage uploadje .

pac model genpage download

Stahujte generované stránky z aplikace řízené modelem.

Požadované parametry pro model genpage download

--app-id

ID modelem řízené aplikace.

Volitelné parametry pro model genpage download

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--output-directory -o

Adresář pro uložení natažených stránek Výchozí hodnota je aktuální adresář.

--page-id

Seznam ID stránek oddělený čárkami, které se mají vyžádat.

příklady pac model genpage download

Následující příklady ukazují běžné způsoby použití pac model genpage download příkazu.

Stažení jedné generační stránky podle ID stránky do místní složky pro úpravy

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

Stažení všech generivních stránek v aplikaci najednou

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

Vytvořte podadresář pojmenovaný za ID stránky a zapíše následující soubory.

./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 definice schémat TypeScript pro datové zdroje

Požadované parametry pro model genpage generate-types

--data-sources

Seznam použitých zdrojů dat oddělený čárkami (např. account, lead, contact).

Volitelné parametry pro model genpage generate-types

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--output-file -o

Cesta k uložení vygenerovaného souboru schématu TypeScript (výchozí hodnota je RuntimeTypes.ts)

příklady pac model genpage generate-types

Následující příklady ukazují běžné způsoby použití pac model genpage generate-types příkazu.

Generování typů TypeScriptu

Vygenerujte typy TypeScriptu pro tabulky account a contact zapište je do ./src/RuntimeTypes.ts:

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

Generování typů pro jednu tabulku do konkrétního výstupního adresáře

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

Note

Před zápisem kódu stránky, který se dotazuje na tabulky Dataverse, vždy spusťte generate-types . Vygenerovaný soubor obsahuje názvy sloupců silného typu, pole cizího klíče a hodnoty výčtu pro každou tabulku. Spoléhání na vygenerované typy zabraňuje chybám modulu runtime způsobeným chybně napsanými nebo neexistujínými názvy sloupců.

pac model genpage list

Uvádí všechny generované stránky ve specifikované modelově řízené aplikaci.

Požadované parametry pro model genpage list

--app-id

ID modelem řízené aplikace.

Volitelné parametry pro model genpage list

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

příklady pac model genpage list

Následující příklady ukazují běžné způsoby použití pac model genpage list příkazu.

Výpis stránek pomocí ID aplikace

Vypište všechny generující stránky v aplikaci Contoso Sales Hub pomocí ID aplikace:

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

Výpis stránek pomocí názvu aplikace

Vypsat generující stránky podle názvu aplikace (rozhraní příkazového řádku vyhledá ID aplikace automaticky):

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

pac model Výstup ukázky 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 soubor TypeScript s runtime typy pro testování a ladění

Požadované parametry pro model genpage transpile

--code-file

Cesta k souboru obsahujícímu kód stránky

Volitelné parametry pro model genpage transpile

--data-sources

Seznam použitých zdrojů dat oddělený čárkami (např. account, lead, contact).

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--output-file

Cesta k uložení transpilovaného výstupu JavaScriptu (výchozí hodnota je [code-file].compiled.js)

pac model genpage upload

Nahrajte a publikujte vygenerovanou stránku do aplikace řízené modelem.

Požadované parametry pro model genpage upload

--app-id

ID modelem řízené aplikace.

--code-file

Cesta k souboru obsahujícímu kód stránky

Volitelné parametry pro model genpage upload

--add-to-sitemap

Přidejte stránku do navigace v mapě webu aplikace.

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

--agent-message

Zpráva odpovědi agenta.

--agent-message-file

Cesta k souboru obsahujícímu zprávu odpovědi agenta

--compiled-code-file

Cesta k souboru obsahujícímu zkompilovaný kód JavaScriptu Pokud není zadaný, TypeScript se automaticky přepíše do JavaScriptu.

--data-sources

Seznam použitých zdrojů dat oddělený čárkami (např. account, lead, contact).

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--model

Model AI použitý k vygenerování stránky (např. "claude-3-5-sonnet-20241022").

--name -n

Název stránky.

--page-id

ID stránky, která se má aktualizovat. Pokud není k dispozici, vytvoří se nová stránka.

--prompt

Uživatel vyzve, který tuto stránku vygeneroval.

--prompt-file

Cesta k souboru obsahujícímu výzvu uživatele, která tuto stránku vygenerovala.

příklady pac model genpage upload

Následující příklady ukazují běžné způsoby použití pac model genpage upload příkazu.

Publikování nové generující stránky

Publikujte novou stránku generování do aplikace Contoso Sales Hub a přidejte ji do mapy webu aplikace:

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

Aktualizace existující stránky generování

Aktualizujte existující stránku generování zadáním ID stránky (vyhnete --add-to-sitemap se vytvoření duplicitní položky mapy webu):

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

Publikování stránky, která používá napodobená data

Publikujte stránku, která používá napodobená data (bez tabulek Dataverse – vynecháte --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

Parametr --app-id přijímá buď identifikátor GUID aplikace, nebo jeho zobrazovaný název. Pokud více aplikací sdílí stejný zobrazovaný název, použijte identifikátor GUID, abyste se vyhnuli nejednoznačnosti. Spuštěním vyhledejte pac model list ID aplikací.

pac model genpage upload quick-reference k parametru

Parameter Required Description
--app-id Yes IDENTIFIKÁTOR GUID aplikace nebo zobrazovaný název. Spuštěním ji vyhledejte pac model list .
--code-file Yes Cesta ke zdrojovému .tsx souboru, který se má nasadit.
--name Pouze nové stránky Zobrazovaný název zobrazený v mapě webu aplikace
--page-id Updates only IDENTIFIKÁTOR GUID existující stránky, která se má nahradit.
--data-sources Dataverse pages Čárkami oddělený seznam logických názvů tabulek Dataverse (například "account,contact").
--prompt Recommended Shrnutí obsahu stránky v přirozeném jazyce Ukládá se pro kontext regenerace.
--model Recommended ID modelu použité k vygenerování stránky (například claude-sonnet-4-6).
--agent-message Recommended Popis toho, co bylo vytvořeno nebo změněno Ukládá se jako historie změn.
--add-to-sitemap Pouze nové stránky Přidá stránku do navigace v aplikaci automaticky. Při aktualizaci vynecháte.

pac model list

Uvádí všechny modelově řízené aplikace v prostředí.

Volitelné parametry pro model list

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

Příklad pac model list

Zobrazení seznamu všech modelem řízených aplikací v aktuálně aktivním prostředí:

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

Seznamy povolených jazyků v prostředí Dataverse.

Volitelné parametry pro model list-languages

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac model list-tables

Seznam Dataverse tabulek v propojeném prostředí.

Volitelné parametry pro model list-tables

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--search -s

Seznam jmen oddělených čárkami k vyhledávání (odpovídá logickému názvu, názvu schématu nebo zobrazovanému názvu).

--type -t

Filtrujte podle typu tabulky: 'custom', 'standard' nebo 'all' (výchozí: all).

See also

Microsoft Power Platform skupiny příkazů rozhraní příkazového řádku
přehled rozhraní příkazového řádku Microsoft Power Platform