az prototype analyze

Note

This reference is part of the prototype extension for the Azure CLI (version 2.50.0 or higher). The extension will automatically install the first time you run an az prototype analyze command. Learn more about extensions.

Command group 'prototype' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Analyze errors, costs, and diagnostics for the prototype.

Provides analysis capabilities powered by specialized AI agents. Use 'error' to diagnose and fix issues, or 'costs' to estimate Azure spending at different scale tiers.

Commands

Name	Description	Type	Status
az prototype analyze costs	Estimate Azure costs at Small/Medium/Large t-shirt sizes.	Extension	Preview
az prototype analyze error	Analyze an error and get a fix with redeployment instructions.	Extension	Preview

az prototype analyze costs

Preview

Command group 'prototype analyze' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Estimate Azure costs at Small/Medium/Large t-shirt sizes.

Analyzes the current architecture design, queries Azure Retail Prices API for each component, and produces a cost report with estimates at three consumption tiers.

Results are cached in .prototype/state/cost_analysis.yaml. Re-running the command returns the cached result unless the design context has changed. Use --refresh to force a fresh analysis.

az prototype analyze costs [--acquire-policy-token]
                           [--change-reference]
                           [--json]
                           [--refresh]
                           [--report]
                           [--table]

Examples

Show cost summary table (default)

az prototype analyze costs

Show cost summary table only (no file save)

az prototype analyze costs --table

Show full detailed cost report

az prototype analyze costs --report

Get costs as JSON

az prototype analyze costs --json

Force fresh analysis (bypass cache)

az prototype analyze costs --refresh

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--json -j

Output machine-readable JSON instead of formatted display.

Property	Value
Default value:	False

--refresh

Force fresh analysis, bypassing cached results.

Property	Value
Default value:	False

--report

Display the full detailed cost report.

Property	Value
Default value:	False

--table

Display only the cost summary table.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az prototype analyze error

Preview

Command group 'prototype analyze' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Analyze an error and get a fix with redeployment instructions.

Accepts an inline error string, log file path, or screenshot image. The QA engineer agent identifies the root cause, proposes a fix, and tells you which commands to run to redeploy.

az prototype analyze error [--acquire-policy-token]
                           [--change-reference]
                           [--input]
                           [--json]

Examples

Analyze an inline error message

az prototype analyze error --input "ResourceNotFound - The Resource was not found"

Analyze a log file

az prototype analyze error --input ./deploy.log

Analyze a screenshot

az prototype analyze error --input ./error-screenshot.png

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--input

Error input to analyze. Can be an inline error string, path to a log file, or path to a screenshot image.

--json -j

Output machine-readable JSON instead of formatted display.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False