az prototype

Observação

Esta referência faz parte da extensão protótipo para o Azure CLI (versão 2.50.0 ou superior). A extensão instala-se automaticamente na primeira vez que executares um comando azprototype . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie rapidamente protótipos Azure usando equipas de agentes baseadas em IA.

A extensão azprototype permite-lhe construir protótipos Azure funcionais usando equipas de agentes inteligentes alimentadas pelo GitHub Copilot ou Azure OpenAI.

Fluxo de trabalho: init → design → build → deploy

Cada nível pode ser executado de forma independente (com guardas pré-requisitos) e a maioria dos níveis é reentrante — pode voltar para refinar o seu design ou reconstruir componentes específicos.

Os comandos de análise permitem-te diagnosticar erros e estimar custos a qualquer momento.

Comandos

Nome	Descrição	Tipo	Estado
az prototype agent	Gerir agentes de IA para geração de protótipos.	Extensão	Preview
az prototype agent add	Adicione um agente personalizado ao projeto.	Extensão	Preview
az prototype agent export	Exporte qualquer agente (incluindo o incorporado) como ficheiro YAML.	Extensão	Preview
az prototype agent list	Liste todos os agentes disponíveis (integrados e personalizados).	Extensão	Preview
az prototype agent override	Sobrescrever um agente incorporado com uma definição personalizada.	Extensão	Preview
az prototype agent remove	Remova um agente alfandegário ou substituição.	Extensão	Preview
az prototype agent show	Mostre detalhes de um agente específico.	Extensão	Preview
az prototype agent test	Envie um prompt de teste a qualquer agente e mostre a resposta.	Extensão	Preview
az prototype agent update	Atualize as propriedades de um agente alfandegário existente.	Extensão	Preview
az prototype analyze	Analisar erros, custos e diagnósticos para o protótipo.	Extensão	Preview
az prototype analyze costs	Estima os custos do Azure em tamanhos de t-shirts Pequeno/Médio/Grande.	Extensão	Preview
az prototype analyze error	Analisa um erro e obtém uma correção com instruções de reimplantação.	Extensão	Preview
az prototype build	Gerar código de infraestrutura e aplicação em saída faseada.	Extensão	Preview
az prototype config	Gerir a configuração do protótipo do projeto.	Extensão	Preview
az prototype config get	Obtenha um único valor de configuração.	Extensão	Preview
az prototype config init	Configuração interativa para criar um ficheiro de configuração prototype.yaml.	Extensão	Preview
az prototype config set	Defina um valor de configuração.	Extensão	Preview
az prototype config show	Mostrar a configuração atual do projeto.	Extensão	Preview
az prototype deploy	Implementar o protótipo para Azure com implementações interativas e faseadas.	Extensão	Preview
az prototype design	Analisar requisitos e gerar design de arquitetura.	Extensão	Preview
az prototype generate	Gerar documentação e artefactos do kit de especificações.	Extensão	Preview
az prototype generate backlog	Gera um backlog e envia itens de trabalho para o GitHub ou Azure DevOps.	Extensão	Preview
az prototype generate docs	Gerar documentação a partir de templates com população de IA.	Extensão	Preview
az prototype generate speckit	Gerar o pacote de documentação do kit de especificações com a população de IA.	Extensão	Preview
az prototype init	Inicializar um novo projeto protótipo.	Extensão	Preview
az prototype knowledge	Gerir contribuições para a base de conhecimento.	Extensão	Preview
az prototype knowledge contribute	Submeta uma contribuição para a base de conhecimento como uma edição no GitHub.	Extensão	Preview
az prototype status	Mostrar o estado atual do projeto em todas as fases.	Extensão	Preview

az prototype build

Previsualizar

O 'protótipo' do grupo de comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerar código de infraestrutura e aplicação em saída faseada.

Utiliza o design da arquitetura para gerar módulos Terraform/Bicep, código de aplicação, scripts de base de dados e documentação.

Interativa por defeito — a sessão de compilação utiliza prompts com bordas inspirados no Claude Code, indicadores de progresso, aplicação de políticas e um ciclo de revisão conversacional.

Toda a saída está organizada em etapas de implementação detalhadas e ordenadas por dependências. Cada componente de infraestrutura, sistema de base de dados e aplicação tem a sua própria fase. Os modelos de carga de trabalho são usados como pontos de partida opcionais quando correspondem ao design.

Após a geração, um relatório de build mostra o que foi construído e podes fornecer feedback para regenerar fases específicas. Escreve 'feito' para aceitar a build.

Comandos de barra durante a compilação: /status - Mostrar resumo de conclusão de estágio /estágios - Mostrar plano de implementação completo /ficheiros - Listar todos os ficheiros gerados/política - Mostrar resumo da verificação de políticas /ajuda - Mostrar comandos disponíveis

