إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تغطي هذه الصفحة المشكلات والحلول الشائعة عند العمل مع إطار عمل العامل.
Note
تتم إعادة هيكلة هذه الصفحة. ستتم إضافة سيناريوهات استكشاف الأخطاء وإصلاحها الشائعة.
مشكلات شائعة
أخطاء المصادقة
تأكد من أن لديك بيانات الاعتماد الصحيحة التي تم تكوينها لموفر الذكاء الاصطناعي الخاص بك. بالنسبة Azure OpenAI، تحقق مما يلي:
- يتم تثبيت Azure CLI ومصادقتها (
az login) - المستخدم لديه
Cognitive Services OpenAI Userدور أوCognitive Services OpenAI Contributor
مشكلات تثبيت الحزمة
تأكد من استخدام .NET 8.0 SDK أو أحدث. قم بتشغيل dotnet --version للتحقق من الإصدار المثبت.
يدعم إطار عمل العامل Python 3.11 إلى 3.15. لم يعد Python 3.10 مدعوما أو اختبارا في Python 1.24، على الرغم من أن بيانات تعريف الحزمة لا تزال تسمح بالتثبيت. استخدم Python 3.11 أو أحدث، وقم بتشغيل python --version للتحقق من المترجم النشط.
في Python 3.14 و3.15، لا يتم تقييم تعبيرات Power Fx التعريفية. في Python 3.15، pip install agent-framework يحذف Redis لأن RedisVL يتطلب إصدار Python سابق. يدعم Hyperlight 0.8 وواجهة AG-UI A2UI الإضافية وDageDB 2.x Python 3.15. إذا فشل التكامل في حله، فتحقق من نطاقه Requires-Python واستخدم مترجما متوافقا.
للحصول على التفاصيل، راجع دليل التغييرات الهامة Python 2026.
تأكد من استخدام Go 1.26 أو إصدار أحدث. قم بتشغيل go version للتحقق من الإصدار المثبت. إذا فشلت التبعيات في حلها، فقم بتشغيل go mod tidy وتحقق من استيراد الوحدة النمطية github.com/microsoft/agent-framework-go للحزم الموجودة في SDK الحالي.
الحصول على التعليمات
إذا لم تتمكن من العثور على حل هنا، تفضل بزيارة مناقشاتنا GitHub لدعم المجتمع.