pac model

Команди для роботи з додатками, керованими моделями.

Команди

Команда	Опис
pac model create	Створює новий додаток, орієнтований на модель.
pac model genpage add	Вкладіть одну або кілька наявних генеративних сторінок до карти сайту програми на основі моделі (без повторного передавання). Використовуйте "pac model genpage upload", щоб створити або оновити саму сторінку; використовуйте це дієслово, щоб уже передана сторінка відобраилася в іншій програмі.
pac model genpage download	Витягуйте згенеровані сторінки з додатку, керованого моделями.
pac model genpage generate-types	Генерує визначення схем TypeScript для джерел даних
pac model genpage get-connector-schema	Отримує схему стовпця сполучної таблиці або схему операції REST для створених сторінок.
pac model genpage list	Список створених сторінок – за замовчуванням за замовчуванням або для однієї програми, коли вказано ідентифікатор --app. Pass --include-unpublished to also list draft pages.
pac model genpage list-connector-operations	Список операцій REST з'єднувача для створених сторінок.
pac model genpage list-connector-tables	Список сполучних таблиць для створених сторінок.
pac model genpage remove	Від'єднайте наявні генеративні сторінки AI від карти сайту програми на основі моделі. Рядок сторінки в Dataverse зберігається (на нього можуть посилатися інші програми).
pac model genpage transpile	Транспилює файл TypeScript з типами виконання для тестування та налагодження
pac model genpage upload	Передайте створену сторінку до Dataverse та опублікуйте її. Створює нову сторінку, якщо аргумент --page-id не вказано; оновлює наявну сторінку, якщо вказано ідентифікатор --page. Щоб вкласти сторінку, яка вже існує в середовищі, до карти сайту іншої програми без повторного передавання, використовуйте натомість "pac model genpage add".
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

Порада

Використовується pac model list для перевірки створеної програми та отримання її ідентифікатора програми для використання з іншими командами, наприклад pac model genpage upload.

pac model genpage add

Вкладіть одну або кілька наявних генеративних сторінок до карти сайту програми на основі моделі (без повторного передавання). Використовуйте "pac model genpage upload", щоб створити або оновити саму сторінку; використовуйте це дієслово, щоб уже передана сторінка відобраилася в іншій програмі.

Обов'язкові параметри для model genpage add

--page-id

Ідентифікатори генеративних сторінок, розділені комами (ідентифікатори GUID), які потрібно додати до програми.

Необов'язкові параметри для model genpage add

--app-id

Ідентифікатор програми на основі моделі (GUID). Взаємовиключний з --app-name.

--app-name

Унікальне ім'я програми на основі моделі. Взаємовиключний з ідентифікатором --app-id.

--area

Необов'язковий ідентифікатор області на карті сайту для розміщення сторінки в розділі. За замовчуванням до першої області.

--environment на -env

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

--group

Необов'язковий ідентифікатор групи на карті сайту для розміщення сторінки в розділі. За замовчуванням для першої групи вибраної області.

--language-code

Код мови (LCID) для назви SubArea. За замовчуванням використовується значення 1033 (en-US).

--publish

Публікування програми на основі моделі після додавання сторінок.

Для цього параметра не потрібне значення. Це перемикач.

--solution

Унікальне ім'я контексту рішення Dataverse для оновлення карти сайту. За замовчуванням вибрано значення "За замовчуванням".

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

Примітка

Завжди запускайте generate-types перед написанням коду сторінки, який запитує таблиці Dataverse. Створений файл містить сильно введене ім'я стовпців, поля зовнішнього ключа та перелічення значень для кожної таблиці. Покладаючись на створені типи, помилки середовища виконання, спричинені неправильною або неіснуючою назвою стовпців.

pac model genpage get-connector-schema

Отримує схему стовпця сполучної таблиці або схему операції REST для створених сторінок.

Обов'язкові параметри для model genpage get-connector-schema

--connection-id

Ідентифікатор підключення для виявлення метаданих з'єднувача.

--connector-id

Ідентифікатор API з'єднувача (наприклад, /providers/Microsoft). PowerApps/apis/shared_sharepointonline).

Необов'язкові параметри для model genpage get-connector-schema

--dataset

Ідентифікатор набору даних для виявлення табличного з'єднувача (наприклад, URL-адреса сайту SharePoint або SQL server/database). Обов'язковий для --table.

--environment на -env

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

--operation

Ідентифікатор операції REST для режиму схеми операції. Не можна використовувати з набором даних або таблицею --

--table

Ідентифікатор таблиці для табличного режиму схеми. Потрібен набір даних --dataset і його не можна використовувати з функцією --operation.

pac model genpage list

Список створених сторінок – за замовчуванням за замовчуванням або для однієї програми, коли вказано ідентифікатор --app. Pass --include-unpublished to also list draft pages.

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

