Referensi perintah Agen 365 CLI config

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 konfigurasi Agen 365 CLI. Menyediakan opsi untuk mengelola pengaturan konfigurasi Agen 365 CLI. Anda dapat menginisialisasi konfigurasi baru secara interaktif atau menampilkan pengaturan konfigurasi saat ini.

Peran minimum diperlukan: Tidak ada (konfigurasi lokal)

Syntax

a365 config [command] [options]

Opsi

Option	Description
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

config init

Konfigurasikan Agen 365 CLI secara interaktif atau impor dari file.

a365 config init [options]

Gunakan perintah ini untuk menyiapkan konfigurasi Agen 365 CLI Anda melalui proses interaktif atau dengan mengimpor pengaturan dari file konfigurasi yang ada.

init Opsi

Option	Description
-c, --configfile <configfile>	Jalur ke file konfigurasi yang ada untuk diimpor
-g, --global	Membuat konfigurasi di direktori global (AppData) alih-alih direktori saat ini
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

Komentar

Perintah config init meluncurkan wizard interaktif yang meminimalkan input manual:

• Azure CLI integrasi: Secara otomatis mendeteksi langganan, penyewa, grup sumber daya, paket layanan aplikasi, dan wilayah Anda.
• Default cerdas: Menghasilkan nama sumber daya dari nama agen Anda dan tanda waktu (misalnya, myagent-webapp-11140916). Anda dapat menyesuaikan nama-nama ini sebelum menyimpan.
• deteksi Platform: Mendeteksi jenis proyek Anda (.NET, Node.js, Python) dari jalur proyek penyebaran dan memperingatkan jika tidak ada jenis yang didukung yang ditemukan.
• Validasi aplikasi klien: Memvalidasi ID aplikasi klien Anda terhadap penyewa Entra Anda, memeriksa apakah izin yang diperlukan dikonfigurasi dan persetujuan admin diberikan. Anda memiliki hingga tiga upaya sebelum panduan keluar.

Izin cetak biru kustom (opsional): Wizard menyertakan langkah opsional untuk mengonfigurasi izin untuk sumber daya eksternal tambahan, seperti kehadiran Teams atau file OneDrive. Sebagian besar agen tidak memerlukan ini. Anda juga dapat mengonfigurasi izin setelah penyiapan awal menggunakan a365 config permissions.

Memperbarui konfigurasi yang ada: Menjalankan a365 config init ulang memuat saat ini a365.config.json sebagai default. Tekan Enter pada setiap perintah untuk mempertahankan nilai saat ini, atau ketik nilai baru untuk memperbaruinya.

config display

Tampilkan konfigurasi CLI Agen 365 saat ini.

a365 config display [options]

Perintah ini menampilkan pengaturan konfigurasi saat ini untuk Agen 365 CLI, sehingga Anda dapat meninjau penyiapan Anda saat ini.

display Opsi

Option	Description
-g, --generated	Menampilkan konfigurasi yang dihasilkan (a365.generated.config.json)
-a, --all	Menampilkan konfigurasi statis dan yang dihasilkan
-?, , -h--help	Perlihatkan bantuan dan informasi penggunaan

Struktur file konfigurasi

CLI menggunakan file konfigurasi JSON (a365.config.json) dengan properti kunci berikut:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}