Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
(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