--app-id

Ідентифікатор програми на основі моделі.

--environment на -env

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

--include-unpublished

Додайте до списку неопубліковані генеративні сторінки (за замовчуванням: лише опубліковано).

Для цього параметра не потрібне значення. Це перемикач.

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 list-connector-operations

Список операцій REST з'єднувача для створених сторінок.

Обов'язкові параметри для model genpage list-connector-operations

--connection-id

Ідентифікатор підключення для виявлення метаданих з'єднувача.

--connector-id

Ідентифікатор API з'єднувача (наприклад, /providers/Microsoft). PowerApps/apis/shared_sharepointonline).

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

--environment на -env

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

pac model genpage list-connector-tables

Список сполучних таблиць для створених сторінок.

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

--connection-id

Ідентифікатор підключення для виявлення метаданих з'єднувача.

--connector-id

Ідентифікатор API з'єднувача (наприклад, /providers/Microsoft). PowerApps/apis/shared_sharepointonline).

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

--dataset

Ідентифікатор набору даних для виявлення табличного з'єднувача (наприклад, URL-адреса сайту SharePoint або SQL server/database). Обов'язковий для --table.

--environment на -env

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

pac model genpage remove

Від'єднайте наявні генеративні сторінки AI від карти сайту програми на основі моделі. Рядок сторінки в Dataverse зберігається (на нього можуть посилатися інші програми).

Обов'язкові параметри для model genpage remove

--page-id

Один або кілька ідентифікаторів uxagentproject для видалення (розділені комами).

Необов'язкові параметри для model genpage remove

--app-id

Ідентифікатор програми на основі моделі (uniqueid), з якого потрібно видалити сторінки. Взаємовиключний з --app-name.

--app-name

Унікальне ім'я програми на основі моделі для видалення сторінок. Взаємовиключний з ідентифікатором --app-id.

--environment на -env

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

--publish

Опублікуйте програму на основі моделі після редагування карти сайту, щоб зміни відразу з'явились у прямому ефірі.

Для цього параметра не потрібне значення. Це перемикач.

--solution

Унікальне ім'я рішення Dataverse для оновлення карти сайту. За замовчуванням вибрано значення "За замовчуванням".

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

Передайте створену сторінку до Dataverse та опублікуйте її. Створює нову сторінку, якщо аргумент --page-id не вказано; оновлює наявну сторінку, якщо вказано ідентифікатор --page. Щоб вкласти сторінку, яка вже існує в середовищі, до карти сайту іншої програми без повторного передавання, використовуйте натомість "pac model genpage add".

Обов'язкові параметри для model genpage upload

--app-id

Ідентифікатор програми на основі моделі.

--code-file

Шлях до файлу з кодом сторінки.

Необов'язкові параметри для model genpage upload

--add-to-sitemap

Додайте сторінку до навігації карти сайту програми.

Для цього параметра не потрібне значення. Це перемикач.

--agent-message

Відповідь агента.

--agent-message-file

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

--compiled-code-file

Шлях до файлу, що містить скомпільований код JavaScript. Якщо цього не вказано, функція TypeScript автоматично перенаведена на JavaScript.

--connectors

Шлях до файлу JSON зі з'єднувачами для збереження в config.jsonсторінки .

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

Порада

Параметр --app-id приймає GUID програми або коротке ім'я. Якщо кілька програм мають однакове коротке ім'я, використовуйте GUID, щоб уникнути неоднозначності. Запустіть pac model list , щоб знайти ідентифікатори програм.

pac model genpage upload коротке посилання на параметр

Параметр	Обов’язково	Опис
--app-id	Так	GUID програми або коротке ім'я. Запустіть pac model list , щоб знайти його.
--code-file	Так	Шлях до вихідного .tsx файлу для розгортання.
--name	Лише нові сторінки	Коротке ім'я, показане на карті сайту програми.
--page-id	Лише оновлення	GUID наявної сторінки для заміни.
--data-sources	Сторінки з даними	Список логічних імен таблиці Dataverse, розділений комами (наприклад, "account,contact").
--prompt	Рекомендується	Зведення природної мови про те, що робить сторінка. Зберігається для контексту регенерації.
--model	Рекомендується	Ідентифікатор моделі, який використовується для створення сторінки (наприклад, claude-sonnet-4-6).
--agent-message	Рекомендується	Опис того, що було побудовано або змінено. Зберігається як журнал змін.
--add-to-sitemap	Лише нові сторінки	Автоматично додає сторінку до навігації програмами. Не опускати під час оновлення.

pac model list

Містить список усіх додатків, керованих моделями, у середовищі.

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

--environment на -env

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

pac model list Приклад

Перелічіть усі програми на основі моделі в активному середовищі:

pac model list

Зразок виводу:

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' (за замовчуванням: всі).

Додаткові відомості

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