Compartilhar via

pac model

(Versão prévia) Comandos para trabalhar com aplicativos controlados por modelos.

Commands

Command Description
pac model create (Versão prévia) Cria um novo aplicativo controlado por modelos.
pac model genpage download (Versão prévia) Efetuar pull de páginas geradas de um aplicativo controlado por modelos.
pac model genpage generate-types (Versão prévia) Gera definições de esquema TypeScript para fontes de dados
pac model genpage list (Versão prévia) Lista todas as páginas geradas no aplicativo controlado por modelo especificado.
pac model genpage transpile (Versão prévia) Transpila um arquivo TypeScript com tipos de runtime para teste e depuração
pac model genpage upload (Versão prévia) Carregue e publique uma página gerada em um aplicativo controlado por modelos.
pac model list (Versão prévia) Lista todos os aplicativos controlados por modelos no ambiente.
pac model list-languages (Versão prévia) Lista os idiomas habilitados no ambiente do Dataverse.

pac model create

(Versão prévia) Cria um novo aplicativo controlado por modelos.

Parâmetros necessários para model create

--name -n

O nome de exibição do novo aplicativo controlado por modelos.

Parâmetros opcionais para model create

--description -d

Descrição do novo aplicativo controlado por modelos.

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--publish

Publique o aplicativo após a criação.

Esse parâmetro não requer nenhum valor. É um comutador.

--solution

Nome exclusivo da solução à qual adicionar o aplicativo. O padrão é a solução ativa.

pac model create Exemplos

Os exemplos a seguir mostram maneiras comuns de usar o pac model create comando.

Criar um novo aplicativo controlado por modelos no ambiente ativo

pac model create --name "Contoso Sales Hub"

Criar um aplicativo com uma descrição e adicioná-lo a uma solução e, em seguida, publicar imediatamente

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

Criar um aplicativo em um ambiente específico fornecendo a URL do ambiente

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

Dica

Use pac model list para verificar se o aplicativo foi criado e recuperar sua ID do aplicativo para uso com outros comandos, como pac model genpage upload.

pac model genpage download

(Versão prévia) Efetuar pull de páginas geradas de um aplicativo controlado por modelos.

Parâmetros necessários para model genpage download

--app-id

A ID do aplicativo controlado por modelos.

Parâmetros opcionais para model genpage download

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-directory -o

Diretório para salvar páginas extraídas. O padrão é o diretório atual.

--page-id

Lista separada por vírgulas de IDs de página a serem extraídas.

pac model genpage download Exemplos

Os exemplos a seguir mostram maneiras comuns de usar o pac model genpage download comando.

Baixar uma única página de geração por sua ID de página em uma pasta local para edição

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

Baixar todas as páginas generativas em um aplicativo de uma só vez

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

Criar um subdiretório com o nome da ID da página e gravar os arquivos a seguir

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

(Versão prévia) Gera definições de esquema TypeScript para fontes de dados

Parâmetros necessários para model genpage generate-types

--data-sources

Lista separada por vírgulas de fontes de dados usadas (por exemplo, 'conta, cliente potencial, contato').

Parâmetros opcionais para model genpage generate-types

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-file -o

Caminho para salvar o arquivo de esquema TypeScript gerado (padrões para RuntimeTypes.ts)

pac model genpage generate-types Exemplos

Os exemplos a seguir mostram maneiras comuns de usar o pac model genpage generate-types comando.

Gerar tipos typeScript

Gere tipos TypeScript para tabelas account e tabelas contact e escreva-os em ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

Gerar tipos para uma única tabela em um diretório de saída específico

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Observação

Sempre execute generate-types antes de escrever o código da página que consulta tabelas do Dataverse. O arquivo gerado contém nomes de coluna fortemente tipados, campos de chave estrangeira e valores de enumeração para cada tabela. Depender dos tipos gerados impede erros de runtime causados por nomes de coluna incorretos ou inexistentes.

pac model genpage list

(Versão prévia) Lista todas as páginas geradas no aplicativo controlado por modelo especificado.

Parâmetros necessários para model genpage list

--app-id

A ID do aplicativo controlado por modelos.

Parâmetros opcionais para model genpage list

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac model genpage list Exemplos

Os exemplos a seguir mostram maneiras comuns de usar o pac model genpage list comando.

Listar páginas usando a ID do aplicativo

Liste todas as páginas generativas no aplicativo Do Hub de Vendas contoso usando sua ID do aplicativo:

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

