Agent 365 CLI

Agent 365 CLI, Agent 365 uygulamalarını Azure'da dağıtmak ve yönetmek için platformlar arası bir komut satırı aracıdır.

CLI'yi el ile yüklemeniz gerekmez. AI destekli kurulum, CLI'yi kontrol eder, otomatik olarak yükler veya güncelleştirir ve tüm gerekli komutları sizin adınıza çalıştırır. Bu sayfa, CLI'yi doğrudan yüklemeniz veya kullanmanız gereken geliştiriciler için bir başvuru niteliğindedir; örneğin, CI/CD otomasyonu oluştururken, belirli bir adımı giderirken veya AI kodlama aracısı olmadan çalışırken.

Not

AI destekli kurulum, rol rehberliği ve dağıtım sonrası adımları içeren tam geliştirici iş akışı Agent 365 geliştirmeye başlayın konusundadır. Bu sayfa CLI başvurusudur: yükleme, güncelleştirme, kaldırma, kullanılabilir komutlar ve sorun giderme.

Ön koşullar

CLI, .NET 8.0 veya daha sonraki sürüm gerektirir. Diğer tüm ön koşullar (Azure aboneliği, gerekli Entra rolleri ve özel istemci uygulaması kaydı) için bkz. AI destekli kurulum.

Agent 365 CLI'yi yükleme

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

Ön koşullar

.NET yüklü olmalıdır. (.NET 8.0 önerilir.)

dotnet tool install komutunu kullanın

Aşağıdaki komutu kullanarak Agent 365 CLI'yi yükleyin:

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

En son yönergeleri ve kullanılabilir sürümleri görmek için resmi NuGet sayfasını ziyaret edin: Microsoft.Agents.A365.DevTools.Cli on NuGet.org

Yüklemeyi doğrulama

Agent 365 CLI'yi yükledikten sonra, --help komutunu çalıştırarak doğru şekilde 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 doğrular.

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'yi güncelleştirmek için en son NuGet paketine erişmek üzere internet bağlantısı gereklidir: Microsoft.Agents.A365.DevTools.Cli.

Kaldır

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

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

Dosya konumları

Bir aracının yürütülebilir dosyasının varsayılan konumu işletim sistemine bağlıdır:

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

SDK, ilk kez çalıştırdığınızda bu konumu yolunuza ekler. Bu nedenle genel aracıları herhangi bir dizinden çalıştırabilir, aracı konumunu belirtmeden.

Aracı erişimi kullanıcıya özgüdür, makineye genel değildir. Genel bir aracı yalnızca aracıyı yükleyen kullanıcı tarafından kullanılabilir.

Kullanılabilir komutlar

Kullanılabilir komutların tam listesi için --help komutunu kullanın veya Agent 365 CLI Başvurusu bölümüne bakın.

İpucu

CLI komutlarını el ile çalıştırmanız gerekmez. AI destekli kurulum iş akışının tamamını otomatikleştirir - CLI yüklemesi, yapılandırması, şema kurulumu, dağıtım ve yayımlama - bir AI kodlama aracısı kullanarak. CI/CD otomasyonu oluşturuyorsanız, belirli bir adımda sorun gideriyorsanız veya bir AI kodlama aracısı olmadan çalışıyorsanız buradaki CLI başvurusunu kullanın.

Agent 365 aracısını CLI kullanarak ayarlama hakkında tam yönergeler için bkz. Agent 365 geliştirmeye başlayın.

Sorun giderme

Bu bölümde Agent 365 CLI ile hataları giderme hakkında bilgi sağlanmaktadır.

İpucu

Agent 365 Sorun Giderme Kılavuzu yüksek seviyeli sorun giderme önerileri, en iyi uygulamalar ve Agent 365 geliştirme yaşam döngüsünün her aşamasına yönelik sorun giderme içeriğine bağlantılar sunar.

Bu bölümde ele alınan CLI'ye özgü sorunlar:

Aracı Teams'de görünmüyor

Aracı örnekleri oluşturma sorunlarını giderme: Aracı Teams'de görünmüyor

Teams'de aracı örneği oluşturulamıyor

Aracı örnekleri oluşturma sorunlarını giderme: Teams'de aracı örneği oluşturulamıyor