Condividi tramite


az prototype

Annotazioni

Questo riferimento fa parte dell'estensione prototipo per l'interfaccia della riga di comando di Azure (versione 2.50.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az prototype . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare rapidamente prototipi di Azure usando i team degli agenti basati sull'intelligenza artificiale.

L'estensione az prototype consente di creare prototipi funzionali di Azure usando team di agenti intelligenti basati su GitHub Copilot o Azure OpenAI.

Flusso di lavoro: init → progettare → compilazione → distribuire

Ogni fase può essere eseguita in modo indipendente (con le guardie dei prerequisiti) e la maggior parte delle fasi è ricompilata. È possibile tornare a perfezionare la progettazione o ricompilare componenti specifici.

I comandi di analisi consentono di diagnosticare gli errori e stimare i costi in qualsiasi momento.

Comandi

Nome Descrizione Tipo Status
az prototype agent

Gestire gli agenti di intelligenza artificiale per la generazione di prototipi.

Estensione Preview
az prototype agent add

Aggiungere un agente personalizzato al progetto.

Estensione Preview
az prototype agent export

Esportare qualsiasi agente (incluso il file predefinito) come file YAML.

Estensione Preview
az prototype agent list

Elencare tutti gli agenti disponibili (predefiniti e personalizzati).

Estensione Preview
az prototype agent override

Eseguire l'override di un agente predefinito con una definizione personalizzata.

Estensione Preview
az prototype agent remove

Rimuovere un agente personalizzato o eseguire l'override.

Estensione Preview
az prototype agent show

Mostra i dettagli di un agente specifico.

Estensione Preview
az prototype agent test

Inviare una richiesta di test a qualsiasi agente e visualizzare la risposta.

Estensione Preview
az prototype agent update

Aggiornare le proprietà di un agente personalizzato esistente.

Estensione Preview
az prototype analyze

Analizzare errori, costi e diagnostica per il prototipo.

Estensione Preview
az prototype analyze costs

Stimare i costi di Azure per le dimensioni della t-shirt small/medium/large.

Estensione Preview
az prototype analyze error

Analizzare un errore e ottenere una correzione con le istruzioni di ridistribuzione.

Estensione Preview
az prototype build

Generare il codice dell'infrastruttura e dell'applicazione nell'output a fasi.

Estensione Preview
az prototype config

Gestire la configurazione del progetto prototipo.

Estensione Preview
az prototype config get

Ottenere un singolo valore di configurazione.

Estensione Preview
az prototype config init

Installazione interattiva per creare un file di configurazione prototype.yaml.

Estensione Preview
az prototype config set

Impostare un valore di configurazione.

Estensione Preview
az prototype config show

Visualizzare la configurazione corrente del progetto.

Estensione Preview
az prototype deploy

Distribuire il prototipo in Azure con distribuzioni a fasi interattive.

Estensione Preview
az prototype design

Analizzare i requisiti e generare la progettazione dell'architettura.

Estensione Preview
az prototype generate

Generare la documentazione e gli artefatti spec-kit.

Estensione Preview
az prototype generate backlog

Generare un backlog ed eseguire il push di elementi di lavoro in GitHub o Azure DevOps.

Estensione Preview
az prototype generate docs

Generare la documentazione dai modelli con il popolamento di intelligenza artificiale.

Estensione Preview
az prototype generate speckit

Generare il bundle di documentazione spec-kit con il popolamento di intelligenza artificiale.

Estensione Preview
az prototype init

Inizializzare un nuovo progetto prototipo.

Estensione Preview
az prototype knowledge

Gestire i contributi della Knowledge Base.

Estensione Preview
az prototype knowledge contribute

Inviare un contributo della Knowledge Base come problema di GitHub.

Estensione Preview
az prototype status

Mostra lo stato corrente del progetto in tutte le fasi.

Estensione Preview

az prototype build

Anteprima

Il gruppo di comandi 'prototype' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Generare il codice dell'infrastruttura e dell'applicazione nell'output a fasi.

Usa la progettazione dell'architettura per generare moduli Terraform/Bicep, codice dell'applicazione, script di database e documentazione.

Interattivo per impostazione predefinita: la sessione di compilazione usa prompt con bordi ispirati a Claude Code, indicatori di stato, imposizione dei criteri e un ciclo di revisione conversazionale.

Tutto l'output è organizzato in fasi di distribuzione con granularità fine e ordinate dalle dipendenze. Ogni componente dell'infrastruttura, sistema di database e applicazione ottiene la propria fase. I modelli di carico di lavoro vengono usati come punti di partenza facoltativi quando corrispondono alla progettazione.

Dopo la generazione, un report di compilazione mostra cosa è stato creato ed è possibile fornire commenti e suggerimenti per rigenerare fasi specifiche. Digitare 'done' per accettare la compilazione.

Comandi barra durante la compilazione: /status - Mostra riepilogo completamento fase /fasi - Mostra piano di distribuzione completo /file - Elenca tutti i file generati /policy - Mostra riepilogo controllo criteri /help - Mostra comandi disponibili

Usare --dry-run per un'anteprima non interattiva.

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

Esempio

Sessione di compilazione interattiva (impostazione predefinita)

az prototype build

Mostra lo stato di avanzamento della compilazione corrente

az prototype build --status

Cancellare lo stato di compilazione e iniziare subito

az prototype build --reset

Compilare solo il codice dell'infrastruttura

az prototype build --scope infra

Visualizzare in anteprima gli elementi generati

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--auto-accept

Accetta automaticamente la raccomandazione predefinita per le violazioni dei criteri e i conflitti degli standard.

Proprietà Valore
Valore predefinito: False
--dry-run

Visualizzare in anteprima gli elementi generati senza scrivere file.

Proprietà Valore
Valore predefinito: False
--reset

Cancellare lo stato di compilazione esistente e iniziare subito.

Proprietà Valore
Valore predefinito: False
--scope

Cosa creare.

Proprietà Valore
Valore predefinito: all
Valori accettati: all, apps, db, docs, infra
--status -s

Mostra lo stato di avanzamento della compilazione corrente senza avviare una sessione.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az prototype deploy

Anteprima

Il gruppo di comandi 'prototype' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Distribuire il prototipo in Azure con distribuzioni a fasi interattive.

Interattivo per impostazione predefinita: esegue controlli preliminari (sottoscrizione, strumento IaC, gruppo di risorse, provider di risorse), quindi distribuisce le fasi in sequenza con il rilevamento dello stato e il routing degli errori QA-first.

Dopo la distribuzione, immette un ciclo di conversazione in cui è possibile controllare lo stato, il rollback, la ridistribuzione o visualizzare in anteprima le modifiche usando i comandi barra.

Comandi barra durante la distribuzione: /status - Mostra riepilogo completamento fase /stages - Mostra suddivisione completa della fase (alias per /status) /deploy N - Distribuire una fase specifica (o 'all' per in sospeso) /rollback N - Eseguire il rollback di una fase specifica (o 'all' inversa) order) /redeploy N - Eseguire il rollback e ridistribuire una fase /plan N - What-if /terraform plan for a stage /outputs - Show captured deployment outputs /preflight - Re-run preflight checks /help - Show available commands

