az prototype

Uwaga / Notatka

Ta dokumentacja jest częścią prototypowego rozszerzenia interfejsu wiersza polecenia platformy Azure (wersja 2.50.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az prototype . Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Szybko twórz prototypy platformy Azure przy użyciu zespołów agentów opartych na sztucznej inteligencji.

Rozszerzenie az prototype umożliwia tworzenie funkcjonalnych prototypów platformy Azure przy użyciu inteligentnych zespołów agentów obsługiwanych przez narzędzie GitHub Copilot lub Azure OpenAI.

Przepływ pracy: inicjowanie projektu → → kompilacji → wdrażanie

Każdy etap może być uruchamiany niezależnie (z osłonami wymagań wstępnych), a większość etapów jest ponownie biorących udział w projekcie — możesz powrócić do uściślinia projektu lub ponownego kompilowania określonych składników.

Polecenia analizy umożliwiają diagnozowanie błędów i szacowanie kosztów w dowolnym momencie.

Polecenia

Nazwa	Opis	Typ	Stan
az prototype agent	Zarządzanie agentami sztucznej inteligencji na potrzeby generowania prototypów.	Extension	Preview
az prototype agent add	Dodaj agenta niestandardowego do projektu.	Extension	Preview
az prototype agent export	Wyeksportuj dowolnego agenta (w tym wbudowanego) jako plik YAML.	Extension	Preview
az prototype agent list	Wyświetl listę wszystkich dostępnych agentów (wbudowanych i niestandardowych).	Extension	Preview
az prototype agent override	Zastąpić wbudowanego agenta z definicją niestandardową.	Extension	Preview
az prototype agent remove	Usuń agenta niestandardowego lub przesłonięć.	Extension	Preview
az prototype agent show	Pokaż szczegóły określonego agenta.	Extension	Preview
az prototype agent test	Wyślij monit testowy do dowolnego agenta i wyświetl odpowiedź.	Extension	Preview
az prototype agent update	Zaktualizuj właściwości istniejącego agenta niestandardowego.	Extension	Preview
az prototype analyze	Analizowanie błędów, kosztów i diagnostyki prototypu.	Extension	Preview
az prototype analyze costs	Szacowanie kosztów platformy Azure w rozmiarach małych/średnich/dużych t-shirtów.	Extension	Preview
az prototype analyze error	Przeanalizuj błąd i uzyskaj poprawkę z instrukcjami ponownego wdrażania.	Extension	Preview
az prototype build	Generowanie infrastruktury i kodu aplikacji w przygotowanych danych wyjściowych.	Extension	Preview
az prototype config	Zarządzanie konfiguracją projektu prototypu.	Extension	Preview
az prototype config get	Pobierz pojedynczą wartość konfiguracji.	Extension	Preview
az prototype config init	Konfiguracja interaktywna w celu utworzenia pliku konfiguracji prototype.yaml.	Extension	Preview
az prototype config set	Ustaw wartość konfiguracji.	Extension	Preview
az prototype config show	Wyświetl bieżącą konfigurację projektu.	Extension	Preview
az prototype deploy	Wdrażanie prototypu na platformie Azure przy użyciu interaktywnych wdrożeń etapowych.	Extension	Preview
az prototype design	Analizowanie wymagań i generowanie projektu architektury.	Extension	Preview
az prototype generate	Generowanie dokumentacji i artefaktów zestawu specyfikacji.	Extension	Preview
az prototype generate backlog	Generowanie listy prac i wypychanie elementów roboczych do usługi GitHub lub Azure DevOps.	Extension	Preview
az prototype generate docs	Generowanie dokumentacji na podstawie szablonów przy użyciu populacji sztucznej inteligencji.	Extension	Preview
az prototype generate speckit	Wygeneruj pakiet dokumentacji zestawu specyfikacji przy użyciu populacji sztucznej inteligencji.	Extension	Preview
az prototype init	Zainicjuj nowy projekt prototypowy.	Extension	Preview
az prototype knowledge	Zarządzanie współtworzeniami bazy wiedzy.	Extension	Preview
az prototype knowledge contribute	Prześlij wkład bazy wiedzy jako problem z usługą GitHub.	Extension	Preview
az prototype status	Pokaż bieżący stan projektu we wszystkich etapach.	Extension	Preview

az prototype build

Prapremiera

Grupa poleceń "prototyp" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Generowanie infrastruktury i kodu aplikacji w przygotowanych danych wyjściowych.

Używa projektu architektury do generowania modułów Terraform/Bicep, kodu aplikacji, skryptów bazy danych i dokumentacji.

Interakcyjne domyślnie — sesja kompilacji używa monitów inspirowanych przez kod Claude'a, wskaźników postępu, wymuszania zasad i pętli przeglądu konwersacyjnego.

Wszystkie dane wyjściowe są zorganizowane w szczegółowe, uporządkowane według zależności etapy wdrażania. Każdy składnik infrastruktury, system bazy danych i aplikacja pobiera własny etap. Szablony obciążeń są używane jako opcjonalne punkty początkowe, gdy są zgodne z projektem.

Po wygenerowaniu raport kompilacji pokazuje, co zostało skompilowane i możesz przekazać opinię w celu ponownego wygenerowania określonych etapów. Wpisz "gotowe", aby zaakceptować kompilację.

Polecenia Slash podczas kompilacji: /status — Pokaż podsumowanie ukończenia etapu /stages — Pokaż pełny plan wdrożenia /files — Wyświetlanie wszystkich wygenerowanych plików /policy — Pokaż podsumowanie sprawdzania zasad /help — Pokaż dostępne polecenia

Użyj --dry-run dla nieinterakcyjnej wersji zapoznawczej.

az prototype build [--auto-accept]
                   [--dry-run]
                   [--reset]
                   [--scope {all, apps, db, docs, infra}]
                   [--status]

Przykłady

Interaktywna sesja kompilacji (domyślna)

az prototype build

Pokaż bieżący postęp kompilacji

az prototype build --status

Wyczyść stan kompilacji i rozpocznij od nowa

az prototype build --reset

Kompilowanie tylko kodu infrastruktury

az prototype build --scope infra

Wyświetlanie podglądu wygenerowanych danych

az prototype build --scope all --dry-run

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--auto-accept

Automatycznie zaakceptuj domyślne zalecenie dotyczące naruszeń zasad i konfliktów standardów.

Własność	Wartość
Wartość domyślna:	False

--dry-run

Wyświetl podgląd wygenerowanych plików bez zapisywania plików.

Własność	Wartość
Wartość domyślna:	False

--reset

Wyczyść istniejący stan kompilacji i rozpocznij od nowa.

Własność	Wartość
Wartość domyślna:	False

--scope

Co należy skompilować.

Własność	Wartość
Wartość domyślna:	all
Akceptowane wartości:	all, apps, db, docs, infra

--status -s

Pokaż bieżący postęp kompilacji bez uruchamiania sesji.

Własność	Wartość
Wartość domyślna:	False

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

az prototype deploy

Prapremiera

Grupa poleceń "prototyp" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wdrażanie prototypu na platformie Azure przy użyciu interaktywnych wdrożeń etapowych.

Interakcyjne domyślnie — uruchamia testy wstępne (subskrypcja, narzędzie IaC, grupa zasobów, dostawcy zasobów), a następnie wdraża etapy sekwencyjnie z śledzeniem postępu i routingiem błędów pierwszej kontroli jakości.

Po wdrożeniu wprowadza pętlę konwersacyjną, w której można sprawdzać stan, wycofywanie, ponowne wdrażanie lub podgląd zmian przy użyciu poleceń ukośnika.

Polecenia ukośnika podczas wdrażania: /status — Pokaż podsumowanie ukończenia etapu /stages — Pokaż podział pełnego etapu (alias /status) /deploy N — Wdrażanie określonego etapu (lub "wszystkie" dla oczekujących) /rollback N — Wycofywanie określonego etapu (lub "wszystko" w odwrotna kolejność) /redeploy N - Roll back and reploy a stage /plan N - What-if / terraform plan for a stage /outputs - Show captured deployment outputs /preflight - Re-run preflight checks /help - Show available commands (Pokaż dostępne polecenia)

Użyj polecenia --dry-run w przypadku nieinterakcyjnej wersji zapoznawczej planu what-if/terraform. Użyj --stage N dla nieinterakcyjnego wdrożenia jednoetapowego. Użyj --stage N --dry-run w celu wyświetlenia podglądu warunkowego pojedynczego etapu. Użyj --outputs, aby wyświetlić przechwycone dane wyjściowe wdrożenia. Użyj --rollback-info, aby wyświetlić instrukcje wycofywania. Użyj --generate-scripts, aby wygenerować deploy.sh dla katalogów aplikacji.

az prototype deploy [--client-id]
                    [--client-secret]
                    [--dry-run]
                    [--force]
                    [--generate-scripts]
                    [--outputs]
                    [--reset]
                    [--rollback-info]
                    [--script-registry]
                    [--script-resource-group]
                    [--script-type {container_app, function, webapp}]
                    [--service-principal]
                    [--stage]
                    [--status]
                    [--tenant]
                    [--tenant-id]

Przykłady

Interaktywna sesja wdrażania (domyślna)

az prototype deploy

Pokaż bieżący postęp wdrażania

az prototype deploy --status

Wyświetl podgląd wszystkich etapów (co-jeżeli / plan terraform)

az prototype deploy --dry-run

Wdrażanie tylko etapu 2

az prototype deploy --stage 2

Wymuś pełne ponowne wdrożenie

az prototype deploy --force

Pokaż przechwycone dane wyjściowe wdrożenia

az prototype deploy --outputs

Pokaż instrukcje wycofywania

az prototype deploy --rollback-info

Generowanie skryptów wdrażania usługi App Service

az prototype deploy --generate-scripts --script-type webapp

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--client-id

Aplikacja główna usługi/identyfikator klienta (lub ustawiona za pomocą konfiguracji).

--client-secret

Wpis tajny klienta jednostki usługi (lub ustawiany za pośrednictwem konfiguracji).

--dry-run

Wyświetl podgląd wdrożonych elementów (co-jeżeli dla Bicep, plan narzędzia Terraform).

Własność	Wartość
Wartość domyślna:	False

--force

Wymuś pełne wdrożenie, ignorując śledzenie zmian.

Własność	Wartość
Wartość domyślna:	False

--generate-scripts

Generowanie skryptów deploy.sh dla katalogów aplikacji.

Własność	Wartość
Wartość domyślna:	False

--outputs

Pokaż przechwycone dane wyjściowe wdrożenia z narzędzia Terraform/Bicep.

Własność	Wartość
Wartość domyślna:	False

--reset

Wyczyść stan wdrożenia i rozpocznij od nowa.

Własność	Wartość
Wartość domyślna:	False

--rollback-info

Pokaż instrukcje wycofywania na podstawie historii wdrożenia.

Własność	Wartość
Wartość domyślna:	False

--script-registry

Adres URL rejestru kontenerów dla skryptów --generate-script (typ container_app).

--script-resource-group

Domyślna nazwa grupy zasobów dla skryptów --generate-scripts.

--script-type

Typ docelowy wdrożenia platformy Azure dla skryptów --generate-scripts.

Własność	Wartość
Wartość domyślna:	webapp
Akceptowane wartości:	container_app, function, webapp

--service-principal

Uwierzytelnianie przy użyciu jednostki usługi przed wdrożeniem.

Własność	Wartość
Wartość domyślna:	False

--stage

Wdróż tylko określony numer etapu (użyj --status, aby wyświetlić etapy).

--status -s

Pokaż bieżący postęp wdrażania bez uruchamiania sesji.

Własność	Wartość
Wartość domyślna:	False

--tenant

Identyfikator dzierżawy usługi Azure AD dla wdrożenia między dzierżawami.

--tenant-id

Identyfikator dzierżawy na potrzeby uwierzytelniania jednostki usługi (lub ustawiany za pomocą konfiguracji).

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

az prototype design

Prapremiera

Grupa poleceń "prototyp" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Analizowanie wymagań i generowanie projektu architektury.

Odczytuje artefakty (dokumenty, diagramy, specyfikacje), angażuje agenta biz-analyst w celu zidentyfikowania luk i generuje dokumentację architektury.

Po uruchomieniu bez parametrów rozpoczyna się interakcyjny dialog w celu przechwytywania wymagań za pomocą pytań z przewodnikiem.

W przypadku funkcji --interactive wprowadza pętlę uściślinia po wygenerowaniu architektury, aby można było przejrzeć projekt i zażądać zmian.

Agent biz-analyst jest zawsze zaangażowany — nawet w przypadku podania --context — w celu sprawdzenia brakujących wymagań i niestatysowanych założeń.

Ten etap jest ponownie uczestnikiem — uruchom go ponownie, aby udoskonalić projekt.

az prototype design [--artifacts]
                    [--context]
                    [--interactive]
                    [--reset]
                    [--skip-discovery]
                    [--status]

Przykłady

Interaktywna sesja projektowania (dialog z przewodnikiem)

az prototype design

Interaktywny projekt z pętlą uściślenia architektury

az prototype design --interactive

Projektowanie z katalogu artefaktów

az prototype design --artifacts ./requirements/

Dodawanie kontekstu do istniejącego projektu

az prototype design --context "Add Redis caching layer"

Resetowanie i rozpoczynanie projektowania od nowa

az prototype design --reset

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--artifacts

Ścieżka do katalogu zawierającego dokumenty wymagań, diagramy lub inne artefakty.

--context

Dodatkowy kontekst lub wymagania jako dowolny tekst.

--interactive -i

Wprowadź interakcyjną pętlę uściślinia po wygenerowaniu architektury.

Własność	Wartość
Wartość domyślna:	False

--reset

Zresetuj stan projektu i rozpocznij od nowa.

Własność	Wartość
Wartość domyślna:	False

--skip-discovery

Pomiń konwersację odnajdywania i wygeneruj architekturę bezpośrednio z istniejącego stanu odnajdywania.

Własność	Wartość
Wartość domyślna:	False

--status -s

Pokaż bieżący stan odnajdywania (otwarte elementy, potwierdzone elementy) bez uruchamiania sesji.

Własność	Wartość
Wartość domyślna:	False

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

az prototype init

Prapremiera

Grupa poleceń "prototyp" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zainicjuj nowy projekt prototypowy.

Konfiguruje tworzenie szkieletu projektu, tworzy plik konfiguracji projektu i opcjonalnie uwierzytelnia się w usłudze GitHub (weryfikuje licencję Copilot).

Uwierzytelnianie w usłudze GitHub jest wymagane tylko dla dostawców sztucznej inteligencji narzędzia github i github-models. W przypadku korzystania z usługi azure-openai uwierzytelnianie usługi GitHub jest całkowicie pomijane.

Jeśli katalog docelowy zawiera już plik prototype.yaml, polecenie wyświetli wiersz polecenia przed zastąpieniem.

az prototype init [--ai-provider {azure-openai, copilot, github-models}]
                  [--environment {dev, prod, staging}]
                  [--iac-tool {bicep, terraform}]
                  [--location]
                  [--model]
                  [--name]
                  [--output-dir]
                  [--template]

Przykłady

Tworzenie nowego projektu prototypu

az prototype init --name my-prototype --location eastus

Inicjowanie przy użyciu preferencji Bicep

az prototype init --name my-app --location westus2 --iac-tool bicep

Korzystanie z usługi Azure OpenAI (pomija uwierzytelnianie w usłudze GitHub)

az prototype init --name my-app --location eastus --ai-provider azure-openai

Określanie środowiska i modelu

az prototype init --name my-app --location eastus --environment staging --model gpt-4o

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--ai-provider

Dostawca sztucznej inteligencji na potrzeby interakcji z agentem.

Własność	Wartość
Wartość domyślna:	copilot
Akceptowane wartości:	azure-openai, copilot, github-models

--environment

Środowisko docelowe prototypu.

Własność	Wartość
Wartość domyślna:	dev
Akceptowane wartości:	dev, prod, staging

--iac-tool

Preferencje narzędzia infrastruktura jako kod.

Własność	Wartość
Wartość domyślna:	terraform
Akceptowane wartości:	bicep, terraform

--location -l

Region świadczenia usługi Azure na potrzeby wdrażania zasobów (np. eastus).

--model

Model sztucznej inteligencji do użycia (domyślnie: claude-sonnet-4.5 dla copilot, gpt-4o dla innych).

--name

Nazwa prototypowego projektu.

--output-dir

Katalog wyjściowy dla plików projektu.

Własność	Wartość
Wartość domyślna:	.

--template

Szablon projektu do użycia (np. aplikacja internetowa, potok danych, ai-app).

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

az prototype status

Prapremiera

Grupa poleceń "prototyp" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pokaż bieżący stan projektu we wszystkich etapach.

Przedstawia podsumowanie prototypowego projektu, w tym konfigurację, postęp etapu (projekt, kompilacja, wdrażanie) i oczekujące zmiany.

Domyślnie jest wyświetlane podsumowanie czytelne dla człowieka. Użyj --json do odczytu maszynowego danych wyjściowych odpowiednich do obsługi skryptów. Użyj --szczegółowe dla rozszerzonych szczegółów poszczególnych etapów.

az prototype status [--detailed]
                    [--json]

Przykłady

Pokaż stan projektu

az prototype status

Pokaż szczegółowy stan z podziałem na etapy

az prototype status --detailed

Pobieranie danych wyjściowych JSON z możliwością odczytu maszyny

az prototype status --json

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--detailed -d

Pokaż rozwinięte szczegóły poszczególnych etapów.

Własność	Wartość
Wartość domyślna:	False

--json -j

Dane wyjściowe z możliwością odczytu maszynowego JSON zamiast sformatowanego wyświetlacza.

Własność	Wartość
Wartość domyślna:	False

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność	Wartość
Wartość domyślna:	False