pac model

（预览版）用于处理模型驱动应用的命令。

指令

Command	Description
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 genpage download

（预览版）从模型驱动应用拉取生成的页面。

所需的参数 model genpage download

`--app-id`

模型驱动应用的 ID。

可选参数 model genpage download

`--environment` `-env`

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

`--output-directory` `-o`

`--page-id`

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

示例

将单个生成页面的页 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）

示例

为 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

（预览版）列出指定模型驱动应用中生成的所有页面。

所需的参数 model genpage list

`--app-id`

模型驱动应用的 ID。

可选参数 model genpage list

`--environment` `-env`

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

示例

使用 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"

示例输出：

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`

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

`--environment` `-env`

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

`--output-file`

保存转换的 JavaScript 输出的路径（默认为 [code-file].compiled.js）

pac model genpage upload

（预览版）将生成的页面上传到模型驱动应用并发布。

所需的参数 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`

包含生成此页面的用户提示的文件的路径。

示例

将新的生成页面发布到 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

小窍门

该 --app-id 参数接受应用的 GUID 或其显示名称。如果多个应用共享相同的显示名称，请使用 GUID 以避免歧义。运行 pac model list 以查找应用 ID。

参数快速参考

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

pac model list

（预览版）列出环境中的所有模型驱动应用。

可选参数 model list

`--environment` `-env`

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

示例

列出当前活动环境中的所有模型驱动应用：

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。如果未指定，将使用为当前身份验证配置文件选择的活动组织。

另请参阅

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

反馈

此页面是否有帮助？

Last updated on 2026-03-21

通过

pac model

指令

pac model genpage download

所需的参数 model genpage download

--app-id

可选参数 model genpage download

--environment -env

--output-directory -o

--page-id

示例

pac model genpage generate-types

所需的参数 model genpage generate-types

--data-sources

可选参数 model genpage generate-types

--environment -env

--output-file -o

示例

pac model genpage list

所需的参数 model genpage list

--app-id

可选参数 model genpage list

--environment -env

示例

pac model genpage transpile

所需的参数 model genpage transpile

--code-file

可选参数 model genpage transpile

--data-sources

--environment -env

--output-file

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

--data-sources

--environment -env

--model

--name -n

--page-id

--prompt

--prompt-file

示例

参数快速参考

pac model list

可选参数 model list

--environment -env

示例

pac model list-languages

可选参数 model list-languages

--environment -env

另请参阅

反馈

其他资源

`--app-id`

`--environment` `-env`

`--output-directory` `-o`

`--page-id`

`--data-sources`

`--environment` `-env`

`--output-file` `-o`

`--app-id`

`--environment` `-env`

`--code-file`

`--data-sources`

`--environment` `-env`

`--output-file`

`--app-id`

`--code-file`

`--add-to-sitemap`

`--agent-message`

`--agent-message-file`

`--compiled-code-file`

`--data-sources`

`--environment` `-env`

`--model`

`--name` `-n`

`--page-id`

`--prompt`

`--prompt-file`

`--environment` `-env`

`--environment` `-env`