az prototype

Observação

Essa referência faz parte da extensão de protótipo da CLI do Azure (versão 2.50.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az protótipo . Saiba mais sobre extensões.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie rapidamente protótipos do Azure usando equipes de agente controladas por IA.

A extensão do protótipo az permite que você crie protótipos funcionais do Azure usando equipes de agente inteligentes alimentadas pelo GitHub Copilot ou pelo Azure OpenAI.

Fluxo de trabalho: init → design → build → implantar

Cada estágio pode ser executado de forma independente (com guardas de pré-requisito) e a maioria dos estágios são reentrantes – você pode retornar para refinar seu design ou recompilar componentes específicos.

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

Comandos

Nome	Description	Tipo	Status
az prototype agent	Gerenciar 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 interno) como um arquivo YAML.	Extensão	Preview
az prototype agent list	Listar todos os agentes disponíveis (internos e personalizados).	Extensão	Preview
az prototype agent override	Substitua um agente interno por uma definição personalizada.	Extensão	Preview
az prototype agent remove	Remova um agente personalizado ou substitua.	Extensão	Preview
az prototype agent show	Mostrar detalhes de um agente específico.	Extensão	Preview
az prototype agent test	Envie um prompt de teste para qualquer agente e exiba a resposta.	Extensão	Preview
az prototype agent update	Atualize as propriedades de um agente personalizado existente.	Extensão	Preview
az prototype analyze	Analise erros, custos e diagnósticos para o protótipo.	Extensão	Preview
az prototype analyze costs	Estimar os custos do Azure em tamanhos de camiseta pequeno/médio/grande.	Extensão	Preview
az prototype analyze error	Analise um erro e obtenha uma correção com instruções de reimplantação.	Extensão	Preview
az prototype build	Gere a infraestrutura e o código do aplicativo na saída em etapas.	Extensão	Preview
az prototype config	Gerenciar a configuração do projeto de protótipo.	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 arquivo 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	Exiba a configuração atual do projeto.	Extensão	Preview
az prototype deploy	Implante o protótipo no Azure com implantações interativas em etapas.	Extensão	Preview
az prototype design	Analise os requisitos e gere o design da arquitetura.	Extensão	Preview
az prototype generate	Gerar documentação e artefatos do kit de especificações.	Extensão	Preview
az prototype generate backlog	Gere uma lista de pendências e envie itens de trabalho por push para o GitHub ou o Azure DevOps.	Extensão	Preview
az prototype generate docs	Gere documentação de modelos com a população de IA.	Extensão	Preview
az prototype generate speckit	Gere o pacote de documentação do kit de especificações com a população de IA.	Extensão	Preview
az prototype init	Inicialize um novo projeto de protótipo.	Extensão	Preview
az prototype knowledge	Gerenciar contribuições da base de dados de conhecimento.	Extensão	Preview
az prototype knowledge contribute	Envie uma contribuição da base de dados de conhecimento como um problema do GitHub.	Extensão	Preview
az prototype launch	Inicie o painel de TUI interativo.	Extensão	Preview
az prototype status	Mostrar o status do projeto atual em todos os estágios.	Extensão	Preview

az prototype build

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gere a infraestrutura e o código do aplicativo na saída em etapas.

Usa o design de arquitetura para gerar módulos terraform/Bicep, código do aplicativo, scripts de banco de dados e documentação.

Interativo por padrão – a sessão de build usa prompts bordados inspirados em Código de Claude, indicadores de progresso, imposição de política e um loop de revisão de conversa.

Toda a saída é organizada em estágios de implantação ordenados por dependência e refinados. Cada componente de infraestrutura, sistema de banco de dados e aplicativo obtém seu próprio estágio. 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 criado e você pode fornecer comentários para regenerar estágios específicos. Digite 'done' para aceitar o build.

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

Use --dry-run para uma versão prévia não interativa.

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

Exemplos

Sessão de build interativa (padrão)

az prototype build

Mostrar o progresso atual do build

az prototype build --status

