Partager via


pac model

(Préversion) Commandes permettant d’utiliser des applications basées sur des modèles.

Commands

Command Descriptif
pac model genpage download (Préversion) Extraire des pages générées à partir d’une application basée sur un modèle.
pac model genpage generate-types (Préversion) Génère des définitions de schéma TypeScript pour les sources de données
pac model genpage list (Préversion) Répertorie toutes les pages générées dans l’application pilotée par modèle spécifiée.
pac model genpage transpile (Préversion) Transpile un fichier TypeScript avec des types d’exécution pour le test et le débogage
pac model genpage upload (Préversion) Chargez et publiez une page générée sur une application basée sur un modèle.
pac model list (Préversion) Répertorie toutes les applications basées sur des modèles dans l’environnement.
pac model list-languages (Préversion) Répertorie les langues activées dans l’environnement Dataverse.

pac model genpage download

(Préversion) Extraire des pages générées à partir d’une application basée sur un modèle.

Paramètres requis pour model genpage download

--app-id

ID de l’application pilotée par modèle.

Paramètres facultatifs pour model genpage download

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--output-directory -o

Répertoire pour enregistrer les pages extraites. La valeur par défaut est le répertoire actif.

--page-id

Liste séparée par des virgules d’ID de page à extraire.

Exemples

Téléchargez une page générative unique par son ID de page dans un dossier local pour modification :

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

Téléchargez toutes les pages dégénératives dans une application en même temps :

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

La commande crée un sous-répertoire nommé après l’ID de page et écrit les fichiers suivants :

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

(Préversion) Génère des définitions de schéma TypeScript pour les sources de données

Paramètres requis pour model genpage generate-types

--data-sources

Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).

Paramètres facultatifs pour model genpage generate-types

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--output-file -o

Chemin d’accès pour enregistrer le fichier de schéma TypeScript généré (valeur par défaut RuntimeTypes.ts)

Exemples

Générez des types TypeScript pour les account tables et contact écrivez-les dans ./src/RuntimeTypes.ts:

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

Générez des types pour une table unique dans un répertoire de sortie spécifique :

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

Note

Exécutez generate-types toujours avant d’écrire du code de page qui interroge les tables Dataverse. Le fichier généré contient des noms de colonnes fortement typés, des champs de clé étrangère et des valeurs d’énumération pour chaque table. L’utilisation des types générés empêche les erreurs d’exécution provoquées par des noms de colonnes mal orthographiés ou inexistants.

pac model genpage list

(Préversion) Répertorie toutes les pages générées dans l’application pilotée par modèle spécifiée.

Paramètres requis pour model genpage list

--app-id

ID de l’application pilotée par modèle.

Paramètres facultatifs pour model genpage list

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Exemples

Répertoriez toutes les pages génératives de l’application Contoso Sales Hub à l’aide de son ID d’application :

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

Répertoriez les pages génératives par nom d’application (l’interface CLI recherche automatiquement l’ID d’application) :

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

Exemple de sortie :

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

(Préversion) Transpile un fichier TypeScript avec des types d’exécution pour le test et le débogage

Paramètres requis pour model genpage transpile

--code-file

Chemin d’accès au fichier contenant le code de page.

Paramètres facultatifs pour model genpage transpile

--data-sources

Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--output-file

Chemin d’accès pour enregistrer la sortie JavaScript transpilée (valeur par défaut pour [code-file].compiled.js)

pac model genpage upload

(Préversion) Chargez et publiez une page générée sur une application basée sur un modèle.

Paramètres requis pour model genpage upload

--app-id

ID de l’application pilotée par modèle.

--code-file

Chemin d’accès au fichier contenant le code de page.

Paramètres facultatifs pour model genpage upload

--add-to-sitemap

Ajoutez la page à la navigation de l’application.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--agent-message

Message de réponse de l’agent.

--agent-message-file

Chemin d’accès à un fichier contenant le message de réponse de l’agent.

--compiled-code-file

Chemin d’accès au fichier contenant le code JavaScript compilé. S’il n’est pas fourni, TypeScript est automatiquement transpilé en JavaScript.

--data-sources

Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--model

Modèle IA utilisé pour générer la page (par exemple, « claude-3-5-sonnet-20241022 »).

--name -n

Nom de la page.

--page-id

ID de la page à mettre à jour. S’il n’est pas fourni, une nouvelle page est créée.

--prompt

Invite de l’utilisateur qui a généré cette page.

--prompt-file

Chemin d’accès à un fichier contenant l’invite utilisateur qui a généré cette page.

Exemples

Publiez une nouvelle page générative sur l’application Contoso Sales Hub et ajoutez-la à l’application :

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

Mettez à jour une page générative existante en fournissant son ID de page (omettez --add-to-sitemap pour éviter de créer une entrée de plan dupliquée) :

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

Publiez une page qui utilise des données fictives (aucune table Dataverse — omettre --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

Conseil / Astuce

Le --app-id paramètre accepte le GUID de l’application ou son nom complet. Si plusieurs applications partagent le même nom d’affichage, utilisez le GUID pour éviter toute ambiguïté. Exécutez pac model list pour rechercher des ID d’application.

Informations de référence rapides sur les paramètres

Paramètre Obligatoire Descriptif
--app-id Oui GUID de l’application ou nom complet. Exécutez-la pac model list pour la trouver.
--code-file Oui Chemin d’accès au .tsx fichier source à déployer.
--name Nouvelles pages uniquement Nom complet affiché dans le plan de l’application.
--page-id Mises à jour uniquement GUID de la page existante à remplacer.
--data-sources Pages Dataverse Liste séparée par des virgules des noms logiques de table Dataverse (par exemple "account,contact").
--prompt Recommandé Résumé du langage naturel de ce que fait la page. Stocké pour le contexte de régénération.
--model Recommandé ID de modèle utilisé pour générer la page (par exemple claude-sonnet-4-6).
--agent-message Recommandé Description de ce qui a été généré ou modifié. Stocké en tant qu’historique des modifications.
--add-to-sitemap Nouvelles pages uniquement Ajoute automatiquement la page à la navigation de l’application. Omettez-le lors de la mise à jour.

pac model list

(Préversion) Répertorie toutes les applications basées sur des modèles dans l’environnement.

Paramètres facultatifs pour model list

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Exemples

Répertoriez toutes les applications basées sur des modèles dans l’environnement actuellement actif :

pac model list

Exemple de sortie :

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

(Préversion) Répertorie les langues activées dans l’environnement Dataverse.

Paramètres facultatifs pour model list-languages

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI