Delen via

pac model

(Preview) Opdrachten voor het werken met modelgestuurde apps.

Commands

Command Description
pac model create (Preview) Hiermee maakt u een nieuwe modelgestuurde app.
pac model genpage download (Preview) Gegenereerde pagina's ophalen uit een modelgestuurde app.
pac model genpage generate-types (Preview) Hiermee genereert u TypeScript-schemadefinities voor gegevensbronnen
pac model genpage list (Preview) Een lijst met alle gegenereerde pagina's in de opgegeven modelgestuurde app.
pac model genpage transpile (Preview) Een TypeScript-bestand transpileert met runtimetypen voor testen en foutopsporing
pac model genpage upload (Preview) Upload en publiceer een gegenereerde pagina naar een modelgestuurde app.
pac model list (Preview) Een lijst met alle modelgestuurde apps in de omgeving.
pac model list-languages (Preview) Lijsten met ingeschakelde talen in de Dataverse-omgeving.

pac model create

(Preview) Hiermee maakt u een nieuwe modelgestuurde app.

Vereiste parameters voor model create

--name -n

De weergavenaam voor de nieuwe modelgestuurde app.

Optionele parameters voor model create

--description -d

Beschrijving voor de nieuwe modelgestuurde app.

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--publish

Publiceer de app na het maken.

Voor deze parameter is geen waarde vereist. Het is een switch.

--solution

De unieke naam van de oplossing waaraan u de app wilt toevoegen. De standaardinstelling is de actieve oplossing.

voorbeelden van pac model create

In de volgende voorbeelden ziet u veelgebruikte manieren om de pac model create opdracht te gebruiken.

Een nieuwe modelgestuurde app maken in de actieve omgeving

pac model create --name "Contoso Sales Hub"

Maak een app met een beschrijving en voeg deze toe aan een oplossing en publiceer vervolgens onmiddellijk

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

Een app maken in een specifieke omgeving door de URL van de omgeving op te geven

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

Aanbeveling

Gebruik pac model list dit om te controleren of de app is gemaakt en de bijbehorende app-id ophaalt voor gebruik met andere opdrachten, zoals pac model genpage upload.

pac model genpage download

(Preview) Gegenereerde pagina's ophalen uit een modelgestuurde app.

Vereiste parameters voor model genpage download

--app-id

De id van de modelgestuurde app.

Optionele parameters voor model genpage download

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--output-directory -o

Map voor het opslaan van opgehaalde pagina's. Standaard ingesteld op huidige map.

--page-id

Door komma's gescheiden lijst met pagina-id's die moeten worden opgehaald.

voorbeelden van pac model genpage download

In de volgende voorbeelden ziet u veelgebruikte manieren om de pac model genpage download opdracht te gebruiken.

Een enkele generatieve pagina met de bijbehorende pagina-id downloaden naar een lokale map voor bewerken

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

Alle generatieve pagina's in een app tegelijk downloaden

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

Maak een submap met de naam van de pagina-id en schrijf de volgende bestanden

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

(Preview) Hiermee genereert u TypeScript-schemadefinities voor gegevensbronnen

Vereiste parameters voor model genpage generate-types

--data-sources

Door komma's gescheiden lijst met gebruikte gegevensbronnen (bijvoorbeeld 'account,lead,contact').

Optionele parameters voor model genpage generate-types

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--output-file -o

Pad om het gegenereerde TypeScript-schemabestand op te slaan (standaard ingesteld op RuntimeTypes.ts)

voorbeelden van pac model genpage generate-types

In de volgende voorbeelden ziet u veelgebruikte manieren om de pac model genpage generate-types opdracht te gebruiken.

TypeScript-typen genereren

TypeScript-typen genereren voor de account en contact tabellen en schrijven naar ./src/RuntimeTypes.ts:

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

Typen genereren voor één tabel in een specifieke uitvoermap

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

Opmerking

Voer altijd uit voordat u paginacode schrijft waarmee query's worden uitgevoerd generate-types op Dataverse-tabellen. Het gegenereerde bestand bevat sterk getypte kolomnamen, velden met refererende sleutels en opsommingswaarden voor elke tabel. Afhankelijk van de gegenereerde typen voorkomt u runtimefouten die worden veroorzaakt door verkeerd gespelde of niet-bestaande kolomnamen.

pac model genpage list

(Preview) Een lijst met alle gegenereerde pagina's in de opgegeven modelgestuurde app.

Vereiste parameters voor model genpage list

--app-id

De id van de modelgestuurde app.

Optionele parameters voor model genpage list

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

voorbeelden van pac model genpage list

In de volgende voorbeelden ziet u veelgebruikte manieren om de pac model genpage list opdracht te gebruiken.

Pagina's weergeven met app-id

Vermeld alle generatieve pagina's in de Contoso Sales Hub-app met behulp van de app-id:

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

Pagina's weergeven met app-naam

