دليل قراءة متعدد اللغات للمهارة

m365-agents-pyالغرض والاستخدام والمصدر

مايكروسوفت365مجموعة أدوات تطوير البرامج (SDK) للوكلاء بلغة بايثون. أنشئ وكلاء متعددي القنوات لـTeams/M365/Copilotاستوديو مزود باستضافة aiohttp، وتوجيه تطبيقات الوكيل، واستجابات متدفقة، ومصادقة قائمة على MSAL. المحفزات: "Microsoft365Agents SDK، "microsoft_agents"، "AgentApplication"، "start_agent_process"، "TurnContext"، "Copilot Studio client"، "CloudAdapter".

تم استرجاع المصدر: 2026-10-29

مستودع المصدر: microsoft/skills
SKILL.md: .github/plugins/azure-sdk-python/skills/m365-agents-py/SKILL.md
نجوم المستودع: 3,157
آخر تحديث للمستودع: 2026-10-31
تصنيف القدرات: خدمات الحوسبة السحابية
وقت التجميع الأخير: 2026-10-31 10:38 UTC+08:00

الترخيص: MIT

SKILL.md الأصلي

مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.

تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.

ما تفعله هذه المهارة

طريقة الاستخدام وفق المستند الأصلي

مايكروسوفت365مجموعة أدوات تطوير البرامج (بايثون) للوكلاء

قم ببناء وكلاء مؤسسيين لمايكروسوفت365، و Teams، و Copilot Studio باستخدام Microsoft Agents SDK مع استضافة aiohttp، وتوجيه AgentApplication، واستجابات البث، والمصادقة المستندة إلى MSAL.

مقتطف من المصدر · L12 ↗

قبل التنفيذ

استخدم أداة التحقق من صحة المستندات (MCP) من مايكروسوفت للتحقق من أحدث توقيعات واجهة برمجة التطبيقات (API) لـ AgentApplication و start_agent_process وخيارات المصادقة. تأكد من إصدارات الحزم على PyPI لحزم microsoft-agents-* التي تنوي استخدامها.

مقتطف من المصدر · L16 ↗

المصادقة ودورة الحياة

> 🔑 هناك قاعدتان تنطبقان على كل نموذج من نماذج التعليمات البرمجية أدناه: > >1هذه الحزمة البرمجية مصممة للعمليات غير المتزامنة أولاً — استخدمasync defالمناولون وasync withفي جميع أنحاء. >2استخدم مديري المصادقة الصريحين وموارد الشبكة المُدارة حسب السياق.MsalConnectionManagerلمصادقة الوكيل، وتغليف موارد HTTP لكل طلب فيasync with(على سبيل المثال،aiohttp.ClientSession). > > قد تختصر المقتطفات هذا الإعداد، ولكن يجب أن يتبع كود الإنتاج دائمًا كلا القاعدتين.

مقتطف من المصدر · L57 ↗

المتطلبات والإعداد

مقتطف من المصدر · bash ↗

pip install microsoft-agents-hosting-core
pip install microsoft-agents-hosting-aiohttp
pip install microsoft-agents-activity
pip install microsoft-agents-authentication-msal
pip install microsoft-agents-copilotstudio-client
pip install python-dotenv aiohttp

الحدود وفحوصات الجودة

إشعار هام - تغييرات الاستيراد

> ⚠️ تغيير جذري: أدت التحديثات الأخيرة إلى تغيير بنية استيراد بايثون منmicrosoft.agentsلmicrosoft_agents(باستخدام الشرطات السفلية بدلاً من النقاط).

مقتطف من المصدر · L21 ↗

ابدأ بتجربة آمنة

تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.

مواصفات ملف المهارة وبنية المجلدات ↗

اقرأ المزيد في المصدر

الترجمة والنطاق

يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.

تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.

المصدر بإصدار ثابت: اقرأ الأصل ↗
تم استرجاع المصدر: 2026-10-29T09:32:23Z
معرّف نسخة Git: 00d66a64919edca5bca2c673373444e36a4b5461
المصدر SHA-256: cd3b4a536bab82b795960a3ba728bf74345729a6cb278a50913639d5d77609a0

العودة إلى قائمة المهارات الكاملة