az prototype

Замечание

Эта ссылка является частью расширения прототипа для Azure CLI (версия 2.50.0 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az prototype . Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Быстро создайте прототипы Azure с помощью команд агентов на основе ИИ.

Расширение az prototype позволяет создавать функциональные прототипы Azure с помощью команд gitHub Copilot или Azure OpenAI.

Рабочий процесс: развертывание → сборки → инициализации → разработки

Каждый этап можно запускать независимо (с предварительными ограничениями), и большинство этапов являются повторным записью— вы можете вернуться, чтобы уточнить дизайн или перестроить определенные компоненты.

Команды анализа позволяют диагностировать ошибки и оценивать затраты в любой момент.

Команды

Имя	Описание	Тип	Состояние
az prototype agent	Управление агентами ИИ для создания прототипов.	Расширение	Preview
az prototype agent add	Добавьте в проект пользовательский агент.	Расширение	Preview
az prototype agent export	Экспорт любого агента (включая встроенный) в виде YAML-файла.	Расширение	Preview
az prototype agent list	Перечислить все доступные агенты (встроенные и настраиваемые).	Расширение	Preview
az prototype agent override	Переопределите встроенный агент с пользовательским определением.	Расширение	Preview
az prototype agent remove	Удалите настраиваемый агент или переопределите.	Расширение	Preview
az prototype agent show	Отображение сведений о конкретном агенте.	Расширение	Preview
az prototype agent test	Отправьте тестовый запрос любому агенту и отобразите ответ.	Расширение	Preview
az prototype agent update	Обновите свойства существующего пользовательского агента.	Расширение	Preview
az prototype analyze	Анализ ошибок, затрат и диагностики прототипа.	Расширение	Preview
az prototype analyze costs	Оцените затраты Azure на размер футболки малого или среднего или большого размера.	Расширение	Preview
az prototype analyze error	Проанализируйте ошибку и получите исправление с инструкциями по повторному развертыванию.	Расширение	Preview
az prototype build	Создание кода инфраструктуры и приложения в промежуточных выходных данных.	Расширение	Preview
az prototype config	Управление конфигурацией проекта прототипа.	Расширение	Preview
az prototype config get	Получите одно значение конфигурации.	Расширение	Preview
az prototype config init	Интерактивная настройка для создания файла конфигурации prototype.yaml.	Расширение	Preview
az prototype config set	Задайте значение конфигурации.	Расширение	Preview
az prototype config show	Отображение текущей конфигурации проекта.	Расширение	Preview
az prototype deploy	Развертывание прототипа в Azure с интерактивными промежуточными развертываниями.	Расширение	Preview
az prototype design	Анализ требований и создание архитектуры.	Расширение	Preview
az prototype generate	Создание артефактов пакета спецификаций и документации.	Расширение	Preview
az prototype generate backlog	Создайте невыполненную работу и отправьте рабочие элементы в GitHub или Azure DevOps.	Расширение	Preview
az prototype generate docs	Создание документации из шаблонов с помощью ИИ.	Расширение	Preview
az prototype generate speckit	Создайте пакет документации по спецификациям с использованием ИИ.	Расширение	Preview
az prototype init	Инициализация нового проекта прототипа.	Расширение	Preview
az prototype knowledge	Управление вкладами базы знаний.	Расширение	Preview
az prototype knowledge contribute	Отправьте вклад базы знаний в качестве проблемы с GitHub.	Расширение	Preview
az prototype status	Отображение текущего состояния проекта на всех этапах.	Расширение	Preview

az prototype build

Предварительный просмотр

Группа команд "прототип" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создание кода инфраструктуры и приложения в промежуточных выходных данных.

Использует структуру архитектуры для создания модулей Terraform/Bicep, кода приложения, скриптов баз данных и документации.

Интерактивный по умолчанию — в сеансе сборки используются пограничные запросы Claude Code, индикаторы хода выполнения, принудительное применение политики и цикл проверки диалога.

Все выходные данные организованы на детально упорядоченные этапы развертывания. Каждый компонент инфраструктуры, система базы данных и приложение получают свой собственный этап. Шаблоны рабочих нагрузок используются в качестве необязательных отправных точек, когда они соответствуют дизайну.

После создания отчет о сборке показывает, что было создано, и вы можете предоставить обратную связь для повторного создания определенных этапов. Введите "готово", чтобы принять сборку.

Команды косой черты во время сборки: /status — показать сводку завершения этапа /этапы . Показать полный план развертывания /files — список всех созданных файлов /policy — показать сводку по политике /справка . Показать доступные команды

Используйте --dry-run для неинтерактивной предварительной версии.

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

Примеры

Интерактивный сеанс сборки (по умолчанию)

az prototype build

Отображение текущего хода выполнения сборки

az prototype build --status

Очистка состояния сборки и запуск свежих

az prototype build --reset

Создание только кода инфраструктуры

az prototype build --scope infra

Предварительный просмотр того, что будет создано

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--auto-accept

Автоматически примите рекомендацию по умолчанию для нарушений политики и конфликтов стандартов.

Свойство	Значение
Default value:	False

--dry-run

Предварительный просмотр того, что будет создано без записи файлов.

Свойство	Значение
Default value:	False

--reset

Очистите существующее состояние сборки и запустите новую.

Свойство	Значение
Default value:	False

--scope

Что нужно создать.

Свойство	Значение
Default value:	all
Допустимые значения:	all, apps, db, docs, infra

--status -s

Отображение текущего хода выполнения сборки без запуска сеанса.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az prototype deploy

Предварительный просмотр

Группа команд "прототип" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Развертывание прототипа в Azure с интерактивными промежуточными развертываниями.

Интерактивный по умолчанию — выполняет предварительные проверки (подписка, средство IaC, группа ресурсов, поставщики ресурсов), а затем развертывает этапы последовательно с отслеживанием хода выполнения и маршрутизацией ошибок QA-first.

После развертывания введите цикл беседы, где можно проверить состояние, откат, повторное развертывание или предварительный просмотр изменений с помощью команд косой черты.

Команды косой черты во время развертывания: /status — показать сводку завершения этапа /этапы . Показать полную разбивку этапов (псевдоним /status) /deploy a specific stage (or all" for pending) /rollback N — откат определенного этапа (или "все" для ожидания) /rollback N — откат определенного этапа (или "все" в обратном порядке) /повторное развертывание N — откат и повторное развертывание этапа /plan N - What-if / terraform plan for a stage /outputs - Showd captured deployment outputs /preflight - Re-run pre-flight checks /help - Show available commands

Используйте --dry-run для неинтерактивной предварительной версии плана what-if / terraform. Используйте --stage N для неинтерактивного одноэтапного развертывания. Используйте --stage N --dry-run для предварительной версии одного этапа. Используйте выходные данные --outputs для отображения захваченных выходных данных развертывания. Используйте --rollback-info для отображения инструкций по откату. Используйте скрипты --generate-scripts для создания deploy.sh для каталогов приложений.

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]

Примеры

Интерактивный сеанс развертывания (по умолчанию)

az prototype deploy

Отображение текущего хода развертывания

az prototype deploy --status

Предварительный просмотр всех этапов (план what-if / terraform)

az prototype deploy --dry-run

Развертывание только этапа 2

az prototype deploy --stage 2

Принудительное развертывание

az prototype deploy --force

Отображение захваченных выходных данных развертывания

az prototype deploy --outputs

Отображение инструкций по откату

az prototype deploy --rollback-info

Создание скриптов развертывания службы приложений

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--client-id

Идентификатор приложения или клиента субъекта-службы (или задать с помощью конфигурации).

--client-secret

Секрет клиента субъекта-службы (или задан с помощью конфигурации).

--dry-run

Предварительная версия развертывания (что если для Bicep, план для Terraform).

Свойство	Значение
Default value:	False

--force

Принудительное полное развертывание, игнорируя отслеживание изменений.

Свойство	Значение
Default value:	False

--generate-scripts

Создайте скрипты deploy.sh для каталогов приложений.

Свойство	Значение
Default value:	False

--outputs

Отображение полученных выходных данных развертывания из Terraform /Bicep.

Свойство	Значение
Default value:	False

--reset

Снимите состояние развертывания и запустите новое.

Свойство	Значение
Default value:	False

--rollback-info

Отображение инструкций отката на основе журнала развертывания.

Свойство	Значение
Default value:	False

--script-registry

URL-адрес реестра контейнеров для скриптов --generate-scripts (тип container_app).

--script-resource-group

Имя группы ресурсов по умолчанию для скриптов --generate-scripts.

--script-type

Целевой тип развертывания Azure для скриптов --generate-scripts.

Свойство	Значение
Default value:	webapp
Допустимые значения:	container_app, function, webapp

--service-principal

Проверка подлинности с помощью субъекта-службы перед развертыванием.

Свойство	Значение
Default value:	False

--stage

Разверните только определенный номер этапа (используйте состояние --status для просмотра этапов).

--status -s

Отображение текущего хода развертывания без запуска сеанса.

Свойство	Значение
Default value:	False

--tenant

Идентификатор клиента Azure AD для развертывания между клиентами.

--tenant-id

Идентификатор клиента для проверки подлинности субъекта-службы (или задан с помощью конфигурации).

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az prototype design

Предварительный просмотр

Группа команд "прототип" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Анализ требований и создание архитектуры.

Считывает артефакты (документы, схемы, спецификации), привлекает агент biz-аналитика для выявления пробелов и создает документацию по архитектуре.

При запуске без параметров запускает интерактивный диалог для отслеживания требований с помощью интерактивных вопросов.

С помощью --interactive введите цикл уточнения после создания архитектуры, чтобы просмотреть изменения дизайна и запроса.

Агент бизнес-аналитика всегда участвует , даже если предоставляется контекст - для проверки отсутствующих требований и несовпадающих предположений.

Этот этап повторно входит в систему — запустите его еще раз, чтобы уточнить структуру.

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

Примеры

Интерактивный сеанс проектирования (интерактивный диалог)

az prototype design

Интерактивный дизайн с циклом уточнения архитектуры

az prototype design --interactive

Проектирование из каталога артефактов

az prototype design --artifacts ./requirements/

Добавление контекста в существующую структуру

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

Сброс и начало разработки

az prototype design --reset

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--artifacts

Путь к каталогу, содержащий документы, схемы или другие артефакты.

--context

Дополнительный контекст или требования в виде свободного текста.

--interactive -i

Введите интерактивный цикл уточнения после создания архитектуры.

Свойство	Значение
Default value:	False

--reset

Сброс состояния конструктора и запуск свежих.

Свойство	Значение
Default value:	False

--skip-discovery

Пропустите беседу обнаружения и создайте архитектуру непосредственно из существующего состояния обнаружения.

Свойство	Значение
Default value:	False

--status -s

Отображение текущего состояния обнаружения (открытые элементы, подтвержденные элементы) без запуска сеанса.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az prototype init

Предварительный просмотр

Группа команд "прототип" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Инициализация нового проекта прототипа.

Настраивает шаблон проекта, создает файл конфигурации проекта и при необходимости выполняет проверку подлинности с помощью GitHub (проверяет лицензию Copilot).

Проверка подлинности GitHub требуется только для поставщиков ИИ для copilot и github-models. При использовании azure-openai проверка подлинности GitHub пропускается полностью.

Если целевой каталог уже содержит прототип.yaml, команда будет запрашивать перед перезаписью.

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

Примеры

Создание проекта прототипа

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

Инициализация с помощью предпочтения Bicep

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

Использование Azure OpenAI (пропускает проверку подлинности GitHub)

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

Указание среды и модели

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--ai-provider

Поставщик ИИ для взаимодействия агента.

Свойство	Значение
Default value:	copilot
Допустимые значения:	azure-openai, copilot, github-models

--environment

Целевая среда для прототипа.

Свойство	Значение
Default value:	dev
Допустимые значения:	dev, prod, staging

--iac-tool

Предпочтения средства "Инфраструктура как код".

Свойство	Значение
Default value:	terraform
Допустимые значения:	bicep, terraform

--location -l

Регион Azure для развертывания ресурсов (например, eastus).

--model

Модель искусственного интеллекта для использования (по умолчанию: claude-sonnet-4.5 для copilot, gpt-4o для других).

--name

Имя проекта прототипа.

--output-dir

Выходной каталог для файлов проекта.

Свойство	Значение
Default value:	.

--template

Шаблон проекта для использования (например, веб-приложение, конвейер данных, ai-app).

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az prototype status

Предварительный просмотр

Группа команд "прототип" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отображение текущего состояния проекта на всех этапах.

Отображает сводку проекта прототипа, включая конфигурацию, ход выполнения этапа (проектирование, сборку, развертывание) и ожидающие изменения.

По умолчанию отображается читаемая человеком сводка. Используйте --json для выходных данных, доступных для машинного чтения, подходящих для сценариев. Используйте подробные сведения о каждом этапе.

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

Примеры

Отображение состояния проекта

az prototype status

Отображение подробного состояния с разбивкой на каждый этап

az prototype status --detailed

Получение выходных данных JSON, доступных для чтения компьютера

az prototype status --json

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--detailed -d

Отображение развернутых сведений на каждом этапе.

Свойство	Значение
Default value:	False

--json -j

Выходные данные json, доступные для чтения компьютера, вместо отформатированного отображения.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False