Udostępnij za pośrednictwem

pac model

(Wersja zapoznawcza) Polecenia do pracy z aplikacjami opartymi na modelu.

Commands

Command Description
pac model create (Wersja zapoznawcza) Tworzy nową aplikację opartą na modelu.
pac model genpage download (Wersja zapoznawcza) Ściąganie wygenerowanych stron z aplikacji opartej na modelu.
pac model genpage generate-types (Wersja zapoznawcza) Generuje definicje schematu Języka TypeScript dla źródeł danych
pac model genpage list (Wersja zapoznawcza) Wyświetla listę wszystkich wygenerowanych stron w określonej aplikacji opartej na modelu.
pac model genpage transpile (Wersja zapoznawcza) Transpiluje plik TypeScript z typami środowiska uruchomieniowego na potrzeby testowania i debugowania
pac model genpage upload (Wersja zapoznawcza) Przekazywanie i publikowanie wygenerowanej strony w aplikacji opartej na modelu.
pac model list (Wersja zapoznawcza) Wyświetla listę wszystkich aplikacji opartych na modelu w środowisku.
pac model list-languages (Wersja zapoznawcza) Wyświetla listę języków z obsługą w środowisku Dataverse.

pac model create

(Wersja zapoznawcza) Tworzy nową aplikację opartą na modelu.

Wymagane parametry dla model create

--name -n

Nazwa wyświetlana nowej aplikacji opartej na modelu.

Parametry opcjonalne dla model create

--description -d

Opis nowej aplikacji opartej na modelu.

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--publish

Opublikuj aplikację po utworzeniu.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--solution

Unikatowa nazwa rozwiązania do dodania aplikacji. Domyślnie jest to aktywne rozwiązanie.

przykłady pac model create

W poniższych przykładach pokazano typowe sposoby użycia pac model create polecenia .

Tworzenie nowej aplikacji opartej na modelu w aktywnym środowisku

pac model create --name "Contoso Sales Hub"

Tworzenie aplikacji z opisem i dodawanie jej do rozwiązania, a następnie natychmiastowe publikowanie

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

Tworzenie aplikacji w określonym środowisku przez podanie adresu URL środowiska

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

Wskazówka

Użyj pac model list polecenia , aby sprawdzić, czy aplikacja została utworzona i pobrać jej identyfikator aplikacji do użycia z innymi poleceniami, takimi jak pac model genpage upload.

pac model genpage download

(Wersja zapoznawcza) Ściąganie wygenerowanych stron z aplikacji opartej na modelu.

Wymagane parametry dla model genpage download

--app-id

Identyfikator aplikacji opartej na modelu.

Parametry opcjonalne dla model genpage download

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-directory -o

Katalog do zapisywania ściągniętych stron. Domyślnie jest to bieżący katalog.

--page-id

Rozdzielona przecinkami lista identyfikatorów stron do ściągnięcia.

przykłady pac model genpage download

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage download polecenia .

Pobieranie pojedynczej strony generowania według identyfikatora strony do folderu lokalnego do edycji

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

Pobieranie wszystkich stron generujących w aplikacji jednocześnie

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

Utwórz podkatalog o nazwie po identyfikatorze strony i zapisuje następujące pliki

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

(Wersja zapoznawcza) Generuje definicje schematu Języka TypeScript dla źródeł danych

Wymagane parametry dla model genpage generate-types

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

Parametry opcjonalne dla model genpage generate-types

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-file -o

Ścieżka do zapisania wygenerowanego pliku schematu TypeScript (wartość domyślna to RuntimeTypes.ts)

przykłady pac model genpage generate-types

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage generate-types polecenia .

Generowanie typów TypeScript

Generuj account typy TypeScript dla tabel i i contact i i zapisuj je w pliku ./src/RuntimeTypes.ts:

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

Generowanie typów dla pojedynczej tabeli w określonym katalogu wyjściowym

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

Uwaga / Notatka

Zawsze uruchamiaj generate-types przed napisaniem kodu strony, który wysyła zapytania do tabel usługi Dataverse. Wygenerowany plik zawiera silnie typizowane nazwy kolumn, pola klucza obcego i wartości wyliczenia dla każdej tabeli. Poleganie na wygenerowanych typach uniemożliwia błędy środowiska uruchomieniowego spowodowane błędami pisowni lub nieistniejącą nazwami kolumn.

pac model genpage list

(Wersja zapoznawcza) Wyświetla listę wszystkich wygenerowanych stron w określonej aplikacji opartej na modelu.

Wymagane parametry dla model genpage list

--app-id

Identyfikator aplikacji opartej na modelu.

Parametry opcjonalne dla model genpage list

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

przykłady pac model genpage list

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage list polecenia .

Wyświetlanie listy stron przy użyciu identyfikatora aplikacji

