Aracılığıyla paylaş

Aracı 365 CLI

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Agent 365 CLI, Azure'da Agent 365 uygulamalarını dağıtmaya ve yönetmeye yönelik platformlar arası bir komut satırı aracıdır.

Agent 365 CLI'yi yükleme

Agent 365 CLI'yi işletim sisteminize genel olarak yüklemek için aşağıdaki adımları kullanın.

Önkoşullar

.NET yüklü olmalıdır. TLS 1.2 önerilir.

dotnet tool install kullanma

Konuk aracısını yüklemek için şu komutu kullanın:

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

Hata microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json alırsanız, bu paket yine de yayın öncesi olarak etiketlenmiş olabileceğinden parametresini kullanın --prerelease .

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

En son yönergeler ve kullanılabilir sürümler için resmi NuGet sayfasını ziyaret edin: NuGet.org'da Microsoft.Agents.A365.DevTools.Cli

Yüklemeyi doğrulama

Agent 365 CLI'yı yükledikten sonra şunu çalıştırarak düzgün yüklendiğini doğrulayın:

a365 -h

Bu komut yardım bilgilerini görüntüler ve CLI'nin kullanıma hazır olduğunu onaylar.

Güncelleş

dotnet tool update komutunu kullanarak Agent 365 CLI'yi güncelleştirin:

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

Not

Agent 365 CLI'ye yönelik tüm güncelleştirmeler, en son Nuget paketine erişmek için İnternet bağlantısı gerektirir: Microsoft.Agents.A365.DevTools.Cli

uygulamasını kaldırma

dotnet tool uninstall komutunu kullanarak Agent 365 CLI'yi kaldırın :

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

Dosya konumu

Aracın yürütülebilir dosyası için varsayılan konum işletim sistemine bağlıdır:

OS Yol
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Bu konum, SDK ilk kez çalıştırıldığında kullanıcının yoluna eklenir. Bu nedenle genel araçlar, araç konumu belirtilmeden herhangi bir dizinden çağrılabilir.

Araç erişimi makine geneli değil kullanıcıya özgüdür. Genel bir araç yalnızca aracı yükleyen kullanıcı tarafından kullanılabilir.

Kullanılabilir komutlar

Kullanılabilir komutların tam listesi için komutunu kullanın --help veya bkz . Agent 365 CLI Başvurusu

Sorun giderme

Bu bölüm, Agent 365 CLI ile ilgili hataları giderme hakkında bilgi içerir.

CLI yükleme, güncelleştirme veya kaldırma işlemi başarısız oldu Not found in NuGet feeds

Hata microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json alırsanız, bu paket yine de ön sürüm olarak etiketlenmiş olabileceğinden parametresini kullanın --prerelease .

En son yönergeler ve kullanılabilir sürümler için resmi NuGet sayfasını ziyaret edin: NuGet.org'da Microsoft.Agents.A365.DevTools.Cli

Kurulum hatayla Authorization_RequestDenied başarısız oluyor

Komutu çalıştırırkensetupbir Authorization_RequestDenied hata alırsanız bu, Microsoft Entra ortamınızda bir izin sorunu olduğunu gösterir.

Yaygın nedenler

Bu sorun genellikle aşağıdaki durumlarda oluşur:

  • Hesabınızda gerekli izinler yok
  • Microsoft Graph Komut Satırı Araçları uygulaması yönetici onayı gerektiriyor
  • Ortamınızda çakışan veya fazla ayrıcalıklara sahip izinler var

Çözüm adımları

  1. Hesabınızın Okuyucu rolüne sahip olduğundan emin olun

    Şu rollerden birine sahip bir hesapla oturum açtığınızdan emin olun:

    • Aracı Kimliği Geliştiricisi
    • Aracı Kimliği Yöneticisi
    • Genel Yönetici

  2. Microsoft Graph Komut Satırı Araçları için yönetici onayı gözden geçirme ve verme

    a365 kurulum komutu, çakışan izinlere sahip olabilecek Microsoft Graph Komut Satırı Araçları uygulamasını kullanır.

    Gözden geçirmek ve düzeltmek için:

    1. Azure portalında oturum açın

    2. Microsoft Graph Komut Satırı Araçları'nı arayın veya Uygulama Kimliği için arama yapın:14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. Gezinti alanından Güvenlik>İzinleri'ni seçin.

    4. İzin arayın Directory.AccessAsUser.All

      • Bu yüksek ayrıcalıklı izin şema oluşturmayı engelliyor
      • Varsa, kaldırmayı veya örneğin en az ayrıcalıklı alternatiflerle değiştirmeyi göz önünde bulundurun Directory.Read.All

      Uyarı

      Bu izni yalnızca ortamınızdaki diğer araçlar veya betikler için gerekli olmadığından eminseniz kaldırın

    5. Yönetici onayı henüz verilmediyse [kiracınız] için yönetici onayı ver'i seçin.

  3. Değişiklik yaptıktan sonra yeniden çalıştırın a365 setup

Ek kaynaklar

Bu bilinen sorun hakkında daha fazla bilgi için bkz . Microsoft Entra Aracısı Kimliği bilinen sorunlar - Directory.AccessAsUser.All diğer izinlerin yoksayılmasına neden oluyor.

  • Last updated on