إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تمنح مهارة Microsoft Agent Framework منشئ .NET، agent-framework-builder-dotnetوكلاء ترميز متوافقين Microsoft إرشادات يتم الحفاظ عليها لبناء حلول إطار عمل العامل .NET (C#).
يساعد عامل الترميز على اختيار نمط مناسب وتحميل التوجيه المركز عليه تدريجيا للمهمة.
يمكن أن توجه المهارة العمل مع:
- الوكلاء العاديون وموفرو النماذج والأدوات والجلسات والمحفوظات وموفرو السياق والبرامج الوسيطة.
- تسخير العوامل مع todos، والأوضاع، والذاكرة، والموافقات، والمهارات، ووكلاء الخلفية، وأدوات shell، والضغط، والحلقات.
- مهام سير العمل والتزامنات المضمنة والتعريفات التعريفية.
- التقييم وقابلية الملاحظة والعملاء المخصصين والوكلاء المخصصين والتكاملات.
- الاستضافة والنشر.
توفر المهارة إرشادات تطوير لعامل ترميز خارجي. إنها ليست حزمة NuGet ولا تعمل داخل تطبيق Agent Framework الخاص بك.
مهم
تختلف مهارة وكيل الترميز هذه عن مهارات عامل وقت التشغيل. يتم تحميل مهارات وقت التشغيل بواسطة عامل إطار عمل العامل أثناء تشغيل التطبيق الخاص بك. تساعد مهارة المنشئ عامل الترميز على إنشاء التعليمات البرمجية المصدر للتطبيق أو تعديلها.
Tip
إقران مهارة المنشئ بخادم Microsoft Learn MCP. تمنح المهارة عامل الترميز إرشادات سير عمل إطار عمل العامل والتنفيذ المركز عليه، بينما يتيح له Learn MCP Server البحث في وثائق Microsoft الحالية وإحضار مقالات كاملة والعثور على نماذج التعليمات البرمجية أثناء المهمة. قم بتكوين نقطة نهاية HTTP العامة غير المصادق عليها في عامل ترميز متوافق:
https://learn.microsoft.com/api/mcp
المتطلبات المسبقه
- عامل ترميز يدعم مواصفات مهارات العامل المفتوحة.
-
GitHub CLI مع أوامر المعاينة
gh skill، أو Node.js 22.20 أو أحدث إذا كنت تستخدم CLI عبر العواملskills. - .NET SDK مدعوم حاليا لتطبيقات إطار عمل العامل الجديدة.
GitHub إدارة مهارات CLI قيد المعاينة وتخضع للتغيير.
مراجعة وتثبيت مع GitHub CLI
مهارة منشئ .NET ليست في إصدار ذات علامة حتى الآن، لذلك تحتاج إلى تحديد @main مرجع . معاينة المهارة قبل تثبيتها:
gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main
تثبيت المهارة:
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main
التثبيت الافتراضي هو نطاق المشروع والأهداف GitHub Copilot في الاستخدام غير التفاعلي. حدد عامل ترميز معتمد آخر أو نطاق مستخدم آخر عند الحاجة:
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent codex
للحصول على خيارات العميل والنطاق الحالية، راجع gh skill install.
التثبيت باستخدام CLI للمهارات عبر العوامل
كبديل، قم بتثبيت المهارة باستخدام CLI عبر الوكيل skills :
npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet
راجع عوامل الترميز المدعومة ل CLI ومتطلبات وقت التشغيل قبل التثبيت.
استخدام المهارة
مطالبة عامل الترميز بشكل طبيعي. العملاء المتوافقون يكتشفون وينشطون المهارة من بيانات التعريف الخاصة بها؛ لا تفترض أمر شرطة مائلة عالمية.
أمثلة على المطالبات:
Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with todos, file access, and safe shell tooling.Review this .NET Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.
قم بتضمين قيود مثل موفر النموذج وهدف الاستضافة ومتطلبات الاستمرار والحدود الأمنية وإصدار .NET الهدف عندما تعرفها.
ما يجب أن يفعله عامل الترميز
ترشد المهارة عامل ترميز إلى:
- افحص الحل الحالي، بما في ذلك أطر العمل المستهدفة وإصدار SDK وإدارة الحزم والحزم المثبتة
Microsoft.Agents.AI.*. - اختر أصغر نمط مناسب، مثل عامل عادي أو تسخير أو سير عمل أو تنسيق أو تعريف تعريف تعريفي.
- قم بتحميل المراجع المركز عليها ذات الصلة فقط.
- أضف المجموعة الضيقة فقط من الحزم التي يحتاجها التطبيق، وتحقق من نضج كل حزمة قبل الاعتماد عليها، لأن بعض الحزم تكون إصدارا مسبقا.
- اقرأ نقاط النهاية والنماذج والمفاتيح من التكوين، وتفضل بيانات اعتماد الرمز المميز على مفاتيح واجهة برمجة التطبيقات ذات التعليمات البرمجية المضمنة.
- تحقق من صحة التطبيق الذي تم إنشاؤه باستخدام اختبارات المستودع الحالية والعينات القابلة للتشغيل.
لا تضمن المهارة أن التعليمات البرمجية التي تم إنشاؤها جاهزة للإنتاج. راجع خطة عامل الترميز وخيارات الحزمة والأوامر والأوامر والتغييرات التي تم إنشاؤها قبل الموافقة.
تعيين الإصدار والثقة
المهارة هي مهارة المستهلك العامة، القابلة للتنصيب، Microsoft الحفاظ عليها. إصدار بيانات تعريف مهارتها هو 0.1.
- استخدم مرجع
@mainحتى يتضمن الإصدار الموسوم المهارة. - معاينة محتوى المهارة قبل التثبيت ومراجعة التحديثات قبل الوثوق في البرامج النصية أو الإرشادات الجديدة.
للحصول على المراجع المصدر والمراجع المركز عليها، راجع:
الخطوات التالية
انتقل إلى أبعد من ذلك:
تمنح مهارة Microsoft Agent Framework منشئ Python، agent-framework-builder-pythonوكلاء الترميز المتوافقين Microsoft إرشادات يتم الحفاظ عليها لبناء حلول إطار عمل عامل Python.
يساعد عامل الترميز على اختيار نمط مناسب وتحميل التوجيه المركز عليه تدريجيا للمهمة.
يمكن أن توجه المهارة العمل مع:
- الوكلاء العاديون وموفرو النماذج والأدوات والموافقات والجلسات والمحفوظات وموفرو السياق.
- الاستفادة من العوامل مع التخطيط، المهام، الذاكرة، الضغط، الملفات، وكلاء الخلفية، أدوات shell، والحلقات.
- مهام سير العمل الوظيفية والرسم البياني، والتزامنات المضمنة، والتعريفات التعريفية.
- التقييم وقابلية المراقبة والبرامج الوسيطة والعملاء المخصصين والوكلاء المخصصين والتكاملات.
- الاستضافة الذاتية وتطوير عامل مستضاف Microsoft Foundry.
المهارة Python فقط. وهو يوفر إرشادات التطوير لعامل ترميز خارجي؛ إنها ليست حزمة Python، لم يتم تثبيتها بواسطة pip install agent-framework، ولا يتم تشغيلها داخل تطبيق Agent Framework الخاص بك.
مهم
تختلف مهارة وكيل الترميز هذه عن مهارات عامل وقت التشغيل. يتم تحميل مهارات وقت التشغيل بواسطة عامل إطار عمل العامل أثناء تشغيل التطبيق الخاص بك. تساعد مهارة المنشئ عامل الترميز على إنشاء التعليمات البرمجية المصدر للتطبيق أو تعديلها.
Tip
إقران مهارة المنشئ بخادم Microsoft Learn MCP. تمنح المهارة عامل الترميز إرشادات سير عمل إطار عمل العامل والتنفيذ المركز عليه، بينما يتيح له Learn MCP Server البحث في وثائق Microsoft الحالية وإحضار مقالات كاملة والعثور على نماذج التعليمات البرمجية أثناء المهمة. قم بتكوين نقطة نهاية HTTP العامة غير المصادق عليها في عامل ترميز متوافق:
https://learn.microsoft.com/api/mcp
المتطلبات المسبقه
- عامل ترميز يدعم مواصفات مهارات العامل المفتوحة.
-
GitHub CLI مع أوامر المعاينة
gh skill، أو Node.js 22.20 أو أحدث إذا كنت تستخدم CLI عبر العواملskills. - Python 3.11 أو أحدث. لم يعد Agent Framework 1.24 يدعم أو يختبر Python 3.10، على الرغم من أن بيانات تعريف الحزمة لا تزال تسمح بالتثبيت.
GitHub إدارة مهارات CLI قيد المعاينة وتخضع للتغيير.
مراجعة وتثبيت مع GitHub CLI
معاينة المهارة التي تم إصدارها قبل تثبيتها:
gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0
تثبيت أحدث إصدار تم وضع علامة عليه:
gh skill install microsoft/agent-framework agent-framework-builder-python
ثبت إصدار Python 1.23 عندما تحتاج إلى إرشادات قابلة للتكرار:
gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0
التثبيت الافتراضي هو نطاق المشروع والأهداف GitHub Copilot في الاستخدام غير التفاعلي. حدد عامل ترميز معتمد آخر أو نطاق مستخدم آخر عند الحاجة:
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent codex
للحصول على خيارات العميل والنطاق الحالية، راجع gh skill install.
التثبيت باستخدام CLI للمهارات عبر العوامل
كبديل، قم بتثبيت المهارة باستخدام CLI عبر الوكيل skills :
npx skills add microsoft/agent-framework --skill agent-framework-builder-python
راجع عوامل الترميز المدعومة ل CLI ومتطلبات وقت التشغيل قبل التثبيت.
استخدام المهارة
مطالبة عامل الترميز بشكل طبيعي. العملاء المتوافقون يكتشفون وينشطون المهارة من بيانات التعريف الخاصة بها؛ لا تفترض أمر شرطة مائلة عالمية.
أمثلة على المطالبات:
Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with planning, todos, file access, and safe shell tooling.Review this Python Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.
قم بتضمين قيود مثل موفر النموذج وهدف الاستضافة ومتطلبات الاستمرار وقيود الأمان وإصدار Python المدعوم عندما تعرفها.
ما يجب أن يفعله عامل الترميز
ترشد المهارة عامل ترميز إلى:
- اختر أصغر نمط مناسب، مثل عامل عادي أو تسخير أو سير عمل أو تنسيق أو تعريف تعريف تعريفي.
- قم بتحميل المراجع المركز عليها ذات الصلة فقط.
- تفضل إرشادات Microsoft Learn الحالية ومراجع واجهة برمجة التطبيقات العامة ومعلومات دورة حياة الحزمة والعينات التي تم الاحتفاظ بها للحصول على تفاصيل متقلبة.
- قم بتثبيت مجموعات الحزم الضيقة بدلا من افتراض أن كل تكامل مستقر أو مطلوب.
- الاحتفاظ بحدود الجلسة والموافقة والمصادقة والاستضافة الصريحة.
- تحقق من صحة التطبيق الذي تم إنشاؤه باستخدام الاختبارات الموجودة للمستودع وعمليات التحقق من النوع والعينات القابلة للتشغيل.
لا تضمن المهارة أن التعليمات البرمجية التي تم إنشاؤها جاهزة للإنتاج. راجع خطة عامل الترميز وخيارات الحزمة والأوامر والأوامر والتغييرات التي تم إنشاؤها قبل الموافقة.
تعيين الإصدار والثقة
المهارة هي مهارة المستهلك العامة، القابلة للتنزيل، Microsoft التي تم إصدارها في python-1.23.0 علامة المستودع. إصدار بيانات تعريف مهارتها هو 0.3.
- استخدم أمر التثبيت غير المؤهل لأحدث إصدار تم وضع علامة عليه.
- تثبيت
@python-1.23.0عندما تكون قابلية إعادة الإنتاج مهمة. - استخدم
@mainفقط عندما تريد إرشادات غير مستخدمة عن قصد. - معاينة محتوى المهارة قبل التثبيت ومراجعة التحديثات قبل الوثوق في البرامج النصية أو الإرشادات الجديدة.
للحصول على المراجع المصدر والمراجع المركز عليها، راجع:
الخطوات التالية
انتقل إلى أبعد من ذلك:
ملاحظة
لا تتوفر مهارة Microsoft Agent Framework builder ل Go حتى الآن. استخدم البرنامج التعليمي Go get-startedوأمثلة Agent Framework Go للإرشادات الحالية.