Compartir vía

pac model

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

Commands

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

Descargue 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

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

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

El comando crea un subdirectorio denominado después del identificador de página y escribe los archivos siguientes:

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

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

Genere 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

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

Resultados del ejemplo:

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

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

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

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.

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.

Ejemplos

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