pac model

Befehle zum Arbeiten mit modellgetriebenen Apps.

Commands

Befehl Beschreibung
pac model create Erstellt eine neue modellgetriebene App.
pac model genpage add Fügen Sie eine oder mehrere vorhandene generative Seiten an die Sitemap einer modellgesteuerten App an (kein erneutes Hochladen). Verwenden Sie "pac model genpage upload" zum Erstellen oder Aktualisieren der Seite selbst. Verwenden Sie dieses Verb, um eine bereits hochgeladene Seite in einer anderen App anzuzeigen.
pac model genpage download Ziehe generierte Seiten aus einer modellgetriebenen App.
pac model genpage generate-types Erzeugt TypeScript-Schema-Definitionen für Datenquellen
pac model genpage list Auflisten generierter Seiten – standardmäßig env-breit oder für eine App, wenn --app-id angegeben wird. Pass --include-unpublished to also list draft pages.
pac model genpage remove Trennen Sie vorhandene generative KI-Seiten von der Sitemap einer modellgesteuerten App. Die Seitenzeile in Dataverse wird beibehalten (es kann weiterhin von anderen Apps darauf verwiesen werden).
pac model genpage transpile Transpileert eine TypeScript-Datei mit Laufzeittypen zum Testen und Debuggen
pac model genpage upload Laden Sie eine generierte Seite in Dataverse hoch, und veröffentlichen Sie sie. Erstellt eine neue Seite, wenn --page-id weggelassen wird; aktualisiert die vorhandene Seite, wenn --page-id angegeben wird. Wenn Sie eine Seite anfügen möchten, die bereits in der Umgebung vorhanden ist, ohne die Sitemap einer anderen App erneut hochzuladen, verwenden Sie stattdessen "pac model genpage add".
pac model list Listet alle modellgesteuerten Anwendungen in der Umgebung auf.
pac model list-languages Listet aktivierte Sprachen in der Dataverse-Umgebung auf.
pac model list-tables Listen Sie Dataverse-Tabellen in der verbundenen Umgebung auf.

pac model create

Erstellt eine neue modellgetriebene App.

Erforderliche Parameter für model create

--name -n

Der Anzeigename für die neue modellgesteuerte App.

Optionale Parameter für model create

--description -d

Beschreibung für die neue modellgesteuerte App.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--publish

Veröffentlichen Sie die App nach der Erstellung.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--solution

Der eindeutige Name der Lösung, der die App hinzugefügt werden soll. Wenn nicht angegeben, wird standardmäßig "Standard" festgelegt.

Beispiele für pac model create

Die folgenden Beispiele zeigen häufig verwendete Methoden für die Verwendung des pac model create Befehls.

Erstellen einer neuen modellgesteuerten App in der aktiven Umgebung

pac model create --name "Contoso Sales Hub"

Erstellen Sie eine App mit einer Beschreibung, und fügen Sie sie zu einer Lösung hinzu, und veröffentlichen Sie sie dann sofort.

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

Erstellen einer App in einer bestimmten Umgebung durch Bereitstellen der Umgebungs-URL

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

Verwenden Sie diese Eigenschaft pac model list , um zu überprüfen, ob die App erstellt wurde, und rufen Sie die App-ID für die Verwendung mit anderen Befehlen ab, z pac model genpage upload. B. .

pac model genpage add

Fügen Sie eine oder mehrere vorhandene generative Seiten an die Sitemap einer modellgesteuerten App an (kein erneutes Hochladen). Verwenden Sie "pac model genpage upload" zum Erstellen oder Aktualisieren der Seite selbst. Verwenden Sie dieses Verb, um eine bereits hochgeladene Seite in einer anderen App anzuzeigen.

Erforderliche Parameter für model genpage add

--page-id

Comma-separated generative page IDs (GUIDs), die der App hinzugefügt werden sollen.

Optionale Parameter für model genpage add

--app-id

Die ID der modellgesteuerten App (GUID). Sich gegenseitig ausschließend mit --app-name.

--app-name

Der eindeutige Name der modellgesteuerten App. Sich gegenseitig ausschließend mit --app-id.

--area

Optionale Bereichs-ID in der Sitemap, um die Seite unter zu platzieren. Standardmäßig wird der erste Bereich verwendet.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--group

Optionale Gruppen-ID in der Sitemap, um die Seite unter zu platzieren. Standardmäßig wird die erste Gruppe des ausgewählten Bereichs festgelegt.

--language-code

Sprachcode (LCID) für den Titel "SubArea". Standardwert ist 1033 (en-US).

--publish

Veröffentlichen Sie die modellgesteuerte App nach dem Hinzufügen der Seite(n).

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--solution

Eindeutiger Name des Dataverse-Lösungskontexts für das Sitemap-Update. Der Standardwert ist 'Standard'.

pac model genpage download

Ziehe generierte Seiten aus einer modellgetriebenen App.

