Troubleshooting

تغطي هذه الصفحة المشكلات والحلول الشائعة عند العمل مع إطار عمل العامل.

Note

تتم إعادة هيكلة هذه الصفحة. ستتم إضافة سيناريوهات استكشاف الأخطاء وإصلاحها الشائعة.

مشكلات شائعة

أخطاء المصادقة

تأكد من أن لديك بيانات الاعتماد الصحيحة التي تم تكوينها لموفر الذكاء الاصطناعي الخاص بك. بالنسبة Azure OpenAI، تحقق مما يلي:

  • يتم تثبيت Azure CLI ومصادقتها (az login)
  • المستخدم لديه Cognitive Services OpenAI User دور أو Cognitive Services OpenAI Contributor

مشكلات تثبيت الحزمة

تأكد من استخدام .NET 8.0 SDK أو أحدث. قم بتشغيل dotnet --version للتحقق من الإصدار المثبت.

تأكد من استخدام Python 3.10 أو أحدث. قم بتشغيل python --version للتحقق من الإصدار المثبت.

تأكد من استخدام Go 1.25 أو إصدار أحدث. قم بتشغيل go version للتحقق من الإصدار المثبت. إذا فشلت التبعيات في حلها، فقم بتشغيل go mod tidy وتحقق من استيراد الوحدة النمطية github.com/microsoft/agent-framework-go للحزم الموجودة في SDK الحالي.

الحصول على التعليمات

إذا لم تتمكن من العثور على حل هنا، تفضل بزيارة مناقشاتنا GitHub لدعم المجتمع.

الخطوات التالية