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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

pac model genpage list Приклади

У наведених нижче прикладах наведено типові способи використання pac model genpage list команди.

• Список сторінок за допомогою ідентифікатора програми
• Список сторінок з іменем програми

Список сторінок за допомогою ідентифікатора програми

Перелічіть усі генеративні сторінки в програмі Contoso Sales Hub за допомогою ідентифікатора програми:

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

Список сторінок з іменем програми

Перелічіть генеративні сторінки за іменем програми (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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--output-file

Шлях до збереження транспільованого виводу JavaScript (за замовчуванням до [code-file].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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--model

Модель AI, яка використовується для створення сторінки (наприклад, "claude-3-5-sonnet-20241022").

--name на -n

Ім'я сторінки.

--page-id

Ідентифікатор сторінки для оновлення. Якщо її не вказано, буде створено нову сторінку.

--prompt

Запит користувача, який створив цю сторінку.

--prompt-file

Шлях до файлу, який містить запит користувача, який створив цю сторінку.

pac model genpage upload Приклади

У наведених нижче прикладах наведено типові способи використання pac model genpage upload команди.

• Публікація нової генеративної сторінки
• Оновлення наявної генеративної сторінки
• Публікація сторінки, на якій використовуються глузливі дані

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

Опублікуйте нову генеративну сторінку в програмі Contoso Sales Hub і додайте її до карти сайту програми:

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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

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. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

pac model list-tables

Перелічіть таблиці Dataverse у підключеному середовищі.

Необов'язкові параметри для model list-tables

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--search на -s

Список імен з розділеним комою для пошуку (відповідає логічному імені, імені схеми або відображеному імені).

--type на -t

Фільтруйте за типом таблиці: 'custom', 'standard' або 'all' (за замовчуванням: всі).

See also

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