Freigeben über

pac model

(Vorschau) Befehle zum Arbeiten mit modellgesteuerten Apps.

Befehle

Command Description
pac model create (Vorschau) Erstellt eine neue modellgesteuerte App.
pac model genpage download (Vorschau) Rufen Sie generierte Seiten aus einer modellgesteuerten App ab.
pac model genpage generate-types (Vorschau) Generiert TypeScript-Schemadefinitionen für Datenquellen
pac model genpage list (Vorschau) Listet alle generierten Seiten in der angegebenen modellgesteuerten App auf.
pac model genpage transpile (Vorschau) Transpiliert eine TypeScript-Datei mit Laufzeittypen zum Testen und Debuggen
pac model genpage upload (Vorschau) Laden Sie eine generierte Seite in eine modellgesteuerte App hoch und veröffentlichen Sie sie.
pac model list (Vorschau) Listet alle modellgesteuerten Apps in der Umgebung auf.
pac model list-languages (Vorschau) Listet aktivierte Sprachen in der Dataverse-Umgebung auf.

pac model create

(Vorschau) Erstellt eine neue modellgesteuerte 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. Standardmäßig wird die aktive Lösung verwendet.

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

Tipp

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 download

(Vorschau) Rufen Sie generierte Seiten aus einer modellgesteuerten App ab.

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

(Vorschau) Generiert TypeScript-Schemadefinitionen 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

Hinweis

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

(Vorschau) Listet alle generierten Seiten in der angegebenen modellgesteuerten App auf.

Erforderliche Parameter für model genpage list

--app-id

Die ID der modellgesteuerten App.

Optionale Parameter für model genpage 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.

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 transpile

(Vorschau) Transpiliert 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

(Vorschau) Laden Sie eine generierte Seite in eine modellgesteuerte App hoch und veröffentlichen Sie sie.

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

Tipp

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 Description
--app-id Ja App-GUID oder Anzeigename. Führen Sie den Befehl aus pac model list , um ihn zu finden.
--code-file Ja 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

(Vorschau) Listet alle modellgesteuerten Apps 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

(Vorschau) 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.

Siehe auch

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

  • Last updated on