az prototype

Preview

Poznámka:

Tento odkaz je součástí prototypového rozšíření azure CLI (verze 2.50.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az prototype . Přečtěte si další informace o rozšířeních.

Tato skupina příkazů je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Rychlé vytváření prototypů Azure pomocí týmů agentů řízených AI

Rozšíření az prototype vám umožňuje vytvářet funkční prototypy Azure pomocí týmů inteligentních agentů využívajících GitHub Copilot nebo Azure OpenAI.

Pracovní postup: Inicializační → návrh → nasazení → sestavení

Jednotlivé fáze je možné spouštět nezávisle (s požadovanými strážemi) a většina fází je znovu účastníkem – můžete se vrátit k upřesnění návrhu nebo opětovnému sestavení konkrétních komponent.

Příkazy analýzy umožňují kdykoli diagnostikovat chyby a odhadnout náklady.

Příkazy

Name	Description	Typ	Stav
az prototype agent	Správa agentů AI pro generování prototypů	Extension	Preview
az prototype agent add	Přidejte do projektu vlastního agenta.	Extension	Preview
az prototype agent export	Exportujte libovolného agenta (včetně integrovaného) jako soubor YAML.	Extension	Preview
az prototype agent list	Zobrazí seznam všech dostupných agentů (integrovaných a vlastních).	Extension	Preview
az prototype agent override	Přepsání integrovaného agenta vlastní definicí	Extension	Preview
az prototype agent remove	Odeberte vlastního agenta nebo přepište.	Extension	Preview
az prototype agent show	Zobrazení podrobností o konkrétním agentu	Extension	Preview
az prototype agent test	Odešlete testovací výzvu libovolnému agentu a zobrazte odpověď.	Extension	Preview
az prototype agent update	Aktualizujte vlastnosti existujícího vlastního agenta.	Extension	Preview
az prototype analyze	Analyzujte chyby, náklady a diagnostiku prototypu.	Extension	Preview
az prototype analyze costs	Odhad nákladů na Azure na velikosti malých/středních/velkých t-shirt.	Extension	Preview
az prototype analyze error	Analyzujte chybu a získejte opravu s pokyny k opětovnému nasazení.	Extension	Preview
az prototype build	Vygenerujte infrastrukturu a kód aplikace ve fázovaném výstupu.	Extension	Preview
az prototype config	Správa konfigurace prototypu projektu	Extension	Preview
az prototype config get	Získejte jednu hodnotu konfigurace.	Extension	Preview
az prototype config init	Interaktivní nastavení pro vytvoření konfiguračního souboru prototype.yaml	Extension	Preview
az prototype config set	Nastavte hodnotu konfigurace.	Extension	Preview
az prototype config show	Zobrazí aktuální konfiguraci projektu.	Extension	Preview
az prototype deploy	Nasazení prototypu do Azure pomocí interaktivních fázovaných nasazení	Extension	Preview
az prototype design	Analyzujte požadavky a vygenerujte návrh architektury.	Extension	Preview
az prototype generate	Vygenerujte dokumentaci a artefakty sady spec-kit.	Extension	Preview
az prototype generate backlog	Vygenerujte backlog a nasdílení pracovních položek do GitHubu nebo Azure DevOps.	Extension	Preview
az prototype generate docs	Generování dokumentace ze šablon s využitím základního souboru AI	Extension	Preview
az prototype generate speckit	Vygenerujte sadu dokumentace sady spec-kit s využitím základního souboru AI.	Extension	Preview
az prototype init	Inicializace nového prototypového projektu	Extension	Preview
az prototype knowledge	Správa příspěvků znalostní báze	Extension	Preview
az prototype knowledge contribute	Odešlete příspěvek znalostní báze jako problém GitHubu.	Extension	Preview
az prototype launch	Spusťte interaktivní řídicí panel TUI.	Extension	Preview
az prototype status	Umožňuje zobrazit aktuální stav projektu ve všech fázích.	Extension	Preview

az prototype build

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vygenerujte infrastrukturu a kód aplikace ve fázovaném výstupu.

Pomocí návrhu architektury vygeneruje moduly Terraform/Bicep, kód aplikace, databázové skripty a dokumentaci.

Interaktivní ve výchozím nastavení – relace sestavení používá ohraničené výzvy inspirované Claudem Code, indikátory průběhu, vynucení zásad a smyčku konverzační kontroly.

Veškerý výstup je uspořádaný do jemně odstupňovaných fází nasazení seřazených podle závislostí. Každá komponenta infrastruktury, databázový systém a aplikace získávají vlastní fázi. Šablony úloh se používají jako volitelné výchozí body, když odpovídají návrhu.

Po generování sestava sestavení ukazuje, co bylo vytvořeno, a můžete poskytnout zpětnou vazbu k opětovnému generování konkrétních fází. Pokud chcete sestavení přijmout, zadejte hotovo.

Příkazy lomítka během sestavení: /status – Zobrazit souhrn dokončení fáze /stages – Zobrazit úplný plán nasazení /soubory – Výpis všech vygenerovaných souborů /zásad – Zobrazení souhrnu kontroly zásad /nápověda – Zobrazit dostupné příkazy

Použijte --dry-run pro neinteraktivní náhled.

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

Příklady

Interaktivní relace sestavení (výchozí)

az prototype build

Zobrazit aktuální průběh sestavení

az prototype build --status

Vymazat stav sestavení a začít znovu

az prototype build --reset

Sestavení pouze kódu infrastruktury

az prototype build --scope infra

Zobrazení náhledu, co by se vygenerovalo

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--auto-accept

Automaticky přijměte výchozí doporučení pro porušení zásad a konflikty standardů.

Vlastnost	Hodnota
Default value:	False

--dry-run

Náhled toho, co by se vygenerovalo bez zápisu souborů

Vlastnost	Hodnota
Default value:	False

--reset

Vymažte existující stav sestavení a začněte znovu.

Vlastnost	Hodnota
Default value:	False

--scope

Co se má sestavit.

Vlastnost	Hodnota
Default value:	all
Přípustné hodnoty:	all, apps, db, docs, infra

--status -s

Umožňuje zobrazit aktuální průběh sestavení bez spuštění relace.

Vlastnost	Hodnota
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az prototype deploy

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Nasazení prototypu do Azure pomocí interaktivních fázovaných nasazení

Interaktivní ve výchozím nastavení – spouští předběžné kontroly (předplatné, nástroj IaC, skupina prostředků, poskytovatelé prostředků) a pak postupně nasazuje fáze se sledováním průběhu a směrováním chyb první kontroly kvality.

Po nasazení zadá konverzační smyčku, ve které můžete zkontrolovat stav, vrácení zpět, znovu nasadit nebo zobrazit náhled změn pomocí příkazů lomítka.

Příkazy lomítka během nasazení: /status – Zobrazení souhrnu dokončení fáze /stages – Zobrazení rozpisu úplné fáze (alias pro /status) /deploy N – Nasazení konkrétní fáze (nebo "vše" pro čekání) /rollback N – Vrácení zpět konkrétní fáze (nebo "vše" v obráceném směru order) /redeploy N - Vrácení zpět a opětovné nasazení fáze /plan N - What-if / terraform plan for a stage /outputs - Show captured deployment outputs /preflight - Re-run preflight checks /help - Show available commands

Použijte příkaz --dry-run pro neinteraktivní citlivostní /terraform plan preview. Pro neinteraktivní jednofázové nasazení použijte --stage N. Použijte příkaz --stage N --dry-run pro verzi what-if preview jedné fáze. Pomocí --outputs můžete zobrazit zachycené výstupy nasazení. Pomocí funkce --rollback-info zobrazíte pokyny pro vrácení zpět. K vygenerování deploy.sh pro adresáře aplikací použijte --generate-scripts.

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]

