Bagikan melalui


az prototype

Nota

Referensi ini adalah bagian dari ekstensi prototipe untuk Azure CLI (versi 2.50.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az prototype . Pelajari selengkapnya tentang ekstensi.

Grup perintah ini dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Buat prototipe Azure dengan cepat menggunakan tim agen berbasis AI.

Ekstensi prototipe az memberdayakan Anda untuk membangun prototipe Azure fungsional menggunakan tim agen cerdas yang didukung oleh GitHub Copilot atau Azure OpenAI.

Alur kerja: init → desain → build → deploy

Setiap tahap dapat dijalankan secara independen (dengan penjaga prasyarat) dan sebagian besar tahapan dilalui kembali — Anda dapat kembali untuk memperbaiki desain atau membangun kembali komponen tertentu.

Perintah analisis memungkinkan Anda mendiagnosis kesalahan dan memperkirakan biaya kapan saja.

Perintah

Nama Deskripsi Jenis Status
az prototype agent

Mengelola agen AI untuk pembuatan prototipe.

Ekstensi Pratinjau
az prototype agent add

Tambahkan agen kustom ke proyek.

Ekstensi Pratinjau
az prototype agent export

Ekspor agen apa pun (termasuk bawaan) sebagai file YAML.

Ekstensi Pratinjau
az prototype agent list

Cantumkan semua agen yang tersedia (bawaan dan kustom).

Ekstensi Pratinjau
az prototype agent override

Mengambil alih agen bawaan dengan definisi kustom.

Ekstensi Pratinjau
az prototype agent remove

Hapus agen kustom atau ambil alih.

Ekstensi Pratinjau
az prototype agent show

Tampilkan detail agen tertentu.

Ekstensi Pratinjau
az prototype agent test

Kirim permintaan pengujian ke agen mana pun dan tampilkan responsnya.

Ekstensi Pratinjau
az prototype agent update

Perbarui properti agen kustom yang sudah ada.

Ekstensi Pratinjau
az prototype analyze

Menganalisis kesalahan, biaya, dan diagnostik untuk prototipe.

Ekstensi Pratinjau
az prototype analyze costs

Perkirakan biaya Azure pada ukuran t-shirt Kecil/Sedang/Besar.

Ekstensi Pratinjau
az prototype analyze error

Analisis kesalahan dan dapatkan perbaikan dengan instruksi penyebaran ulang.

Ekstensi Pratinjau
az prototype build

Hasilkan infrastruktur dan kode aplikasi dalam output bertahap.

Ekstensi Pratinjau
az prototype config

Mengelola konfigurasi proyek prototipe.

Ekstensi Pratinjau
az prototype config get

Dapatkan satu nilai konfigurasi.

Ekstensi Pratinjau
az prototype config init

Penyiapan interaktif untuk membuat file konfigurasi prototype.yaml.

Ekstensi Pratinjau
az prototype config set

Tetapkan nilai konfigurasi.

Ekstensi Pratinjau
az prototype config show

Tampilkan konfigurasi proyek saat ini.

Ekstensi Pratinjau
az prototype deploy

Sebarkan prototipe ke Azure dengan penyebaran bertahap interaktif.

Ekstensi Pratinjau
az prototype design

Menganalisis persyaratan dan menghasilkan desain arsitektur.

Ekstensi Pratinjau
az prototype generate

Hasilkan artefak dokumentasi dan spec-kit.

Ekstensi Pratinjau
az prototype generate backlog

Buat backlog dan dorong item kerja ke GitHub atau Azure DevOps.

Ekstensi Pratinjau
az prototype generate docs

Buat dokumentasi dari templat dengan populasi AI.

Ekstensi Pratinjau
az prototype generate speckit

Hasilkan bundel dokumentasi spec-kit dengan populasi AI.

Ekstensi Pratinjau
az prototype init

Menginisialisasi proyek prototipe baru.

Ekstensi Pratinjau
az prototype knowledge

Mengelola kontribusi pangkalan pengetahuan.

Ekstensi Pratinjau
az prototype knowledge contribute

Kirimkan kontribusi pangkalan pengetahuan sebagai Masalah GitHub.

Ekstensi Pratinjau
az prototype launch

Luncurkan dasbor TUI interaktif.

Ekstensi Pratinjau
az prototype status

Tampilkan status proyek saat ini di semua tahap.

Ekstensi Pratinjau

az prototype build

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Hasilkan infrastruktur dan kode aplikasi dalam output bertahap.

Menggunakan desain arsitektur untuk menghasilkan modul Terraform/Bicep, kode aplikasi, skrip database, dan dokumentasi.

Interaktif secara default — sesi build menggunakan perintah berbatasan yang terinspirasi Claude Code, indikator kemajuan, penegakan kebijakan, dan perulangan tinjauan percakapan.

Semua output diatur ke dalam tahap penyebaran terperinci dan diurutkan dependensi. Setiap komponen infrastruktur, sistem database, dan aplikasi mendapatkan tahapannya sendiri. Templat beban kerja digunakan sebagai titik awal opsional saat cocok dengan desain.

Setelah pembuatan, laporan build menunjukkan apa yang dibuat dan Anda dapat memberikan umpan balik untuk meregenerasi tahap tertentu. Ketik 'selesai' untuk menerima build.

Perintah garis miring selama build: /status - Tampilkan ringkasan /tahap penyelesaian tahap - Tampilkan rencana penyebaran lengkap /file - Cantumkan semua file /kebijakan yang dihasilkan - Tampilkan ringkasan pemeriksaan kebijakan /bantuan - Tampilkan perintah yang tersedia

Gunakan --dry-run untuk pratinjau non-interaktif.

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

Contoh

Sesi build interaktif (default)

az prototype build

Perlihatkan kemajuan build saat ini

az prototype build --status

Bersihkan status build dan mulai dari awal

az prototype build --reset

Hanya bangun kode infrastruktur

az prototype build --scope infra

Pratinjau apa yang akan dihasilkan

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--auto-accept

Secara otomatis menerima rekomendasi default untuk pelanggaran kebijakan dan konflik standar.

Properti Nilai
Nilai default: False
--dry-run

Pratinjau apa yang akan dihasilkan tanpa menulis file.

Properti Nilai
Nilai default: False
--reset

Bersihkan status build yang ada dan mulai dari awal.

Properti Nilai
Nilai default: False
--scope

Apa yang harus dibangun.

Properti Nilai
Nilai default: all
Nilai yang diterima: all, apps, db, docs, infra
--status -s

Tampilkan kemajuan build saat ini tanpa memulai sesi.

Properti Nilai
Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False

az prototype deploy

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Sebarkan prototipe ke Azure dengan penyebaran bertahap interaktif.

Interaktif secara default — menjalankan pemeriksaan preflight (langganan, alat IaC, grup sumber daya, penyedia sumber daya), lalu menyebarkan tahapan secara berurutan dengan pelacakan kemajuan dan perutean kesalahan QA-first.

Setelah penyebaran, masukkan perulangan percakapan tempat Anda dapat memeriksa perubahan status, pembatalan, penyebaran ulang, atau pratinjau menggunakan perintah garis miring.

Perintah garis miring selama penyebaran: /status - Tampilkan ringkasan /tahap penyelesaian tahap - Tampilkan perincian tahap penuh (alias untuk /status) /deploy N - Sebarkan tahap tertentu (atau 'semua' untuk tertunda) /rollback N - Gulung balik tahap tertentu (atau 'semua' di reverse order) /redeploy N - Roll back dan sebarkan ulang tahap /plan N - Bagaimana-jika / terraform plan untuk tahap /outputs - Tampilkan output penyebaran yang diambil /preflight - Jalankan kembali pemeriksaan preflight /help - Tampilkan perintah yang tersedia

Gunakan --dry-run untuk pratinjau rencana bagaimana-jika/terraform non-interaktif. Gunakan --stage N untuk penyebaran tahap tunggal non-interaktif. Gunakan --stage N --dry-run untuk pratinjau bagaimana-jika dari satu tahap. Gunakan --outputs untuk menampilkan output penyebaran yang diambil. Gunakan --rollback-info untuk menampilkan instruksi putar kembali. Gunakan --generate-scripts untuk menghasilkan deploy.sh untuk direktori aplikasi.

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]

