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
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.
Accetta automaticamente la raccomandazione predefinita per le violazioni dei criteri e i conflitti degli standard.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Visualizzare in anteprima gli elementi generati senza scrivere file.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Cancellare lo stato di compilazione esistente e iniziare subito.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Cosa creare.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | all |
| Valori accettati: | all, apps, db, docs, infra |
Mostra lo stato di avanzamento della compilazione corrente senza avviare una sessione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az prototype deploy
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.
Applicazione o ID client dell'entità servizio (o impostato tramite config).
Segreto client dell'entità servizio (o impostato tramite config).
Visualizzare in anteprima gli elementi da distribuire (simulazione per Bicep, pianificare Terraform).
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Forzare la distribuzione completa, ignorando il rilevamento delle modifiche.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Generare script deploy.sh per le directory dell'applicazione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Visualizzare gli output di distribuzione acquisiti da Terraform/Bicep.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Cancellare lo stato di distribuzione e avviarsi di nuovo.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Visualizzare le istruzioni di rollback in base alla cronologia di distribuzione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
URL del registro contenitori per --generate-scripts (tipo di container_app).
Nome del gruppo di risorse predefinito per --generate-scripts.
Tipo di destinazione della distribuzione di Azure per --generate-scripts.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | webapp |
| Valori accettati: | container_app, function, webapp |
Eseguire l'autenticazione usando un'entità servizio prima della distribuzione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Distribuire solo un numero di fase specifico (usare --status per visualizzare le fasi).
Mostra lo stato di avanzamento della distribuzione corrente senza avviare una sessione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
ID tenant di Azure AD per la distribuzione tra tenant.
ID tenant per l'autenticazione dell'entità servizio (o impostato tramite config).
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az prototype design
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.
Percorso della directory contenente documenti dei requisiti, diagrammi o altri artefatti.
Contesto o requisiti aggiuntivi come testo libero.
Immettere un ciclo di perfezionamento interattivo dopo la generazione dell'architettura.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Reimpostare lo stato di progettazione e iniziare subito.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Ignorare la conversazione di individuazione e generare l'architettura direttamente dallo stato di individuazione esistente.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra lo stato di individuazione corrente (elementi aperti, elementi confermati) senza avviare una sessione.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az prototype init
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.
Provider di intelligenza artificiale per le interazioni con agenti.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | copilot |
| Valori accettati: | azure-openai, copilot, github-models |
Ambiente di destinazione per il prototipo.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | dev |
| Valori accettati: | dev, prod, staging |
Preferenza dello strumento infrastruttura distribuita come codice.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | terraform |
| Valori accettati: | bicep, terraform |
Area di Azure per la distribuzione delle risorse (ad esempio eastus).
Modello di intelligenza artificiale da usare (impostazione predefinita: claude-sonnet-4.5 per copilot, gpt-4o per altri).
Nome del progetto prototipo.
Directory di output per i file di progetto.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | . |
Modello di progetto da usare ,ad esempio web-app, data-pipeline, ai-app.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az prototype status
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.
Mostra i dettagli espansi per fase.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Output json leggibile dal computer anziché visualizzazione formattata.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |