Compartir a través de

pac model

(Versión preliminar) Comandos para trabajar con aplicaciones controladas por modelos.

Commands

Command Description
pac model create (Versión preliminar) Crea una nueva aplicación controlada por modelos.
pac model genpage download (Versión preliminar) Extraiga páginas generadas desde una aplicación controlada por modelos.
pac model genpage generate-types (Versión preliminar) Genera definiciones de esquema de TypeScript para orígenes de datos
pac model genpage list (Versión preliminar) Enumera todas las páginas generadas en la aplicación controlada por modelos especificada.
pac model genpage transpile (Versión preliminar) Transpila un archivo TypeScript con tipos en tiempo de ejecución para probar y depurar
pac model genpage upload (Versión preliminar) Cargue y publique una página generada en una aplicación controlada por modelos.
pac model list (Versión preliminar) Enumera todas las aplicaciones controladas por modelos en el entorno.
pac model list-languages (Versión preliminar) Enumera los idiomas habilitados en el entorno de Dataverse.

pac model create

(Versión preliminar) Crea una nueva aplicación controlada por 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

Sugerencia

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

(Versión preliminar) Extraiga páginas generadas desde una aplicación controlada por 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

(Versión preliminar) Genera definiciones de esquema de TypeScript para orígenes 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

Nota:

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

(Versión preliminar) Enumera todas las páginas generadas en la aplicación controlada por 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

(Versión preliminar) Transpila un archivo TypeScript con tipos en tiempo de ejecución para probar y depurar

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

(Versión preliminar) Cargue y publique una página generada en una aplicación controlada por 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

Sugerencia

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

Parámetro Obligatorio Description
--app-id Sí GUID de la aplicación o nombre para mostrar. Ejecute pac model list para encontrarlo.
--code-file Sí 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 Solo actualizaciones GUID de la página existente que se va a reemplazar.
--data-sources Páginas de Dataverse Lista separada por comas de nombres lógicos de tabla de Dataverse (por ejemplo, "account,contact").
--prompt Recomendado Resumen del lenguaje natural de lo que hace la página. Se almacena para el contexto de regeneración.
--model Recomendado Id. de modelo usado para generar la página (por ejemplo, claude-sonnet-4-6).
--agent-message Recomendado 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

(Versión preliminar) Enumera todas las aplicaciones controladas por 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

Resultados del ejemplo:

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

(Versión preliminar) Enumera los idiomas habilitados en el entorno de 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.

Consulte también

Grupos de comandos de Microsoft Power Platform CLI
Microsoft Power PlatformVisión general del CLI

  • Last updated on