az prototype

Nota:

Esta referencia forma parte de la extensión de prototipo para la CLI de Azure (versión 2.50.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az prototype . Obtenga más información sobre las extensiones.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree rápidamente prototipos de Azure mediante equipos de agentes controlados por IA.

La extensión az prototype le permite crear prototipos funcionales de Azure mediante equipos de agentes inteligentes con tecnología de GitHub Copilot o Azure OpenAI.

Flujo de trabajo: init → diseño → compilación → implementar

Cada fase se puede ejecutar de forma independiente (con guardias de requisitos previos) y la mayoría de las fases se vuelven a participar; puede volver a refinar el diseño o recompilar componentes específicos.

Los comandos de análisis permiten diagnosticar errores y calcular los costos en cualquier momento.

Comandos

Nombre	Description	Tipo	Estado
az prototype agent	Administrar agentes de IA para la generación de prototipos.	Extension	Preview
az prototype agent add	Agregue un agente personalizado al proyecto.	Extension	Preview
az prototype agent export	Exporte cualquier agente (incluido integrado) como un archivo YAML.	Extension	Preview
az prototype agent list	Enumerar todos los agentes disponibles (integrados y personalizados).	Extension	Preview
az prototype agent override	Invalide un agente integrado con una definición personalizada.	Extension	Preview
az prototype agent remove	Quite un agente personalizado o invalide.	Extension	Preview
az prototype agent show	Mostrar detalles de un agente específico.	Extension	Preview
az prototype agent test	Envíe un mensaje de prueba a cualquier agente y muestre la respuesta.	Extension	Preview
az prototype agent update	Actualice las propiedades de un agente personalizado existente.	Extension	Preview
az prototype analyze	Analice los errores, los costos y los diagnósticos del prototipo.	Extension	Preview
az prototype analyze costs	Calcule los costos de Azure en tamaños de camiseta pequeños, medianos o grandes.	Extension	Preview
az prototype analyze error	Analice un error y obtenga una corrección con instrucciones de reimplementación.	Extension	Preview
az prototype build	Genere código de aplicación e infraestructura en la salida preconfigurada.	Extension	Preview
az prototype config	Administrar la configuración del proyecto prototipo.	Extension	Preview
az prototype config get	Obtenga un único valor de configuración.	Extension	Preview
az prototype config init	Configuración interactiva para crear un archivo de configuración prototype.yaml.	Extension	Preview
az prototype config set	Establezca un valor de configuración.	Extension	Preview
az prototype config show	Mostrar la configuración actual del proyecto.	Extension	Preview
az prototype deploy	Implemente prototipo en Azure con implementaciones preconfiguradas interactivas.	Extension	Preview
az prototype design	Analice los requisitos y genere el diseño de la arquitectura.	Extension	Preview
az prototype generate	Genere documentación y artefactos del kit de especificaciones.	Extension	Preview
az prototype generate backlog	Genere un trabajo pendiente e inserte elementos de trabajo en GitHub o Azure DevOps.	Extension	Preview
az prototype generate docs	Genere documentación a partir de plantillas con el rellenado de inteligencia artificial.	Extension	Preview
az prototype generate speckit	Genere el conjunto de documentación del kit de especificaciones con el rellenado de IA.	Extension	Preview
az prototype init	Inicialice un nuevo proyecto de prototipo.	Extension	Preview
az prototype knowledge	Administrar las contribuciones de la base de conocimiento.	Extension	Preview
az prototype knowledge contribute	Envíe una contribución de la base de conocimiento como un problema de GitHub.	Extension	Preview
az prototype status	Mostrar el estado actual del proyecto en todas las fases.	Extension	Preview

az prototype build

Vista previa

El grupo de comandos 'prototipo' está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Genere código de aplicación e infraestructura en la salida preconfigurada.

Usa el diseño de arquitectura para generar módulos de Terraform/Bicep, código de aplicación, scripts de base de datos y documentación.

Interactivo de forma predeterminada: la sesión de compilación usa avisos bordeados inspirados en Claude Code, indicadores de progreso, aplicación de directivas y un bucle de revisión conversacional.

Toda la salida se organiza en fases de implementación específicas ordenadas por dependencias. Cada componente de infraestructura, sistema de base de datos y aplicación obtiene su propia fase. Las plantillas de carga de trabajo se usan como puntos de partida opcionales cuando coinciden con el diseño.

Después de la generación, un informe de compilación muestra lo que se creó y puede proporcionar comentarios para volver a generar fases específicas. Escriba "done" para aceptar la compilación.

Comandos de barra diagonal durante la compilación: /status - Mostrar resumen de finalización de fases /stages - Mostrar plan de implementación completo /files - Enumerar todos los archivos generados /policy - Mostrar resumen de comprobación de directivas /help - Mostrar comandos disponibles

Use --dry-run para una versión preliminar no interactiva.

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

Ejemplos

Sesión de compilación interactiva (valor predeterminado)

az prototype build

Mostrar el progreso de la compilación actual

az prototype build --status

Borrar el estado de compilación e iniciarse de nuevo

az prototype build --reset

Compilar solo código de infraestructura

az prototype build --scope infra

Vista previa de lo que se generaría

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--auto-accept

Acepte automáticamente la recomendación predeterminada para infracciones de directivas y conflictos de estándares.

Propiedad	Valor
Valor predeterminado:	False

--dry-run

Obtenga una vista previa de lo que se generaría sin escribir archivos.

Propiedad	Valor
Valor predeterminado:	False

--reset

Borre el estado de compilación existente e inicie de nuevo.

Propiedad	Valor
Valor predeterminado:	False

--scope

Qué crear.

Propiedad	Valor
Valor predeterminado:	all
Valores aceptados:	all, apps, db, docs, infra

--status -s

Mostrar el progreso de la compilación actual sin iniciar una sesión.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az prototype deploy

Vista previa

El grupo de comandos 'prototipo' está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Implemente prototipo en Azure con implementaciones preconfiguradas interactivas.

Interactivo de forma predeterminada: ejecuta comprobaciones previas (suscripción, herramienta IaC, grupo de recursos, proveedores de recursos) y, a continuación, implementa fases secuencialmente con seguimiento de progreso y enrutamiento de errores qa-first.

Después de la implementación, escribe un bucle conversacional donde puede comprobar los cambios de estado, reversión, reimplementación o vista previa mediante comandos de barra diagonal.

Comandos de barra diagonal durante la implementación: /status: mostrar resumen de finalización de fases /stages: mostrar desglose de fase completa (alias para /status) /deploy N: implementar una fase específica (o "all" para pendiente) /rollback N: revertir una fase específica (o "todo" en orden inverso) /redeploy N: reversión y reimplementación de 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 (Mostrar comandos disponibles)

Use --dry-run para la versión preliminar del plan what-if o terraform no interactivo. Use --stage N para la implementación de una sola fase no interactiva. Use --stage N --dry-run para la versión preliminar what-if de una sola fase. Use --outputs para mostrar las salidas de implementación capturadas. Use --rollback-info para mostrar las instrucciones de reversión. Use --generate-scripts para generar deploy.sh para directorios de aplicaciones.

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]