Příklady

Interaktivní relace nasazení (výchozí)

az prototype deploy

Zobrazení aktuálního průběhu nasazení

az prototype deploy --status

Náhled všech fází (what-if / terraform plan)

az prototype deploy --dry-run

Nasazení pouze fáze 2

az prototype deploy --stage 2

Vynucení úplného opětovného nasazení

az prototype deploy --force

Zobrazení zachycených výstupů nasazení

az prototype deploy --outputs

Zobrazit pokyny pro vrácení zpět

az prototype deploy --rollback-info

Generování skriptů nasazení služby App Service

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--client-id

Aplikace instančního objektu / ID klienta (nebo nastavené prostřednictvím konfigurace).

--client-secret

Tajný klíč klienta instančního objektu (nebo nastavený prostřednictvím konfigurace).

--dry-run

Preview, co se nasadí (what-if for Bicep, plan for Terraform).

Vlastnost	Hodnota
Default value:	False

--force

Vynuťte úplné nasazení bez ohledu na sledování změn.

Vlastnost	Hodnota
Default value:	False

--generate-scripts

Vygenerujte deploy.sh skripty pro adresáře aplikací.

Vlastnost	Hodnota
Default value:	False

--outputs

Zobrazí zachycené výstupy nasazení z Terraformu / Bicep.

