pac model

Model odaklı uygulamalarla çalışmak için komutlar.

Commands

Komut Description
pac model create Yeni model odaklı bir uygulama oluşturuyor.
pac model genpage add Model temelli bir uygulamanın site haritasına bir veya daha fazla mevcut oluşturucu sayfa ekleyin (yeniden karşıya yükleme yok). Sayfanın kendisini oluşturmak veya güncelleştirmek için 'pac model genpage upload' kullanın; zaten karşıya yüklenmiş bir sayfanın başka bir uygulamada gösterilmesini sağlamak için bu fiili kullanın.
pac model genpage download Model odaklı bir uygulamadan oluşturulan sayfaları çekin.
pac model genpage generate-types Veri kaynakları için TypeScript şema tanımları oluşturur
pac model genpage list Oluşturulan sayfaları listeleyin ( varsayılan olarak env-wide veya --app-id sağlandığında bir uygulama için). Taslak sayfaları da listelemek için --include-unpublished öğesini geçirin.
pac model genpage remove Model temelli bir uygulamanın site haritasından mevcut üretken yapay zeka sayfalarını ayırma. Dataverse'deki sayfa satırı korunur (yine de diğer uygulamalardan başvurulabilir).
pac model genpage transpile Test ve hata ayıklama için çalışma zamanı tipleriyle bir TypeScript dosyası aktarır
pac model genpage upload Oluşturulan bir sayfayı Dataverse'e yükleyin ve yayımlayın. --page-id atlandığında yeni bir sayfa oluşturur; , --page-id sağlandığında var olan sayfayı güncelleştirir. Ortamda zaten var olan bir sayfayı yeniden karşıya yüklemeden başka bir uygulamanın site haritasına eklemek için bunun yerine 'pac model genpage add' kullanın.
pac model list Ortamdaki tüm model tabanlı uygulamaları listeler.
pac model list-languages Listler, Dataverse ortamında dilleri etkinleştirdi.
pac model list-tables Bağlı ortamda Dataverse tablolarını listeleyin.

pac model create

Yeni model odaklı bir uygulama oluşturuyor.

Için Gerekli Parametreler model create

--name -n

Yeni model temelli uygulamanın görünen adı.

için İsteğe Bağlı Parametreler model create

--description -d

Yeni model temelli uygulamanın açıklaması.

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--publish

Oluşturma işleminden sonra uygulamayı yayımlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--solution

Uygulamayı eklemek için çözüm benzersiz adı. Belirtilmezse varsayılan olarak 'Varsayılan' olur.

pac model create örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model create .

Etkin ortamda model temelli yeni bir uygulama oluşturma

pac model create --name "Contoso Sales Hub"

Açıklama içeren bir uygulama oluşturun ve bir çözüme ekleyin, ardından hemen yayımlayın

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

Ortam URL'sini sağlayarak belirli bir ortamda uygulama oluşturma

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

Uygulamanın oluşturulduğunu doğrulamak ve gibi pac model listdiğer komutlarla kullanmak üzere uygulama kimliğini almak için kullanınpac model genpage upload.

pac model genpage add

Model temelli bir uygulamanın site haritasına bir veya daha fazla mevcut oluşturucu sayfa ekleyin (yeniden karşıya yükleme yok). Sayfanın kendisini oluşturmak veya güncelleştirmek için 'pac model genpage upload' kullanın; zaten karşıya yüklenmiş bir sayfanın başka bir uygulamada gösterilmesini sağlamak için bu fiili kullanın.

Için Gerekli Parametreler model genpage add

--page-id