Ejemplos

Sesión de implementación interactiva (valor predeterminado)

az prototype deploy

Mostrar el progreso de la implementación actual

az prototype deploy --status

Obtener una vista previa de todas las fases (what-if/terraform plan)

az prototype deploy --dry-run

Implementar solo la fase 2

az prototype deploy --stage 2

Forzar la reimplementación completa

az prototype deploy --force

Mostrar salidas de implementación capturadas

az prototype deploy --outputs

Mostrar instrucciones de reversión

az prototype deploy --rollback-info

Generación de scripts de implementación de App Service

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--client-id

Identificador de cliente o aplicación de entidad de servicio (o se establece a través de la configuración).

--client-secret

Secreto de cliente de la entidad de servicio (o se establece a través de la configuración).

--dry-run

Obtenga una vista previa de lo que se implementaría (what-if para Bicep, planee Terraform).

Propiedad	Valor
Valor predeterminado:	False

--force

Forzar la implementación completa, omitir el seguimiento de cambios.

Propiedad	Valor
Valor predeterminado:	False

--generate-scripts

Genere scripts de deploy.sh para directorios de aplicaciones.

Propiedad	Valor
Valor predeterminado:	False

--outputs

Mostrar las salidas de implementación capturadas de Terraform /Bicep.

Propiedad	Valor
Valor predeterminado:	False

--reset

Borre el estado de implementación y comience de nuevo.

Propiedad	Valor
Valor predeterminado:	False

--rollback-info

Mostrar instrucciones de reversión basadas en el historial de implementación.

Propiedad	Valor
Valor predeterminado:	False

--script-registry

Dirección URL del registro de contenedor para --generate-scripts (tipo container_app).

--script-resource-group

Nombre predeterminado del grupo de recursos para --generate-scripts.

--script-type

Tipo de destino de implementación de Azure para --generate-scripts.

Propiedad	Valor
Valor predeterminado:	webapp
Valores aceptados:	container_app, function, webapp

--service-principal

Autentíquese mediante una entidad de servicio antes de implementarla.

Propiedad	Valor
Valor predeterminado:	False

--stage

Implemente solo un número de fase específico (use --status para ver las fases).

--status -s

Mostrar el progreso de implementación actual sin iniciar una sesión.

