Panduan pemecahan masalah Agent 365

Gunakan panduan ini untuk mendiagnosis dan mengatasi masalah di seluruh siklus hidup pengembangan Agent 365. Gunakan artikel ini sebagai titik awal untuk pemecahan masalah, lalu buka bagian tertentu untuk solusi mendetail.

Langkah-langkah pemecahan masalah

Setiap tautan dalam tabel ini memberikan langkah-langkah pemecahan masalah untuk area tertentu. Konten dikelompokkan menurut tahap-tahap siklus hidup pengembangan Agent 365 SDK.

Tahapan Memecahkan masalah konten
Membangun dan menjalankan agen Agent 365 CLI
Pendaftaran aplikasi klien kustom untuk Agent 365 CLI
Server perkakas tiruan
Pengamatan agen
Pengujian agen
Uji agen dengan menggunakan Dev Tunnels
Menambahkan dan mengelola alat
Penyiapan cetak biru agen Penyiapan Cetak biru agen
Menyebarkan Menyebarkan agen ke Azure
Menyebarkan agen pada Amazon Web Services (AWS)
Menyebarkan agen ke Google Cloud Platform (GCP)
Terbitkan agen ke Pusat Admin Microsoft 365 Menerbitkan agen ke pusat admin Microsoft
Buat instans agen Buat instans agen

Referensi perintah diagnostik

Sebelum menyelami masalah tertentu, gunakan perintah ini untuk memeriksa status penyiapan Agent 365 Anda saat ini:

Periksa CLI dan konfigurasi

Gunakan perintah-perintah ini untuk memvalidasi CLI dan konfigurasi Anda.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Verifikasi sumber daya Azure

Gunakan perintah ini untuk memeriksa sumber daya Azure dan status aplikasi.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Verifikasi cetak biru agen

Pastikan cetak biru agen Anda ada dan telah dikonfigurasi dengan benar.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Verifikasi cetak biru di Microsoft Entra

  1. Buka https://entra.microsoft.com>Pendaftaran aplikasi>Semua aplikasi.
  2. Cari agentBlueprintId Anda.

Praktik pencegahan terbaik

Gunakan rekomendasi ini untuk mencegah masalah umum dan memperlancar proses pemecahan masalah.

Sebelum memulai

Daftar periksa prasyarat:

✅ .NET 8.0 SDK diinstal
✅ Azure CLI telah diinstal dan diautentikasi
✅ Izin Entra yang diperlukan telah ditetapkan
✅ Aplikasi klien kustom dibuat dan dikonfigurasi
✅ Tenant telah diaktifkan untuk Microsoft Agent 365 Frontier

Perintah validasi:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Selama pengembangan

Simpan konfigurasi Anda:

  • Simpan cadangan file konfigurasi.
  • Dokumentasikan pilihan penyiapan Anda.
  • Simpan ID yang dihasilkan, misalnya blueprint ID dan managed identity ID.

Terus perbarui CLI:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Uji secara bertahap:

  • Uji setelah setiap langkah utama.
  • Verifikasi keberhasilan sebelum melanjutkan.
  • Pertahankan konfigurasi yang sudah berfungsi.

Sebelum penyebaran

Daftar periksa pra-penyebaran:

✅ Agen bekerja secara lokal dengan Agents Playground.
✅ Semua variabel lingkungan yang didokumentasikan.
✅ File konfigurasi telah dikomitkan ke sistem kontrol versi.
✅ Server MCP dikonfigurasi dan diuji.
✅ Observabilitas diaktifkan dan diverifikasi.

Dapatkan bantuan tambahan

Untuk meninjau kode sampel, melaporkan masalah, atau mencari masalah yang ada, gunakan repositori berikut:

  • Last updated on