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 add Připojte jednu nebo více existujících generivních stránek k mapě webu modelem řízené aplikace (bez opětovného nahrání). Pomocí příkazu 'pac model genpage upload' můžete vytvořit nebo aktualizovat samotnou stránku. Pomocí tohoto příkazu se již nahraná stránka zobrazí v jiné aplikaci.
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 Seznam vygenerovaných stránek – ve výchozím nastavení env-wide nebo pro jednu aplikaci při zadání --app-id. Umožňuje předat --include-unpublished, aby se vypisovaly také stránky konceptu.
pac model genpage remove Odpojte existující stránky generující umělé inteligence od mapy webu modelem řízené aplikace. Řádek stránky v Dataverse se zachová (může se na něj stále odkazovat z jiných aplikací).
pac model genpage transpile Transpiluje soubor TypeScript s runtime typy pro testování a ladění
pac model genpage upload Nahrajte vygenerovanou stránku do služby Dataverse a publikujte ji. Vytvoří novou stránku při vynechání --page-id; aktualizuje existující stránku při zadání --page-id. Pokud chcete připojit stránku, která už v prostředí existuje, k mapě webu jiné aplikace bez opětovného nahrání použijte místo toho "pac model genpage add".
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 Pokud není zadáno, nastaví se výchozí hodnota.

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

Návod

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 add

Připojte jednu nebo více existujících generivních stránek k mapě webu modelem řízené aplikace (bez opětovného nahrání). Pomocí příkazu 'pac model genpage upload' můžete vytvořit nebo aktualizovat samotnou stránku. Pomocí tohoto příkazu se již nahraná stránka zobrazí v jiné aplikaci.

Požadované parametry pro model genpage add

--page-id

Id generovaných stránek oddělených čárkami (GUID) pro přidání do aplikace

Volitelné parametry pro model genpage add

--app-id

ID (GUID) modelem řízené aplikace Vzájemně se vylučují s názvem --app-name.

--app-name

Jedinečný název modelem řízené aplikace. Vzájemně se vylučují s --app-id.

--area

Volitelné ID oblasti v mapě webu pro umístění stránky pod. Výchozí hodnota je první oblast.

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

--group

Volitelné ID skupiny na webu pro umístění stránky pod. Výchozí hodnota je první skupina vybrané oblasti.

--language-code

Kód jazyka (LCID) pro název podoblasti. Výchozí hodnota je 1033 (en-US).

--publish

Publikujte modelem řízenou aplikaci po přidání stránek.

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

--solution

Jedinečný název kontextu řešení Dataverse pro aktualizaci mapy webu Výchozí hodnota je "Výchozí".

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

Seznam vygenerovaných stránek – ve výchozím nastavení env-wide nebo pro jednu aplikaci při zadání --app-id. Umožňuje předat --include-unpublished, aby se vypisovaly také stránky konceptu.

Volitelné parametry pro model genpage list

--app-id

ID 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í.

--include-unpublished

Do seznamu zahrňte nepublikované generující stránky (výchozí hodnota: publikovaná).

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

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 remove

Odpojte existující stránky generující umělé inteligence od mapy webu modelem řízené aplikace. Řádek stránky v Dataverse se zachová (může se na něj stále odkazovat z jiných aplikací).

Požadované parametry pro model genpage remove

--page-id

Jedno nebo více ID projektu uxagentproject, které se mají odebrat (oddělené čárkami).

Volitelné parametry pro model genpage remove

--app-id

ID modelem řízené aplikace (uniqueid) pro odebrání stránek. Vzájemně se vylučují s názvem --app-name.

--app-name

Jedinečný název modelem řízené aplikace pro odebrání stránek Vzájemně se vylučují s --app-id.

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

Publikujte modelem řízenou aplikaci po úpravě mapy webu, aby se změny okamžitě změnily.

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

--solution

Jedinečný název řešení Dataverse pro aktualizaci mapy webu Výchozí hodnota je "Výchozí".

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 vygenerovanou stránku do služby Dataverse a publikujte ji. Vytvoří novou stránku při vynechání --page-id; aktualizuje existující stránku při zadání --page-id. Pokud chcete připojit stránku, která už v prostředí existuje, k mapě webu jiné aplikace bez opětovného nahrání použijte místo toho "pac model genpage add".

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

Návod

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 Povinné Description
--app-id Ano IDENTIFIKÁTOR GUID aplikace nebo zobrazovaný název. Spuštěním ji vyhledejte pac model list .
--code-file Ano 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 Pouze aktualizace IDENTIFIKÁTOR GUID existující stránky, která se má nahradit.
--data-sources Stránky Dataverse Čárkami oddělený seznam logických názvů tabulek Dataverse (například "account,contact").
--prompt Doporučený Shrnutí obsahu stránky v přirozeném jazyce Ukládá se pro kontext regenerace.
--model Doporučený ID modelu použité k vygenerování stránky (například claude-sonnet-4-6).
--agent-message Doporučený 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

Ukázkový výstup:

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

Viz také

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

  • Last updated on