az prototype

Förhandsvisning

Anmärkning

Den här referensen är en del av prototyptillägget för Azure CLI (version 2.50.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az prototype-kommando . Läs mer om tillägg.

Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa snabbt Azure-prototyper med hjälp av AI-drivna agentteam.

Med tillägget az prototype kan du skapa funktionella Azure-prototyper med hjälp av intelligenta agentteam som drivs av GitHub Copilot eller Azure OpenAI.

Arbetsflöde: skapa → → skapa → distribuera

Varje steg kan köras separat (med kravskydd) och de flesta faser är nya – du kan återgå för att förfina din design eller återskapa specifika komponenter.

Med analyskommandon kan du diagnostisera fel och beräkna kostnader när som helst.

Kommandon

Namn	Beskrivning	Typ	Status
az prototype agent	Hantera AI-agenter för prototypgenerering.	Extension	Preview
az prototype agent add	Lägg till en anpassad agent i projektet.	Extension	Preview
az prototype agent export	Exportera alla agenter (inklusive inbyggda) som en YAML-fil.	Extension	Preview
az prototype agent list	Visa en lista över alla tillgängliga agenter (inbyggda och anpassade).	Extension	Preview
az prototype agent override	Åsidosätt en inbyggd agent med en anpassad definition.	Extension	Preview
az prototype agent remove	Ta bort en anpassad agent eller åsidosättning.	Extension	Preview
az prototype agent show	Visa information om en specifik agent.	Extension	Preview
az prototype agent test	Skicka en testfråga till vilken agent som helst och visa svaret.	Extension	Preview
az prototype agent update	Uppdatera egenskaperna för en befintlig anpassad agent.	Extension	Preview
az prototype analyze	Analysera fel, kostnader och diagnostik för prototypen.	Extension	Preview
az prototype analyze costs	Beräkna Azure-kostnader i storlekar för små/medelstora/stora t-shirtar.	Extension	Preview
az prototype analyze error	Analysera ett fel och få en korrigering med omdistributionsinstruktioner.	Extension	Preview
az prototype build	Generera infrastruktur och programkod i mellanlagrade utdata.	Extension	Preview
az prototype config	Hantera projektkonfiguration för prototyper.	Extension	Preview
az prototype config get	Hämta ett enda konfigurationsvärde.	Extension	Preview
az prototype config init	Interaktiv installation för att skapa en prototype.yaml-konfigurationsfil.	Extension	Preview
az prototype config set	Ange ett konfigurationsvärde.	Extension	Preview
az prototype config show	Visa aktuell projektkonfiguration.	Extension	Preview
az prototype deploy	Distribuera prototypen till Azure med interaktiva mellanlagrade distributioner.	Extension	Preview
az prototype design	Analysera krav och generera arkitekturdesign.	Extension	Preview
az prototype generate	Generera dokumentation och spec-kit-artefakter.	Extension	Preview
az prototype generate backlog	Generera kvarvarande uppgifter och push-överföra arbetsobjekt till GitHub eller Azure DevOps.	Extension	Preview
az prototype generate docs	Generera dokumentation från mallar med AI-population.	Extension	Preview
az prototype generate speckit	Generera dokumentationspaketet spec-kit med AI-populationen.	Extension	Preview
az prototype init	Initiera ett nytt prototypprojekt.	Extension	Preview
az prototype knowledge	Hantera bidrag från kunskapsbasen.	Extension	Preview
az prototype knowledge contribute	Skicka in ett bidrag till kunskapsbasen som ett GitHub-problem.	Extension	Preview
az prototype status	Visa aktuell projektstatus i alla faser.	Extension	Preview

az prototype build

Förhandsvisning

Kommandogruppens prototyp är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Generera infrastruktur och programkod i mellanlagrade utdata.

Använder arkitekturdesignen för att generera Terraform/Bicep-moduler, programkod, databasskript och dokumentation.

Interaktiv som standard – byggsessionen använder Claude Code-inspirerade kantlinjer, förloppsindikatorer, principframtvingande och en konversationsgranskningsloop.

Alla utdata är ordnade i detaljerade, beroendebeställda distributionssteg. Varje infrastrukturkomponent, databassystem och program får en egen fas. Arbetsbelastningsmallar används som valfria startpunkter när de matchar designen.

Efter generation visar en byggrapport vad som har skapats och du kan ge feedback för att återskapa specifika faser. Skriv "klar" för att acceptera bygget.

Snedstreckskommandon under bygget: /status – Visa sammanfattning /faser för slutförande av faser – Visa fullständig distributionsplan /files – Visa alla genererade filer /princip – Visa sammanfattning av principkontroll /hjälp – Visa tillgängliga kommandon

Använd --dry-run för en icke-interaktiv förhandsversion.

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

Exempel

Interaktiv build-session (standard)

az prototype build

Visa aktuellt bygge-förlopp

az prototype build --status

Rensa byggtillstånd och börja om på nytt

az prototype build --reset

Skapa endast infrastrukturkod

az prototype build --scope infra

Förhandsgranska vad som skulle genereras

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna utföras framgångsrikt.

--auto-accept

Acceptera automatiskt standardrekommenditeten för principöverträdelser och standardkonflikter.

Egenskap	Värde
Standardvärde:	False

--dry-run

Förhandsgranska vad som skulle genereras utan att skriva filer.

Egenskap	Värde
Standardvärde:	False

--reset

Rensa befintligt byggtillstånd och börja om på nytt.

Egenskap	Värde
Standardvärde:	False

--scope

Vad du ska skapa.

Egenskap	Värde
Standardvärde:	all
Godkända värden:	all, apps, db, docs, infra

--status -s

Visa förloppet för den aktuella versionen utan att starta en session.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az prototype deploy

Förhandsvisning

Kommandogruppens prototyp är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Distribuera prototypen till Azure med interaktiva mellanlagrade distributioner.

Interaktiv som standard – kör preflight-kontroller (prenumeration, IaC-verktyg, resursgrupp, resursproviders) och distribuerar sedan faser sekventiellt med förloppsspårning och QA-första felroutning.

Efter distributionen anger du en konversationsloop där du kan kontrollera status, återställning, omdistribuering eller förhandsgranskningsändringar med hjälp av snedstreckskommandon.

Snedstreckskommandon under distribution: /status – Visa sammanfattning/faser för slutförande av faser – Visa fullständig fasuppdelning (alias för /status) /deploy N – Distribuera en specifik fas (eller "alla" för väntande) /återställning N – Återställa en specifik fas (eller "alla" i omvänd ordning) /omdistribuera N – Rulla tillbaka och distribuera om en fas /plan N – Konsekvens/terraform-plan för en fas /utdata – Visa insamlade distributionsutdata /preflight – Kör preflight-kontroller /hjälp igen – Visa tillgängliga kommandon

Använd --dry-run för icke-interaktiv what-if/terraform plan preview. Använd --stage N för icke-interaktiv distribution i en fas. Använd --stage N --dry-run för what-if-förhandsversion av en enskild fas. Använd --outputs för att visa insamlade distributionsutdata. Använd --rollback-info för att visa återställningsinstruktioner. Använd --generate-scripts för att generera deploy.sh för programkataloger.

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]

