Freigeben über


az prototype

Hinweis

Diese Referenz ist Teil der Prototyperweiterung für die Azure CLI (Version 2.50.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az-Prototypbefehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie schnell Azure-Prototypen mithilfe von KI-gesteuerten Agentteams.

Mit der Az-Prototyperweiterung können Sie funktionale Azure-Prototypen mit intelligenten Agent-Teams erstellen, die von GitHub Copilot oder Azure OpenAI unterstützt werden.

Workflow: → Erstellen → bereitstellen → erstellen

Jede Phase kann unabhängig (mit erforderlichen Schutzvorrichtungen) ausgeführt werden, und die meisten Phasen werden neu gestartet – Sie können den Entwurf verfeinern oder bestimmte Komponenten neu erstellen.

Mithilfe von Analysebefehlen können Sie Fehler diagnostizieren und Kosten jederzeit schätzen.

Befehle

Name Beschreibung Typ Status
az prototype agent

Verwalten Sie KI-Agents für die Prototypgenerierung.

Extension Vorschau
az prototype agent add

Fügen Sie dem Projekt einen benutzerdefinierten Agent hinzu.

Extension Vorschau
az prototype agent export

Exportieren Sie einen beliebigen Agent (einschließlich integrierter Agent) als YAML-Datei.

Extension Vorschau
az prototype agent list

Alle verfügbaren Agents auflisten (integriert und benutzerdefiniert).

Extension Vorschau
az prototype agent override

Überschreiben Sie einen integrierten Agent mit einer benutzerdefinierten Definition.

Extension Vorschau
az prototype agent remove

Entfernen Sie einen benutzerdefinierten Agent oder eine Außerkraftsetzung.

Extension Vorschau
az prototype agent show

Details eines bestimmten Agents anzeigen.

Extension Vorschau
az prototype agent test

Senden Sie eine Testaufforderung an einen beliebigen Agent, und zeigen Sie die Antwort an.

Extension Vorschau
az prototype agent update

Aktualisieren Sie die Eigenschaften eines vorhandenen benutzerdefinierten Agents.

Extension Vorschau
az prototype analyze

Analysieren Sie Fehler, Kosten und Diagnosen für den Prototyp.

Extension Vorschau
az prototype analyze costs

Schätzen Sie die Azure-Kosten bei kleinen/mittleren/großen T-Shirt-Größen.

Extension Vorschau
az prototype analyze error

Analysieren Sie einen Fehler, und erhalten Sie eine Lösung mit Anweisungen zur erneuten Bereitstellung.

Extension Vorschau
az prototype build

Generieren Sie Infrastruktur und Anwendungscode in mehrstufiger Ausgabe.

Extension Vorschau
az prototype config

Verwalten der Prototypprojektkonfiguration.

Extension Vorschau
az prototype config get

Rufen Sie einen einzelnen Konfigurationswert ab.

Extension Vorschau
az prototype config init

Interaktives Setup zum Erstellen einer Konfigurationsdatei "prototype.yaml".

Extension Vorschau
az prototype config set

Legen Sie einen Konfigurationswert fest.

Extension Vorschau
az prototype config show

Aktuelle Projektkonfiguration anzeigen.

Extension Vorschau
az prototype deploy

Bereitstellen eines Prototyps in Azure mit interaktiven mehrstufigen Bereitstellungen.

Extension Vorschau
az prototype design

Analysieren Sie Anforderungen, und generieren Sie den Architekturentwurf.

Extension Vorschau
az prototype generate

Generieren Sie Dokumentationen und Spec-Kit-Artefakte.

Extension Vorschau
az prototype generate backlog

Generieren Sie einen Backlog und pushen Sie Arbeitsaufgaben an GitHub oder Azure DevOps.

Extension Vorschau
az prototype generate docs

Generieren Sie Dokumentationen aus Vorlagen mit KI-Population.

Extension Vorschau
az prototype generate speckit

Generieren Sie das Spezifikationskit-Dokumentationspaket mit KI-Population.

Extension Vorschau
az prototype init

Initialisieren Sie ein neues Prototypprojekt.

Extension Vorschau
az prototype knowledge

Verwalten von Knowledge Base-Beiträgen.

Extension Vorschau
az prototype knowledge contribute

Übermitteln Sie einen Knowledge Base-Beitrag als GitHub-Problem.

Extension Vorschau
az prototype status

Zeigen Sie den aktuellen Projektstatus in allen Phasen an.

Extension Vorschau

az prototype build

Vorschau

Befehlsgruppe "Prototyp" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Generieren Sie Infrastruktur und Anwendungscode in mehrstufiger Ausgabe.

Verwendet das Architekturdesign, um Terraform/Bicep-Module, Anwendungscode, Datenbankskripts und Dokumentation zu generieren.

Interactive by default – the build session uses Claude Code-inspired bordered prompts, progress indicators, policy enforcement, and a conversational review loop.

Alle Ausgaben sind in fein abgestimmten, abhängigkeitsgeordneten Bereitstellungsphasen angeordnet. Jede Infrastrukturkomponente, jedes Datenbanksystem und jede Anwendung erhält eine eigene Stufe. Arbeitsauslastungsvorlagen werden als optionale Ausgangspunkte verwendet, wenn sie dem Entwurf entsprechen.

Nach der Generierung zeigt ein Buildbericht, was erstellt wurde, und Sie können Feedback geben, um bestimmte Phasen neu zu generieren. Geben Sie "fertig" ein, um den Build zu akzeptieren.

Schrägstrichbefehle während des Builds: /status - Zusammenfassung der Phase /stages anzeigen - Vollständige Bereitstellungsplan /files anzeigen - Alle generierten Dateien /policy auflisten - Zusammenfassung der Richtlinienüberprüfung anzeigen - Verfügbare Befehle anzeigen

Verwenden Sie "-dry-run" für eine nicht interaktive Vorschau.

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

Beispiele

Interaktive Buildsitzung (Standard)

az prototype build

Aktuellen Buildfortschritt anzeigen

az prototype build --status

Erstellen Sie den Buildstatus, und beginnen Sie neu

az prototype build --reset

Nur Infrastrukturcode erstellen

az prototype build --scope infra

Anzeigen einer Vorschau, was generiert wird

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--auto-accept

Akzeptieren Sie automatisch die Standardempfehlung für Richtlinienverstöße und Standardskonflikte.

Eigenschaft Wert
Standardwert: False
--dry-run

Zeigen Sie eine Vorschau an, was generiert wird, ohne Dateien zu schreiben.

Eigenschaft Wert
Standardwert: False
--reset

Löschen Sie den vorhandenen Buildstatus, und beginnen Sie neu.

Eigenschaft Wert
Standardwert: False
--scope

Was zu erstellen ist.

Eigenschaft Wert
Standardwert: all
Zulässige Werte: all, apps, db, docs, infra
--status -s

Zeigen Sie den aktuellen Buildstatus an, ohne eine Sitzung zu starten.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az prototype deploy

Vorschau

Befehlsgruppe "Prototyp" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Bereitstellen eines Prototyps in Azure mit interaktiven mehrstufigen Bereitstellungen.

Interactive by default – runs preflight checks (subscription, IaC tool, resource group, resource providers), then deploys stages sequentially with progress tracking and QA-first error routing.

Nach der Bereitstellung wird eine Unterhaltungsschleife eingegeben, in der Sie den Status, das Rollback, die erneute Bereitstellung oder die Vorschau von Änderungen mithilfe von Schrägstrichbefehlen überprüfen können.

Schrägstrichbefehle während der Bereitstellung: /status - Zusammenfassung /Phasen anzeigen - Vollständige Aufschlüsselung der Stufe anzeigen (Alias für /status) /deploy N - Bereitstellen einer bestimmten Phase (oder "alle" für ausstehende) /rollback N - Rollback einer bestimmten Phase (oder "alle" in reverse order) /redeploy N - Rollback und erneutes Bereitstellen einer Phase /plan N - Was-wäre-wenn/Terraform-Plan für eine Stufe /Outputs - Anzeigen erfasster Bereitstellungsausgaben /preflight - Erneutes Ausführen von Preflight-Prüfungen /help - Anzeigen verfügbarer Befehle

Verwenden Sie "--dry-run" für nicht interaktive Was-wäre-wenn-/Terraform-Planvorschau. Verwenden Sie "-Phase N" für nicht interaktive Einzelphasenbereitstellungen. Verwenden Sie "--stage N--dry-run" für was-wäre-wenn-Vorschau einer einzelnen Stufe. Verwenden Sie "-outputs", um erfasste Bereitstellungsausgaben anzuzeigen. Verwenden Sie "--rollback-info", um Rollbackanweisungen anzuzeigen. Verwenden Sie "--generate-scripts", um deploy.sh für Anwendungsverzeichnisse zu generieren.

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]