Wyświetl listę wszystkich stron generujących w aplikacji Contoso Sales Hub przy użyciu jej identyfikatora aplikacji:

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

Wyświetlanie listy stron przy użyciu nazwy aplikacji

Wyświetl strony generowania według nazwy aplikacji (interfejs wiersza polecenia automatycznie wyszukuje identyfikator aplikacji):

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

pac model Dane wyjściowe przykładu usługi 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

(Wersja zapoznawcza) Transpiluje plik TypeScript z typami środowiska uruchomieniowego na potrzeby testowania i debugowania

Wymagane parametry dla model genpage transpile

--code-file

Ścieżka do pliku zawierającego kod strony.

Parametry opcjonalne dla model genpage transpile

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-file

Ścieżka do zapisania transpilowanych danych wyjściowych języka JavaScript (domyślnie na [code-file].compiled.js)

pac model genpage upload

(Wersja zapoznawcza) Przekazywanie i publikowanie wygenerowanej strony w aplikacji opartej na modelu.

Wymagane parametry dla model genpage upload

--app-id

Identyfikator aplikacji opartej na modelu.

--code-file

Ścieżka do pliku zawierającego kod strony.

Parametry opcjonalne dla model genpage upload

--add-to-sitemap

Dodaj stronę do nawigacji mapy witryny aplikacji.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--agent-message

Komunikat odpowiedzi agenta.

--agent-message-file

Ścieżka do pliku zawierającego komunikat odpowiedzi agenta.

--compiled-code-file

Ścieżka do pliku zawierającego skompilowany kod JavaScript. Jeśli nie zostanie podany, język TypeScript zostanie automatycznie transpilowany do języka JavaScript.

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--model

Model AI używany do generowania strony (np. "claude-3-5-sonnet-20241022").

--name -n

Nazwa strony.

--page-id

Identyfikator strony do zaktualizowania. Jeśli nie zostanie podana, zostanie utworzona nowa strona.

--prompt

Monit użytkownika, który wygenerował tę stronę.

--prompt-file

Ścieżka do pliku zawierającego monit użytkownika, który wygenerował tę stronę.

przykłady pac model genpage upload

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage upload polecenia .

Publikowanie nowej strony generowania

Opublikuj nową stronę generowania w aplikacji Contoso Sales Hub i dodaj ją do mapy witryny aplikacji:

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

Aktualizowanie istniejącej strony generowania

Zaktualizuj istniejącą stronę generowania, podając jej identyfikator strony (pomijaj --add-to-sitemap , aby uniknąć tworzenia zduplikowanego wpisu mapy witryny):

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

Publikowanie strony korzystającej z pozornych danych

Publikowanie strony korzystającej z pozornych danych (bez tabel Usługi Dataverse — pomijanie --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

Wskazówka

Parametr --app-id akceptuje identyfikator GUID aplikacji lub jego nazwę wyświetlaną. Jeśli wiele aplikacji ma taką samą nazwę wyświetlaną, użyj identyfikatora GUID, aby uniknąć niejednoznaczności. Uruchom polecenie pac model list , aby wyszukać identyfikatory aplikacji.

pac model genpage upload krótki przewodnik dotyczący parametrów

Parametr Required Description
--app-id Yes Identyfikator GUID aplikacji lub nazwa wyświetlana. Uruchom polecenie pac model list , aby go znaleźć.
--code-file Yes Ścieżka do pliku źródłowego .tsx do wdrożenia.
--name Tylko nowe strony Nazwa wyświetlana wyświetlana na mapie witryny aplikacji.
--page-id Tylko aktualizacje Identyfikator GUID istniejącej strony do zastąpienia.
--data-sources Strony usługi Dataverse Rozdzielona przecinkami lista nazw logicznych tabeli Dataverse (na przykład "account,contact").
--prompt Zalecane Podsumowanie języka naturalnego tego, co robi strona. Przechowywane w kontekście rewitalizacji.
--model Zalecane Identyfikator modelu używany do generowania strony (na przykład claude-sonnet-4-6).
--agent-message Zalecane Opis tego, co zostało skompilowane lub zmienione. Przechowywane jako historia zmian.
--add-to-sitemap Tylko nowe strony Automatycznie dodaje stronę do nawigacji aplikacji. Pomiń podczas aktualizowania.

pac model list

(Wersja zapoznawcza) Wyświetla listę wszystkich aplikacji opartych na modelu w środowisku.

Parametry opcjonalne dla model list

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac model list przykład

Wyświetl listę wszystkich aplikacji opartych na modelu w aktualnie aktywnym środowisku:

pac model list

Przykładowe dane wyjściowe:

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

(Wersja zapoznawcza) Wyświetla listę języków z obsługą w środowisku Dataverse.

Parametry opcjonalne dla model list-languages

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform

  • Last updated on