Referensi perintah Agen 365 CLI `deploy`

Penting

Anda harus menjadi bagian dari program pratinjau Frontier untuk mendapatkan akses awal ke Microsoft Agent 365. Frontier menghubungkan Anda langsung dengan inovasi AI terbaru Microsoft. Pratinjau frontier tunduk pada ketentuan pratinjau yang ada dari perjanjian pelanggan Anda. Karena fitur-fitur ini masih dalam pengembangan, ketersediaan dan kemampuannya dapat berubah dari waktu ke waktu.

Sebarkan biner aplikasi Agen 365 ke Azure App Service yang dikonfigurasi dan memperbarui izin Alat Agen 365 Perintah deploy menyediakan opsi untuk membuat penyebaran Agen 365. Gunakan perintah ini untuk menyebarkan biner aplikasi ke infrastruktur Azure Anda dan memberikan izin Alat Agen 365.

peran Minimum diperlukan: Azure Kontributor + Administrator Global

Untuk informasi tentang menggunakan perintah ini, lihat agen Deploy ke Azure.

Syntax

a365 deploy [command] [options]

Opsi

Option	Description
`-c`, `--config <config>`	Jalur ke file konfigurasi (default: a365.config.json)
`-v`, `--verbose`	Mengaktifkan pencatatan terperinci
`--dry-run`	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
`--inspect`	Jeda sebelum penyebaran untuk memeriksa terbitkan folder dan konten ZIP
`--restart`	Lewati build dan mulai dari mengompresi folder penerbitan yang ada (untuk iterasi cepat setelah perubahan manual)
`-?`, , `-h--help`	Perlihatkan bantuan dan informasi penggunaan

Komentar

Berjalan a365 deploy tanpa subperintah menjalankan penyebaran dua fase:

Phase 1 — Biner aplikasi: Membangun dan menyebarkan aplikasi Anda ke Azure App Service.
Fase 2 — Izin MCP: Membaca cakupan yang diperlukan dari toolingManifest.json dan memperbarui cetak biru agen dengan izin yang diperlukan.

Kedua fase berjalan bahkan dengan --dry-run. Output dry-run dibagi menjadi dua bagian berlabel sehingga Anda dapat meninjau apa yang akan dilakukan setiap fase.

Pemeriksaan preflight

Sebelum menyebarkan, CLI memvalidasi:

Azure autentikasi dan langganan: Sesi dan langganan Azure CLI Anda harus valid. Jika tidak, penyebaran berhenti dengan kesalahan. Perbaiki dengan az login --tenant <TENANT_ID> dan az account set --subscription <SUBSCRIPTION_ID>.
Azure App Service keberadaan: Aplikasi web target harus ada sebelum penyebaran dilanjutkan. Jika aplikasi tidak ditemukan, jalankan a365 setup atau benar webAppName dan resourceGroup di a365.config.json.

Konfigurasi

CLI membaca dari dua file konfigurasi:

a365.config.json — konfigurasi proyek Anda (dikelola pengguna).
a365.generated.config.json — status dinamis yang dihasilkan oleh perintah penyiapan.

Cakupan alat MCP dibaca dari toolingManifest.json dalam direktori proyek penyebaran Anda.

CLI juga menyimpan salinan konfigurasi dan status global di:

Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
Linux/macOS: ~/.config/a365

Perilaku bendera

--restart: Melewati langkah build dan mulai langsung dari mengompresi folder yang ada publish/ . Jika publish/ tidak ada, penyebaran gagal. Jalankan penyebaran penuh (tanpa --restart) terlebih dahulu untuk menghasilkan publish/ folder.

--inspect: Menjeda sebelum langkah unggahan sehingga Anda dapat memeriksa publish/ folder dan file ZIP yang dihasilkan. Hanya tersedia untuk fase aplikasi.

--dry-run: Mencetak semua yang akan terjadi tanpa membuat perubahan apa pun. Saat berjalan a365 deploy (dua fase), output dibagi menjadi:

Bagian 1 — Menyebarkan biner aplikasi
Bagian 2 — Sebarkan/perbarui izin Alat Agen 365

`deploy app`

Menyebarkan kode agen Anda ke Azure Web App yang dibuat selama penyiapan.

a365 deploy app [options]