Beispiele

Interaktive Bereitstellungssitzung (Standard)

az prototype deploy

Anzeigen des aktuellen Bereitstellungsfortschritts

az prototype deploy --status

Vorschau aller Phasen (Was-wäre-wenn/Terraform-Plan)

az prototype deploy --dry-run

Bereitstellen nur Phase 2

az prototype deploy --stage 2

Vollständige Erneute Bereitstellung erzwingen

az prototype deploy --force

Anzeigen erfasster Bereitstellungsausgaben

az prototype deploy --outputs

Anzeigen von Rollbackanweisungen

az prototype deploy --rollback-info

Generieren von App Service-Bereitstellungsskripts

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--client-id

Dienstprinzipalanwendung/Client-ID (oder über die Konfiguration festgelegt).

--client-secret

Geheimer Clientschlüssel des Dienstprinzipals (oder über die Konfiguration festgelegt).

--dry-run

Zeigen Sie eine Vorschau an, was bereitgestellt werden soll (Was-wäre für Bicep, Plan für Terraform).

Eigenschaft Wert
Standardwert: False
--force

Erzwingen der vollständigen Bereitstellung und Ignorieren der Änderungsnachverfolgung.

Eigenschaft Wert
Standardwert: False
--generate-scripts

Generieren Sie deploy.sh Skripts für Anwendungsverzeichnisse.

