az prototype

注

このリファレンスは、Azure CLI (バージョン 2.50.0 以降) の プロトタイプ 拡張機能の一部です。 拡張機能は、 az prototype コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

AI 主導のエージェント チームを使用して Azure プロトタイプを迅速に作成します。

az プロトタイプ拡張機能を使用すると、GitHub Copilot または Azure OpenAI を利用したインテリジェント なエージェント チームを使用して、機能的な Azure プロトタイプを構築できます。

ワークフロー: ビルド→デプロイ→設計→初期化する

各ステージは (前提条件のガードを使用して) 個別に実行でき、ほとんどのステージは再入可能です。設計を調整したり、特定のコンポーネントを再構築したりすることもできます。

分析コマンドを使用すると、エラーを診断し、いつでもコストを見積もります。

コマンド

名前	説明	型	状態
az prototype agent	プロトタイプ生成用の AI エージェントを管理します。	Extension	Preview
az prototype agent add	カスタム エージェントをプロジェクトに追加します。	Extension	Preview
az prototype agent export	任意のエージェント (組み込みを含む) を YAML ファイルとしてエクスポートします。	Extension	Preview
az prototype agent list	使用可能なすべてのエージェント (組み込みおよびカスタム) を一覧表示します。	Extension	Preview
az prototype agent override	組み込みエージェントをカスタム定義でオーバーライドします。	Extension	Preview
az prototype agent remove	カスタム エージェントまたはオーバーライドを削除します。	Extension	Preview
az prototype agent show	特定のエージェントの詳細を表示します。	Extension	Preview
az prototype agent test	任意のエージェントにテスト プロンプトを送信し、応答を表示します。	Extension	Preview
az prototype agent update	既存のカスタム エージェントのプロパティを更新します。	Extension	Preview
az prototype analyze	プロトタイプのエラー、コスト、診断を分析します。	Extension	Preview
az prototype analyze costs	小/中/大の T シャツ サイズで Azure のコストを見積もります。	Extension	Preview
az prototype analyze error	エラーを分析し、再デプロイ手順を使用して修正を取得します。	Extension	Preview
az prototype build	ステージング出力でインフラストラクチャとアプリケーション コードを生成します。	Extension	Preview
az prototype config	プロトタイプ プロジェクトの構成を管理します。	Extension	Preview
az prototype config get	1 つの構成値を取得します。	Extension	Preview
az prototype config init	prototype.yaml 構成ファイルを作成するための対話型セットアップ。	Extension	Preview
az prototype config set	構成値を設定します。	Extension	Preview
az prototype config show	現在のプロジェクト構成を表示します。	Extension	Preview
az prototype deploy	対話型のステージング デプロイを使用してプロトタイプを Azure にデプロイします。	Extension	Preview
az prototype design	要件を分析し、アーキテクチャ設計を生成します。	Extension	Preview
az prototype generate	ドキュメントと仕様キット成果物を生成します。	Extension	Preview
az prototype generate backlog	バックログを生成し、作業項目を GitHub または Azure DevOps にプッシュします。	Extension	Preview
az prototype generate docs	AI 母集団を使用してテンプレートからドキュメントを生成します。	Extension	Preview
az prototype generate speckit	AI 母集団を含む spec-kit ドキュメント バンドルを生成します。	Extension	Preview
az prototype init	新しいプロトタイプ プロジェクトを初期化します。	Extension	Preview
az prototype knowledge	ナレッジ ベースの投稿を管理します。	Extension	Preview
az prototype knowledge contribute	GitHub イシューとしてナレッジ ベースの投稿を送信します。	Extension	Preview
az prototype status	すべてのステージで現在のプロジェクトの状態を表示します。	Extension	Preview

az prototype build

プレビュー

コマンド グループ 'プロトタイプ' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

ステージング出力でインフラストラクチャとアプリケーション コードを生成します。

アーキテクチャ設計を使用して、Terraform/Bicep モジュール、アプリケーション コード、データベース スクリプト、およびドキュメントを生成します。

既定では対話型 — ビルド セッションでは、Claude Code に着想を得た境界付きプロンプト、進行状況インジケーター、ポリシーの適用、会話レビュー ループが使用されます。