Erforderliche Parameter für model genpage download

--app-id

Die ID der modellgesteuerten App.

Optionale Parameter für model genpage download

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--output-directory -o

Verzeichnis zum Speichern von pullierten Seiten. Standardmäßig wird das aktuelle Verzeichnis verwendet.

--page-id

Durch Trennzeichen getrennte Liste von Seiten-IDs, die abgerufen werden sollen.

Beispiele für pac model genpage download

Die folgenden Beispiele zeigen häufig verwendete Methoden für die Verwendung des pac model genpage download Befehls.

Herunterladen einer einzelnen generativen Seite anhand der Seiten-ID in einen lokalen Ordner zum Bearbeiten

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

Alle generativen Seiten in einer App gleichzeitig herunterladen

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

Erstellen Eines Unterverzeichnisses, das nach der Seiten-ID benannt ist, und schreibt die folgenden Dateien.

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

Erzeugt TypeScript-Schema-Definitionen für Datenquellen

Erforderliche Parameter für model genpage generate-types

--data-sources

Durch Trennzeichen getrennte Liste der verwendeten Datenquellen (z. B. "Konto,Lead,Kontakt").

Optionale Parameter für model genpage generate-types

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--output-file -o

Pfad zum Speichern der generierten TypeScript-Schemadatei (Standardeinstellung für RuntimeTypes.ts)

Beispiele für pac model genpage generate-types

Die folgenden Beispiele zeigen häufig verwendete Methoden für die Verwendung des pac model genpage generate-types Befehls.

Generieren von TypeScript-Typen

Generieren Sie TypeScript-Typen für die account und contact Tabellen, und schreiben Sie sie in ./src/RuntimeTypes.ts:

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

Generieren von Typen für eine einzelne Tabelle in einem bestimmten Ausgabeverzeichnis

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

Note

Führen Sie vor dem Schreiben von Seitencode immer aus generate-types , der Dataverse-Tabellen abfragt. Die generierte Datei enthält stark typierte Spaltennamen, Fremdschlüsselfelder und Enumerationswerte für jede Tabelle. Das Vertrauen auf die generierten Typen verhindert Laufzeitfehler, die durch falsch geschriebene oder nicht vorhandene Spaltennamen verursacht werden.

pac model genpage list

Auflisten generierter Seiten – standardmäßig env-breit oder für eine App, wenn --app-id angegeben wird. Pass --include-unpublished to also list draft pages.

Optionale Parameter für model genpage list

--app-id

Die ID der modellgesteuerten App.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--include-unpublished

Schließen Sie nicht veröffentlichte generative Seiten in die Liste ein (Standard: nur veröffentlicht).

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

Beispiele für pac model genpage list

Die folgenden Beispiele zeigen häufig verwendete Methoden für die Verwendung des pac model genpage list Befehls.

Auflisten von Seiten mithilfe der App-ID

Auflisten aller generativen Seiten in der Contoso Sales Hub-App mithilfe der App-ID:

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

Auflisten von Seiten mithilfe des App-Namens

Generierende Seiten nach App-Namen auflisten (die CLI sucht die App-ID automatisch):

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

pac model Genpage-Beispielausgabe

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

Trennen Sie vorhandene generative KI-Seiten von der Sitemap einer modellgesteuerten App. Die Seitenzeile in Dataverse wird beibehalten (es kann weiterhin von anderen Apps darauf verwiesen werden).

Erforderliche Parameter für model genpage remove

--page-id

Eine oder mehrere zu entfernende uxagentproject-IDs (durch Trennzeichen getrennt).

Optionale Parameter für model genpage remove

--app-id

Modellgesteuerte App-ID (uniqueid), um die Seite(n) zu entfernen. Sich gegenseitig ausschließend mit --app-name.

--app-name

Modellgesteuerte App eindeutiger Name, um die Seite(n) zu entfernen. Sich gegenseitig ausschließend mit --app-id.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--publish

Veröffentlichen Sie die modellgesteuerte App nach der Sitemap-Bearbeitung, damit Änderungen sofort live gehen.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--solution

Dataverse Solution eindeutiger Name für das Sitemap-Update. Der Standardwert ist 'Standard'.

pac model genpage transpile

Transpileert eine TypeScript-Datei mit Laufzeittypen zum Testen und Debuggen

Erforderliche Parameter für model genpage transpile

--code-file

Pfad zur Datei, die den Seitencode enthält.

Optionale Parameter für model genpage transpile

--data-sources

Durch Trennzeichen getrennte Liste der verwendeten Datenquellen (z. B. "Konto,Lead,Kontakt").

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--output-file

Pfad zum Speichern der transpilierten JavaScript-Ausgabe (Standardwert für [Codedatei].compiled.js)

pac model genpage upload

