pac model

Perintah untuk bekerja dengan apl dipacu model.

Commands

Command Description
pac model create Mencipta apl dipacu model baharu.
pac model genpage download Tarik halaman yang dijana daripada apl dipacu model.
pac model genpage generate-types Menjana takrifan skema TypeScript untuk sumber data
pac model genpage list Menyenaraikan semua halaman yang dijana dalam aplikasi dipacu model yang ditentukan.
pac model genpage transpile Mentranspil fail TypeScript dengan jenis masa jalan untuk ujian dan penyahpepijatan
pac model genpage upload Muat naik dan terbitkan halaman yang dijana ke apl dipacu model.
pac model list Menyenaraikan semua aplikasi dipacu model dalam persekitaran.
pac model list-languages Menyenaraikan bahasa yang didayakan dalam persekitaran Dataverse.
pac model list-tables Senaraikan jadual Dataverse dalam persekitaran yang disambungkan.

pac model create

Mencipta apl dipacu model baharu.

Parameter yang diperlukan untuk model create

--name -n

Nama paparan untuk apl dipacu model baharu.

Parameter Pilihan untuk model create

--description -d

Penerangan untuk apl dipacu model baharu.

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--publish

Terbitkan apl selepas penciptaan.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--solution

Nama unik penyelesaian untuk menambah apl. Lalai kepada penyelesaian aktif.

pac model create Contoh

Contoh berikut menunjukkan cara biasa untuk menggunakan pac model create arahan.

Cipta apl dipacu model baharu dalam persekitaran aktif

pac model create --name "Contoso Sales Hub"

Cipta apl dengan perihalan dan tambahkannya pada penyelesaian, kemudian terbitkan serta-merta

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

Cipta apl dalam persekitaran tertentu dengan menyediakan URL persekitaran

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

Gunakan pac model list untuk mengesahkan apl telah dicipta dan mendapatkan semula ID aplnya untuk digunakan dengan arahan lain seperti pac model genpage upload.

pac model genpage download

Tarik halaman yang dijana daripada apl dipacu model.

Parameter yang diperlukan untuk model genpage download

--app-id

ID apl dipacu model.

Parameter Pilihan untuk model genpage download

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--output-directory -o

Direktori untuk menyimpan halaman yang ditarik. Lalai kepada direktori semasa.

--page-id

Senarai ID halaman yang dipisahkan koma untuk ditarik.

pac model genpage download Contoh

Contoh berikut menunjukkan cara biasa untuk menggunakan pac model genpage download arahan.

Muat turun satu halaman generatif mengikut ID halamannya ke folder tempatan untuk diedit

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

Muat turun semua halaman generatif dalam apl sekaligus

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

Cipta subdirektori yang dinamakan sempena ID halaman dan menulis fail berikut

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

Menjana takrifan skema TypeScript untuk sumber data

Parameter yang diperlukan untuk model genpage generate-types

--data-sources

Senarai sumber data yang dipisahkan koma yang digunakan (cth., 'akaun,petunjuk,kenalan').

Parameter Pilihan untuk model genpage generate-types

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--output-file -o

Laluan untuk menyimpan fail skema TypeScript yang dijana (lalai kepada RuntimeTypes.ts)

pac model genpage generate-types Contoh

Contoh berikut menunjukkan cara biasa untuk menggunakan pac model genpage generate-types arahan.

Jana jenis TypeScript

Jana jenis TypeScript untuk account jadual dan contact tulis kepada ./src/RuntimeTypes.ts:

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

Jana jenis untuk jadual tunggal ke dalam direktori output tertentu

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

Note

Sentiasa jalankan generate-types sebelum menulis kod halaman yang menanyakan jadual Dataverse. Fail yang dijana mengandungi nama lajur yang ditaip dengan kuat, medan kunci asing dan nilai enum untuk setiap jadual. Bergantung pada jenis yang dijana menghalang ralat masa jalan yang disebabkan oleh nama lajur yang salah eja atau tidak wujud.

pac model genpage list

Menyenaraikan semua halaman yang dijana dalam aplikasi dipacu model yang ditentukan.

Parameter yang diperlukan untuk model genpage list

--app-id

ID apl dipacu model.

Parameter Pilihan untuk model genpage list

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac model genpage list Contoh

Contoh berikut menunjukkan cara biasa untuk menggunakan pac model genpage list arahan.

Senaraikan halaman menggunakan ID apl

Senaraikan semua halaman generatif dalam aplikasi Hab Jualan Contoso menggunakan ID aplikasinya:

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

Senaraikan halaman menggunakan nama apl

Senaraikan halaman generatif mengikut nama apl (CLI mencari ID apl secara automatik):

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

pac model keluaran sampel genpage

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

