Sorun giderme

Bu sayfa, Agent Framework ile çalışırken karşılaşılan yaygın sorunları ve çözümleri kapsar.

Uyarı

Bu sayfa yeniden yapılandırılıyor. Yaygın sorun giderme senaryoları eklenecektir.

Yaygın Sorunlar

Kimlik Doğrulaması Hataları

Yapay zeka sağlayıcınız için doğru kimlik bilgilerinin yapılandırıldığından emin olun. Azure OpenAI için şunları doğrulayın:

• Azure CLI yüklü ve kimliği doğrulanmış (az login)
• Kullanıcının Cognitive Services OpenAI User veya Cognitive Services OpenAI Contributor rolü vardır

Paket Yükleme Sorunları

.NET 8.0 SDK veya üzerini kullandığınızdan emin olun. Yüklü sürümünüzü denetlemek için komutunu çalıştırın dotnet --version .

Agent Framework, Python 3.11 ile 3.15 sürümlerini destekler. Python 3.10 artık Python 1.24'te desteklenmiyor veya test edilmiyor, ancak paket meta verileri hala yüklemeye izin verir. Python 3.11 veya sonraki bir sürümü kullanın ve etkin yorumlayıcıyı doğrulamak için python --version komutunu çalıştırın.

Python 3.14 ve 3.15'te bildirimsel Power Fx ifadeleri değerlendirilmez. Python 3.15'te pip install agent-framework, RedisVL daha önceki bir Python sürümü gerektirdiği için Redis'i atlar. Hyperlight 0.8, AG-UI A2UI ekstra ve DuckDB 2.x, Python 3.15'i destekler. Tümleştirme çözümlenmezse Requires-Python aralığını denetleyin ve uyumlu bir yorumlayıcı kullanın. Ayrıntılar için Python 2026 önemli değişiklikler kılavuzuna bakın.

Go 1.26 veya sonraki bir sürümü kullandığınızdan emin olun. Yüklü sürümünüzü denetlemek için komutunu çalıştırın go version . Bağımlılıklar çözümlenemezse go mod tidy komutunu çalıştırın ve modülünüzün geçerli SDK'da bulunan github.com/microsoft/agent-framework-go paketlerini içe aktardığını doğrulayın.

Yardım Alma

Burada bir çözüm bulamazsanız, topluluk desteği için GitHub Tartışmaları'mızı ziyaret edin.

Sonraki Adımlar

SSS