Bagikan melalui

Referensi perintah Agen 365 CLI setup

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.

Siapkan lingkungan Agen 365 Anda dengan kontrol terperinci atas setiap langkah. Perintah ini mengelola alur kerja penyiapan awal untuk cetak biru Agen 365.

peran Minimum diperlukan: Azure Kontributor + Administrator Global

Syntax

a365 setup [command] [options]

Opsi

Option Description
-?, , -h--help Menampilkan informasi bantuan dan penggunaan. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Atau jalankan semua langkah sekaligus:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Validasi prasyarat untuk penyiapan Agen 365. Menjalankan pemeriksaan persyaratan modular dan memberikan panduan untuk masalah apa pun yang ditemukannya.

a365 setup requirements [options]

Perintah ini menjalankan langkah-langkah berikut:

  • Memeriksa semua prasyarat yang diperlukan untuk penyiapan Agen 365.
  • Melaporkan masalah dengan panduan resolusi terperinci.
  • Terus memeriksa semua persyaratan bahkan jika beberapa pemeriksaan gagal.
  • Menyediakan ringkasan semua pemeriksaan di akhir.

requirements Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Menampilkan output terperinci untuk semua pemeriksaan.
--category <category> Menjalankan pemeriksaan hanya untuk kategori tertentu, seperti Azure, Authentication, atau Configuration.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

setup infrastructure

Buat infrastruktur Azure.

Minimum memerlukan izin: Kontributor atau Pemilik Langganan Azure

a365 setup infrastructure [options]

infrastructure Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

setup blueprint

Buat cetak biru agen (pendaftaran aplikasi Entra ID).

Izin minimum yang diperlukan: Peran Pengembang ID Agen

a365 setup blueprint [options]

blueprint Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
--no-endpoint Jangan mendaftarkan titik akhir olahpesan (hanya cetak biru).
--endpoint-only Daftarkan titik akhir olahpesan saja. Memerlukan cetak biru yang ada.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

setup permissions

Konfigurasikan pemberian izin OAuth2 dan izin yang dapat diwariskan.

Izin minimum yang diperlukan: Administrator Global

a365 setup permissions [command] [options]

Opsi

Option Description
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

perintah tambahan

Subcommand Description
mcp Konfigurasikan pemberian OAuth2 server MCP dan izin yang dapat diwariskan.
bot Konfigurasikan pemberian OAuth2 OAuth2 Api Bot Ossaging dan izin yang dapat diwariskan.
custom Menerapkan izin API kustom ke cetak biru agen Anda yang melampaui izin standar yang diperlukan untuk operasi agen.
copilotstudio Mengonfigurasi pemberian izin OAuth2 dan izin yang dapat diwariskan untuk cetak biru agen guna memanggil salinan Copilot Studio melalui API Power Platform.

setup permissions mcp

Konfigurasikan pemberian OAuth2 server MCP dan izin yang dapat diwariskan.

Izin minimum yang diperlukan: Administrator Global

a365 setup permissions mcp [options]

Perintah ini:

  • ToolingManifest.json Membaca dari yang deploymentProjectPath ditentukan dalam a365.config.json.
  • Memberikan pemberian izin yang didelegasikan OAuth2 untuk setiap cakupan server MCP ke cetak biru agen.
  • Mengonfigurasi izin yang dapat diwariskan sehingga instans agen dapat mengakses alat MCP.
  • Bersifat idempogen dan aman untuk dijalankan beberapa kali.

Penting

  • Sebelum menjalankan perintah ini, jalankan a365 config display untuk memverifikasi bahwa deploymentProjectPath menunjuk ke folder proyek yang berisi yang diperbarui ToolingManifest.json. Jika pengembang menambahkan server MCP di komputer yang berbeda, bagikan yang diperbarui ToolingManifest.json dengan Administrator Global terlebih dahulu. Berjalan tanpa benar ToolingManifest.json tidak menambahkan izin server MCP baru ke cetak biru.
  • Jalankan perintah ini setelah pengembang menjalankan a365 develop add-mcp-servers. Menambahkan server MCP ke manifes dan memberikan izin ke cetak biru adalah dua langkah terpisah. Setelah perintah ini selesai, izin server MCP terlihat dalam cetak biru agen.

permissions mcp Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

setup permissions bot

Konfigurasikan pemberian OAuth2 OAuth2 Api Bot Ossaging dan izin yang dapat diwariskan.

Izin minimum yang diperlukan: Administrator Global

Prasyarat: Izin Cetak biru dan MCP (jalankan a365 setup permissions mcp terlebih dahulu)

langkah Next: Sebarkan agen Anda (jalankan a365 deploy jika hosting di Azure)

a365 setup permissions bot [options]

permissions bot Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

setup permissions custom

Menerapkan izin API kustom ke cetak biru agen Anda yang melampaui izin standar yang diperlukan untuk operasi agen. Dengan menggunakan perintah ini, Anda memberikan akses agen ke cakupan Microsoft Graph tambahan, seperti Kehadiran, File, dan Obrolan, atau ke API kustom yang terdaftar di penyewa ID Entra organisasi Anda.

Izin minimum yang diperlukan: Administrator Global

Prasyarat: Jalankan a365 setup blueprint terlebih dahulu. Tambahkan izin kustom ke a365.config.json dengan menggunakan a365 config permissions sebelum menjalankan perintah ini.

a365 setup permissions custom [options]

Perintah ini:

  • Mengonfigurasi pemberian izin yang didelegasikan OAuth2 dengan persetujuan admin untuk setiap sumber daya yang dikonfigurasi.
  • Mengatur izin yang dapat diwariskan sehingga pengguna agen dapat mewarisi akses dari cetak biru.
  • Menyesuaikan Microsoft Entra dengan konfigurasi saat ini dengan menambahkan izin baru dan menghapus izin apa pun yang dihapus dari konfigurasi.
  • Bersifat idempogen dan aman untuk dijalankan beberapa kali.

permissions custom Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

Mengonfigurasi izin kustom

Gunakan a365 config permissions untuk menambahkan izin kustom ke konfigurasi Anda sebelum menjalankan perintah ini:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Nama sumber daya diselesaikan secara otomatis dari Azure selama penyiapan. Anda tidak perlu menentukannya dalam konfigurasi.

Menghapus izin kustom

Untuk menghapus izin kustom dari konfigurasi dan Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integrasi dengan setup all

Saat konfigurasi Anda menyertakan izin kustom, berjalan a365 setup all secara otomatis mengonfigurasinya. Urutan penyiapan lengkap adalah:

  1. Infrastruktur
  2. Rencana
  3. Izin MCP
  4. Izin BOT API
  5. Izin cetak biru kustom (jika dikonfigurasi)
  6. Titik akhir pengiriman pesan

setup permissions copilotstudio

Mengonfigurasi pemberian izin OAuth2 dan izin yang dapat diwariskan untuk cetak biru agen guna memanggil salinan Copilot Studio melalui API Power Platform.

Izin minimum yang diperlukan: Administrator Global

Prasyarat: Jalankan a365 setup blueprint terlebih dahulu.

a365 setup permissions copilotstudio [options]

Perintah ini:

  • Memastikan perwakilan layanan API Power Platform ada di penyewa Anda.
  • Membuat pemberian izin OAuth2 dari cetak biru ke API Power Platform dengan CopilotStudio.Copilots.Invoke cakupan.
  • Mengatur izin yang dapat diwariskan sehingga instans agen dapat memanggil salinan Copilot Studio.

permissions copilotstudio Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.

Gunakan perintah ini saat agen Anda perlu memanggil salinan Copilot Studio saat runtime atau memanggil API Power Platform yang memerlukan izin CopilotStudio.

setup all

Lakukan semua langkah penyiapan untuk menyiapkan lingkungan Agen 365 Anda

a365 setup all [options]

Menjalankan penyiapan Agen 365 lengkap, semua langkah secara berurutan.

Termasuk: Infrastruktur, Cetak Biru, Izin, dan Titik Akhir.

Izin minimum yang diperlukan (Administrator Global memiliki semua izin ini):

  • Kontributor Langganan Azure (untuk infrastruktur dan titik akhir)
  • Peran Pengembang ID Agen (untuk pembuatan cetak biru)
  • Administrator Global (untuk pemberian izin dan persetujuan admin)

setup all Opsi

Option Description
-c, --config <config> Jalur file konfigurasi. Defaultnya adalah a365.config.json.
-v, --verbose Tampilkan output terperinci.
--dry-run Tunjukkan apa yang akan dilakukan tanpa mengeksekusi.
--skip-infrastructure Lewati pembuatan infrastruktur Azure (gunakan jika infrastruktur sudah ada). Opsi ini masih membuat: Cetak Biru, Izin, dan Titik Akhir.
--skip-requirements Lewati pemeriksaan validasi persyaratan. Gunakan dengan hati-hati: penyiapan mungkin gagal jika prasyarat tidak terpenuhi.
-?, , -h--help Menampilkan informasi bantuan dan penggunaan.
  • Last updated on