Use --dry-run para uma pré-visualização não interativa.

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

Exemplos

Sessão de compilação interativa (por defeito)

az prototype build

Mostrar o progresso da build atual

az prototype build --status

Limpar o estado de construção e começar do zero

az prototype build --reset

Código de infraestrutura apenas para compilar

az prototype build --scope infra

Pré-visualize o que seria gerado

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

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--auto-accept

Aceitar automaticamente a recomendação padrão para violações de políticas e conflitos de normas.

Propriedade	Valor
Valor padrão:	False

--dry-run

Pré-visualiza o que seria gerado sem escrever ficheiros.

Propriedade	Valor
Valor padrão:	False

--reset

Limpa o estado de construção existente e começa do novo.

Propriedade	Valor
Valor padrão:	False

--scope

O que construir.

Propriedade	Valor
Valor padrão:	all
Valores aceites:	all, apps, db, docs, infra

--status -s

Mostra o progresso da build atual sem iniciar uma sessão.

Propriedade	Valor
Valor padrão:	False

Parâmetros globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az prototype deploy

Previsualizar

O 'protótipo' do grupo de comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Implementar o protótipo para Azure com implementações interativas e faseadas.

Interativo por defeito — executa verificações pré-voo (subscrição, ferramenta IaC, grupo de recursos, fornecedores de recursos), depois implementa as fases sequencialmente com acompanhamento de progresso e encaminhamento de erros QA-first.

Após a implementação, entra num ciclo conversacional onde pode verificar o estado, reverter, redistribuir ou pré-visualizar alterações usando comandos de barra.

Comandos de barra durante a implantação: /status - Mostrar resumo da conclusão do estágio /estágios - Mostrar a divisão completa dos estágios (alias para /status) /deploy N - Implantar um estágio específico (ou 'todos' para pendentes) /reverter N - Reverter um estágio específico (ou 'todos' por ordem inversa) /reimplantar N - Reverter e reimplantar um estágio /plano N - E se / plano de terraformação para um estágio /outputs - Mostrar resultados de implementação capturados /pré-voo - Repetir verificações pré-voo / ajuda - Mostrar comandos disponíveis

Use --dry-run para pré-visualização não interativa do plano de terraformação, tipo 'e se'. Use --stage N para implantação de estágio único não interativa. Use --stage N --dry-run para uma pré-visualização hipotética de uma única fase. Use as saídas --para mostrar as saídas de implementação capturadas. Use --rollback-info para mostrar instruções de rollback. Use --generate-scripts para gerar deploy.sh para diretórios de aplicações.

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]

Exemplos

Sessão de implementação interativa (por defeito)

az prototype deploy

Mostrar o progresso atual da implementação

az prototype deploy --status

Pré-visualizar todas as fases (e se / plano de terraformação)

az prototype deploy --dry-run

Apenas desdobrar estágio 2

az prototype deploy --stage 2

Forçar a redistribuição total

az prototype deploy --force

Mostrar as saídas de implementação capturadas

az prototype deploy --outputs

Instruções de rollback para mostrar

az prototype deploy --rollback-info

Gerar scripts de implementação de Serviços de Aplicações

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

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--client-id

ID de aplicação principal de serviço/cliente (ou definido via configuração).

--client-secret

O principal do serviço é o cliente secret (ou definido via config).

--dry-run

Pré-visualiza o que seria implementado (e se para o Bicep, plano para o Terraform).

Propriedade	Valor
Valor padrão:	False

--force

Forçar o desdobramento total, ignorando o acompanhamento das mudanças.

Propriedade	Valor
Valor padrão:	False

--generate-scripts

Gerar deploy.sh scripts para diretórios de aplicações.

Propriedade	Valor
Valor padrão:	False

--outputs

Mostrar as saídas de implementação capturadas do Terraform / Bicep.

Propriedade	Valor
Valor padrão:	False

--reset

Limpar o estado de implantação e começar do zero.

Propriedade	Valor
Valor padrão:	False

--rollback-info

Mostrar instruções de rollback com base no histórico de implementação.

Propriedade	Valor
Valor padrão:	False

--script-registry

URL do registo de contentores para --generate-scripts (tipo container_app).

--script-resource-group

Nome padrão do grupo de recursos para --generate-scripts.

--script-type

Tipo de destino de implementação Azure para --generate-scripts.

Propriedade	Valor
Valor padrão:	webapp
Valores aceites:	container_app, function, webapp

--service-principal

Autenticar usando um principal de serviço antes de implementar.

Propriedade	Valor
Valor padrão:	False

--stage

Implemente apenas um número de estágio específico (use --status para ver os estágios).

