pac model

Perintah untuk bekerja dengan aplikasi berbasis model.

Commands

Command Description
pac model create Membuat aplikasi berbasis model baru.
pac model genpage download Tarik halaman yang dihasilkan dari aplikasi berbasis model.
pac model genpage generate-types Menghasilkan definisi skema TypeScript untuk sumber data
pac model genpage list Mencantumkan semua halaman yang dihasilkan di aplikasi berbasis model yang ditentukan.
pac model genpage transpile Mentranspile file TypeScript dengan jenis runtime untuk pengujian dan debugging
pac model genpage upload Upload dan publikasikan halaman yang dihasilkan ke aplikasi berbasis model.
pac model list Mencantumkan semua aplikasi berbasis model di lingkungan.
pac model list-languages Mencantumkan bahasa yang diaktifkan di lingkungan Dataverse.
pac model list-tables Cantumkan tabel Dataverse di lingkungan yang terhubung.

pac model create

Membuat aplikasi berbasis model baru.

Parameter yang Diperlukan untuk model create

--name -n

Nama tampilan untuk aplikasi berbasis model baru.

Parameter Opsional untuk model create

--description -d

Deskripsi untuk aplikasi berbasis model baru.

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--publish

Terbitkan aplikasi setelah pembuatan.

Parameter ini tidak memerlukan nilai. Ini saklar.

--solution

Nama unik solusi untuk menambahkan aplikasi. Default ke solusi aktif.

pac model create contoh

Contoh berikut menunjukkan cara umum untuk menggunakan pac model create perintah .

Membuat aplikasi berbasis model baru di lingkungan aktif

pac model create --name "Contoso Sales Hub"

Buat aplikasi dengan deskripsi dan tambahkan ke solusi, lalu terbitkan segera

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

Membuat aplikasi di lingkungan tertentu dengan menyediakan URL lingkungan

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 memverifikasi bahwa aplikasi telah dibuat dan mengambil ID aplikasinya untuk digunakan dengan perintah lain seperti pac model genpage upload.

pac model genpage download

Tarik halaman yang dihasilkan dari aplikasi berbasis model.

Parameter yang Diperlukan untuk model genpage download

--app-id

ID aplikasi berbasis model.

Parameter Opsional untuk model genpage download

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--output-directory -o

Direktori untuk menyimpan halaman yang ditarik. Default ke direktori saat ini.

--page-id

Daftar ID halaman yang dipisahkan koma untuk ditarik.

pac model genpage download contoh

Contoh berikut menunjukkan cara umum untuk menggunakan pac model genpage download perintah .

Mengunduh satu halaman generatif dengan ID halamannya ke folder lokal untuk pengeditan

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

Mengunduh semua halaman generatif dalam aplikasi sekaligus

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

Buat subdirektori yang dinamai sesuai ID halaman dan tulis file 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

Menghasilkan definisi skema TypeScript untuk sumber data

Parameter yang Diperlukan untuk model genpage generate-types

--data-sources

Daftar sumber data yang dipisahkan koma yang digunakan (misalnya, 'akun,prospek,kontak').

Parameter Opsional untuk model genpage generate-types

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--output-file -o

Jalur untuk menyimpan file skema TypeScript yang dihasilkan (default ke RuntimeTypes.ts)

pac model genpage generate-types contoh

Contoh berikut menunjukkan cara umum untuk menggunakan pac model genpage generate-types perintah .

Membuat jenis TypeScript

Hasilkan jenis TypeScript untuk account tabel dan contact dan tulis ke ./src/RuntimeTypes.ts:

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

Membuat jenis untuk satu tabel ke dalam direktori output tertentu

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

Note

Selalu jalankan generate-types sebelum menulis kode halaman yang mengkueri tabel Dataverse. File yang dihasilkan berisi nama kolom yang diketik dengan kuat, bidang kunci asing, dan nilai enum untuk setiap tabel. Mengandalkan jenis yang dihasilkan mencegah kesalahan runtime yang disebabkan oleh nama kolom yang salah eja atau tidak ada.

pac model genpage list

Mencantumkan semua halaman yang dihasilkan di aplikasi berbasis model yang ditentukan.

Parameter yang Diperlukan untuk model genpage list

--app-id

ID aplikasi berbasis model.

Parameter Opsional untuk model genpage list

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac model genpage list contoh

Contoh berikut menunjukkan cara umum untuk menggunakan pac model genpage list perintah .

Mencantumkan halaman menggunakan ID aplikasi

Cantumkan semua halaman generatif di aplikasi Contoso Sales Hub menggunakan ID aplikasinya:

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

Mencantumkan halaman menggunakan nama aplikasi

Cantumkan halaman generatif menurut nama aplikasi (CLI mencari ID aplikasi secara otomatis):

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

