Referensi perintah Agen 365 CLI develop

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.

Mengelola server alat MCP untuk pengembangan agen. Perintah ini develop menyediakan opsi untuk mengelola server alat MCP (Model Context Protocol) untuk pengembangan agen. Anda dapat mencantumkan server yang tersedia, melihat server yang dikonfigurasi, dan menambahkan atau menghapus server MCP dari konfigurasi agen Anda.

Peran minimum diperlukan: Tidak ada (manajemen manifes lokal)

Syntax

a365 develop [command] [options]

Opsi

Option	Description
-c, --config <config>	Jalur file konfigurasi. Default: a365.config.json
-v, --verbose	Mengaktifkan pencatatan terperinci
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

develop list-available

Cantumkan semua server MCP yang tersedia di katalog (apa yang dapat Anda instal).

a365 develop list-available [options]

Perintah ini menampilkan semua server MCP yang tersedia di katalog dan Anda dapat menginstalnya untuk digunakan dengan pengembangan agen Anda.

list-available Opsi

Option	Description
-c, --config <config>	Jalur file konfigurasi. Default: a365.config.json
--dry-run	Perlihatkan apa yang akan dilakukan perintah tanpa mengeksekusinya.
--skip-auth	Lewati autentikasi. Hanya untuk pengujian. Perintah kemungkinan gagal tanpa autentikasi yang valid.
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

develop list-configured

Daftar server MCP yang saat ini dikonfigurasi dari lokal ToolingManifest.jsonAnda.

a365 develop list-configured [options]

Perintah ini menunjukkan semua server MCP yang saat ini Anda konfigurasi dalam file ToolingManifest.json lokal Anda.

list-configured Opsi

Option	Description
-c, --config <config>	Jalur file konfigurasi. Default: a365.config.json
--dry-run	Perlihatkan apa yang akan dilakukan perintah tanpa mengeksekusinya.
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

develop add-mcp-servers

Tambahkan Server MCP ke konfigurasi agen saat ini.

a365 develop add-mcp-servers [<servers>...] [options]

Perintah ini menambahkan server MCP yang ditentukan ke ToolingManifest.json dalam folder proyek Anda. Ini tidak memberikan izin ke cetak biru agen.

Penting

Perintah ini hanya diperbarui ToolingManifest.json — perintah ini tidak memberikan izin ke cetak biru agen. Bagaimana izin diterapkan bergantung pada di mana Anda berada dalam proses penyiapan:

• Sebelum penyiapan awal: Lanjutkan dengan a365 setup all. Izin MCP diterapkan sebagai bagian dari pembuatan cetak biru awal.
• Setelah cetak biru sudah ada: Administrator Global harus berjalan a365 setup permissions mcp secara terpisah. Admin harus menjalankan a365 config display terlebih dahulu untuk memverifikasi bahwa deploymentProjectPath dalam poin mereka a365.config.json ke folder proyek yang berisi yang diperbarui ToolingManifest.json.

Argumen add-mcp-servers

Tentukan satu atau beberapa nama server MCP untuk ditambahkan ke konfigurasi agen Anda. Anda dapat menyediakan beberapa nama server yang dipisahkan oleh spasi.

Argumen	Description
<servers>	Nama server MCP yang akan ditambahkan

add-mcp-servers Opsi

Gunakan opsi ini untuk menyesuaikan perilaku add-mcp-servers perintah, termasuk pemilihan file konfigurasi dan pengujian dry-run.

Option	Description
-c, --config <config>	Jalur file konfigurasi. Default: a365.config.json
--dry-run	Perlihatkan apa yang akan dilakukan perintah tanpa mengeksekusinya.
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

develop remove-mcp-servers

Hapus Server MCP dari konfigurasi agen saat ini.

a365 develop remove-mcp-servers [<servers>...] [options]

Perintah ini menghapus server MCP tertentu dari konfigurasi agen Anda saat ini.

Argumen remove-mcp-servers

Argumen	Description
<servers>	Nama server MCP yang akan dihapus

remove-mcp-servers Opsi

Option	Description
-c, --config <config>	Jalur file konfigurasi. Default: a365.config.json
--dry-run	Perlihatkan apa yang akan dilakukan perintah tanpa mengeksekusinya.
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