Lijst met generatieve pagina's op app-naam (de CLI zoekt automatisch de app-id op):

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

pac model genpage-voorbeelduitvoer

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

(Preview) Een TypeScript-bestand transpileert met runtimetypen voor testen en foutopsporing

Vereiste parameters voor model genpage transpile

--code-file

Pad naar het bestand met de paginacode.

Optionele parameters voor model genpage transpile

--data-sources

Door komma's gescheiden lijst met gebruikte gegevensbronnen (bijvoorbeeld 'account,lead,contact').

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--output-file

Pad voor het opslaan van de transpiled JavaScript-uitvoer (standaard ingesteld op [code-bestand].compiled.js)

pac model genpage upload

(Preview) Upload en publiceer een gegenereerde pagina naar een modelgestuurde app.

Vereiste parameters voor model genpage upload

--app-id

De id van de modelgestuurde app.

--code-file

Pad naar het bestand met de paginacode.

Optionele parameters voor model genpage upload

--add-to-sitemap

Voeg de pagina toe aan de sitemapnavigatie van de app.

Voor deze parameter is geen waarde vereist. Het is een switch.

--agent-message

Het antwoordbericht van de agent.

--agent-message-file

Pad naar een bestand met het antwoordbericht van de agent.

--compiled-code-file

Pad naar het bestand met de gecompileerde JavaScript-code. Als dit niet wordt opgegeven, wordt TypeScript automatisch naar JavaScript getranspileerd.

--data-sources

Door komma's gescheiden lijst met gebruikte gegevensbronnen (bijvoorbeeld 'account,lead,contact').

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--model

Het AI-model dat wordt gebruikt om de pagina te genereren (bijvoorbeeld 'claude-3-5-sonnet-20241022').

--name -n

De naam van de pagina.

--page-id

De id van de pagina die moet worden bijgewerkt. Als deze niet is opgegeven, wordt er een nieuwe pagina gemaakt.

--prompt

De gebruiker vraagt of deze pagina is gegenereerd.

--prompt-file

Pad naar een bestand met de gebruikersprompt die deze pagina heeft gegenereerd.

voorbeelden van pac model genpage upload

In de volgende voorbeelden ziet u veelgebruikte manieren om de pac model genpage upload opdracht te gebruiken.

Een nieuwe generatieve pagina publiceren

Publiceer een nieuwe generatieve pagina naar de Contoso Sales Hub-app en voeg deze toe aan de siteoverzicht van de app:

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

Een bestaande generatieve pagina bijwerken

Werk een bestaande generatieve pagina bij door de bijbehorende pagina-id op te geven (laat weg --add-to-sitemap om te voorkomen dat er een dubbele sitemapvermelding wordt gemaakt):

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

Een pagina publiceren die gebruikmaakt van gesimuleerde gegevens

Een pagina publiceren die gebruikmaakt van gesimuleerde gegevens (geen Dataverse-tabellen — weglaten --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

Aanbeveling

De --app-id parameter accepteert de GUID van de app of de weergavenaam van de app. Als meerdere apps dezelfde weergavenaam delen, gebruikt u de GUID om dubbelzinnigheid te voorkomen. Voer uit pac model list om app-id's op te zoeken.

pac model genpage upload snelzoekgids voor parameters

Kenmerk Verplicht Description
--app-id Ja App-GUID of weergavenaam. Voer pac model list uit om het te vinden.
--code-file Ja Pad naar het .tsx bronbestand dat moet worden geïmplementeerd.
--name Alleen nieuwe pagina's Weergavenaam die wordt weergegeven in de sitemap van de app.
--page-id Alleen updates GUID van de bestaande pagina die moet worden vervangen.
--data-sources Dataverse-pagina's Door komma's gescheiden lijst met logische namen van dataverse-tabellen (bijvoorbeeld "account,contact").
--prompt Aanbevolen Samenvatting van natuurlijke taal van wat de pagina doet. Opgeslagen voor regeneratiecontext.
--model Aanbevolen Model-id die wordt gebruikt om de pagina te genereren (bijvoorbeeld claude-sonnet-4-6).
--agent-message Aanbevolen Beschrijving van wat er is gebouwd of gewijzigd. Opgeslagen als wijzigingsgeschiedenis.
--add-to-sitemap Alleen nieuwe pagina's Hiermee wordt de pagina automatisch toegevoegd aan de app-navigatie. Laat weg bij het bijwerken.

pac model list

(Preview) Een lijst met alle modelgestuurde apps in de omgeving.

Optionele parameters voor model list

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac model list voorbeeld

Geef alle modelgestuurde apps weer in de huidige actieve omgeving:

pac model list

Voorbeelduitvoer:

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

(Preview) Lijsten met ingeschakelde talen in de Dataverse-omgeving.

Optionele parameters voor model list-languages

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

Zie ook

Microsoft Power Platform CLI-opdrachtgroepen
Overzicht van Microsoft Power Platform CLI

  • Last updated on