az prototype

비고

이 참조는 Azure CLI(버전 2.50.0 이상)에 대한 프로토타입 확장의 일부입니다. az prototype 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

AI 기반 에이전트 팀을 사용하여 Azure 프로토타입을 신속하게 만듭니다.

az 프로토타입 확장을 사용하면 GitHub Copilot 또는 Azure OpenAI에서 제공하는 지능형 에이전트 팀을 사용하여 기능적인 Azure 프로토타입을 빌드할 수 있습니다.

워크플로: 빌드 → 배포를 → 디자인 → init

각 스테이지는 독립적으로 실행할 수 있으며(필수 구성 요소 가드 포함) 대부분의 스테이지는 재입력됩니다. 즉, 디자인을 구체화하거나 특정 구성 요소를 다시 빌드할 수 있습니다.

분석 명령을 사용하면 언제든지 오류를 진단하고 비용을 예측할 수 있습니다.

명령

Name	Description	형식	상태
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	Azure 비용을 중소/중형/대형 티셔츠 크기로 예측합니다.	Extension	Preview
az prototype analyze error	오류를 분석하고 재배포 지침을 사용하여 수정합니다.	Extension	Preview
az prototype build	준비된 출력에서 인프라 및 애플리케이션 코드를 생성합니다.	Extension	Preview
az prototype config	프로토타입 프로젝트 구성을 관리합니다.	Extension	Preview
az prototype config get	단일 구성 값을 가져옵니다.	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 모집단을 사용하여 사양 키트 설명서 번들을 생성합니다.	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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az prototype deploy

미리 보기

명령 그룹 '프로토타입'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

대화형 스테이징 배포를 사용하여 Azure에 프로토타입을 배포합니다.

대화형은 기본적으로 실행 전 검사(구독, IaC 도구, 리소스 그룹, 리소스 공급자)를 실행한 다음 진행률 추적 및 QA 우선 오류 라우팅을 사용하여 단계를 순차적으로 배포합니다.

배포 후 슬래시 명령을 사용하여 상태, 롤백, 다시 배포 또는 미리 보기 변경 내용을 확인할 수 있는 대화형 루프를 입력합니다.

배포 중 명령 슬래시: /status - 스테이지 완료 요약 /스테이지 표시 - 전체 스테이지 분석 표시(/상태 별칭) /deploy N - 특정 스테이지 배포(또는 보류 중인 경우 'all' ) /rollback N - 특정 스테이지 롤백(또는 'all'을 역방향으로 롤백합니다. order) /redeploy N - 스테이지 /plan N 롤백 및 재배포 - 단계 /출력에 대한 What-if/terraform 계획 - 캡처된 배포 출력 표시 /preflight - 실행 전 검사 다시 실행 /도움말 - 사용 가능한 명령 표시

비대화형 what-if/terraform 계획 미리 보기에 --dry-run을 사용합니다. 비대화형 단일 스테이지 배포에는 --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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--client-id

서비스 주체 애플리케이션/클라이언트 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

--generate-scripts(container_app 형식)에 대한 컨테이너 레지스트리 URL입니다.

--script-resource-group

--generate-scripts의 기본 리소스 그룹 이름입니다.

--script-type

--generate-scripts에 대한 Azure 배포 대상 유형입니다.

속성	값
Default value:	webapp
허용되는 값:	container_app, function, webapp

--service-principal

배포하기 전에 서비스 주체를 사용하여 인증합니다.

속성	값
Default value:	False

--stage

특정 스테이지 번호만 배포합니다(--status를 사용하여 스테이지 보기).

--status -s

세션을 시작하지 않고 현재 배포 진행률을 표시합니다.

속성	값
Default value:	False

--tenant

테넌트 간 배포를 위한 Azure AD 테넌트 ID입니다.

--tenant-id

서비스 주체 인증(또는 구성을 통해 설정)에 대한 테넌트 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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--ai-provider

에이전트 상호 작용을 위한 AI 공급자입니다.

속성	값
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

사용할 AI 모델(기본값: 부조종사에 대해 claude-sonnet-4.5, 다른 사람의 경우 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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False