--status -s

Mostrar o progresso atual da implementação sem iniciar uma sessão.

Propriedade	Valor
Valor padrão:	False

--tenant

Azure AD tenant ID for cross-tenant deployment.

--tenant-id

ID de inquilino para autenticação do principal de serviço (ou definido via config).

Parâmetros globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az prototype design

Previsualizar

O 'protótipo' do grupo de comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Analisar requisitos e gerar design de arquitetura.

Lê artefactos (documentos, diagramas, especificações), envolve o agente analista de negócios para identificar lacunas e gera documentação de arquitetura.

Quando executado sem parâmetros, inicia um diálogo interativo para captar requisitos através de perguntas orientadas.

Com --interactive, entra um ciclo de refinamento após a geração da arquitetura para que possas rever o design e pedir alterações.

O agente analista de negócios está sempre envolvido — mesmo quando — é fornecido contexto — para verificar requisitos em falta e pressupostos não declarados.

Esta fase é reentrante — joga-a novamente para refinar o design.

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

Exemplos

Sessão de design interativo (diálogo guiado)

az prototype design

Design interativo com ciclo de refinamento arquitetónico

az prototype design --interactive

Design a partir do diretório de artefactos

az prototype design --artifacts ./requirements/

Adicionar contexto ao design existente

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

Reiniciar e começar o design do zero

az prototype design --reset

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--artifacts

Caminho para o diretório contendo documentos de requisitos, diagramas ou outros artefactos.

--context

Contexto adicional ou requisitos como texto livre.

--interactive -i

Entra um ciclo interativo de refinamento após a geração da arquitetura.

Propriedade	Valor
Valor padrão:	False

--reset

Reiniciar o estado de design e começar do zero.

Propriedade	Valor
Valor padrão:	False

--skip-discovery

Ignora a conversa de descoberta e gera arquitetura diretamente a partir do estado de descoberta existente.

Propriedade	Valor
Valor padrão:	False

--status -s

Mostrar o estado atual da descoberta (itens abertos, itens confirmados) sem iniciar uma sessão.

Propriedade	Valor
Valor padrão:	False

Parâmetros globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az prototype init

Previsualizar

O 'protótipo' do grupo de comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Inicializar um novo projeto protótipo.

Configura a estrutura do projeto, cria o ficheiro de configuração do projeto e, opcionalmente, autentica com o GitHub (valida a licença Copilot).

A autenticação no GitHub é exigida apenas para os fornecedores de IA copilot e github-models. Ao usar o Azure-OpenAI, a autenticação do GitHub é completamente ignorada.

Se o diretório de destino já contiver um prototype.yaml, o comando será solicitado antes de sobrescrever.

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

Exemplos

Criar um novo projeto protótipo

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

Inicializar com preferência de bíceps

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

Use Azure OpenAI (skip GitHub auth)

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

Especifique o ambiente e o modelo

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

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--ai-provider

Fornecedor de IA para interações com agentes.

Propriedade	Valor
Valor padrão:	copilot
Valores aceites:	azure-openai, copilot, github-models

--environment

Ambiente alvo para o protótipo.

Propriedade	Valor
Valor padrão:	dev
Valores aceites:	dev, prod, staging

--iac-tool

Preferência de ferramenta infraestrutura como código.

Propriedade	Valor
Valor padrão:	terraform
Valores aceites:	bicep, terraform

--location -l

Azure region para deployment de recursos (por exemplo, eastus).

--model

Modelo de IA a usar (padrão: claude-sonnet-4.5 para copilot, gpt-4o para outros).

--name

Nome do projeto protótipo.

--output-dir

Diretório de saída para ficheiros de projeto.

Propriedade	Valor
Valor padrão:	.

--template

Modelo de projeto a usar (por exemplo, web-app, data-pipeline, AI-app).

Parâmetros globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az prototype status

Previsualizar

O 'protótipo' do grupo de comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar o estado atual do projeto em todas as fases.

Apresenta um resumo do projeto protótipo, incluindo configuração, progresso das fases (design, construção, implementação) e alterações pendentes.

Por defeito, mostra um resumo legível para humanos. Use --json para uma saída legível por máquina, adequada para scripting. Use --detailed para detalhes aprofundados por etapa.

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

Exemplos

Estado do projeto de exposição

az prototype status

Mostrar o estado detalhado com análise por palco

az prototype status --detailed

Obtenha uma saída JSON legível por máquina

az prototype status --json

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--detailed -d

Mostra detalhes expandidos por palco.

Propriedade	Valor
Valor padrão:	False

--json -j

Saída JSON legível por máquina em vez de ecrã formatado.

Propriedade	Valor
Valor padrão:	False

Parâmetros globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False