pac model

Команди за работа с приложения, управлявани от модели.

Commands

Command	Description
pac model create	Създава ново приложение, базирано на модели.
pac model genpage download	Изтеглете генерирани страници от приложение, управлявано от модели.
pac model genpage generate-types	Генерира дефиниции на схема в TypeScript за източници на данни
pac model genpage list	Изброява всички генерирани страници в зададеното приложение, управлявано от модели.
pac model genpage transpile	Транспилира TypeScript файл с типове за изпълнение за тестване и отстраняване на грешки
pac model genpage upload	Качете и публикувайте генерирана страница в приложение, управлявано от модели.
pac model list	Изброява всички приложения, управлявани от модели, в средата.
pac model list-languages	Изброява активирани езици в средата на Dataverse.
pac model list-tables	Изброете таблиците на Dataverse в свързаната среда.

pac model create

Създава ново приложение, базирано на модели.

Задължителни параметри за model create

--name -n

Показваното име за новото базирано на модел приложение.

Незадължителни параметри за model create

--description -d

Описание за новото базирано на модел приложение.

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--publish

Публикувайте приложението след създаването му.

Този параметър не изисква стойност. Това е превключвател.

--solution

Уникално име на решение, към което да добавите приложението. По подразбиране е активното решение.

pac model create Примери

Следващите примери показват често срещани начини за използване на командата pac model create .

• Създаване на ново базирано на модел приложение в активната среда
• Създайте приложение с описание и го добавете към решение, след което го публикувайте незабавно
• Създаване на приложение в конкретна среда чрез предоставяне на URL адреса на средата

Създаване на ново базирано на модел приложение в активната среда

pac model create --name "Contoso Sales Hub"

Създайте приложение с описание и го добавете към решение, след което го публикувайте незабавно

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

Създаване на приложение в конкретна среда чрез предоставяне на 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

Tip

Използвайте pac model list , за да проверите дали приложението е създадено, и извлечете неговия ИД на приложение за използване с други команди, като pac model genpage uploadнапример .

pac model genpage download

Изтеглете генерирани страници от приложение, управлявано от модели.

Задължителни параметри за model genpage download

--app-id

ИД на базираното на модел приложение.

Незадължителни параметри за model genpage download

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--output-directory -o

Директория за записване на извлечени страници. По подразбиране е текущата директория.

--page-id

Разделен със запетаи списък с ИД на страница, които да се изтеглят.

pac model genpage download Примери

Следващите примери показват често срещани начини за използване на командата pac model genpage download .

• Изтегляне на една-единствена генеративна страница по ИД на страница в локална папка за редактиране
• Изтегляне на всички жанеративни страници в дадено приложение наведнъж
• Създайте поддиректория, кръстена на ИД на страницата, и записва следните файлове

Изтегляне на една-единствена генеративна страница по ИД на страница в локална папка за редактиране

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

Изтегляне на всички жанеративни страници в дадено приложение наведнъж

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

Създайте поддиректория, кръстена на ИД на страницата, и записва следните файлове

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

Генерира дефиниции на схема в TypeScript за източници на данни

Задължителни параметри за model genpage generate-types

--data-sources

Разделен със запетаи списък на използваните източници на данни (например "акаунт,потенциален клиент,контакт").

Незадължителни параметри за model genpage generate-types

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--output-file -o

Път за записване на генерирания файл със схема на TypeScript (по подразбиране е RuntimeTypes.ts)

pac model genpage generate-types Примери

Следващите примери показват често срещани начини за използване на командата pac model genpage generate-types .

• Генериране на типове TypeScript
• Генериране на типове за една таблица в конкретна изходна директория

Генериране на типове TypeScript

Генерирайте типовете TypeScript за таблиците account и и contact ги запишете в ./src/RuntimeTypes.ts:

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

Генериране на типове за една таблица в конкретна изходна директория

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

Note

Винаги изпълнявай generate-types , преди да пишеш код на страница, който заявки към таблици на Dataverse. Генерираният файл съдържа силно въведени имена на колони, полета с външни ключове и стойности на номериране за всяка таблица. Разчитането на генерираните типове предотвратява грешките по време на изпълнение, предизвикани от неправилно написани или несъществуващи имена на колони.

pac model genpage list

Изброява всички генерирани страници в зададеното приложение, управлявано от модели.

Задължителни параметри за model genpage list

--app-id

ИД на базираното на модел приложение.

Незадължителни параметри за model genpage list

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac model genpage list Примери

Следващите примери показват често срещани начини за използване на командата pac model genpage list .

• Изброяване на страници с ИД на приложение
• Изброяване на страници с помощта на име на приложение

Изброяване на страници с ИД на приложение