Exempel

Interaktiv distributionssession (standard)

az prototype deploy

Visa aktuell distributionsstatus

az prototype deploy --status

Förhandsgranska alla faser (tänk om/terraform-plan)

az prototype deploy --dry-run

Distribuera endast steg 2

az prototype deploy --stage 2

Framtvinga fullständig omdistribution

az prototype deploy --force

Visa insamlade distributionsutdata

az prototype deploy --outputs

Visa återställningsinstruktioner

az prototype deploy --rollback-info

Generera App Service-distributionsskript

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna utföras framgångsrikt.

--client-id

Program/klient-ID för tjänstens huvudnamn (eller inställt via konfiguration).

--client-secret

Klienthemlighet för tjänstens huvudnamn (eller ange via konfiguration).

--dry-run

Förhandsgranska vad som skulle distribueras (tänk om för Bicep, planera för Terraform).

Egenskap	Värde
Standardvärde:	False

--force

Framtvinga fullständig distribution och ignorera ändringsspårning.

Egenskap	Värde
Standardvärde:	False

--generate-scripts

Generera deploy.sh skript för programkataloger.

Egenskap	Värde
Standardvärde:	False

--outputs

Visa insamlade distributionsutdata från Terraform/Bicep.

Egenskap	Värde
Standardvärde:	False

--reset

Rensa distributionstillståndet och börja om på nytt.

Egenskap	Värde
Standardvärde:	False

--rollback-info

Visa återställningsinstruktioner baserat på distributionshistorik.

Egenskap	Värde
Standardvärde:	False

--script-registry

Containerregister-URL för --generate-scripts (container_app typ).

--script-resource-group

Standardnamn för resursgrupp för --generate-scripts.

--script-type

Azure-distributionsmåltyp för --generate-scripts.

Egenskap	Värde
Standardvärde:	webapp
Godkända värden:	container_app, function, webapp

--service-principal

Autentisera med ett huvudnamn för tjänsten innan du distribuerar.

Egenskap	Värde
Standardvärde:	False

--stage

Distribuera endast ett specifikt stegnummer (använd --status för att se faser).

--status -s

Visa förloppet för den aktuella distributionen utan att starta en session.

Egenskap	Värde
Standardvärde:	False

--tenant

Azure AD-klientorganisations-ID för distribution mellan klientorganisationer.

