Bagikan melalui

Agen 365 CLI

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.

Agen 365 CLI adalah alat baris perintah lintas platform untuk menyebarkan dan mengelola aplikasi Agen 365 di Azure.

Menginstal Agen 365 CLI

Gunakan langkah-langkah berikut untuk menginstal Agen 365 CLI secara global pada sistem operasi Anda.

Prasyarat

Anda harus menginstal .NET. (.NET 8.0 disarankan.)

Menggunakan penginstalan alat dotnet

Instal Agen Tamu dengan menggunakan perintah berikut:

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

Jika Anda menerima microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json kesalahan, gunakan parameter karena --prerelease paket ini mungkin masih ditandai sebagai prarilis.

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Untuk petunjuk terbaru dan versi yang tersedia, kunjungi halaman NuGet resmi: Microsoft.Agents.A365.DevTools.Cli di NuGet.org

Memverifikasi penginstalan

Setelah menginstal Agen 365 CLI, verifikasi bahwa CLI diinstal dengan benar dengan menjalankan:

a365 -h

Perintah ini menampilkan informasi bantuan dan mengonfirmasi bahwa CLI siap digunakan.

Update

Perbarui Agen 365 CLI dengan menggunakan perintah pembaruan alat dotnet:

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

Catatan

Semua pembaruan untuk Agen 365 CLI memerlukan koneksi internet untuk mengakses paket Nuget terbaru: Microsoft.Agents.A365.DevTools.Cli

Menghapus instalan

Hapus instalan Agen 365 CLI dengan menggunakan perintah hapus instalan alat dotnet:

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

Lokasi File

Lokasi default untuk file yang dapat dieksekusi alat tergantung pada sistem operasi:

OS Jalur
Linux/macOS $HOME/.dotnet/tools
Jendela %USERPROFILE%\.dotnet\tools

Lokasi ini ditambahkan ke jalur pengguna saat SDK pertama kali dijalankan. Jadi alat global dapat dipanggil dari direktori apa pun tanpa menentukan lokasi alat.

Akses alat khusus pengguna, bukan mesin global. Alat global hanya tersedia untuk pengguna yang menginstal alat.

Perintah yang tersedia

Untuk daftar lengkap perintah yang tersedia, gunakan --help perintah atau lihat Referensi CLI Agen 365

Mengatasi Masalah

Bagian ini berisi informasi tentang cara memecahkan masalah kesalahan dengan Agen 365 CLI.

Penginstalan, Pembaruan, atau Penghapusan Instalasi CLI gagal dengan Not found in NuGet feeds

Jika Anda menerima microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json kesalahan, silakan gunakan parameter karena --prerelease paket ini mungkin masih ditandai sebagai prarilis.

Untuk petunjuk terbaru dan versi yang tersedia, kunjungi halaman NuGet resmi: Microsoft.Agents.A365.DevTools.Cli di NuGet.org

Penyetelan gagal dengan Authorization_RequestDenied kesalahan

Jika Anda menerima kesalahan Authorization_RequestDenied saat menjalankan setup perintah, ini menunjukkan masalah izin di lingkungan Microsoft Entra Anda.

Penyebab umum

Kesalahan ini biasanya terjadi ketika:

  • Akun Anda tidak memiliki izin yang diperlukan
  • Aplikasi Alat Baris Perintah Microsoft Graph memerlukan persetujuan admin
  • Izin yang bertentangan atau kelebihan hak istimewa ada di lingkungan Anda

Langkah resolusi

  1. Verifikasi akun Anda memiliki peran yang diperlukan

    Pastikan Anda masuk dengan akun yang memiliki salah satu peran berikut:

    • Pengembang ID Agen
    • Administrator ID Agen
    • Administrator Global

  2. Meninjau dan memberikan persetujuan admin untuk Alat Baris Perintah Microsoft Graph

    Perintah penyiapan a365 menggunakan aplikasi Alat Baris Perintah Microsoft Graph, yang mungkin memiliki izin yang bertentangan.

    Untuk meninjau dan memperbaiki:

    1. Masuk ke portal Azure

    2. Cari Alat Baris Perintah Microsoft Graph atau cari ID Aplikasi: 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. Pilih Izin Keamanan>dari area navigasi.

    4. Cari Directory.AccessAsUser.All izin

      • Izin yang sangat istimewa ini mengganggu pembuatan cetak biru
      • Jika ada, pertimbangkan untuk menghapusnya atau menggantinya dengan alternatif hak istimewa paling sedikit seperti Directory.Read.All

      Peringatan

      Hanya hapus izin ini jika Anda yakin tidak diperlukan oleh alat atau skrip lain di lingkungan Anda

    5. Jika persetujuan admin belum diberikan, pilih Berikan persetujuan admin untuk [penyewa Anda].

  3. Setelah membuat perubahan, jalankan a365 setup lagi

Sumber daya tambahan

Untuk informasi selengkapnya tentang masalah yang diketahui ini, lihat Masalah umum ID Agen Microsoft Entra - Directory.AccessAsUser.All menyebabkan izin lain diabaikan.

  • Last updated on