develop add-permissions

Tambahkan izin MCP server API ke aplikasi Microsoft Entra untuk skenario pengembangan di mana Anda perlu mengonfigurasi aplikasi kustom untuk mengakses server MCP.

a365 develop add-permissions [options]

add-permissions Opsi

Gunakan opsi ini untuk menambahkan izin dan cakupan API yang diperlukan ke pendaftaran aplikasi Anda, memanfaatkan nilai dari manifes alat.

Option	Description
-c, --config <config>	Jalur file konfigurasi (default: a365.config.json)
-m, --manifest <manifest>	Jalur ke ToolingManifest.json (default: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	ID aplikasi (klien) untuk menambahkan izin ke (default: clientAppId dari konfigurasi)
--scopes <scopes>	Cakupan tertentu untuk ditambahkan (dipisahkan spasi) (default: Semua cakupan dari ToolingManifest.json)
--dry-run	Perlihatkan apa yang akan dilakukan perintah tanpa membuat perubahan
-v, --verbose	Tampilkan output terperinci
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

Penting

Aplikasi yang ditentukan oleh --app-id atau clientAppId harus memiliki izin Application.ReadWrite.All di Microsoft Entra. Perintah ini untuk aplikasi klien kustom. Untuk mengonfigurasi izin untuk cetak biru agen, gunakan a365 setup permissions mcp sebagai gantinya.

develop get-token

Ambil token pembawa untuk menguji server MCP selama pengembangan menggunakan autentikasi browser interaktif.

a365 develop get-token [options]

get-token Opsi

Gunakan opsi ini untuk meminta token akses, cakupan kontrol, perilaku refresh, dan pilih format output.

Option	Description
-c, --config <config>	Jalur file konfigurasi (default: a365.config.json)
--app-id <app-id>	ID aplikasi (klien) untuk autentikasi (default: clientAppId dari konfigurasi)
-m, --manifest <manifest>	Jalur ke ToolingManifest.json (default: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Cakupan khusus untuk diminta (dipisahkan spasi) (default: Baca dari ToolingManifest.json)
-o, --output <output>	Format output: table, , jsonatau raw (default: table)
--force-refresh	Memaksa refresh token melewati cache
--resource <resource>	Kata kunci sumber daya untuk mendapatkan token untuk: mcp (default) atau powerplatform
--resource-id <resource-id>	ID aplikasi sumber daya kustom (GUID) untuk sumber daya yang tidak dicakup oleh --resource kata kunci
-v, --verbose	Tampilkan output terperinci termasuk token penuh
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

get-token opsi sumber daya

Gunakan opsi --resource dan --resource-id untuk mendapatkan token untuk sumber daya Azure yang berbeda:

• --resource: Gunakan kata kunci untuk memilih sumber daya yang telah ditentukan sebelumnya:
  • mcp (default): Alat Agen 365 untuk server MCP
  • powerplatform: API Power Platform
• --resource-id: Masukkan ID aplikasi sumber daya kustom (GUID) untuk sumber daya yang tidak dicakup oleh kata kunci

Penting

--resource dan --resource-id tidak dapat digunakan bersama-sama. Saat Anda menggunakan salah satu opsi, sertakan --scopes. Hanya alur MCP default yang mendukung resolusi cakupan berbasis manifes.

develop start-mock-tooling-server

Mulai server alat tiruan untuk tujuan pengujian dan pengembangan.

a365 develop start-mock-tooling-server [options]

Perintah ini memulai server alat tiruan untuk tujuan pengujian dan pengembangan. Dengan menggunakan server ini, Anda dapat mensimulasikan interaksi server MCP tanpa memerlukan implementasi server yang sebenarnya.

start-mock-tooling-server Opsi

Gunakan opsi ini untuk menyesuaikan perilaku start-mock-tooling-server perintah.

Option	Description	Bawaan
-p, --port <port>	Nomor port untuk server tiruan	5309
-v, --verbose	Mengaktifkan pencatatan terperinci	false
-?, -h, --help	Perlihatkan bantuan dan informasi penggunaan	-
-bg	Jalankan server di terminal baru	-