--tenant-id

Klientorganisations-ID för autentisering med tjänstens huvudnamn (eller inställt via konfiguration).

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az prototype design

Förhandsvisning

Kommandogruppens prototyp är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Analysera krav och generera arkitekturdesign.

Läser artefakter (dokument, diagram, specifikationer), engagerar biz-analytikeragenten för att identifiera luckor och genererar arkitekturdokumentation.

När du kör utan parametrar startar en interaktiv dialog för att samla in krav med hjälp av guidade frågor.

Med --interactive anger du en förfiningsloop efter arkitekturgenereringen så att du kan granska design- och begärandeändringarna.

Biz-analyst-agenten är alltid engagerad – även när --context tillhandahålls – för att söka efter saknade krav och outtalade antaganden.

Det här steget är en ny deltagare – kör det igen för att förfina designen.

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

Exempel

Interaktiv designsession (guidad dialog)

az prototype design

Interaktiv design med arkitekturförfiningsloop

az prototype design --interactive

Designa från artefaktkatalog

az prototype design --artifacts ./requirements/

Lägga till kontext i befintlig design

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

Återställ och starta designen på nytt

az prototype design --reset

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna utföras framgångsrikt.

--artifacts

Sökväg till katalogen som innehåller kravdokument, diagram eller andra artefakter.

--context

Ytterligare kontext eller krav som fritext.

--interactive -i

Ange en interaktiv förfiningsloop efter arkitekturgenereringen.

Egenskap	Värde
Standardvärde:	False

--reset

Återställ designtillståndet och börja om på nytt.

Egenskap	Värde
Standardvärde:	False

--skip-discovery

Hoppa över identifieringskonversationen och generera arkitektur direkt från befintligt identifieringstillstånd.

Egenskap	Värde
Standardvärde:	False

--status -s

Visa aktuell identifieringsstatus (öppna objekt, bekräftade objekt) utan att starta en session.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az prototype init

Förhandsvisning

Kommandogruppens prototyp är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Initiera ett nytt prototypprojekt.

Konfigurerar projektställningar, skapar projektkonfigurationsfilen och kan även autentiseras med GitHub (validerar Copilot-licens).

GitHub-autentisering krävs endast för AI-leverantörerna för copilot- och github-modeller. När du använder azure-openai hoppas GitHub-autentisering över helt.

Om målkatalogen redan innehåller en prototype.yaml uppmanas kommandot innan den skrivs över.

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

Exempel

Skapa ett nytt prototypprojekt

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

Initiera med Bicep-inställningar

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

Använda Azure OpenAI (hoppar över GitHub-autentisering)

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

Ange miljö och modell

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna utföras framgångsrikt.

--ai-provider

AI-provider för agentinteraktioner.

Egenskap	Värde
Standardvärde:	copilot
Godkända värden:	azure-openai, copilot, github-models

--environment

Målmiljö för prototypen.

Egenskap	Värde
Standardvärde:	dev
Godkända värden:	dev, prod, staging

--iac-tool

Verktygsinställningar för infrastruktur som kod.

Egenskap	Värde
Standardvärde:	terraform
Godkända värden:	bicep, terraform

--location -l

Azure-region för resursdistribution (t.ex. eastus).

--model

AI-modell att använda (standard: claude-sonnet-4.5 för copilot, gpt-4o för andra).

--name

Namn på prototypprojektet.

--output-dir

Utdatakatalog för projektfiler.

Egenskap	Värde
Standardvärde:	.

--template

Projektmall som ska användas (t.ex. webbapp, datapipeline, ai-app).

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az prototype status

Förhandsvisning

Kommandogruppens prototyp är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa aktuell projektstatus i alla faser.

Visar en sammanfattning av prototypprojektet, inklusive konfiguration, fasförlopp (design, version, distribution) och väntande ändringar.

Som standard visas en sammanfattning som kan läsas av människor. Använd --json för maskinläsbara utdata som är lämpliga för skript. Använd – detaljerad för utökad information per steg.

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

Exempel

Visa projektstatus

az prototype status

Visa detaljerad status med uppdelning per steg

az prototype status --detailed

Hämta maskinläsbara JSON-utdata

az prototype status --json

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna utföras framgångsrikt.

--detailed -d

Visa expanderad information per steg.

Egenskap	Värde
Standardvärde:	False

--json -j

Utdatadatorläsbar JSON i stället för formaterad visning.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

Feedback

Var den här sidan hjälpsam?

Dela via

az prototype

Kommandon

az prototype build

Exempel

Valfria parametrar

az prototype deploy

Exempel

Valfria parametrar

az prototype design

Exempel

Valfria parametrar

az prototype init

Exempel

Valfria parametrar

az prototype status

Exempel

Valfria parametrar

Feedback