pac model

Comandos para trabajar con aplicaciones basadas en modelos.

Commands

Command Description
pac model create Crea una nueva aplicación basada en modelos.
pac model genpage download Extrae páginas generadas de una aplicación basada en modelos.
pac model genpage generate-types Genera definiciones de esquema TypeScript para fuentes de datos
pac model genpage list Lista todas las páginas generadas en la aplicación basada en modelos especificada.
pac model genpage transpile Transpila un archivo TypeScript con tipos de ejecución para pruebas y depuración
pac model genpage upload Sube y publica una página generada en una aplicación basada en modelos.
pac model list Lista todas las aplicaciones orientadas a modelos en el entorno.
pac model list-languages Listas habilitadas en lenguajes en el entorno Dataverse.
pac model list-tables Lista las tablas de Dataverse en el entorno conectado.

pac model create

Crea una nueva aplicación basada en modelos.

Parámetros necesarios para model create

--name -n

Nombre para mostrar de la nueva aplicación controlada por modelos.

Parámetros opcionales para model create

--description -d

Descripción de la nueva aplicación controlada por modelos.

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--publish

Publique la aplicación después de la creación.

Este parámetro no requiere ningún valor. Es un modificador.

--solution

Nombre único de la solución al que agregar la aplicación. El valor predeterminado es la solución activa.

ejemplos de pac model create

En los ejemplos siguientes se muestran formas comunes de usar el pac model create comando .

Creación de una nueva aplicación controlada por modelos en el entorno activo

pac model create --name "Contoso Sales Hub"

Cree una aplicación con una descripción y agréguela a una solución y, a continuación, publíquela inmediatamente.

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

Creación de una aplicación en un entorno específico proporcionando la dirección URL del entorno

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

Use pac model list para comprobar que la aplicación se creó y recuperar su identificador de aplicación para usarlo con otros comandos, como pac model genpage upload.

pac model genpage download

Extrae páginas generadas de una aplicación basada en modelos.

Parámetros necesarios para model genpage download

--app-id

Identificador de la aplicación controlada por modelos.

Parámetros opcionales para model genpage download

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--output-directory -o

Directorio para guardar páginas extraídas. El valor predeterminado es el directorio actual.

--page-id

Lista separada por comas de identificadores de página que se van a extraer.

ejemplos de pac model genpage download

En los ejemplos siguientes se muestran formas comunes de usar el pac model genpage download comando .

Descargar una sola página generativa por su identificador de página en una carpeta local para su edición

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

Descargar todas las páginas generativas de una aplicación a la vez

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

Cree un subdirectorio denominado después del identificador de página y escriba los siguientes archivos.

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

Genera definiciones de esquema TypeScript para fuentes de datos

Parámetros necesarios para model genpage generate-types

--data-sources

Lista separada por comas de orígenes de datos usados (por ejemplo, "cuenta, cliente potencial, contacto").

Parámetros opcionales para model genpage generate-types

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--output-file -o

Ruta de acceso para guardar el archivo de esquema typeScript generado (el valor predeterminado es RuntimeTypes.ts)

ejemplos de pac model genpage generate-types

En los ejemplos siguientes se muestran formas comunes de usar el pac model genpage generate-types comando .

Generación de tipos TypeScript

Genere tipos typeScript para las account tablas y contact y escríbalos en ./src/RuntimeTypes.ts:

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

Generación de tipos para una sola tabla en un directorio de salida específico

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

Note

generate-types Ejecute siempre antes de escribir código de página que consulta las tablas de Dataverse. El archivo generado contiene nombres de columna fuertemente tipados, campos de clave externa y valores de enumeración para cada tabla. Confiar en los tipos generados evita errores en tiempo de ejecución causados por nombres de columna mal escritos o inexistentes.

pac model genpage list

Lista todas las páginas generadas en la aplicación basada en modelos especificada.

Parámetros necesarios para model genpage list

--app-id

Identificador de la aplicación controlada por modelos.

Parámetros opcionales para model genpage list

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

ejemplos de pac model genpage list

En los ejemplos siguientes se muestran formas comunes de usar el pac model genpage list comando .

Enumerar páginas mediante el identificador de aplicación

Enumere todas las páginas generativas de la aplicación Contoso Sales Hub con su identificador de aplicación:

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

Enumerar páginas con el nombre de la aplicación

Enumerar páginas generativas por nombre de aplicación (la CLI busca automáticamente el identificador de aplicación):

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

pac model Salida de ejemplo 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