Vlastnost	Hodnota
Default value:	False

--reset

Vymažte stav nasazení a začněte znovu.

Vlastnost	Hodnota
Default value:	False

--rollback-info

Zobrazit pokyny pro vrácení zpět na základě historie nasazení.

Vlastnost	Hodnota
Default value:	False

--script-registry

Adresa URL registru kontejneru pro --generate-scripts (typ container_app).

--script-resource-group

Výchozí název skupiny prostředků pro --generate-scripts

--script-type

Typ cíle nasazení Azure pro --generate-scripts.

Vlastnost	Hodnota
Default value:	webapp
Přípustné hodnoty:	container_app, function, webapp

--service-principal

Před nasazením se ověřte pomocí instančního objektu.

Vlastnost	Hodnota
Default value:	False

--stage

Nasaďte pouze konkrétní číslo fáze (k zobrazení fází použijte parametr --status).

--status -s

Umožňuje zobrazit aktuální průběh nasazení bez spuštění relace.

Vlastnost	Hodnota
Default value:	False

--tenant

ID tenanta Azure AD pro nasazení mezi tenanty

--tenant-id

ID tenanta pro ověřování instančního objektu (nebo nastavené prostřednictvím konfigurace)

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az prototype design

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Analyzujte požadavky a vygenerujte návrh architektury.

Čte artefakty (dokumenty, diagramy, specifikace), zapojuje agenta biz-analytika k identifikaci mezer a generuje dokumentaci k architektuře.

Při spuštění bez parametrů spustí interaktivní dialog pro zachycení požadavků prostřednictvím otázek s asistencí.

V případě --interactive zadáte po generování architektury smyčku upřesnění, abyste mohli zkontrolovat změny návrhu a žádosti.

Agent biz-analytik je vždy zapojen ( i v případě, že je k dispozici --kontext ) ke kontrole chybějících požadavků a nestatovaných předpokladů.

Tato fáze je znovu účastníkem – spusťte ji znovu, aby se návrh zpřesnily.

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

Příklady

Interaktivní relace návrhu (dialog s asistencí)

az prototype design

Interaktivní návrh se smyčkou upřesnění architektury

az prototype design --interactive

Návrh z adresáře artefaktů

az prototype design --artifacts ./requirements/

Přidání kontextu do existujícího návrhu

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

Obnovení a zahájení návrhu

az prototype design --reset

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--artifacts

Cesta k adresáři obsahujícímu dokumenty, diagramy nebo jiné artefakty.

--context

Další kontext nebo požadavky jako volný text

--interactive -i

Po generování architektury zadejte interaktivní smyčku upřesnění.

Vlastnost	Hodnota
Default value:	False