Избройте всички жанративни страници в приложението "Център за продажби на Contoso" , като използвате неговия ИД на приложение:

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

Изброяване на страници с помощта на име на приложение

Изброяване на generative страници по име на приложение (CLI търси ИД на приложението автоматично):

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

pac model примерен резултат от 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

Транспилира TypeScript файл с типове за изпълнение за тестване и отстраняване на грешки

Задължителни параметри за model genpage transpile

--code-file

Път до файла, съдържащ кода на страницата.

Незадължителни параметри за model genpage transpile

--data-sources

Разделен със запетаи списък на използваните източници на данни (например "акаунт,потенциален клиент,контакт").

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--output-file

Път за записване на транспилирания JavaScript изход (по подразбиране на [кодов файл].compiled.js)

pac model genpage upload

Качете и публикувайте генерирана страница в приложение, управлявано от модели.

Задължителни параметри за model genpage upload

--app-id

ИД на базираното на модел приложение.

--code-file

Път до файла, съдържащ кода на страницата.

Незадължителни параметри за model genpage upload

--add-to-sitemap

Добавете страницата към навигацията на картата на сайта на приложението.

Този параметър не изисква стойност. Това е превключвател.

--agent-message

Съобщение за отговор на агента.

--agent-message-file

Път до файл, съдържащ съобщението за отговор на агента.

--compiled-code-file

Път до файла, съдържащ компилиран JavaScript код. Ако не е предоставен, TypeScript автоматично ще се транслира в JavaScript.

--data-sources

Разделен със запетаи списък на използваните източници на данни (например "акаунт,потенциален клиент,контакт").

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--model

Моделът AI, използван за генериране на страницата (например "claude-3-5-sonnet-20241022").

--name -n

Името на страницата.

--page-id

ИД на страницата за актуализиране. Ако не е предоставена, ще бъде създадена нова страница.

--prompt

Подканата на потребителя, генерирала тази страница.

--prompt-file

Път до файл, съдържащ подканата на потребителя, генерирал тази страница.

pac model genpage upload Примери

Следващите примери показват често срещани начини за използване на командата pac model genpage upload .

• Публикуване на нова генеративна страница
• Актуализиране на съществуваща генеративна страница
• Публикуване на страница, която използва макет на данни

Публикуване на нова генеративна страница

Публикувайте нова генеративна страница в приложението "Център за продажби на Contoso" и я добавете към картата на сайта на приложението:

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

Актуализиране на съществуваща генеративна страница

Актуализирайте съществуваща генеративна страница, като предоставите нейния ИД на страница (пропуснете --add-to-sitemap , за да избегнете създаването на дублиран запис на карта на сайт):

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

Публикуване на страница, която използва макет на данни

Публикуване на страница, която използва макет на данни (без таблици на Dataverse – пропускане --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

Параметърът --app-id приема GUID на приложението или неговото показвано име. Ако няколко приложения имат едно и също показвано име, използвайте GUID, за да избегнете неяснота. Изпълнете pac model list , за да потърсите ИД на приложение.

pac model genpage upload бърза справка за параметър

Parameter	Required	Description
--app-id	Yes	GUID на приложение или показвано име. Изпълнете, pac model list за да го намерите.
--code-file	Yes	Път до .tsx файла източник за разполагане.
--name	Само нови страници	Показвано име, показано в картата на сайта на приложението.
--page-id	Updates only	GUID на съществуващата страница за заместване.
--data-sources	Dataverse pages	Разделен със запетаи списък с логически имена на таблици на Dataverse (например "account,contact").
--prompt	Recommended	Резюме на естествения език за това, което прави страницата. Съхранен за контекст на регенерация.
--model	Recommended	ИД на модела, използван за генериране на страницата (например claude-sonnet-4-6).
--agent-message	Recommended	Описание на това, което е създадено или променено. Съхранен като хронология на промените.
--add-to-sitemap	Само нови страници	Добавя страницата към навигацията на приложението автоматично. Пропускане при актуализиране.

pac model list

Изброява всички приложения, управлявани от модели, в средата.

Незадължителни параметри за model list

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac model list Пример

Избройте всички приложения, управлявани от модел, в активната в момента среда:

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

Изброява активирани езици в средата на Dataverse.

Незадължителни параметри за model list-languages

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

pac model list-tables

Изброете таблиците на Dataverse в свързаната среда.

Незадължителни параметри за model list-tables

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--search -s

Списък с имена, разделени със запетая, за търсене (съвпада с логическо име, име на схема или дисплейно име).

--type -t

Филтрирайте по тип таблица: 'custom', 'standard' или 'all' (по подразбиране: всички).

See also

Microsoft Power Platform CLI командни групи
Microsoft Power Platform CLI общ преглед