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
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.
Secara otomatis menerima rekomendasi default untuk pelanggaran kebijakan dan konflik standar.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Pratinjau apa yang akan dihasilkan tanpa menulis file.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Bersihkan status build yang ada dan mulai dari awal.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Apa yang harus dibangun.
| Properti | Nilai |
|---|---|
| Nilai default: | all |
| Nilai yang diterima: | all, apps, db, docs, infra |
Tampilkan kemajuan build saat ini tanpa memulai sesi.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
az prototype deploy
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.
ID aplikasi/klien perwakilan layanan (atau diatur melalui konfigurasi).
Rahasia klien perwakilan layanan (atau diatur melalui konfigurasi).
Pratinjau apa yang akan disebarkan (bagaimana-jika untuk Bicep, rencanakan untuk Terraform).
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Paksa penyebaran penuh, abaikan pelacakan perubahan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Hasilkan skrip deploy.sh untuk direktori aplikasi.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan output penyebaran yang diambil dari Terraform / Bicep.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Bersihkan status penyebaran dan mulai dari awal.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan instruksi putar kembali berdasarkan riwayat penyebaran.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
URL registri kontainer untuk --generate-scripts (jenis container_app).
Nama grup sumber daya default untuk --generate-scripts.
Jenis target penyebaran Azure untuk --generate-scripts.
| Properti | Nilai |
|---|---|
| Nilai default: | webapp |
| Nilai yang diterima: | container_app, function, webapp |
Autentikasi menggunakan perwakilan layanan sebelum menyebarkan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Sebarkan hanya nomor tahap tertentu (gunakan --status untuk melihat tahapan).
Tampilkan kemajuan penyebaran saat ini tanpa memulai sesi.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
ID penyewa Azure AD untuk penyebaran lintas penyewa.
ID penyewa untuk autentikasi perwakilan layanan (atau diatur melalui konfigurasi).
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
az prototype design
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.
Jalur ke direktori yang berisi dokumen persyaratan, diagram, atau artefak lainnya.
Konteks atau persyaratan tambahan sebagai teks gratis.
Masukkan perulangan penyempurnaan interaktif setelah pembuatan arsitektur.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Reset status desain dan mulai segar.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Lewati percakapan penemuan dan hasilkan arsitektur langsung dari status penemuan yang ada.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan status penemuan saat ini (item terbuka, item yang dikonfirmasi) tanpa memulai sesi.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
az prototype init
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.
Penyedia AI untuk interaksi agen.
| Properti | Nilai |
|---|---|
| Nilai default: | copilot |
| Nilai yang diterima: | azure-openai, copilot, github-models |
Lingkungan target untuk prototipe.
| Properti | Nilai |
|---|---|
| Nilai default: | dev |
| Nilai yang diterima: | dev, prod, staging |
Preferensi alat infrastruktur sebagai kode.
| Properti | Nilai |
|---|---|
| Nilai default: | terraform |
| Nilai yang diterima: | bicep, terraform |
Wilayah Azure untuk penyebaran sumber daya (misalnya, eastus).
Model AI untuk digunakan (default: claude-sonnet-4.5 untuk salinan, gpt-4o untuk orang lain).
Nama proyek prototipe.
Direktori output untuk file proyek.
| Properti | Nilai |
|---|---|
| Nilai default: | . |
Templat proyek yang akan digunakan (misalnya, web-app, data-pipeline, ai-app).
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
az prototype launch
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.
Mulai TUI pada tahap tertentu alih-alih mendeteksi secara otomatis.
| Properti | Nilai |
|---|---|
| Nilai yang diterima: | build, deploy, design |
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
az prototype status
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.
Tampilkan detail per tahap yang diperluas.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Output JSON yang dapat dibaca mesin alih-alih tampilan yang diformat.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
| Properti | Nilai |
|---|---|
| Nilai default: | False |
Format output.
| Properti | Nilai |
|---|---|
| Nilai default: | json |
| Nilai yang diterima: | json, jsonc, none, table, tsv, yaml, yamlc |
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
| Properti | Nilai |
|---|---|
| Nilai default: | False |