pac model

Comandes per treballar amb aplicacions basades en models.

Ordres

Ordre Descripció
pac model create Crea una nova aplicació basada en models.
pac model genpage add Adjunta una o més pàgines generatives existents al mapa del lloc d'una aplicació basada en models (sense tornar a pujar). Utilitza 'pac model genpage upload' per crear o actualitzar la pàgina mateixa; utilitza aquest verb per fer que una pàgina ja pujada aparegui en una altra aplicació.
pac model genpage download Extreu les pàgines generades d'una aplicació basada en models.
pac model genpage generate-types Genera definicions d'esquemes TypeScript per a fonts de dades
pac model genpage list Llista pàgines generades — per defecte a tot l'entorn ambiental, o per a una sola aplicació quan s'hi subministra --app-id. Passa --include-unpublished per també llistar pàgines d'esborrany.
pac model genpage remove Desvincula les pàgines existents d'IA generativa del mapa del sitemap d'una aplicació basada en models. La fila de pàgina a Dataverse es conserva (encara pot ser referenciada des d'altres aplicacions).
pac model genpage transpile Transpila un fitxer TypeScript amb tipus d'execució per a proves i depuració
pac model genpage upload Puja una pàgina generada a Dataverse i publica-la. Crea una pàgina nova quan s'omet --page-id; Actualitza la pàgina existent quan es subministra --page-id. Per adjuntar una pàgina que ja existeix a l'entorn al mapa del lloc d'una altra aplicació sense tornar a pujar-la, utilitza 'pac model genpage add' en el seu lloc.
pac model list Llista totes les aplicacions basades en models de l'entorn.
pac model list-languages Llistes habilitades llenguatges a l'entorn Dataverse.
pac model list-tables Llista les taules Dataverse a l'entorn connectat.

pac model create

Crea una nova aplicació basada en models.

Paràmetres requerits per a model create

--name -n

El nom de visualització de la nova aplicació basada en models.

Paràmetres opcionals per a model create

--description -d

Descripció de la nova aplicació basada en models.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--publish

Publica l'aplicació després de crear-la.

Aquest paràmetre no requereix cap valor. És un canvi.

--solution

Solució amb nom únic per afegir l'aplicació. Per defecte es posa a 'Default' si no s'especifica.

pac model create Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model create ordre.

Crea una nova aplicació basada en models en l'entorn actiu

pac model create --name "Contoso Sales Hub"

Crea una aplicació amb una descripció i afegeix-la a una solució, després publica-la immediatament

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

Crea una aplicació en un entorn específic proporcionant l'URL de l'entorn

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

Propina

Utilitza pac model list per verificar que l'aplicació ha estat creada i recuperar el seu ID d'aplicació per utilitzar-lo amb altres comandes com pac model genpage upload.

pac model genpage add

Adjunta una o més pàgines generatives existents al mapa del lloc d'una aplicació basada en models (sense tornar a pujar). Utilitza 'pac model genpage upload' per crear o actualitzar la pàgina mateixa; utilitza aquest verb per fer que una pàgina ja pujada aparegui en una altra aplicació.

Paràmetres requerits per a model genpage add

--page-id

IDs generatius de pàgina separats per comes (GUIDs) per afegir a l'aplicació.

Paràmetres opcionals per a model genpage add

--app-id

L'ID (GUID) de l'aplicació basada en models. Són mútuament excloents amb --app-name.

--app-name

El nom únic de l'aplicació basada en models. Són mútuament excloents amb --app-id.

--area

ID d'àrea opcional al mapa del lloc per col·locar la pàgina a sota. Per defecte es posa a la primera Àrea.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--group

ID de grup opcional al mapa del lloc per col·locar la pàgina a sota. Per defecte, el primer grup de l'Àrea escollida.

--language-code

Codi d'idioma (LCID) per al títol SubArea. Per defecte és 1033 (en-US).

--publish

Publica l'aplicació basada en models després d'afegir la(s) pàgina(s).

Aquest paràmetre no requereix cap valor. És un canvi.

--solution

Nom únic del context de la solució Dataverse per a l'actualització del mapa del lloc. Per defecte es posa a 'Default'.

pac model genpage download

Extreu les pàgines generades d'una aplicació basada en models.

Paràmetres requerits per a model genpage download

--app-id

L'ID de l'aplicació basada en models.

Paràmetres opcionals per a model genpage download

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-directory -o

Directori per desar pàgines extretes. Per defecte el directori actual.

--page-id

Llista separada per coma d'identificadors de pàgina per extreure.

pac model genpage download Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage download ordre.

Descarrega una sola pàgina generativa amb el seu ID de pàgina a una carpeta local per editar-la

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

Descarrega totes les pàgines generatives d'una aplicació alhora

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

Crea un subdirectori anomenat segons l'ID de pàgina i escriu els fitxers següents

./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 definicions d'esquemes TypeScript per a fonts de dades

Paràmetres requerits per a model genpage generate-types

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

Paràmetres opcionals per a model genpage generate-types

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-file -o

Ruta per desar el fitxer d'esquema TypeScript generat (per defecte a RuntimeTypes.ts)

pac model genpage generate-types Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage generate-types ordre.

Genera tipus TypeScript

Genera tipus TypeScript per a les account taules i contact escriu-los a ./src/RuntimeTypes.ts:

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

Genera tipus per a una sola taula en un directori de sortida específic

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

Nota

Sempre executa generate-types abans d'escriure codi de pàgina que consulti taules de Dataverse. El fitxer generat conté noms de columna fortament tipats, camps de clau foranya i valors d'enum per a cada taula. Confiar en els tipus generats evita errors en temps d'execució causats per noms de columna mal escrits o inexistents.

pac model genpage list

Llista pàgines generades — per defecte a tot l'entorn ambiental, o per a una sola aplicació quan s'hi subministra --app-id. Passa --include-unpublished per també llistar pàgines d'esborrany.

Paràmetres opcionals per a model genpage list

--app-id

L'ID de l'aplicació basada en models.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--include-unpublished

Inclou pàgines generatives no publicades a la llista (per defecte: només publicades).

Aquest paràmetre no requereix cap valor. És un canvi.

pac model genpage list Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage list ordre.

Pàgines de llista que utilitzen l'ID de l'aplicació

Llista totes les pàgines generatives de l'aplicació Contoso Sales Hub utilitzant el seu ID d'aplicació:

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

Pàgines de llista que utilitzen el nom de l'aplicació

Llista les pàgines generatives pel nom de l'aplicació (la CLI busca automàticament l'ID de l'aplicació):

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

pac model Sortida d'exemple 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 remove

Desvincula les pàgines existents d'IA generativa del mapa del sitemap d'una aplicació basada en models. La fila de pàgina a Dataverse es conserva (encara pot ser referenciada des d'altres aplicacions).

Paràmetres requerits per a model genpage remove

--page-id

Un o més IDs d'uxagentproject per eliminar (coma separades).

Paràmetres opcionals per a model genpage remove

--app-id

Id d'aplicació basat en model (uniqueid) per eliminar la(s) pàgina(s). Són mútuament excloents amb --app-name.

--app-name

Nom únic d'aplicació basada en models per eliminar la(s) pàgina(s). Són mútuament excloents amb --app-id.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--publish

Publica l'aplicació basada en models després de l'edició del mapa del lloc perquè els canvis estiguin actius immediatament.

Aquest paràmetre no requereix cap valor. És un canvi.

--solution

Solució de Dataverse, nom únic per a l'actualització del mapa del lloc. Per defecte es posa a 'Default'.

pac model genpage transpile

Transpila un fitxer TypeScript amb tipus d'execució per a proves i depuració

Paràmetres requerits per a model genpage transpile

--code-file

Ruta cap al fitxer que conté el codi de la pàgina.

Paràmetres opcionals per a model genpage transpile

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-file

Camí per desar la sortida JavaScript transpilada (per defecte [code-file].compiled.js)

pac model genpage upload

Puja una pàgina generada a Dataverse i publica-la. Crea una pàgina nova quan s'omet --page-id; Actualitza la pàgina existent quan es subministra --page-id. Per adjuntar una pàgina que ja existeix a l'entorn al mapa del lloc d'una altra aplicació sense tornar a pujar-la, utilitza 'pac model genpage add' en el seu lloc.

Paràmetres requerits per a model genpage upload

--app-id

L'ID de l'aplicació basada en models.

--code-file

Ruta cap al fitxer que conté el codi de la pàgina.

Paràmetres opcionals per a model genpage upload

--add-to-sitemap

Afegeix la pàgina a la navegació del mapa del lloc de l'aplicació.

Aquest paràmetre no requereix cap valor. És un canvi.

--agent-message

El missatge de resposta de l'agent.

--agent-message-file

Ruta cap a un fitxer que conté el missatge de resposta de l'agent.

--compiled-code-file

Camí cap al fitxer que conté el codi JavaScript compilat. Si no es proporciona, TypeScript es transpilarà automàticament a JavaScript.

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--model

El model d'IA utilitzat per generar la pàgina (per exemple, 'claude-3-5-sonnet-20241022').

--name -n

El nom de la pàgina.

--page-id

L'ID de la pàgina a actualitzar. Si no es proporciona, es crearà una nova pàgina.

--prompt

L'indicació d'usuari que va generar aquesta pàgina.

--prompt-file

Ruta cap a un fitxer que conté el prompt d'usuari que ha generat aquesta pàgina.

pac model genpage upload Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage upload ordre.

Publica una nova pàgina generativa

Publica una nova pàgina generativa a l'aplicació Contoso Sales Hub i afegeix-la al mapa del lloc de l'aplicació:

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

Actualitza una pàgina generativa existent

Actualitza una pàgina generativa existent proporcionant el seu ID de pàgina (ometent --add-to-sitemap per evitar crear una entrada duplicada del mapa del lloc):

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 una pàgina que utilitzi dades simulades

Publicar una pàgina que utilitzi dades simulades (sense taules Dataverse — omet-ho --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

Propina

El --app-id paràmetre accepta tant el GUID de l'aplicació com el seu nom de visualització. Si diverses aplicacions comparteixen el mateix nom de visualització, utilitza el GUID per evitar ambigüitats. Corre pac model list a buscar els ID de les aplicacions.

pac model genpage upload Referència ràpida de paràmetres

Paràmetre Necessari Descripció
--app-id Sí GUID de l'aplicació o nom de visualització. Corre pac model list a buscar-lo.
--code-file Sí Ruta cap al .tsx fitxer font per desplegar.
--name Només pàgines noves Nom de visualització mostrat al mapa del lloc de l'aplicació.
--page-id Només actualitzacions GUID de la pàgina existent per substituir.
--data-sources Pàgines del Dataverse Llista separada per coma dels noms lògics de les taules Dataverse (per exemple, "account,contact").
--prompt Recomanat Resum en llenguatge natural del que fa la pàgina. Emmagatzemat per al context de regeneració.
--model Recomanat ID de model utilitzat per generar la pàgina (per exemple, claude-sonnet-4-6).
--agent-message Recomanat Descripció del que es va construir o canviar. Emmagatzemat com a historial de canvis.
--add-to-sitemap Només pàgines noves Afegeix la pàgina automàticament a la navegació de l'aplicació. Omet-ho quan actualitzis.

pac model list

Llista totes les aplicacions basades en models de l'entorn.

Paràmetres opcionals per a model list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac model list Exemple

Llista totes les aplicacions basades en models en l'entorn actiu actualment:

pac model list

Exemple de sortida:

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

Llistes habilitades llenguatges a l'entorn Dataverse.

Paràmetres opcionals per a model list-languages

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac model list-tables

Llista les taules Dataverse a l'entorn connectat.

Paràmetres opcionals per a model list-tables

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--search -s

Llista separada per coma de noms a buscar (coincideix amb el nom lògic, el nom de l'esquema o el nom de visualització).

--type -t

Filtra per tipus de taula: 'personalitzat', 'estàndard' o 'tots' (per defecte: tots).

Consulteu també

Microsoft Power Platform Grups de Comandament CLI
Microsoft Power Platform Visió general de la CLI

  • Last updated on