agent-framework
بناء وكلاء الذكاء الاصطناعي باستخدام إطار عمل وكيل Microsoft
إنشاء وكلاء الذكاء الاصطناعي وسير عمل الوكلاء المتعددين باستخدام إطار عمل وكيل Microsoft SDK. يقوم هذا المهارة بتصميم مشاريع الوكلاء باستخدام الأدوات ودعم خادم HTTP وتكوينات تصحيح أخطاء VSCode لتطبيقات الذكاء الاصطناعي المؤسسية.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "agent-framework". Create a new agent called 'WeatherAgent' that can tell the weather
النتيجة المتوقعة:
تقوم المهارة بتوليد: requirements.txt مع إصدارات مثبتة من agent-framework، main.py مع إعداد ChatAgent وأداة الطقس، قالب ملف .env لـ FOUNDRY_PROJECT_ENDPOINT وFOUNDRY_MODEL_DEPLOYMENT_NAME، .vscode/launch.json و.vscode/tasks.json للتصحيح
استخدام "agent-framework". Build a Writer-Reviewer workflow
النتيجة المتوقعة:
تقوم المهارة بتوليد: منفذ الكاتب الذي ينشئ المحتوى، منفذ المراجع الذي يقدم الملاحظات، تكوين WorkflowBuilder مع حواف تربط الوكيلين، معالجة حدث run_stream للإخراج في الوقت الفعلي
التدقيق الأمني
آمنThis is an official Microsoft skill for creating AI agents using Microsoft Agent Framework SDK. The static scanner flagged 165 potential issues, but evaluation confirms all are false positives. The flagged backtick patterns are Markdown code fences in documentation files. The skill appropriately uses .env files for storing Azure Foundry credentials (FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL_DEPLOYMENT_NAME), which is a standard and secure practice for credential management.
مشكلات متوسطة المخاطر (1)
عوامل الخطر
🔑 متغيرات البيئة (1)
درجة الجودة
ماذا يمكنك بناءه
تطوير تطبيقات الذكاء الاصطناعي المؤسسية
بناء وكلاء ذكاء اصطناعي للإنتاج مع أمان الأنواع والنقاط المرجعية والتنسيق لبيئات Azure المؤسسية.
النماذج الأولية لسير عمل الوكلاء المتعددين
إنشاء واختبار سير عمل الوكلاء المتعددين مع أنماط الكاتب-المراجع والحلقات وتفاعلات الإنسان في الحلقة.
إعداد تصحيح أخطاء VSCode
تكوين التصحيح المحلي مع AI Toolkit Agent Inspector للاختبار التفاعلي للوكلاء واستكشاف الأخطاء وإصلاحها.
جرّب هذه الموجهات
إنشاء وكيل ذكاء اصطناعي جديد باستخدام Microsoft Agent Framework يمكنه الاستجابة لاستفسارات المستخدم. قم بتضمين دعم وضع خادم HTTP.
بناء وكيل بأدوات مخصصة باستخدام نمط استدعاء الدوال. أضف أداتين مخصصتين على الأقل ليستخدمهما الوكيل.
إنشاء سير عمل وكيل متعدد مع وكيل كاتب ينشئ محتوى ووكيل مراجع يقدم ملاحظات. استخدم نمط منشئ سير العمل.
بناء سير عمل حلقي للوكلاء المتعددين يتفاعل فيه وكيل معلم ووكيل طالب. قم بتضمين التحكم القائم على الأدوار بحد أقصى 5 تكرارات.
أفضل الممارسات
- استخدم دائماً إصدارات SDK مثبتة (1.0.0b260107 لـ agent-framework) لتجنب التغييرات المسببة للانقطاع من إصدارات بيتا
- استخدم البيئات الافتراضية (.venv) لعزل التبعيات وتجنب التعارضات
- كونف ig خادم HTTP كنقطة الدخول الافتراضية لتحسين التصحيح ودعم الحاويات
- ثبت المتغيرات البيئية في ملف .env ولكن ذكّر المستخدمين بتحديث القيم قبل التشغيل
تجنب
- استخدام أوامر 'python' أو 'pip' العارية بدون تفعيل البيئة الافتراضية
- تخطي وضع الخادم عندما يحتاج المستخدم للوصول إلى نقطة نهاية HTTP
- استخدام AzureAIAgentClient القديم بدلاً من AzureAIClient الحالي
- عدم تثبيت إصدارات SDK مما يؤدي إلى تغييرات مسببة للانقطاع من إصدارات بيتا