Propiedad	Valor
Valor predeterminado:	False

--tenant

Identificador de inquilino de Azure AD para la implementación entre inquilinos.

--tenant-id

Identificador de inquilino para la autenticación de la entidad de servicio (o se establece a través de la configuración).

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az prototype design

Vista previa

El grupo de comandos 'prototipo' está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Analice los requisitos y genere el diseño de la arquitectura.

Lee artefactos (documentos, diagramas, especificaciones), interactúa con el agente de biz-analyst para identificar brechas y genera documentación de arquitectura.

Cuando se ejecuta sin parámetros, inicia un diálogo interactivo para capturar los requisitos a través de preguntas guiadas.

Con --interactive, entra en un bucle de refinamiento después de la generación de la arquitectura para que pueda revisar los cambios de diseño y solicitud.

El agente de biz-analyst siempre está comprometido ( incluso cuando se proporciona --context) para comprobar si faltan requisitos y suposiciones no estadísticas.

Esta fase es de reintento, ejecútelo de nuevo para refinar el diseño.

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

Ejemplos

Sesión de diseño interactiva (diálogo guiado)

az prototype design

Diseño interactivo con bucle de refinamiento de arquitectura

az prototype design --interactive

Diseño desde el directorio de artefactos

az prototype design --artifacts ./requirements/

Agregar contexto al diseño existente

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

Restablecer e iniciar el diseño nuevo

az prototype design --reset

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--artifacts

Ruta de acceso al directorio que contiene documentos de requisitos, diagramas u otros artefactos.

--context

Contexto o requisitos adicionales como texto libre.

--interactive -i

Escriba un bucle de refinamiento interactivo después de la generación de la arquitectura.

Propiedad	Valor
Valor predeterminado:	False

--reset

Restablezca el estado de diseño y comience de nuevo.

Propiedad	Valor
Valor predeterminado:	False

--skip-discovery

Omita la conversación de detección y genere la arquitectura directamente a partir del estado de detección existente.

Propiedad	Valor
Valor predeterminado:	False

--status -s

Mostrar el estado de detección actual (elementos abiertos, elementos confirmados) sin iniciar una sesión.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az prototype init

Vista previa

El grupo de comandos 'prototipo' está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Inicialice un nuevo proyecto de prototipo.

Configura el scaffolding del proyecto, crea el archivo de configuración del proyecto y, opcionalmente, se autentica con GitHub (valida la licencia de Copilot).

La autenticación de GitHub solo es necesaria para los proveedores de IA copilot y github-models. Al usar azure-openai, se omite completamente la autenticación de GitHub.

Si el directorio de destino ya contiene un prototype.yaml, el comando se pedirá antes de sobrescribir.

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

Ejemplos

Creación de un nuevo proyecto de prototipo

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

Inicialización con la preferencia de Bicep

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

Uso de Azure OpenAI (omite la autenticación de GitHub)

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

Especificar el entorno y el modelo

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ai-provider

Proveedor de IA para interacciones del agente.

Propiedad	Valor
Valor predeterminado:	copilot
Valores aceptados:	azure-openai, copilot, github-models

--environment

Entorno de destino para el prototipo.

Propiedad	Valor
Valor predeterminado:	dev
Valores aceptados:	dev, prod, staging

--iac-tool

Preferencia de la herramienta infraestructura como código.

Propiedad	Valor
Valor predeterminado:	terraform
Valores aceptados:	bicep, terraform

--location -l

Región de Azure para la implementación de recursos (por ejemplo, eastus).

--model

Modelo de IA que se va a usar (valor predeterminado: claude-sonnet-4.5 para copilot, gpt-4o para otros).

--name

Nombre del proyecto de prototipo.

--output-dir

Directorio de salida para archivos de proyecto.

Propiedad	Valor
Valor predeterminado:	.

--template

Plantilla de proyecto que se va a usar (por ejemplo, web-app, data-pipeline, ai-app).

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az prototype status

Vista previa

El grupo de comandos 'prototipo' está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar el estado actual del proyecto en todas las fases.

Muestra un resumen del proyecto de prototipo, incluida la configuración, el progreso de la fase (diseño, compilación, implementación) y cambios pendientes.

De forma predeterminada, muestra un resumen legible. Use --json para la salida legible por máquina adecuada para el scripting. Use --detailed para los detalles expandidos por fase.

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

Ejemplos

Mostrar el estado del proyecto

az prototype status

Mostrar el estado detallado con desglose por fase

az prototype status --detailed

Obtención de la salida JSON legible por la máquina

az prototype status --json

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detailed -d

Mostrar detalles expandidos por fase.

Propiedad	Valor
Valor predeterminado:	False

--json -j

Json legible por máquina de salida en lugar de mostrar con formato.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False