pac model

Polecenia do pracy z aplikacjami opartymi na modelach.

Commands

Polecenie Description
pac model create Tworzy nową aplikację opartą na modelach.
pac model genpage add Dołącz co najmniej jedną istniejącą stronę generowania do mapy witryny aplikacji opartej na modelu (bez ponownego przekazywania). Użyj ciągu "pac model genpage upload", aby utworzyć lub zaktualizować samą stronę. Użyj tego zlecenia, aby wyświetlić już przekazaną stronę w innej aplikacji.
pac model genpage download Pobieraj wygenerowane strony z aplikacji opartej na modelach.
pac model genpage generate-types Generuje definicje schematów TypeScript dla źródeł danych
pac model genpage get-connector-schema Pobiera schemat kolumn tabeli łącznika lub schemat operacji REST dla wygenerowanych stron.
pac model genpage list Wyświetl wygenerowane strony — domyślnie dla całej aplikacji lub dla jednej aplikacji, gdy jest dostarczany parametr --app-id. Przekaż --include-unpublished, aby również wyświetlić listę stron roboczych.
pac model genpage list-connector-operations Wyświetla listę operacji REST łącznika dla wygenerowanych stron.
pac model genpage list-connector-tables Wyświetla tabele łączników dla wygenerowanych stron.
pac model genpage remove Odłącz istniejące strony generowania sztucznej inteligencji od mapy witryny aplikacji opartej na modelu. Wiersz strony w usłudze Dataverse jest zachowywany (może być nadal przywoływany z innych aplikacji).
pac model genpage transpile Transpiluje plik TypeScript z typami w czasie wykonywania do testowania i debugowania
pac model genpage upload Przekaż wygenerowaną stronę do usługi Dataverse i opublikuj ją. Tworzy nową stronę po pominięciu --page-id; aktualizuje istniejącą stronę po podaniu parametru --page-id. Aby dołączyć stronę, która już istnieje w środowisku do mapy witryny innej aplikacji bez ponownego przekazywania, użyj polecenia "pac model genpage add".
pac model list Lista wszystkich aplikacji opartych na modelu w środowisku.
pac model list-languages Lista języków włączonych w środowisku Dataverse.
pac model list-tables Lista tabel Dataverse w środowisku połączonym.

pac model create

Tworzy nową aplikację opartą na modelach.

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. Wartość domyślna to "Default", jeśli nie zostanie określona.

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 add

Dołącz co najmniej jedną istniejącą stronę generowania do mapy witryny aplikacji opartej na modelu (bez ponownego przekazywania). Użyj ciągu "pac model genpage upload", aby utworzyć lub zaktualizować samą stronę. Użyj tego zlecenia, aby wyświetlić już przekazaną stronę w innej aplikacji.

Wymagane parametry dla model genpage add

--page-id

Identyfikatory stron generacyjnych rozdzielonych przecinkami (IDENTYFIKATORy GUID), które mają zostać dodane do aplikacji.

Parametry opcjonalne dla model genpage add

--app-id

Identyfikator aplikacji opartej na modelu (GUID). Wzajemnie wykluczające się z --app-name.

--app-name

Unikatowa nazwa aplikacji opartej na modelu. Wzajemnie wyklucza się z --app-id.

--area

Opcjonalny identyfikator obszaru na mapie witryny, aby umieścić stronę w obszarze. Domyślnie jest to pierwszy obszar.

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

--group

Opcjonalny identyfikator grupy na mapie witryny, aby umieścić stronę w obszarze. Domyślnie jest to pierwsza grupa wybranego obszaru.

--language-code

Kod języka (LCID) dla tytułu SubArea. Wartość domyślna to 1033 (en-US).

--publish

Opublikuj aplikację opartą na modelu po dodaniu stron.

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

--solution

Unikatowa nazwa kontekstu rozwiązania Dataverse dla aktualizacji mapy witryny. Wartość domyślna to "Default".

pac model genpage download

Pobieraj wygenerowane strony z aplikacji opartej na modelach.

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

Generuje definicje schematów 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

Note

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 get-connector-schema

Pobiera schemat kolumn tabeli łącznika lub schemat operacji REST dla wygenerowanych stron.

Wymagane parametry dla model genpage get-connector-schema

--connection-id

Identyfikator połączenia do użycia na potrzeby odnajdywania metadanych łącznika.

--connector-id