Contoh

Sesi penyebaran interaktif (default)

az prototype deploy

Perlihatkan kemajuan penyebaran saat ini

az prototype deploy --status

Pratinjau semua tahapan (bagaimana-jika /terraform plan)

az prototype deploy --dry-run

Sebarkan hanya tahap 2

az prototype deploy --stage 2

Paksa penyebaran ulang penuh

az prototype deploy --force

Tampilkan output penyebaran yang diambil

az prototype deploy --outputs

Perlihatkan instruksi putar kembali

az prototype deploy --rollback-info

Membuat skrip penyebaran App Service

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--client-id

ID aplikasi/klien perwakilan layanan (atau diatur melalui konfigurasi).

--client-secret

Rahasia klien perwakilan layanan (atau diatur melalui konfigurasi).

--dry-run

Pratinjau apa yang akan disebarkan (bagaimana-jika untuk Bicep, rencanakan untuk Terraform).

Properti Nilai
Nilai default: False
--force

Paksa penyebaran penuh, abaikan pelacakan perubahan.

Properti Nilai
Nilai default: False
--generate-scripts

Hasilkan skrip deploy.sh untuk direktori aplikasi.

Properti Nilai
Nilai default: False
--outputs

Tampilkan output penyebaran yang diambil dari Terraform / Bicep.