すべての出力は、詳細な依存関係順のデプロイ ステージに編成されます。 各インフラストラクチャ コンポーネント、データベース システム、およびアプリケーションは、独自のステージを取得します。 ワークロード テンプレートは、設計に一致する場合に、省略可能な開始点として使用されます。

生成後、ビルド レポートにビルドされた内容が表示され、フィードバックを提供して特定のステージを再生成できます。 ビルドを受け入れるには「done」と入力します。

ビルド中のスラッシュ コマンド: /status - ステージ完了の概要 /ステージを表示する - 完全な展開計画 /ファイルを表示する - 生成されたすべてのファイル /ポリシーを一覧表示する - ポリシー チェックの概要 /ヘルプを表示する - 使用可能なコマンドを表示する

非対話型プレビューには --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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--auto-accept

ポリシー違反と標準の競合に対する既定の推奨事項を自動的に受け入れます。

プロパティ	値
規定値:	False

--dry-run

ファイルを書き込まずに生成される内容をプレビューします。

プロパティ	値
規定値:	False

--reset

既存のビルド状態をクリアし、新たに開始します。

プロパティ	値
規定値:	False

--scope

ビルドする内容。

プロパティ	値
規定値:	all
指定可能な値:	all, apps, db, docs, infra

--status -s

セッションを開始せずに、現在のビルドの進行状況を表示します。

プロパティ	値
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az prototype deploy

プレビュー

コマンド グループ 'プロトタイプ' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

対話型のステージング デプロイを使用してプロトタイプを Azure にデプロイします。

既定では対話型 — プレフライト チェック (サブスクリプション、IaC ツール、リソース グループ、リソース プロバイダー) を実行し、進行状況の追跡と QA 優先のエラー ルーティングを使用して段階的にステージをデプロイします。

デプロイ後、スラッシュ コマンドを使用して状態の確認、ロールバック、再デプロイ、または変更のプレビューを行うことができる会話型ループに入ります。

展開中のスラッシュ コマンド: /status - ステージ完了の概要 /ステージを表示する - 完全なステージの内訳を表示する (/status のエイリアス) /deploy N - 特定のステージをデプロイする (保留中の場合は 'all' ) /rollback N - 特定のステージをロールバックする (または 'all' で) reverse order) /redeploy N - ステージ /plan N をロールバックして再デプロイする - ステージ /出力の What-if/terraform プラン - キャプチャされたデプロイ出力を表示する /プレフライト - プレフライト チェックを再実行する /help - 使用可能なコマンドを表示する

--dry-run は、非対話型の what-if/terraform プラン プレビューに使用します。 非対話型の単一ステージデプロイには --stage N を使用します。 単一ステージの what-if プレビューには、--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

App Service デプロイ スクリプトを生成する

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--client-id

サービス プリンシパル アプリケーション/クライアント ID (または構成を使用して設定)。

--client-secret

サービス プリンシパル クライアント シークレット (または構成を使用して設定)。

--dry-run

デプロイされる内容をプレビューします (Bicep の場合は、Terraform を計画します)。

プロパティ	値
規定値:	False

--force

変更の追跡を無視して、完全なデプロイを強制します。

プロパティ	値
規定値:	False

--generate-scripts

アプリケーション ディレクトリの deploy.sh スクリプトを生成します。

プロパティ	値
規定値:	False

--outputs

Terraform/Bicep からキャプチャされたデプロイ出力を表示します。

プロパティ	値
規定値:	False

--reset

デプロイ状態をクリアし、新たに開始します。

プロパティ	値
規定値:	False

--rollback-info

デプロイ履歴に基づいてロールバック手順を表示します。

プロパティ	値
規定値:	False

--script-registry

--generate-scripts (container_app 型) のコンテナー レジストリ URL。

--script-resource-group

--generate-scripts の既定のリソース グループ名。

--script-type

--generate-scripts の Azure デプロイ ターゲットの種類。

プロパティ	値
規定値:	webapp
指定可能な値:	container_app, function, webapp

--service-principal

デプロイする前に、サービス プリンシパルを使用して認証します。

プロパティ	値
規定値:	False

--stage