Limpar o estado de build e começar de novo

az prototype build --reset

Criar somente código de infraestrutura

az prototype build --scope infra

Visualizar o que seria gerado

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--auto-accept

Aceite automaticamente a recomendação padrão para violações de política e conflitos de padrões.

Propriedade	Valor
Valor padrão:	False

--dry-run

Visualizar o que seria gerado sem gravar arquivos.

Propriedade	Valor
Valor padrão:	False

--reset

Desmarque o estado de build existente e comece de novo.

Propriedade	Valor
Valor padrão:	False

--scope

O que criar.

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

--status -s

Mostrar o progresso atual do build sem iniciar uma sessão.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

az prototype deploy

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Implante o protótipo no Azure com implantações interativas em etapas.

Interativo por padrão – executa verificações de pré-vôo (assinatura, ferramenta IaC, grupo de recursos, provedores de recursos) e implanta estágios sequencialmente com acompanhamento de progresso e roteamento de erro de qa-first.

Após a implantação, insere um loop de conversa em que você pode verificar o status, a reversão, a reimplantação ou a visualização de alterações usando comandos de barra.

Comandos de barra durante a implantação: /status – Mostrar resumo/estágios de conclusão do estágio – Mostrar detalhamento de estágio completo (alias para /status) /implantar N – Implantar um estágio específico (ou 'todos' para pendente) /rollback N - Reverter um estágio específico (ou 'todos' em ordem inversa) /reimplantar N - Reverter e reimplantar um estágio /plano N - What-if /terraform plan for a stage /outputs - Show captured deployment outputs /preflight - Re-run preflight checks /help - Show available commands

Use --dry-run para a versão prévia do plano what-if/terraform não interativa. Use --stage N para implantação não interativa em estágio único. Use --stage N --dry-run para a visualização de hipóteses de um único estágio. Use --outputs para mostrar saídas de implantação capturadas. Use --rollback-info para mostrar instruções de reversão. Use --generate-scripts para gerar deploy.sh para diretórios de aplicativos.

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 implantação interativa (padrão)

az prototype deploy

Mostrar o progresso da implantação atual

az prototype deploy --status

Visualizar todos os estágios (plano what-if/terraform)

az prototype deploy --dry-run

Implantar somente o estágio 2

az prototype deploy --stage 2

Forçar a reimplantação completa

az prototype deploy --force

Mostrar saídas de implantação capturadas

az prototype deploy --outputs

Mostrar instruções de reversão

az prototype deploy --rollback-info

Gerar scripts de implantação do Serviço de Aplicativo

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--client-id

ID do cliente/aplicativo da entidade de serviço (ou definida por meio de configuração).

--client-secret

Segredo do cliente da entidade de serviço (ou definido por meio de configuração).

--dry-run

Visualizar o que seria implantado (what-if para Bicep, planejar o Terraform).

Propriedade	Valor
Valor padrão:	False

--force

Force a implantação completa, ignorando o controle de alterações.

Propriedade	Valor
Valor padrão:	False

--generate-scripts

Gere scripts deploy.sh para diretórios de aplicativos.

Propriedade	Valor
Valor padrão:	False

--outputs

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

Propriedade	Valor
Valor padrão:	False

--reset

Desmarque o estado de implantação e comece de novo.

Propriedade	Valor
Valor padrão:	False

--rollback-info

Mostrar instruções de reversão com base no histórico de implantação.

Propriedade	Valor
Valor padrão:	False

--script-registry

URL do Registro de Contêiner para --generate-scripts (tipo container_app).

--script-resource-group

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

--script-type

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

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

--service-principal

Autenticar usando uma entidade de serviço antes de implantar.

Propriedade	Valor
Valor padrão:	False

--stage

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

--status -s

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

Propriedade	Valor
Valor padrão:	False

--tenant

ID do locatário do Azure AD para implantação entre locatários.

--tenant-id

ID do locatário para autenticação de entidade de serviço (ou definida por meio de configuração).

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

