Freigeben über


pac model

(Vorschau) Befehle zum Arbeiten mit modellgesteuerten Apps.

Befehle

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

Laden Sie eine einzelne generative Seite anhand ihrer Seiten-ID in einen lokalen Ordner zum Bearbeiten herunter:

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

Laden Sie alle generativen Seiten in einer App gleichzeitig herunter:

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

Der Befehl erstellt ein Unterverzeichnis, 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

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

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"

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

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

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

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

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 zum Generieren der Seite (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.

Beispiele

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