Transpila un archivo TypeScript con tipos de ejecución para pruebas y depuración

Parámetros necesarios para model genpage transpile

--code-file

Ruta de acceso al archivo que contiene el código de página.

Parámetros opcionales para model genpage transpile

--data-sources

Lista separada por comas de orígenes de datos usados (por ejemplo, "cuenta, cliente potencial, contacto").

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--output-file

Ruta de acceso para guardar la salida de JavaScript transpilada (el valor predeterminado es [code-file].compiled.js)

pac model genpage upload

Sube y publica una página generada en una aplicación basada en modelos.

Parámetros necesarios para model genpage upload

--app-id

Identificador de la aplicación controlada por modelos.

--code-file

Ruta de acceso al archivo que contiene el código de página.

Parámetros opcionales para model genpage upload

--add-to-sitemap

Agregue la página a la navegación del mapa del sitio de la aplicación.

Este parámetro no requiere ningún valor. Es un modificador.

--agent-message

Mensaje de respuesta del agente.

--agent-message-file

Ruta de acceso a un archivo que contiene el mensaje de respuesta del agente.

--compiled-code-file

Ruta de acceso al archivo que contiene el código JavaScript compilado. Si no se proporciona, TypeScript se transpilará automáticamente a JavaScript.

--data-sources

Lista separada por comas de orígenes de datos usados (por ejemplo, "cuenta, cliente potencial, contacto").

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--model

El modelo de IA usado para generar la página (por ejemplo, "claude-3-5-sonnet-20241022").

--name -n

Nombre de la página.

--page-id

Identificador de la página que se va a actualizar. Si no se proporciona, se creará una nueva página.

--prompt

Mensaje de usuario que generó esta página.

--prompt-file

Ruta de acceso a un archivo que contiene el mensaje del usuario que generó esta página.

ejemplos de pac model genpage upload

En los ejemplos siguientes se muestran formas comunes de usar el pac model genpage upload comando .

Publicar una nueva página generativa

Publique una nueva página generativa en la aplicación Contoso Sales Hub y agréguela al mapa del sitio de la aplicación:

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

Actualización de una página generativa existente

Actualice una página generativa existente proporcionando su identificador de página (omitir --add-to-sitemap para evitar crear una entrada duplicada del mapa del sitio):

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

Publicación de una página que usa datos ficticios

Publique una página que use datos ficticios (sin tablas de 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

Tip

El --app-id parámetro acepta el GUID de la aplicación o su nombre para mostrar. Si varias aplicaciones comparten el mismo nombre para mostrar, use el GUID para evitar ambigüedad. Ejecute pac model list para buscar identificadores de aplicación.

pac model genpage upload referencia rápida de parámetros

Parameter Required Description
--app-id Yes GUID de la aplicación o nombre para mostrar. Ejecute pac model list para encontrarlo.
--code-file Yes Ruta de acceso al .tsx archivo de origen que se va a implementar.
--name Solo páginas nuevas Nombre para mostrar que se muestra en el mapa del sitio de la aplicación.
--page-id Updates only GUID de la página existente que se va a reemplazar.
--data-sources Dataverse pages Lista separada por comas de nombres lógicos de tabla de Dataverse (por ejemplo, "account,contact").
--prompt Recommended Resumen del lenguaje natural de lo que hace la página. Se almacena para el contexto de regeneración.
--model Recommended Id. de modelo usado para generar la página (por ejemplo, claude-sonnet-4-6).
--agent-message Recommended Descripción de lo que se creó o cambió. Almacenado como historial de cambios.
--add-to-sitemap Solo páginas nuevas Agrega la página a la navegación de la aplicación automáticamente. Omita al actualizar.

pac model list

Lista todas las aplicaciones orientadas a modelos en el entorno.

Parámetros opcionales para model list

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

Ejemplo de pac model list

Enumere todas las aplicaciones controladas por modelos en el entorno activo actualmente:

pac model list

Sample output:

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

Listas habilitadas en lenguajes en el entorno Dataverse.

Parámetros opcionales para model list-languages

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

pac model list-tables

Lista las tablas de Dataverse en el entorno conectado.

Parámetros opcionales para model list-tables

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--search -s

Lista de nombres separados por comas a buscar (coincide con el nombre lógico, el nombre del esquema o el nombre de visualización).

--type -t

Filtra por tipo de tabla: 'personalizado', 'estándar' o 'todos' (por defecto: todos).

See also

Grupos de comandos de la CLI de Microsoft Power Platform
Visión general del CLI de Microsoft Power Platform

  • Last updated on