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-unpublish to also list draft pages.
pac model genpage remove 从模型驱动应用的站点地图中分离现有的生成 AI 页面。 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。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--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 验证应用是否已创建并检索其应用 ID，以用于其他命令，例如 pac model genpage upload。

pac model genpage add

将一个或多个现有生成页面附加到模型驱动应用的站点地图（无重新上传）。 使用“”pac model genpage upload创建或更新页面本身;使用此谓词使已上传的页面显示在另一个应用中。

所需的参数 model genpage add

--page-id

要添加到应用的逗号分隔生成页 ID（GUID）。

可选参数 model genpage add

--app-id

模型驱动应用的 ID（GUID）。 与 --app-name 互斥。

--app-name

模型驱动应用的唯一名称。 与 --app-id 互斥。

--area

站点地图中用于放置页面的可选区域 ID。 默认为第一个区域。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--group

站点地图中用于放置页面的可选组 ID。 默认为所选区域的第一组。

--language-code

SubArea 标题的语言代码 （LCID）。 默认值为 1033（en-US）。

--publish

添加页面后发布模型驱动应用。

此参数不需要任何值。 这是一个开关。

--solution

Sitemap 更新的 Dataverse 解决方案上下文的唯一名称。 默认为 'Default'。

pac model genpage download

从模型驱动的应用中拉取生成的页面。

所需的参数 model genpage download

--app-id

模型驱动应用的 ID。

可选参数 model genpage download

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--output-directory -o

用于保存拉取页的目录。 默认为当前目录。

--page-id

要拉取的页面 ID 的逗号分隔列表。

pac model genpage download 示例

以下示例演示了使用命令的 pac model genpage download 常见方法。

将单个生成页面的页 ID 下载到本地文件夹进行编辑

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

创建以页面 ID 命名的子目录，并写入以下文件

./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。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--output-file -o

保存生成的 TypeScript 架构文件的路径（默认为RuntimeTypes.ts）

pac model genpage generate-types 示例

以下示例演示了使用命令的 pac model genpage generate-types 常见方法。

生成 TypeScript 类型

为 account 表 contact 生成 TypeScript 类型并将其写入 ./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

注释

始终在编写查询 Dataverse 表的页面代码之前运行 generate-types 。 生成的文件包含每个表的强类型列名、外键字段和枚举值。 依赖生成的类型可防止因拼写错误或不存在的列名而导致的运行时错误。

pac model genpage list

列出生成的页面 - 默认情况下为 env-wide，或者在提供 --app-id 时为一个应用列出。 传递 --include-unpublish to also list draft pages.

可选参数 model genpage list

--app-id

模型驱动应用的 ID。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--include-unpublished

在列表中包括未发布的生成页面（默认值：仅已发布）。

此参数不需要任何值。 这是一个开关。

pac model genpage list 示例

以下示例演示了使用命令的 pac model genpage list 常见方法。

使用应用 ID 列出页面

使用 Contoso Sales Hub 应用中的应用 ID 列出所有生成页面：

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

使用应用名称列出页面

按应用名称列出生成页面（CLI 自动查找应用 ID）：

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

从模型驱动应用的站点地图中分离现有的生成 AI 页面。 Dataverse 中的页面行会保留（它可能仍可从其他应用引用）。

所需的参数 model genpage remove

--page-id

要删除的一个或多个 uxagentproject ID（逗号分隔）。

可选参数 model genpage remove

--app-id

要从中删除页面的模型驱动应用 ID （uniqueid）。 与 --app-name 互斥。

--app-name

要从中删除页面的模型驱动应用唯一名称。 与 --app-id 互斥。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--publish

在站点地图编辑后发布模型驱动应用，以便更改立即上线。

此参数不需要任何值。 这是一个开关。

--solution

Sitemap 更新的 Dataverse 解决方案唯一名称。 默认为 'Default'。

pac model genpage transpile

将带有运行时类型用于测试和调试的 TypeScript 文件进行转译

所需的参数 model genpage transpile

--code-file

包含页面代码的文件的路径。

可选参数 model genpage transpile

--data-sources

使用的数据源（例如“account，lead，contact”）的逗号分隔列表。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

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

模型驱动应用的 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。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--model

用于生成页面（例如“claude-3-5-sonnet-20241022”）的 AI 模型。

--name -n

页的名称。

--page-id

要更新的页面的 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

更新现有生成页面

通过提供其页面 ID 来更新现有生成页面（省略 --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 以查找应用 ID。

pac model genpage upload 参数快速参考

参数 必需 Description
--app-id 是的 应用 GUID 或显示名称。 运行 pac model list 以查找它。
--code-file 是的 要部署的 .tsx 源文件的路径。
--name 仅新页面 应用站点地图中显示的显示名称。
--page-id 仅更新 要替换的现有页面的 GUID。
--data-sources Dataverse 页面 Dataverse 表逻辑名称（例如， "account,contact"）逗号分隔的列表。
--prompt Recommended 页面功能的自然语言摘要。 存储用于重新生成上下文。
--model Recommended 用于生成页面（例如， claude-sonnet-4-6）的模型 ID。
--agent-message Recommended 生成或更改的内容的说明。 存储为更改历史记录。
--add-to-sitemap 仅新页面 自动将页面添加到应用导航。 更新时省略。

pac model list

列出环境中所有模型驱动应用。

可选参数 model list

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

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。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

pac model list-tables

在连接环境中列出Dataverse表。

可选参数 model list-tables

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定，将使用为当前身份验证配置文件选择的活动组织。

--search -s

搜索名称列表，逗号分隔（匹配逻辑名称、模式名称或显示名称）。

--type -t

按表类型筛选：“自定义”、“标准”或“全部”（默认：全部）。

另见

Microsoft Power Platform CLI 命令组
Microsoft Power Platform CLI 概述

  • Last updated on