Uygulamaya eklenecek virgülle ayrılmış üretken sayfa kimlikleri (GUID' ler).

için İsteğe Bağlı Parametreler model genpage add

--app-id

Model temelli uygulamanın kimliği (GUID). --app-name ile birbirini dışlar.

--app-name

Model temelli uygulamanın benzersiz adı. --app-id ile birbirini dışlar.

--area

Sayfayı yerleştirmek için site haritasındaki isteğe bağlı Alan Kimliği. Varsayılan olarak ilk Alan'ı kullanır.

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--group

Sayfayı yerleştirmek için site haritasındaki isteğe bağlı Grup Kimliği. Varsayılan olarak seçilen Alanın ilk Grubu'na ayarlır.

--language-code

Alt Alan başlığı için dil kodu (LCID). Varsayılan olarak 1033 (en-US).

--publish

Sayfaları ekledikten sonra model temelli uygulamayı yayımlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--solution

Site haritası güncelleştirmesi için Dataverse çözüm bağlamının benzersiz adı. Varsayılan olarak 'Varsayılan' olarak ayarlanır.

pac model genpage download

Model odaklı bir uygulamadan oluşturulan sayfaları çekin.

Için Gerekli Parametreler model genpage download

--app-id

Model temelli uygulamanın kimliği.

için İsteğe Bağlı Parametreler model genpage download

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-directory -o

Çekilen sayfaları kaydetmek için dizin. Varsayılan olarak geçerli dizine geçer.

--page-id

Çekecek sayfa kimliklerinin virgülle ayrılmış listesi.

pac model genpage download örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage download .

Sayfa kimliğine göre tek bir üretken sayfayı düzenlemek üzere yerel bir klasöre indirme

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

Bir uygulamadaki tüm üretken sayfaları aynı anda indirme

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

Sayfa kimliğinden sonra adlı bir alt dizin oluşturun ve aşağıdaki dosyaları yazar

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

Veri kaynakları için TypeScript şema tanımları oluşturur

Için Gerekli Parametreler model genpage generate-types

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

için İsteğe Bağlı Parametreler model genpage generate-types

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-file -o

Oluşturulan TypeScript şema dosyasını kaydetme yolu (varsayılan olarak RuntimeTypes.ts)

pac model genpage generate-types örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage generate-types .

TypeScript türleri oluşturma

ve account tabloları için contact TypeScript türleri oluşturup yazın./src/RuntimeTypes.ts:

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

Belirli bir çıkış dizininde tek bir tablo için türler oluşturma

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

Note

Dataverse tablolarını sorgulayan sayfa kodu yazmadan önce her zaman çalıştırın generate-types . Oluşturulan dosya, her tablo için kesin olarak yazılmış sütun adları, yabancı anahtar alanları ve sabit listesi değerleri içerir. Oluşturulan türlere güvenmek, yanlış yazılmış veya varolmayan sütun adlarının neden olduğu çalışma zamanı hatalarını önler.

pac model genpage list

Oluşturulan sayfaları listeleyin ( varsayılan olarak env-wide veya --app-id sağlandığında bir uygulama için). Taslak sayfaları da listelemek için --include-unpublished öğesini geçirin.

için İsteğe Bağlı Parametreler model genpage list

--app-id

Model temelli uygulamanın kimliği.

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--include-unpublished

Yayımlanmamış üretken sayfaları listeye ekleyin (varsayılan: yalnızca yayımlandı).

Bu parametre için değer gerekmez. Bu bir anahtar.

pac model genpage list örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage list .

Uygulama kimliğini kullanarak sayfaları listeleme

Contoso Sales Hub uygulamasındaki tüm üretken sayfaları uygulama kimliğini kullanarak listeleyin:

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

Uygulama adını kullanarak sayfaları listeleme

Oluşturan sayfaları uygulama adına göre listeleyin (CLI, uygulama kimliğini otomatik olarak arar):

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

pac model genpage örnek çıktısı

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 remove

Model temelli bir uygulamanın site haritasından mevcut üretken yapay zeka sayfalarını ayırma. Dataverse'deki sayfa satırı korunur (yine de diğer uygulamalardan başvurulabilir).

Için Gerekli Parametreler model genpage remove

--page-id

Kaldırılacak bir veya daha fazla uxagentproject kimliği (virgülle ayrılmış).

için İsteğe Bağlı Parametreler model genpage remove

--app-id

Sayfaları kaldırmak için model temelli uygulama kimliği (uniqueid). --app-name ile birbirini dışlar.

--app-name

Sayfaları kaldırmak için model temelli uygulama benzersiz adı. --app-id ile birbirini dışlar.

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--publish

Değişikliklerin hemen canlı olması için site haritası düzenledikten sonra model temelli uygulamayı yayımlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--solution

Site haritası güncelleştirmesi için Dataverse çözümü benzersiz adı. Varsayılan olarak 'Varsayılan' olarak ayarlanır.

pac model genpage transpile

Test ve hata ayıklama için çalışma zamanı tipleriyle bir TypeScript dosyası aktarır

Için Gerekli Parametreler model genpage transpile

--code-file

Sayfa kodunu içeren dosyanın yolu.

için İsteğe Bağlı Parametreler model genpage transpile

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-file

Çevrilmiş JavaScript çıkışını kaydetme yolu (varsayılan olarak [code-file].compiled.js)

pac model genpage upload

Oluşturulan bir sayfayı Dataverse'e yükleyin ve yayımlayın. --page-id atlandığında yeni bir sayfa oluşturur; , --page-id sağlandığında var olan sayfayı güncelleştirir. Ortamda zaten var olan bir sayfayı yeniden karşıya yüklemeden başka bir uygulamanın site haritasına eklemek için bunun yerine 'pac model genpage add' kullanın.

Için Gerekli Parametreler model genpage upload

--app-id

Model temelli uygulamanın kimliği.

--code-file

Sayfa kodunu içeren dosyanın yolu.

için İsteğe Bağlı Parametreler model genpage upload

--add-to-sitemap

Sayfayı uygulamanın site haritası gezintisine ekleyin.

Bu parametre için değer gerekmez. Bu bir anahtar.

--agent-message

Aracının yanıt iletisi.

--agent-message-file

Aracının yanıt iletisini içeren dosyanın yolu.

--compiled-code-file

Derlenmiş JavaScript kodunu içeren dosyanın yolu. Sağlanmazsa, TypeScript otomatik olarak JavaScript'e çevrilir.

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--model

Sayfayı oluşturmak için kullanılan yapay zeka modeli (örneğin, 'claude-3-5-sonnet-20241022').

--name -n

Sayfanın adı.

--page-id

Güncelleştirilecek sayfanın kimliği. Sağlanmazsa yeni bir sayfa oluşturulur.

--prompt

Bu sayfayı oluşturan kullanıcı istemi.

--prompt-file

Bu sayfayı oluşturan kullanıcı istemini içeren dosyanın yolu.

pac model genpage upload örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage upload .

Yeni bir üretken sayfa yayımlama

Contoso Sales Hub uygulamasında yeni bir üretken sayfa yayımlayın ve bunu uygulama site haritasına ekleyin:

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

Var olan bir üretken sayfayı güncelleştirme

Var olan bir üretken sayfayı, sayfa kimliğini sağlayarak güncelleştirin (yinelenen site haritası girdisi oluşturmaktan kaçınmak için atla --add-to-sitemap ):

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

Sahte veri kullanan bir sayfa yayımlama

Sahte veri kullanan bir sayfa yayımlama (Dataverse tablosu yok — atlayın --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

--app-id parametresi, uygulamanın GUID'sini veya görünen adını kabul eder. Birden çok uygulama aynı görünen adı paylaşıyorsa, belirsizliği önlemek için GUID'yi kullanın. Uygulama kimliklerini aramak için komutunu çalıştırın pac model list .

pac model genpage upload parametre hızlı başvurusu

Parametre Zorunlu Description
--app-id Evet Uygulama GUID'i veya görünen ad. Bulmak için çalıştırın pac model list .
--code-file Evet Dağıtılacak .tsx kaynak dosyanın yolu.
--name Yalnızca yeni sayfalar Uygulama site haritasında gösterilen görünen ad.
--page-id Yalnızca güncelleştirmeler Değiştirilmek üzere var olan sayfanın GUID'i.
--data-sources Dataverse sayfaları Dataverse tablosu mantıksal adlarının virgülle ayrılmış listesi (örneğin, "account,contact").
--prompt Recommended Sayfanın ne yaptığının doğal dil özeti. Yeniden oluşturma bağlamı için depolanır.
--model Recommended Sayfayı oluşturmak için kullanılan model kimliği (örneğin, claude-sonnet-4-6).
--agent-message Recommended Oluşturulan veya değiştirilenlerin açıklaması. Değişiklik geçmişi olarak depolanır.
--add-to-sitemap Yalnızca yeni sayfalar Sayfayı uygulama gezintisine otomatik olarak ekler. Güncelleştirme sırasında atla.

pac model list

Ortamdaki tüm model tabanlı uygulamaları listeler.

için İsteğe Bağlı Parametreler model list

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac model list örneği

Şu anda etkin olan ortamdaki tüm model temelli uygulamaları listeleyin:

pac model list

Örnek çıkış:

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

Listler, Dataverse ortamında dilleri etkinleştirdi.

için İsteğe Bağlı Parametreler model list-languages

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac model list-tables

Bağlı ortamda Dataverse tablolarını listeleyin.

için İsteğe Bağlı Parametreler model list-tables

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--search -s

Virgülle ayrılmış aranan isim listesi (mantıksal isim, şema adı veya gösterim adı ile eşleşir).

--type -t

Tablo tipine göre filtreleyin: 'custom', 'standard' veya 'all' (varsayılan: all).

Ayrıca bakınız

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış

  • Last updated on