Sebarkan biner aplikasi Microsoft Agent 365 ke Azure App Service yang dikonfigurasi. Perintah ini menyebarkan biner aplikasi ke layanan aplikasi Azure yang dikonfigurasi di Azure.

`app` Opsi

Option	Description
`-c`, `--config <config>`	Jalur ke file konfigurasi (default: a365.config.json)
`-v`, `--verbose`	Mengaktifkan pencatatan terperinci
`--dry-run`	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
`--inspect`	Jeda sebelum penyebaran untuk memeriksa terbitkan folder dan konten ZIP
`--restart`	Lewati build dan mulai dari mengompresi folder penerbitan yang ada (untuk iterasi cepat setelah perubahan manual)
`-?`, , `-h--help`	Perlihatkan bantuan dan informasi penggunaan

`deploy mcp`

Memperbarui izin server MCP pada cetak biru agen Anda.

a365 deploy mcp [options]

`mcp` Opsi

Option	Description
`-c`, `--config <config>`	Jalur file konfigurasi (default: a365.config.json)
`-v`, `--verbose`	Mengaktifkan pencatatan terperinci
`--dry-run`	Perlihatkan apa yang akan dilakukan tanpa mengeksekusi
`-?`, , `-h--help`	Perlihatkan bantuan dan informasi penggunaan

Catatan penggunaan

Perbarui cakupan dan izin server MCP pada cetak biru agen yang ada. Perintah ini menambahkan izin untuk Alat Agen 365 ke cetak biru agen.

Jika Anda menambahkan atau mengubah server MCP dalam kode agen Anda, gunakan perintah ini untuk memperbarui izin pada cetak biru agen Anda.

Perintah ini:

Membaca konfigurasi server MCP Anda dari kode Anda.
Memperbarui cetak biru agen dengan izin yang diperlukan.
Memberikan izin API yang diperlukan untuk server MCP.

Pembaruan izin berlaku dalam urutan berikut:

Pemberian izin OAuth2 (perwakilan layanan cetak biru → platform MCP)
Izin yang dapat diwariskan (cetak biru agen → sumber daya MCP)
Persetujuan admin (identitas agen → platform MCP)

Kapan menggunakan deploy mcp:

Setelah menambahkan server MCP baru ke agen Anda.
Setelah mengubah konfigurasi server MCP.
Saat alat MCP tidak dapat diakses oleh agen Anda.

Anda tidak perlu menjalankan deploy mcp:

Pada penyebaran awal. Ini ditangani secara otomatis selama penyiapan.
Ketika hanya mengubah logika agen tanpa perubahan MCP.
Setelah pembaruan kode rutin yang tidak memengaruhi alat.

Nota

a365 deploy mcp hanya memperbarui izin - tidak menyebarkan kode Anda. Jalankan a365 deploy app terlebih dahulu jika Anda memiliki perubahan kode.

Troubleshooting

Gunakan bagian berikut untuk mengatasi potensi masalah dengan deploy perintah .

Tidak masuk ke langganan Azure atau salah
Aplikasi Web tidak ditemukan
Pembaruan izin gagal
--restart Gagal

Tidak masuk ke langganan Azure atau salah

Jalankan az login --tenant <TENANT_ID> dan az account set --subscription <SUBSCRIPTION_ID>.

Aplikasi Web tidak ditemukan

Pastikan a365 setup telah dijalankan, atau verifikasi bahwa webAppName dan resourceGroup sudah benar di a365.config.json.

Pembaruan izin gagal

Konfirmasi , AgentBlueprintIdAgenticAppId, dan lingkungan diatur dalam a365.config.json.
Pastikan akun Anda memiliki hak untuk mengelola perwakilan layanan dan pemberian.
Verifikasi bahwa toolingManifest.json ada di direktori proyek penyebaran Anda dan berisi cakupan yang valid.

`--restart` Gagal

Jalankan penyebaran penuh tanpa --restart menghasilkan publish/ folder, lalu gunakan --restart untuk iterasi berikutnya.

Catatan

File log CLI disimpan di:

Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
Linux/macOS: ~/.config/a365/logs/

Untuk melihat 80 baris terakhir dari file log penyebaran terbaru, gunakan Get-Content di Windows atau tail di Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Untuk log aplikasi runtime, gunakan Log Stream di portal Azure untuk stdout/stderr dari App Service Anda.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-03-10