Usare --dry-run per l'anteprima del piano di simulazione non interattiva/terraform. Usare --stage N per la distribuzione a fasi singole non interattive. Usare --stage N --dry-run per l'anteprima di simulazione di una singola fase. Usare --outputs per visualizzare gli output di distribuzione acquisiti. Usare --rollback-info per visualizzare le istruzioni di rollback. Usare --generate-scripts per generare deploy.sh per le directory dell'applicazione.

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]

Esempio

Sessione di distribuzione interattiva (impostazione predefinita)

az prototype deploy

Mostra lo stato di avanzamento della distribuzione corrente

az prototype deploy --status

Anteprima di tutte le fasi (piano di simulazione/terraform)

az prototype deploy --dry-run

Distribuire solo la fase 2

az prototype deploy --stage 2

Forzare la ridistribuzione completa

az prototype deploy --force

Visualizzare gli output di distribuzione acquisiti

az prototype deploy --outputs

Visualizzare le istruzioni di rollback

az prototype deploy --rollback-info

Generare script di distribuzione del servizio app

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--client-id

Applicazione o ID client dell'entità servizio (o impostato tramite config).

--client-secret

Segreto client dell'entità servizio (o impostato tramite config).

--dry-run

Visualizzare in anteprima gli elementi da distribuire (simulazione per Bicep, pianificare Terraform).

Proprietà Valore
Valore predefinito: False
--force

Forzare la distribuzione completa, ignorando il rilevamento delle modifiche.

Proprietà Valore
Valore predefinito: False
--generate-scripts

Generare script deploy.sh per le directory dell'applicazione.

Proprietà Valore
Valore predefinito: False
--outputs

Visualizzare gli output di distribuzione acquisiti da Terraform/Bicep.

Proprietà Valore
Valore predefinito: False
--reset

Cancellare lo stato di distribuzione e avviarsi di nuovo.

Proprietà Valore
Valore predefinito: False
--rollback-info

Visualizzare le istruzioni di rollback in base alla cronologia di distribuzione.

Proprietà Valore
Valore predefinito: False
--script-registry

URL del registro contenitori per --generate-scripts (tipo di container_app).

--script-resource-group

Nome del gruppo di risorse predefinito per --generate-scripts.

--script-type

Tipo di destinazione della distribuzione di Azure per --generate-scripts.

Proprietà Valore
Valore predefinito: webapp
Valori accettati: container_app, function, webapp
--service-principal

Eseguire l'autenticazione usando un'entità servizio prima della distribuzione.

Proprietà Valore
Valore predefinito: False
--stage

Distribuire solo un numero di fase specifico (usare --status per visualizzare le fasi).

--status -s