Mentranspil fail TypeScript dengan jenis masa jalan untuk ujian dan penyahpepijatan

Parameter yang diperlukan untuk model genpage transpile

--code-file

Laluan ke fail yang mengandungi kod halaman.

Parameter Pilihan untuk model genpage transpile

--data-sources

Senarai sumber data yang dipisahkan koma yang digunakan (cth., 'akaun,petunjuk,kenalan').

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--output-file

Laluan untuk menyimpan output JavaScript yang ditranspil (lalai kepada [fail kod].compiled.js)

pac model genpage upload

Muat naik dan terbitkan halaman yang dijana ke apl dipacu model.

Parameter yang diperlukan untuk model genpage upload

--app-id

ID apl dipacu model.

--code-file

Laluan ke fail yang mengandungi kod halaman.

Parameter Pilihan untuk model genpage upload

--add-to-sitemap

Tambahkan halaman pada navigasi peta laman apl.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--agent-message

Mesej respons ejen.

--agent-message-file

Laluan ke fail yang mengandungi mesej respons ejen.

--compiled-code-file

Laluan ke fail yang mengandungi kod JavaScript yang disusun. Jika tidak disediakan, TypeScript akan ditranspilasikan secara automatik kepada JavaScript.

--data-sources

Senarai sumber data yang dipisahkan koma yang digunakan (cth., 'akaun,petunjuk,kenalan').

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--model

Model AI digunakan untuk menjana halaman (cth., 'claude-3-5-sonnet-20241022').

--name -n

Nama halaman.

--page-id

ID halaman untuk dikemas kini. Jika tidak disediakan, halaman baru akan dibuat.

--prompt

Gesaan pengguna yang menjana halaman ini.

--prompt-file

Laluan ke fail yang mengandungi gesaan pengguna yang menjana halaman ini.

pac model genpage upload Contoh

Contoh berikut menunjukkan cara biasa untuk menggunakan pac model genpage upload arahan.

Terbitkan halaman generatif baharu

Terbitkan halaman generatif baharu ke aplikasi Hab Jualan Contoso dan tambahkannya pada peta laman aplikasi:

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

Kemas kini halaman generatif sedia ada

Kemas kini halaman generatif sedia ada dengan memberikan ID halamannya (tinggalkan --add-to-sitemap untuk mengelak daripada mencipta entri peta laman pendua):

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

Terbitkan halaman yang menggunakan data olok-olok

Terbitkan halaman yang menggunakan data olok-olok (tiada jadual Dataverse — tinggalkan --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

Parameter menerima --app-id sama ada GUID apl atau nama paparannya. Jika berbilang app berkongsi nama paparan yang sama, gunakan GUID untuk mengelakkan kekaburan. Jalankan pac model list untuk mencari ID apl.

pac model genpage upload Parameter rujukan pantas

Parameter Required Description
--app-id Yes GUID apl atau nama paparan. Lari pac model list untuk mencarinya.
--code-file Yes Laluan ke .tsx fail sumber untuk digunakan.
--name Halaman baru sahaja Nama paparan yang ditunjukkan dalam peta laman apl.
--page-id Updates only GUID halaman sedia ada untuk diganti.
--data-sources Dataverse pages Senarai nama logik jadual Dataverse yang dipisahkan koma (contohnya, "account,contact").
--prompt Recommended Ringkasan bahasa semula jadi tentang apa yang dilakukan oleh halaman itu. Disimpan untuk konteks penjanaan semula.
--model Recommended ID model digunakan untuk menjana halaman (contohnya, claude-sonnet-4-6).
--agent-message Recommended Penerangan tentang apa yang dibina atau diubah. Disimpan sebagai sejarah perubahan.
--add-to-sitemap Halaman baru sahaja Menambah halaman pada navigasi apl secara automatik. Tinggalkan semasa mengemas kini.

pac model list

Menyenaraikan semua aplikasi dipacu model dalam persekitaran.

Parameter Pilihan untuk model list

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac model list Contoh

Senaraikan semua aplikasi dipacu model dalam persekitaran yang sedang aktif:

pac model list

Sample output:

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

Menyenaraikan bahasa yang didayakan dalam persekitaran Dataverse.

Parameter Pilihan untuk model list-languages

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac model list-tables

Senaraikan jadual Dataverse dalam persekitaran yang disambungkan.

Parameter Pilihan untuk model list-tables

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--search -s

Senarai nama yang dipisahkan koma untuk dicari (sepadan dengan nama logik, nama skema atau nama paparan).

--type -t

Tapis mengikut jenis jadual: 'tersuai', 'standard' atau 'semua' (lalai: semua).

See also

Microsoft Power Platform Kumpulan Perintah CLI
Microsoft Power Platform Gambaran keseluruhan CLI

  • Last updated on