Properti Nilai
Nilai default: False
--reset

Bersihkan status penyebaran dan mulai dari awal.

Properti Nilai
Nilai default: False
--rollback-info

Tampilkan instruksi putar kembali berdasarkan riwayat penyebaran.

Properti Nilai
Nilai default: False
--script-registry

URL registri kontainer untuk --generate-scripts (jenis container_app).

--script-resource-group

Nama grup sumber daya default untuk --generate-scripts.

--script-type

Jenis target penyebaran Azure untuk --generate-scripts.

Properti Nilai
Nilai default: webapp
Nilai yang diterima: container_app, function, webapp
--service-principal

Autentikasi menggunakan perwakilan layanan sebelum menyebarkan.

Properti Nilai
Nilai default: False
--stage

Sebarkan hanya nomor tahap tertentu (gunakan --status untuk melihat tahapan).

--status -s

Tampilkan kemajuan penyebaran saat ini tanpa memulai sesi.

Properti Nilai
Nilai default: False
--tenant

ID penyewa Azure AD untuk penyebaran lintas penyewa.

--tenant-id

ID penyewa untuk autentikasi perwakilan layanan (atau diatur melalui konfigurasi).

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False

az prototype design

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Menganalisis persyaratan dan menghasilkan desain arsitektur.

Membaca artefak (dokumen, diagram, spesifikasi), melibatkan agen biz-analis untuk mengidentifikasi celah, dan menghasilkan dokumentasi arsitektur.

Saat dijalankan tanpa parameter, memulai dialog interaktif untuk menangkap persyaratan melalui pertanyaan terpandu.

Dengan --interaktif, memasuki perulangan penyempurnaan setelah pembuatan arsitektur sehingga Anda dapat meninjau desain dan meminta perubahan.

Agen biz-analis selalu terlibat — bahkan ketika --konteks disediakan - untuk memeriksa persyaratan yang hilang dan asumsi yang tidak distatuskan.

Tahap ini di-entrant ulang - jalankan lagi untuk menyempurnakan desain.

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

Contoh

Sesi desain interaktif (dialog terpandu)

az prototype design

Desain interaktif dengan perulangan penyempurnaan arsitektur

az prototype design --interactive

Desain dari direktori artefak

az prototype design --artifacts ./requirements/