Mostra lo stato di avanzamento della distribuzione corrente senza avviare una sessione.

Proprietà Valore
Valore predefinito: False
--tenant

ID tenant di Azure AD per la distribuzione tra tenant.

--tenant-id

ID tenant per l'autenticazione dell'entità servizio (o impostato tramite config).

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az prototype design

Anteprima

Il gruppo di comandi 'prototype' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Analizzare i requisiti e generare la progettazione dell'architettura.

Legge gli artefatti (documenti, diagrammi, specifiche), coinvolge l'agente biz-analyst per identificare le lacune e genera la documentazione sull'architettura.

Quando viene eseguito senza parametri, avvia un dialogo interattivo per acquisire i requisiti tramite domande guidate.

Con --interactive, entra in un ciclo di perfezionamento dopo la generazione dell'architettura in modo da poter esaminare la progettazione e richiedere le modifiche.

L'agente biz-analyst è sempre coinvolto, anche quando viene fornito --context, per verificare la presenza di requisiti mancanti e presupposti non registrati.

Questa fase è di nuovo partecipante: eseguirla di nuovo per perfezionare la progettazione.

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

Esempio

Sessione di progettazione interattiva (dialogo guidato)

az prototype design

Progettazione interattiva con ciclo di perfezionamento dell'architettura

az prototype design --interactive

Progettare dalla directory degli artefatti

az prototype design --artifacts ./requirements/

Aggiungere contesto alla progettazione esistente

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

Reimpostare e avviare la progettazione aggiornata

az prototype design --reset

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--artifacts

Percorso della directory contenente documenti dei requisiti, diagrammi o altri artefatti.

--context

Contesto o requisiti aggiuntivi come testo libero.

--interactive -i

Immettere un ciclo di perfezionamento interattivo dopo la generazione dell'architettura.

Proprietà Valore
Valore predefinito: False
--reset

Reimpostare lo stato di progettazione e iniziare subito.

Proprietà Valore
Valore predefinito: False
--skip-discovery

Ignorare la conversazione di individuazione e generare l'architettura direttamente dallo stato di individuazione esistente.

Proprietà Valore
Valore predefinito: False
--status -s

Mostra lo stato di individuazione corrente (elementi aperti, elementi confermati) senza avviare una sessione.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az prototype init

Anteprima

Il gruppo di comandi 'prototype' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Inizializzare un nuovo progetto prototipo.

Configura lo scaffolding del progetto, crea il file di configurazione del progetto e, facoltativamente, esegue l'autenticazione con GitHub (convalida la licenza copilot).

L'autenticazione di GitHub è necessaria solo per i provider di intelligenza artificiale copilot e github-models. Quando si usa azure-openai, l'autenticazione di GitHub viene ignorata completamente.

Se la directory di destinazione contiene già un prototype.yaml, il comando richiederà prima di sovrascrivere.

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

Esempio

Creare un nuovo progetto prototipo

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

Inizializzare con preferenza Bicep

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

Usare Azure OpenAI (ignora l'autenticazione di GitHub)

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

Specificare l'ambiente e il modello

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ai-provider

Provider di intelligenza artificiale per le interazioni con agenti.

Proprietà Valore
Valore predefinito: copilot
Valori accettati: azure-openai, copilot, github-models
--environment

Ambiente di destinazione per il prototipo.

Proprietà Valore
Valore predefinito: dev
Valori accettati: dev, prod, staging
--iac-tool

Preferenza dello strumento infrastruttura distribuita come codice.

Proprietà Valore
Valore predefinito: terraform
Valori accettati: bicep, terraform
--location -l

Area di Azure per la distribuzione delle risorse (ad esempio eastus).

--model

Modello di intelligenza artificiale da usare (impostazione predefinita: claude-sonnet-4.5 per copilot, gpt-4o per altri).

--name

Nome del progetto prototipo.

--output-dir

Directory di output per i file di progetto.

Proprietà Valore
Valore predefinito: .
--template

Modello di progetto da usare ,ad esempio web-app, data-pipeline, ai-app.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az prototype status

Anteprima

Il gruppo di comandi 'prototype' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Mostra lo stato corrente del progetto in tutte le fasi.

Visualizza un riepilogo del progetto prototipo, tra cui la configurazione, lo stato di avanzamento della fase (progettazione, compilazione, distribuzione) e le modifiche in sospeso.

Per impostazione predefinita, viene visualizzato un riepilogo leggibile. Usare --json per l'output leggibile dal computer adatto per lo scripting. Usare --detailed per i dettagli espansi per fase.

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

Esempio

Mostra lo stato del progetto

az prototype status

Mostra stato dettagliato con suddivisione per fase

az prototype status --detailed

Ottenere l'output JSON leggibile dal computer

az prototype status --json

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--detailed -d

Mostra i dettagli espansi per fase.

Proprietà Valore
Valore predefinito: False
--json -j

Output json leggibile dal computer anziché visualizzazione formattata.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False