Listar páginas usando o nome do aplicativo

Listar páginas generativas pelo nome do aplicativo (a CLI pesquisa a ID do aplicativo automaticamente):

pac model genpage list --app-id "Contoso Sales Hub"

pac model saída de exemplo de 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

(Versão prévia) Transpila um arquivo TypeScript com tipos de runtime para teste e depuração

Parâmetros necessários para model genpage transpile

--code-file

Caminho para o arquivo que contém o código da página.

Parâmetros opcionais para model genpage transpile

--data-sources

Lista separada por vírgulas de fontes de dados usadas (por exemplo, 'conta, cliente potencial, contato').

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-file

Caminho para salvar a saída de JavaScript transpilada (padrões para [arquivo de código].compiled.js)

pac model genpage upload

(Versão prévia) Carregue e publique uma página gerada em um aplicativo controlado por modelos.

Parâmetros necessários para model genpage upload

--app-id

A ID do aplicativo controlado por modelos.

--code-file

Caminho para o arquivo que contém o código da página.

Parâmetros opcionais para model genpage upload

--add-to-sitemap

Adicione a página à navegação do sitemap do aplicativo.

Esse parâmetro não requer nenhum valor. É um comutador.

--agent-message

A mensagem de resposta do agente.

--agent-message-file

Caminho para um arquivo que contém a mensagem de resposta do agente.

--compiled-code-file

Caminho para o arquivo que contém o código JavaScript compilado. Se não for fornecido, o TypeScript será automaticamente transpilado para JavaScript.

--data-sources

Lista separada por vírgulas de fontes de dados usadas (por exemplo, 'conta, cliente potencial, contato').

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--model

O modelo de IA usado para gerar a página (por exemplo, 'claude-3-5-sonnet-20241022').

--name -n

O nome da página.

--page-id

A ID da página a ser atualizada. Se não for fornecido, uma nova página será criada.

--prompt

O prompt do usuário que gerou esta página.

--prompt-file

Caminho para um arquivo que contém o prompt de usuário que gerou esta página.

pac model genpage upload Exemplos

Os exemplos a seguir mostram maneiras comuns de usar o pac model genpage upload comando.

Publicar uma nova página de geração

Publique uma nova página gerativa no aplicativo Do Hub de Vendas contoso e adicione-a ao sitemap do aplicativo:

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

Atualizar uma página de geração existente

Atualize uma página generativa existente fornecendo sua ID de página (omita --add-to-sitemap para evitar a criação de uma entrada de sitemap duplicada):

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

Publicar uma página que usa dados fictícios

Publicar uma página que usa dados fictícios (sem tabelas do Dataverse — omita --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

Dica

O --app-id parâmetro aceita o GUID do aplicativo ou seu nome de exibição. Se vários aplicativos compartilharem o mesmo nome de exibição, use o GUID para evitar ambiguidade. Execute pac model list para pesquisar IDs do aplicativo.

pac model genpage upload referência rápida do parâmetro

Parâmetro Obrigatório Description
--app-id Sim GUID do aplicativo ou nome de exibição. Execute pac model list para encontrá-lo.
--code-file Sim Caminho para o arquivo de origem .tsx a ser implantado.
--name Somente novas páginas Nome de exibição mostrado no mapa do site do aplicativo.
--page-id Somente atualizações GUID da página existente a ser substituída.
--data-sources Páginas do Dataverse Lista separada por vírgulas de nomes lógicos de tabela do Dataverse (por exemplo, "account,contact").
--prompt Recomendado Resumo da linguagem natural do que a página faz. Armazenado para o contexto de regeneração.
--model Recomendado ID do modelo usada para gerar a página (por exemplo, claude-sonnet-4-6).
--agent-message Recomendado Descrição do que foi criado ou alterado. Armazenado como histórico de alterações.
--add-to-sitemap Somente novas páginas Adiciona a página à navegação do aplicativo automaticamente. Omita ao atualizar.

pac model list

(Versão prévia) Lista todos os aplicativos controlados por modelos no ambiente.

Parâmetros opcionais para model list

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac model list exemplo

Liste todos os aplicativos controlados por modelos no ambiente ativo no momento:

pac model list

Saída de exemplo:

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

(Versão prévia) Lista os idiomas habilitados no ambiente do Dataverse.

Parâmetros opcionais para model list-languages

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

  • Last updated on