Eigenschaft Wert
Standardwert: False
--outputs

Zeigen Sie erfasste Bereitstellungsausgaben von Terraform / Bicep an.

Eigenschaft Wert
Standardwert: False
--reset

Löschen Sie den Bereitstellungsstatus, und beginnen Sie neu.

Eigenschaft Wert
Standardwert: False
--rollback-info

Anzeigen von Rollbackanweisungen basierend auf dem Bereitstellungsverlauf.

Eigenschaft Wert
Standardwert: False
--script-registry

Containerregistrierungs-URL für --generate-scripts (container_app Typ).

--script-resource-group

Standardressourcengruppenname für --generate-scripts.

--script-type

Azure-Bereitstellungszieltyp für Skripts –-generate-scripts.

Eigenschaft Wert
Standardwert: webapp
Zulässige Werte: container_app, function, webapp
--service-principal

Authentifizieren mithilfe eines Dienstprinzipals vor der Bereitstellung.

Eigenschaft Wert
Standardwert: False
--stage

Stellen Sie nur eine bestimmte Stufennummer bereit (verwenden Sie "--status", um Phasen anzuzeigen).

--status -s

Zeigen Sie den aktuellen Bereitstellungsfortschritt an, ohne eine Sitzung zu starten.

Eigenschaft Wert
Standardwert: False
--tenant

Azure AD-Mandanten-ID für die mandantenübergreifende Bereitstellung.

--tenant-id

Mandanten-ID für die Dienstprinzipalauthentifizierung (oder über die Konfiguration festgelegt).

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az prototype design

Vorschau

Befehlsgruppe "Prototyp" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Analysieren Sie Anforderungen, und generieren Sie den Architekturentwurf.

Liest Artefakte (Dokumente, Diagramme, Spezifikationen), setzt den Biz-Analyst-Agent ein, um Lücken zu identifizieren und architekturdokumentation zu generieren.

Wenn sie ohne Parameter ausgeführt wird, beginnt ein interaktiver Dialog, um Anforderungen durch geführte Fragen zu erfassen.

Bei "-interactive" wird nach der Architekturgenerierung eine Einschränkungsschleife eingegeben, sodass Sie die Entwurfs- und Anforderungsänderungen überprüfen können.

Der Biz-Analyst-Agent wird – auch wenn der Kontext bereitgestellt wird – immer eingebunden, um auf fehlende Anforderungen und nicht festgelegte Annahmen zu prüfen.

Diese Phase wird erneut gestartet – führen Sie sie erneut aus, um den Entwurf zu verfeinern.

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