Menambahkan konteks ke desain yang sudah ada

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

Reset dan mulai desain segar

az prototype design --reset

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--artifacts

Jalur ke direktori yang berisi dokumen persyaratan, diagram, atau artefak lainnya.

--context

Konteks atau persyaratan tambahan sebagai teks gratis.

--interactive -i

Masukkan perulangan penyempurnaan interaktif setelah pembuatan arsitektur.

Properti Nilai
Nilai default: False
--reset

Reset status desain dan mulai segar.

Properti Nilai
Nilai default: False
--skip-discovery

Lewati percakapan penemuan dan hasilkan arsitektur langsung dari status penemuan yang ada.

Properti Nilai
Nilai default: False
--status -s

Tampilkan status penemuan saat ini (item terbuka, item yang dikonfirmasi) tanpa memulai sesi.

Properti Nilai
Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False

az prototype init

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Menginisialisasi proyek prototipe baru.

Menyiapkan perancah proyek, membuat file konfigurasi proyek, dan secara opsional mengautentikasi dengan GitHub (memvalidasi lisensi Copilot).

Autentikasi GitHub hanya diperlukan untuk penyedia AI copilot dan github-models. Saat menggunakan azure-openai, autentikasi GitHub dilewati sepenuhnya.

Jika direktori target sudah berisi prototype.yaml, perintah akan meminta sebelum menimpa.

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

Contoh

Membuat proyek prototipe baru

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

Menginisialisasi dengan preferensi Bicep

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

Menggunakan Azure OpenAI (melewati autentikasi GitHub)

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

Tentukan lingkungan dan model

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--ai-provider

Penyedia AI untuk interaksi agen.

Properti Nilai
Nilai default: copilot
Nilai yang diterima: azure-openai, copilot, github-models
--environment

Lingkungan target untuk prototipe.

Properti Nilai
Nilai default: dev
Nilai yang diterima: dev, prod, staging
--iac-tool

Preferensi alat infrastruktur sebagai kode.

Properti Nilai
Nilai default: terraform
Nilai yang diterima: bicep, terraform
--location -l

Wilayah Azure untuk penyebaran sumber daya (misalnya, eastus).

--model

Model AI untuk digunakan (default: claude-sonnet-4.5 untuk salinan, gpt-4o untuk orang lain).

--name

Nama proyek prototipe.

--output-dir

Direktori output untuk file proyek.

Properti Nilai
Nilai default: .
--template

Templat proyek yang akan digunakan (misalnya, web-app, data-pipeline, ai-app).

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False

az prototype launch

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Luncurkan dasbor TUI interaktif.

Mendeteksi secara otomatis tahap proyek saat ini dan meluncurkan sesi yang sesuai di dalam aplikasi terminal Tekstual.

az prototype launch [--stage {build, deploy, design}]

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--stage

Mulai TUI pada tahap tertentu alih-alih mendeteksi secara otomatis.

Properti Nilai
Nilai yang diterima: build, deploy, design
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False

az prototype status

Pratinjau

Grup perintah 'prototipe' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Tampilkan status proyek saat ini di semua tahap.

Menampilkan ringkasan proyek prototipe termasuk konfigurasi, kemajuan tahap (desain, build, penyebaran), dan perubahan yang tertunda.

Secara default menunjukkan ringkasan yang dapat dibaca manusia. Gunakan --json untuk output yang dapat dibaca mesin yang cocok untuk pembuatan skrip. Gunakan --detail untuk detail per tahap yang diperluas.

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

Contoh

Perlihatkan status proyek

az prototype status

Tampilkan status terperinci dengan perincian per tahap

az prototype status --detailed

Dapatkan output JSON yang dapat dibaca mesin

az prototype status --json

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--detailed -d

Tampilkan detail per tahap yang diperluas.

Properti Nilai
Nilai default: False
--json -j

Output JSON yang dapat dibaca mesin alih-alih tampilan yang diformat.

Properti Nilai
Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti Nilai
Nilai default: False