pac model

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

Commands

Command Description
pac model create Создаёт новое приложение, основанное на моделях.
pac model genpage add Подключите одну или несколько существующих созданных страниц к карте сайта приложения на основе модели (без повторной отправки). Используйте "pac model genpage upload" для создания или обновления самой страницы; используйте эту команду, чтобы создать уже отправленную страницу в другом приложении.
pac model genpage download Извлекайте сгенерированные страницы из приложения, управляемого моделями.
pac model genpage generate-types Генерирует определения схем TypeScript для источников данных
pac model genpage list Список созданных страниц — env-wide по умолчанию или для одного приложения при указании идентификатора --app-id. Передайте --include-unpublished, чтобы также перечислить черновики страниц.
pac model genpage remove Отсоединить существующие страницы создания ИИ от карты сайта на основе модели. Строка страницы в Dataverse сохраняется (она по-прежнему может ссылаться из других приложений).
pac model genpage transpile Транспилирует файл TypeScript с типами выполнения для тестирования и отладки
pac model genpage upload Отправьте созданную страницу в Dataverse и опубликуйте ее. Создает новую страницу при опущении --page-id; обновляет существующую страницу при указании идентификатора --page-id. Чтобы подключить страницу, которая уже существует в среде, к карте сайта другого приложения без повторной отправки, используйте вместо этого "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 или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--publish

Опубликуйте приложение после создания.

Этот параметр не требует значения. Это переключатель.

--solution

Уникальное имя решения для добавления приложения в. По умолчанию используется значение Default, если оно не указано.

примеры pac model create

В следующих примерах показаны распространенные способы использования pac model create команды.

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

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 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 или абсолютным URL-адресом 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 или абсолютным URL-адресом 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

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

Необязательные параметры для model genpage generate-types

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--output-file -o

Путь к сохранению созданного файла схемы TypeScript (по умолчанию — RuntimeTypes.ts)

примеры pac model genpage generate-types

В следующих примерах показаны распространенные способы использования pac model genpage generate-types команды.

Создание типов 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

Список созданных страниц — env-wide по умолчанию или для одного приложения при указании идентификатора --app-id. Передайте --include-unpublished, чтобы также перечислить черновики страниц.

Необязательные параметры для model genpage list

--app-id

Идентификатор приложения на основе модели.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом 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"

Вывод списка страниц с помощью имени приложения

Вывод списка создаваемых страниц по имени приложения (ИНТЕРФЕЙС командной строки автоматически ищет идентификатор приложения):

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 remove

Отсоединить существующие страницы создания ИИ от карты сайта на основе модели. Строка страницы в Dataverse сохраняется (она по-прежнему может ссылаться из других приложений).

Обязательные параметры для model genpage remove

--page-id

Один или несколько идентификаторов uxagentproject для удаления (разделенные запятыми).

Необязательные параметры для model genpage remove

--app-id

Идентификатор приложения на основе модели (uniqueid), из которого удаляются страницы. Взаимоисключаемая с именем --app-name.

--app-name

Уникальное имя приложения на основе модели для удаления страниц. Взаимоисключаемая с --app-id.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--publish

Опубликуйте приложение на основе модели после изменения карты сайта, чтобы изменения сразу же идут в режиме реального времени.

Этот параметр не требует значения. Это переключатель.

--solution

Уникальное имя решения dataverse для обновления карты сайта. По умолчанию установлено значение "По умолчанию".

pac model genpage transpile

Транспилирует файл TypeScript с типами выполнения для тестирования и отладки

Обязательные параметры для model genpage transpile

--code-file

Путь к файлу, содержаму код страницы.

Необязательные параметры для model genpage transpile

--data-sources

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--output-file

Путь к сохранению транспилированных выходных данных JavaScript (по умолчанию — [code-file].compiled.js)

pac model genpage upload

Отправьте созданную страницу в Dataverse и опубликуйте ее. Создает новую страницу при опущении --page-id; обновляет существующую страницу при указании идентификатора --page-id. Чтобы подключить страницу, которая уже существует в среде, к карте сайта другого приложения без повторной отправки, используйте вместо этого "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.

--data-sources

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--model

Модель искусственного интеллекта, используемая для создания страницы (например, 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 Обязательный Description
--app-id Да GUID приложения или отображаемое имя. Запустите pac model list , чтобы найти его.
--code-file Да Путь к исходному файлу .tsx для развертывания.
--name Только новые страницы Отображаемое имя, показанное на карте сайта приложения.
--page-id Только обновления GUID существующей страницы для замены.
--data-sources Страницы с данными Разделенный запятыми список логических имен таблицы 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 или абсолютным URL-адресом 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 или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac model list-tables

Перечислите таблицы Dataverse в связанной среде.

Необязательные параметры для model list-tables

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--search -s

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

--type -t

Фильтруйте по типу таблицы: «пользовательский», «стандартный» или «все» (по умолчанию: все).

См. также

Microsoft Power Platform группы команд CLI
Обзор Microsoft Power Platform CLI

  • Last updated on