Laden Sie eine generierte Seite in Dataverse hoch, und veröffentlichen Sie sie. Erstellt eine neue Seite, wenn --page-id weggelassen wird; aktualisiert die vorhandene Seite, wenn --page-id angegeben wird. Wenn Sie eine Seite anfügen möchten, die bereits in der Umgebung vorhanden ist, ohne die Sitemap einer anderen App erneut hochzuladen, verwenden Sie stattdessen "pac model genpage add".

Erforderliche Parameter für model genpage upload

--app-id

Die ID der modellgesteuerten App.

--code-file

Pfad zur Datei, die den Seitencode enthält.

Optionale Parameter für model genpage upload

--add-to-sitemap

Fügen Sie die Seite zur Sitemap-Navigation der App hinzu.

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--agent-message

Die Antwortnachricht des Agents.

--agent-message-file

Pfad zu einer Datei, die die Antwortnachricht des Agents enthält.

--compiled-code-file

Pfad zur Datei, die den kompilierten JavaScript-Code enthält. Wenn nicht angegeben, wird TypeScript automatisch in JavaScript transpiliert.

--data-sources

Durch Trennzeichen getrennte Liste der verwendeten Datenquellen (z. B. "Konto,Lead,Kontakt").

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--model

Das KI-Modell, das zum Generieren der Seite verwendet wird (z. B. "claude-3-5-sonnet-20241022").

--name -n

Der Name der Seite.

--page-id

Die ID der zu aktualisierenden Seite. Wenn nicht angegeben, wird eine neue Seite erstellt.

--prompt

Der Benutzer fordert diese Seite auf.

--prompt-file

Pfad zu einer Datei, die die Benutzeraufforderung enthält, die diese Seite generiert hat.

Beispiele für pac model genpage upload

Die folgenden Beispiele zeigen häufig verwendete Methoden für die Verwendung des pac model genpage upload Befehls.

Veröffentlichen einer neuen generativen Seite

Veröffentlichen Sie eine neue generative Seite in der Contoso Sales Hub-App, und fügen Sie sie der App-Sitemap hinzu:

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

Aktualisieren einer vorhandenen generativen Seite

Aktualisieren Sie eine vorhandene generative Seite, indem Sie ihre Seiten-ID angeben (weglassen --add-to-sitemap , um das Erstellen eines doppelten Sitemap-Eintrags zu vermeiden):

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

Veröffentlichen einer Seite, die simulierte Daten verwendet

Veröffentlichen einer Seite, die simulierte Daten verwendet (keine Dataverse-Tabellen — weglassen --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

Der --app-id Parameter akzeptiert entweder die GUID der App oder den Anzeigenamen. Wenn mehrere Apps denselben Anzeigenamen verwenden, verwenden Sie die GUID, um Mehrdeutigkeit zu vermeiden. Führen Sie diese Aus pac model list , um App-IDs nachzuschlagen.

pac model genpage upload Kurzübersicht zu Parametern

Parameter Erforderlich Beschreibung
--app-id Yes App-GUID oder Anzeigename. Führen Sie den Befehl aus pac model list , um ihn zu finden.
--code-file Yes Pfad zur .tsx bereitzustellenden Quelldatei.
--name Nur neue Seiten Anzeigename, der in der App-Sitemap angezeigt wird.
--page-id Nur Updates GUID der vorhandenen Zu ersetzenden Seite.
--data-sources Dataverse-Seiten Durch Trennzeichen getrennte Liste der logischen Namen der Dataverse-Tabelle (z. B "account,contact". ).
--prompt Empfohlen Zusammenfassung der Natürlichen Sprache, was die Seite tut. Gespeichert für den Regenerationskontext.
--model Empfohlen Modell-ID, die zum Generieren der Seite verwendet wird (z. B claude-sonnet-4-6. ).
--agent-message Empfohlen Beschreibung, was erstellt oder geändert wurde. Als Änderungsverlauf gespeichert.
--add-to-sitemap Nur neue Seiten Fügt die Seite automatisch zur App-Navigation hinzu. Lassen Sie es beim Aktualisieren aus.

pac model list

Listet alle modellgesteuerten Anwendungen in der Umgebung auf.

Optionale Parameter für model list

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac model list-Beispiel

Auflisten aller modellgesteuerten Apps in der derzeit aktiven Umgebung:

pac model list

Beispielausgabe:

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

Listet aktivierte Sprachen in der Dataverse-Umgebung auf.

Optionale Parameter für model list-languages

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac model list-tables

Listen Sie Dataverse-Tabellen in der verbundenen Umgebung auf.

Optionale Parameter für model list-tables

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--search -s

Komma-separierte Liste von Namen, nach denen man suchen sollte (entspricht logischem Namen, Schema-Namen oder Anzeigename).

--type -t

Filtern Sie nach Tabellentyp: 'benutzerdefiniert', 'Standard' oder 'alle' (Standard: alle).

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht

  • Last updated on