Beispiele

Interaktive Designsitzung (geführter Dialog)

az prototype design

Interaktives Design mit Architektureinschränkungsschleife

az prototype design --interactive

Entwurf aus Artefaktverzeichnis

az prototype design --artifacts ./requirements/

Hinzufügen von Kontext zu vorhandenem Design

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

Zurücksetzen und Starten des Designs neu

az prototype design --reset

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--artifacts

Pfad zum Verzeichnis, das Anforderungsdokumente, Diagramme oder andere Artefakte enthält.

--context

Zusätzlicher Kontext oder Anforderungen als Freitext.

--interactive -i

Geben Sie nach der Architekturgenerierung eine interaktive Einschränkungsschleife ein.

Eigenschaft Wert
Standardwert: False
--reset

Setzen Sie den Entwurfszustand zurück, und beginnen Sie neu.

Eigenschaft Wert
Standardwert: False
--skip-discovery

Überspringen Sie die Ermittlungsunterhaltung, und generieren Sie die Architektur direkt aus dem vorhandenen Ermittlungszustand.

Eigenschaft Wert
Standardwert: False
--status -s

Aktuellen Ermittlungsstatus (geöffnete Elemente, bestätigte Elemente) anzeigen, ohne eine Sitzung zu starten.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az prototype init

Vorschau

Befehlsgruppe "Prototyp" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Initialisieren Sie ein neues Prototypprojekt.

Richtet das Projektgerüst ein, erstellt die Projektkonfigurationsdatei und authentifiziert optional mit GitHub (überprüft die Copilot-Lizenz).

Die GitHub-Authentifizierung ist nur für die Copilot- und Github-Modelle AI-Anbieter erforderlich. Bei verwendung von azure-openai wird die GitHub-Authentifizierung vollständig übersprungen.

Wenn das Zielverzeichnis bereits einen prototyp.yaml enthält, wird der Befehl vor dem Überschreiben aufgefordert.

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

Beispiele

Erstellen eines neuen Prototypprojekts

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

Initialisieren mit der Bicep-Einstellung

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

Verwenden von Azure OpenAI (Überspringt GitHub-Authentifizierung)

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

Angeben von Umgebung und Modell

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ai-provider

KI-Anbieter für Agentinteraktionen.

Eigenschaft Wert
Standardwert: copilot
Zulässige Werte: azure-openai, copilot, github-models
--environment

Zielumgebung für den Prototyp.

Eigenschaft Wert
Standardwert: dev
Zulässige Werte: dev, prod, staging
--iac-tool

Einstellung des Infrastruktur-as-Code-Tools.

Eigenschaft Wert
Standardwert: terraform
Zulässige Werte: bicep, terraform
--location -l

Azure-Region für die Ressourcenbereitstellung (z. B. Ost).

--model

ZU verwendende KI-Modell (Standard: claude-sonnet-4.5 für Copilot, gpt-4o für andere).

--name

Name des Prototypprojekts.

--output-dir

Ausgabeverzeichnis für Projektdateien.

Eigenschaft Wert
Standardwert: .
--template

Zu verwendende Projektvorlage (z. B. Web-App, Datenpipeline, Ai-App).

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az prototype status

Vorschau

Befehlsgruppe "Prototyp" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Zeigen Sie den aktuellen Projektstatus in allen Phasen an.

Zeigt eine Zusammenfassung des Prototypprojekts einschließlich Konfiguration, Phasenfortschritt (Entwurf, Build, Bereitstellung) und ausstehende Änderungen an.

Standardmäßig wird eine lesbare Zusammenfassung angezeigt. Verwenden Sie "-json" für maschinenlesbare Ausgabe, die für skripting geeignet ist. Verwenden Sie "-detaillierte" für erweiterte Details pro Stufe.

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

Beispiele

Projektstatus anzeigen

az prototype status

Detaillierter Status mit aufschlüsselung pro Stufe anzeigen

az prototype status --detailed

Abrufen maschinenlesbarer JSON-Ausgabe

az prototype status --json

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--detailed -d

Erweiterte Details pro Stufe anzeigen.

Eigenschaft Wert
Standardwert: False
--json -j

Ausgabe maschinenlesbares JSON anstelle der formatierten Anzeige.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False