--reset

Resetujte stav návrhu a začněte znovu.

Vlastnost	Hodnota
Default value:	False

--skip-discovery

Přeskočte konverzaci zjišťování a vygenerujte architekturu přímo ze stávajícího stavu zjišťování.

Vlastnost	Hodnota
Default value:	False

--status -s

Umožňuje zobrazit aktuální stav zjišťování (otevřené položky, potvrzené položky) bez spuštění relace.

Vlastnost	Hodnota
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az prototype init

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Inicializace nového prototypového projektu

Nastaví generování uživatelského rozhraní projektu, vytvoří konfigurační soubor projektu a volitelně se ověří pomocí GitHubu (ověří licenci Copilot).

Ověřování GitHubu se vyžaduje jenom pro zprostředkovatele AI copilot a github-models. Při použití azure-openai se ověřování GitHubu úplně přeskočí.

Pokud cílový adresář již obsahuje prototyp.yaml, příkaz před přepsáním zobrazí výzvu.

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

Příklady

Vytvoření nového prototypového projektu

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

Inicializace s předvolbou Bicep

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

Použití Azure OpenAI (přeskočí ověřování GitHubu)

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

Určení prostředí a modelu

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ai-provider

Zprostředkovatel AI pro interakce agentů.

Vlastnost	Hodnota
Default value:	copilot
Přípustné hodnoty:	azure-openai, copilot, github-models

--environment

Cílové prostředí pro prototyp.

Vlastnost	Hodnota
Default value:	dev
Přípustné hodnoty:	dev, prod, staging

--iac-tool

Předvolba nástrojů infrastruktury jako kódu

Vlastnost	Hodnota
Default value:	terraform
Přípustné hodnoty:	bicep, terraform

--location -l

Oblast Azure pro nasazení prostředků (např. eastus).

--model

Model AI, který se má použít (výchozí: claude-sonnet-4.5 pro copilot, gpt-4o pro ostatní).

--name

Název prototypového projektu.

--output-dir

Výstupní adresář pro soubory projektu

Vlastnost	Hodnota
Default value:	.

--template

Project template to use (např. web-app, data-pipeline, ai-app).

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az prototype launch

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Spusťte interaktivní řídicí panel TUI.

Automaticky rozpozná aktuální fázi projektu a spustí příslušnou relaci uvnitř aplikace textového terminálu.

az prototype launch [--stage {build, deploy, design}]

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--stage

Místo automatického zjišťování zahajte tuI v určité fázi.

Vlastnost	Hodnota
Přípustné hodnoty:	build, deploy, design

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az prototype status

Preview

Skupina příkazů prototyp je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Umožňuje zobrazit aktuální stav projektu ve všech fázích.

Zobrazí souhrn prototypového projektu včetně konfigurace, průběhu fáze (návrh, sestavení, nasazení) a čekajících změn.

Ve výchozím nastavení se zobrazuje souhrn, který je čitelný pro člověka. Použijte --json pro strojově čitelný výstup vhodný pro skriptování. Pro rozbalené podrobnosti o jednotlivých fázích použijte --detailed.

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

Příklady

Zobrazit stav projektu

az prototype status

Zobrazení podrobného stavu s rozpisem jednotlivých fází

az prototype status --detailed

Získání strojově čitelného výstupu JSON

az prototype status --json

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--detailed -d

Umožňuje zobrazit rozbalené podrobnosti o jednotlivých fázích.

Vlastnost	Hodnota
Default value:	False

--json -j

Výstupní strojově čitelný JSON místo formátovaného zobrazení.

Vlastnost	Hodnota
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

az prototype

Příkazy

az prototype build

Příklady

Volitelné parametry

az prototype deploy

Příklady

Volitelné parametry

az prototype design

Příklady

Volitelné parametry

az prototype init

Příklady

Volitelné parametry

az prototype launch

Volitelné parametry

az prototype status

Příklady

Volitelné parametry

Váš názor