Identyfikator interfejsu API łącznika (na przykład /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

Parametry opcjonalne dla model genpage get-connector-schema

--dataset

Identyfikator zestawu danych dla odnajdywania łącznika tabelarycznego (na przykład adres URL witryny SharePoint lub serwer/baza danych SQL). Wymagane z --table.

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

--operation

Identyfikator operacji REST dla trybu schematu operacji. Nie można używać z parametrem --dataset lub --table.

--table

Identyfikator tabeli dla trybu schematu tabelarycznego. Wymaga parametru --dataset i nie można go używać z parametrem --operation.

pac model genpage list

Wyświetl wygenerowane strony — domyślnie dla całej aplikacji lub dla jednej aplikacji, gdy jest dostarczany parametr --app-id. Przekaż --include-unpublished, aby również wyświetlić listę stron roboczych.

Parametry opcjonalne dla model genpage list

--app-id

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

--include-unpublished

Uwzględnij nieopublikowane strony generowania na liście (ustawienie domyślne: tylko opublikowane).

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

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 list-connector-operations

Wyświetla listę operacji REST łącznika dla wygenerowanych stron.

Wymagane parametry dla model genpage list-connector-operations

--connection-id

Identyfikator połączenia do użycia na potrzeby odnajdywania metadanych łącznika.

--connector-id

Identyfikator interfejsu API łącznika (na przykład /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

Parametry opcjonalne dla model genpage list-connector-operations

--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 genpage list-connector-tables

Wyświetla tabele łączników dla wygenerowanych stron.

Wymagane parametry dla model genpage list-connector-tables

--connection-id

Identyfikator połączenia do użycia na potrzeby odnajdywania metadanych łącznika.

--connector-id

Identyfikator interfejsu API łącznika (na przykład /providers/Microsoft. PowerApps/apis/shared_sharepointonline).

Parametry opcjonalne dla model genpage list-connector-tables

--dataset

Identyfikator zestawu danych dla odnajdywania łącznika tabelarycznego (na przykład adres URL witryny SharePoint lub serwer/baza danych SQL). Wymagane z --table.

--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 genpage remove

Odłącz istniejące strony generowania sztucznej inteligencji od mapy witryny aplikacji opartej na modelu. Wiersz strony w usłudze Dataverse jest zachowywany (może być nadal przywoływany z innych aplikacji).

Wymagane parametry dla model genpage remove

--page-id

Co najmniej jeden identyfikator uxagentproject do usunięcia (rozdzielony przecinkami).

Parametry opcjonalne dla model genpage remove

--app-id

Identyfikator aplikacji opartej na modelu (uniqueid) w celu usunięcia stron. Wzajemnie wykluczające się z --app-name.

--app-name

Unikatowa nazwa aplikacji opartej na modelu w celu usunięcia stron. Wzajemnie wyklucza się z --app-id.

--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ę opartą na modelu po edycji mapy witryny, aby zmiany mogły być natychmiast aktywne.

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

--solution

Unikatowa nazwa rozwiązania Dataverse dla aktualizacji mapy witryny. Wartość domyślna to "Default".

pac model genpage transpile

Transpiluje plik TypeScript z typami w czasie wykonywania do 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

Przekaż wygenerowaną stronę do usługi Dataverse i opublikuj ją. Tworzy nową stronę po pominięciu --page-id; aktualizuje istniejącą stronę po podaniu parametru --page-id. Aby dołączyć stronę, która już istnieje w środowisku do mapy witryny innej aplikacji bez ponownego przekazywania, użyj polecenia "pac model genpage add".

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.

--connectors

Ścieżka do pliku JSON z powiązaniami łącznika w celu utrwalonego w config.jsonstrony .

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

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

Przykład: pac model list

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

Lista języków włączonych 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.

pac model list-tables

Lista tabel Dataverse w środowisku połączonym.

Parametry opcjonalne dla model list-tables

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

--search -s

Lista nazw oddzielonych przecinkami do wyszukiwania (odpowiada nazwie logicznej, nazwie schematu lub nazwie wyświetlanej).

--type -t

Filtruj według typu tabeli: 'custom', 'standard' lub 'all' (domyślnie: all).

Zobacz też

Microsoft Power Platform grupy poleceń interfejsu wiersza polecenia
omówienie interfejsu wiersza polecenia Microsoft Power Platform

  • Last updated on