特定のステージ番号のみをデプロイします (--status を使用してステージを表示します)。

--status -s

セッションを開始せずに、現在のデプロイの進行状況を表示します。

プロパティ	値
規定値:	False

--tenant

テナント間デプロイ用の Azure AD テナント ID。

--tenant-id

サービス プリンシパル認証のテナント ID (または構成を使用して設定)。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az prototype design

プレビュー

コマンド グループ 'プロトタイプ' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

要件を分析し、アーキテクチャ設計を生成します。

成果物 (ドキュメント、図、仕様) を読み取り、biz-analyst エージェントと連携してギャップを特定し、アーキテクチャ ドキュメントを生成します。

パラメーターを指定せずに実行する場合は、対話型ダイアログを開始して、ガイド付き質問を通じて要件をキャプチャします。

--interactive を使用すると、アーキテクチャの生成後に絞り込みループに入り、設計を確認して変更を要求できます。

biz-analyst エージェントは、--context が提供されている場合でも常に関与し、不足している要件と控えめな前提条件を確認します。

この段階は再参加です。デザインを改良するためにもう一度実行します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--artifacts

要件ドキュメント、ダイアグラム、またはその他の成果物を含むディレクトリへのパス。

--context

フリー テキストとしての追加のコンテキストまたは要件。

--interactive -i

アーキテクチャの生成後に対話型の絞り込みループを入力します。

プロパティ	値
規定値:	False

--reset

デザイン状態をリセットし、新たに開始します。

プロパティ	値
規定値:	False

--skip-discovery

検出の会話をスキップし、既存の検出状態から直接アーキテクチャを生成します。

プロパティ	値
規定値:	False

--status -s

セッションを開始せずに、現在の検出状態 (開いているアイテム、確認済みアイテム) を表示します。

プロパティ	値
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az prototype init

プレビュー

コマンド グループ 'プロトタイプ' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

新しいプロトタイプ プロジェクトを初期化します。

プロジェクトスキャフォールディングを設定し、プロジェクト構成ファイルを作成し、必要に応じて GitHub で認証します (Copilot ライセンスを検証します)。

GitHub 認証は、コピロットと github モデルの AI プロバイダーにのみ必要です。 azure-openai を使用する場合、GitHub 認証は完全にスキップされます。

ターゲット ディレクトリに既に prototype.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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--ai-provider

エージェントの対話のための AI プロバイダー。

プロパティ	値
規定値:	copilot
指定可能な値:	azure-openai, copilot, github-models

--environment

プロトタイプのターゲット環境。

プロパティ	値
規定値:	dev
指定可能な値:	dev, prod, staging

--iac-tool

コードとしてのインフラストラクチャ ツールの基本設定。

プロパティ	値
規定値:	terraform
指定可能な値:	bicep, terraform

--location -l

リソースデプロイ用の Azure リージョン (例: eastus)。

--model

使用する AI モデル (既定: copilot の場合は claude-sonnet-4.5、他の場合は gpt-4o)。

--name

プロトタイプ プロジェクトの名前。

--output-dir

プロジェクト ファイルの出力ディレクトリ。

プロパティ	値
規定値:	.

--template

使用するプロジェクト テンプレート (Web アプリ、データ パイプライン、ai アプリなど)。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az prototype status

プレビュー

コマンド グループ 'プロトタイプ' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

すべてのステージで現在のプロジェクトの状態を表示します。

構成、ステージの進行状況 (設計、ビルド、配置)、保留中の変更など、プロトタイプ プロジェクトの概要を表示します。

既定では、人間が判読できる概要が表示されます。 スクリプトに適したマシン読み取り可能な出力には --json を使用します。 --detailed を使用して、ステージごとの詳細を拡張します。

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

例

プロジェクトの状態を表示する

az prototype status

ステージごとの内訳で詳細な状態を表示する

az prototype status --detailed

マシンが読み取り可能な JSON 出力を取得する

az prototype status --json

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--detailed -d

展開されたステージごとの詳細を表示します。

プロパティ	値
規定値:	False

--json -j

書式設定された表示ではなく、コンピューターが読み取り可能な JSON を出力します。

プロパティ	値
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False