pac model output 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

Mentranspile file TypeScript dengan jenis runtime untuk pengujian dan debugging

Parameter yang Diperlukan untuk model genpage transpile

--code-file

Jalur ke file yang berisi kode halaman.

Parameter Opsional untuk model genpage transpile

--data-sources

Daftar sumber data yang dipisahkan koma yang digunakan (misalnya, 'akun,prospek,kontak').

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--output-file

Jalur untuk menyimpan output JavaScript yang ditranspilasi (default ke [code-file].compiled.js)

pac model genpage upload

Upload dan publikasikan halaman yang dihasilkan ke aplikasi berbasis model.

Parameter yang Diperlukan untuk model genpage upload

--app-id

ID aplikasi berbasis model.

--code-file

Jalur ke file yang berisi kode halaman.

Parameter Opsional untuk model genpage upload

--add-to-sitemap

Tambahkan halaman ke navigasi peta situs aplikasi.

Parameter ini tidak memerlukan nilai. Ini saklar.

--agent-message

Pesan respons agen.

--agent-message-file

Jalur ke file yang berisi pesan respons agen.

--compiled-code-file

Jalur ke file yang berisi kode JavaScript yang dikompilasi. Jika tidak disediakan, TypeScript akan secara otomatis ditranspilasi ke JavaScript.

--data-sources

Daftar sumber data yang dipisahkan koma yang digunakan (misalnya, 'akun,prospek,kontak').

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--model

Model AI yang digunakan untuk menghasilkan halaman (misalnya, 'claude-3-5-sonnet-20241022').

--name -n

Nama halaman.

--page-id

ID halaman yang akan diperbarui. Jika tidak disediakan, halaman baru akan dibuat.

--prompt

Permintaan pengguna yang menghasilkan halaman ini.

--prompt-file

Jalur ke file yang berisi permintaan pengguna yang menghasilkan halaman ini.

pac model genpage upload contoh

Contoh berikut menunjukkan cara umum untuk menggunakan pac model genpage upload perintah .

Menerbitkan halaman generatif baru

Terbitkan halaman generatif baru ke aplikasi Contoso Sales Hub dan tambahkan ke peta situs 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

Memperbarui halaman generatif yang sudah ada

Perbarui halaman generatif yang ada dengan memberikan ID halamannya (hilangkan --add-to-sitemap untuk menghindari pembuatan entri peta situs duplikat):

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

Menerbitkan halaman yang menggunakan data tiruan

Terbitkan halaman yang menggunakan data tiruan (tidak ada tabel Dataverse — hilangkan --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 --app-id menerima GUID aplikasi atau nama tampilannya. Jika beberapa aplikasi memiliki nama tampilan yang sama, gunakan GUID untuk menghindari ambiguitas. Jalankan pac model list untuk mencari ID aplikasi.

pac model genpage upload referensi cepat parameter

Parameter Required Description
--app-id Yes GUID aplikasi atau nama tampilan. Jalankan pac model list untuk menemukannya.
--code-file Yes Jalur ke file sumber untuk .tsx disebarkan.
--name Halaman baru saja Nama tampilan ditampilkan di peta situs aplikasi.
--page-id Updates only GUID halaman yang ada untuk diganti.
--data-sources Dataverse pages Daftar nama logika tabel Dataverse yang dipisahkan koma (misalnya, "account,contact").
--prompt Recommended Ringkasan bahasa alami dari apa yang dilakukan halaman. Disimpan untuk konteks regenerasi.
--model Recommended ID model yang digunakan untuk menghasilkan halaman (misalnya, claude-sonnet-4-6).
--agent-message Recommended Deskripsi tentang apa yang dibangun atau diubah. Disimpan sebagai riwayat perubahan.
--add-to-sitemap Halaman baru saja Menambahkan halaman ke navigasi aplikasi secara otomatis. Hilangkan saat memperbarui.

pac model list

Mencantumkan semua aplikasi berbasis model di lingkungan.

Parameter Opsional untuk model list

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac model list contoh

Cantumkan semua aplikasi berbasis model di lingkungan yang saat ini 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

Mencantumkan bahasa yang diaktifkan di lingkungan Dataverse.

Parameter Opsional untuk model list-languages

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac model list-tables

Cantumkan tabel Dataverse di lingkungan yang terhubung.

Parameter Opsional untuk model list-tables

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--search -s

Daftar nama yang dipisahkan koma untuk dicari (cocok dengan nama logis, nama skema, atau nama tampilan).

--type -t

Filter berdasarkan jenis tabel: 'kustom', 'standar', atau 'semua' (default: semua).

See also

Microsoft Power Platform Grup Perintah CLI
Gambaran umum CLI Microsoft Power Platform

  • Last updated on