az prototype design

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Analise os requisitos e gere o design da arquitetura.

Lê artefatos (documentos, diagramas, especificações), envolve o agente biz-analyst para identificar lacunas e gera documentação de arquitetura.

Quando executado sem parâmetros, inicia um diálogo interativo para capturar requisitos por meio de perguntas guiadas.

Com --interactive, insere um loop de refinamento após a geração da arquitetura para que você possa examinar as alterações de design e solicitação.

O agente biz-analyst está sempre envolvido , mesmo quando --contexto é fornecido — para verificar se há requisitos ausentes e suposições não declaradas.

Este estágio é um novo participante – execute-o 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 loop de refinamento de arquitetura

az prototype design --interactive

Design do diretório de artefatos

az prototype design --artifacts ./requirements/

Adicionar contexto ao design existente

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

Redefinir e iniciar o design novo

az prototype design --reset

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--artifacts

Caminho para o diretório que contém documentos de requisito, diagramas ou outros artefatos.

--context

Contexto ou requisitos adicionais como texto gratuito.

--interactive -i

Insira um loop de refinamento interativo após a geração da arquitetura.

Propriedade	Valor
Valor padrão:	False

--reset

Redefina o estado de design e inicie novamente.

Propriedade	Valor
Valor padrão:	False

--skip-discovery

Ignore a conversa de descoberta e gere a arquitetura diretamente do estado de descoberta existente.

Propriedade	Valor
Valor padrão:	False

--status -s

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

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

az prototype init

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Inicialize um novo projeto de protótipo.

Configura o scaffolding do projeto, cria o arquivo de configuração do projeto e, opcionalmente, autentica com o GitHub (valida a licença copilot).

A autenticação do GitHub é necessária apenas para os provedores de IA copilot e github-models. Ao usar azure-openai, a autenticação do GitHub é totalmente ignorada.

Se o diretório de destino já contiver um protótipo.yaml, o comando solicitará antes da substituição.

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 de protótipo

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

Inicializar com preferência de Bicep

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

Usar o Azure OpenAI (ignora a autenticação do GitHub)

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

Especificar ambiente e modelo

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ai-provider

Provedor de IA para interações de agente.

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

--environment

Ambiente de destino para o protótipo.

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

--iac-tool

Preferência de ferramenta de infraestrutura como código.

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

--location -l

Região do Azure para implantação de recursos (por exemplo, eastus).

--model

Modelo de IA a ser usado (padrão: claude-sonnet-4.5 para copilot, gpt-4o para outras pessoas).

--name

Nome do projeto de protótipo.

--output-dir

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

Propriedade	Valor
Valor padrão:	.

--template

Modelo de projeto a ser usado (por exemplo, web-app, data-pipeline, ai-app).

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

az prototype launch

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Inicie o painel de TUI interativo.

Detecta automaticamente o estágio atual do projeto e inicia a sessão apropriada dentro de um aplicativo de terminal Textual.

az prototype launch [--stage {build, deploy, design}]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--stage

Inicie a TUI em um estágio específico em vez de detectar automaticamente.

Propriedade	Valor
Valores aceitos:	build, deploy, design

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False

az prototype status

Versão Prévia

O grupo de comandos 'protótipo' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar o status do projeto atual em todos os estágios.

Exibe um resumo do projeto de protótipo, incluindo configuração, progresso do estágio (design, build, implantação) e alterações pendentes.

Por padrão, mostra um resumo legível por humanos. Use --json para uma saída legível pelo computador adequada para scripts. Use --detailed para detalhes expandidos por estágio.

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

Exemplos

Mostrar o status do projeto

az prototype status

Mostrar status detalhado com detalhamento por estágio

az prototype status --detailed

Obter saída JSON legível pelo computador

az prototype status --json

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--detailed -d

Mostrar detalhes expandidos por estágio.

Propriedade	Valor
Valor padrão:	False

--json -j

Saída JSON legível pelo computador em vez de exibição formatada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--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 aceitos:	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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Valor padrão:	False