Agent 365 sorun giderme yönergeleri

Bu kılavuzu, Agent 365 geliştirme yaşam döngüsü boyunca sorunları teşhis etmek ve çözmek için kullanın. Bu makaleyi sorun giderme işlemlerine başlamak için başlangıç noktası olarak kullanın ve ayrıntılı çözümler için belirli bölümlere gidin.

Sorun giderme adımları

Bu tablodaki her bağlantı, belirli alanlar için sorun giderme adımları sunar. İçerik, Agent 365 SDK geliştirme yaşam döngüsü aşamasına göre gruplandırılmıştır.

Aşama Sorun giderme içeriği
Aracı oluşturma ve çalıştırma Agent 365 CLI
Agent 365 CLI için özel istemci uygulaması kaydı
Mock tooling sunucusu
Aracı gözlemlenebilirliği
Aracıların test edilmesi
Dev Tunnels kullanarak aracıları test etmek
Araçları ekleyin ve yönetin
Aracı şablonunu oluşturma Aracı şablonunu oluşturma
Dağıtma Aracıyı Azure'a dağıtma
Amazon Web Services'e (AWS) aracıyı dağıt
Aracıyı Google Cloud Platform'a (GCP) dağıtın
Aracıyı Microsoft 365 yönetim merkezine yayınla Aracıyı Microsoft yönetim merkezine yayınla
Aracı örnekleri oluştur Aracı örnekleri oluştur

Tanı komutları referansı

Belirli sorunlara geçmeden önce, Agent 365 kurulumunuzun mevcut durumunu kontrol etmek için şu komutları kullanın:

CLI ve yapılandırmayı kontrol edin

CLI'nizi ve yapılandırmanızı doğrulamak için bu komutları kullanın.

# 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

Azure kaynaklarını doğrulama

Bu komutları Azure kaynaklarını ve uygulamanın durumunu incelemek için kullanın.

# 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

Aracı şablonunu doğrulayın

Aracı şablonunuzun mevcut olduğunu ve doğru şekilde yapılandırıldığını doğrulayın.

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

Microsoft Entra'da planı doğrulayın

  1. https://entra.microsoft.com > Uygulama kayıtları>Tüm uygulamalar bölümüne gidin.
  2. agentBlueprintId'inizi arayın.

Önleyici en iyi uygulamalar

Yaygın sorunları önlemek ve sorun gidermeyi kolaylaştırmak için bu önerileri kullanın.

Başlamadan önce

Ön koşullar denetim listesi:

✅ .NET 8.0 SDK yüklü
✅ Azure CLI yüklü ve kimlik doğrulaması yapılmış
✅ Gerekli Entra izinleri atanmış
✅ Özel istemci uygulaması oluşturulmuş ve yapılandırılmış
✅ Microsoft Agent 365 Frontier için kiracı etkinleştirildi

Doğrulama komutları:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Geliştirme sırasında

Yapılandırmalarınızı kaydedin:

  • Yapılandırma dosyalarının yedeklerini tutun.
  • Kurulum seçeneklerinizi belgeleyin.
  • Oluşturulan kimlikleri, örneğin blueprint ID ve yönetilen kimlik ID'si gibi, kaydedin.

CLI'yi güncel tutun:

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

Kademeli test:

  • Her büyük adımdan sonra test yapın.
  • Devam etmeden önce başarıyı doğrulayın.
  • Çalışan konfigürasyonları saklayın.

Dağıtım öncesi

Dağıtım öncesi denetim listesi:

✅ Yerel ortamda Agents Playground ile çalışır.
✅ Tüm ortam değişkenleri belgelendi.
✅ Yapılandırma dosyaları kaynak kontrolüne kaydedildi.
✅ MCP sunucuları yapılandırıldı ve test edildi.
✅ Gözlemlenebilirlik etkinleştirilmiş ve doğrulanmış.

Ek yardım alın

Örnek kodu incelemek, sorunları raporlamak veya mevcut sorunları aramak için şu depoları kullanın:

  • Son güncelleştirme: