نظرة عامة على مجموعة تطوير البرمجيات لـ Microsoft Agent 365

يربط Microsoft Agent 365 SDK وكيلاً تملكه بالفعل وتقوم بتشغيله إلى Microsoft Agent 365. استخدمها للوصول على مستوى الكود إلى قدرات مثل هوية الوكيل، أدوات Work IQ المحكومة، أو الإشعارات.

أين تندرج مجموعة تطوير البرمجيات

يجمع Agent 365 وكلاء مِنْ مصادر مختلفة فِي طبقة تحكم واحدة حيث يمكن للمؤسسات اكتشافهم وإدارتهم وتأمينهم على نطاق واسع. يعتمد مسار التكامل على مكان وكيفية بناء الوكيل:

رسم توضيحي يظهر وكلاء من ثلاثة مصادر (Microsoft، الكود المخصص، وسحابة طرف ثالث) يتصلون عبر طبقة حوكمة Agent 365 ويحصلون على قدرات الهوية، والسياسات، والملاحظة، والإشعارات.

مصدر الْعامل مسار التكامل
منصات ووكلاء Microsoft، ووكلاء الْجهات الْخارجية الْمدعومة استخدم تكامل Agent 365 الأصلي للمنصة. يمكن لهؤلاء الوكلاء الظهور في مخزون Agent 365 دون إضافة مجموعة تطوير برامج Agent 365.
الوكلاء الذين تبنيهم باستخدام SDK أو إطار عمل أضف Agent 365 SDK إلى التعليمات البرمجية لعاملك لإتاحة إمكانات يدمجها المطوّر، مثل أدوات Work IQ الخاضعة للحوكمة أو الإشعارات.
منصات العاملين المتصلين قم بتكوين مزامنة الْسجل لكل منصة لاستيراد العاملين التابعين لها إلى مخزون Agent 365.

تربط المسارات الثلاثة الوكلاء ب Agent 365 وتكاملاته مع Microsoft Entra وMicrosoft Defender وMicrosoft Purview وMicrosoft Intune. التكامل الأصلي ومزامنة السجل لا يوفران بالضرورة نفس القدرات على مستوى الكود كما في مجموعة تطوير Agent 365. تتطور التكاملات مع المنصات، لذا تأكد من توجيهات المنصة الحالية قبل تغيير التكامل. انظر اختر خيار التكامل الخاص بك.

كيف تتناسب قدرات Agent 365 معًا

يوفر تكامل مطوري Agent 365 أربع قدرات. توفر حزمة SDK الخاصة بـ Agent 365 إمكانات الهوية والأدوات والإشعارات. يوفر Microsoft OpenTelemetry قابلية للملاحظة:

الإمكانية Description
Identity استخدم هوية وكيل مدعومة من Microsoft Entra للمصادقة الآمنة والوصول المتحكم به إلى الأدوات والبيانات. الوكلاء الذين يحتاجون إلى حساب مستخدم وصندوق بريد خاص بهم متاحون فقط للمستأجرين المشاركين في برنامج معاينة فرونتير.
إمكانية المراقبة استخدم توزيعة Microsoft OpenTelemetry المنفصلة لإصدار بيانات عن بعد تنتج تفاعلات مدققة وقابلة للتتبع، وأحداث استدلال، واستخدام الأدوات.
الأدوات استدعِ خوادم Work IQ Model Context Protocol (MCP) الخاضعة للحوكمة للوصول إلى أحمال عمل Microsoft 365، مثل Mail وCalendar وWord وSharePoint وTeams، تحت تحكم المسؤول.
الإعلامات استقبال الرسائل والرد عليها من Teams وOutlook وتعليقات Word والبريد الإلكتروني، كما لو كنت مشاركًا بشريًا في تطبيقات Microsoft 365. تتطلب هذه الإمكانية حساب المستخدم الخاص بالوكيل، وهي متاحة فقط للمستأجرين المشاركين في برنامج المعاينة فرونتير.

مهم

لا تستخدم حزمة SDK المهجورة لـ Agent 365 لقابلية المراقبة لتكاملات قابلية المراقبة الجديدة. استخدم توزيعة Microsoft OpenTelemetry. استمر في استخدام حزم SDK الخاصة بالوكيل 365 للهوية، والأدوات، والإشعارات.

اختر القدرات التي تتوافق مع متطلبات وكيلك بدلاً من اعتماد مجموعة وظائف SDK الكاملة. تستخدم الهوية والأدوات والإشعارات مخطط هوية الوكيل كأساس لـ Entra. تتطلب الإشعارات أيضا حساب مستخدم وكيل. يمكن ل Microsoft OpenTelemetry استخدام إما مخطط هوية الوكيل أو تسجيل تطبيق Microsoft Entra القياسي.

يتم تقديم مجموعة تطوير البرمجيات في حزم خاصة بكل لغة للغات Python وJavaScript و.NET. قم بتثبيت الحزمة أو الحزم الخاصة بالقدرات التي تختارها، ثم قم بتكوين الهوية المقابلة، والأذونات، وتكامل وقت التشغيل. للاطلاع على الحزم المتاحة، راجع حزم Agent 365 SDK. قم بتثبيت Microsoft OpenTelemetry بشكل منفصل لتكاملات الرصد الجديدة.

مقارنة بين Microsoft Agent 365 SDK وMicrosoft 365 Agents SDK

Microsoft Agent 365 SDK وMicrosoft 365 Agents SDK هما منتجان مختلفان.

Microsoft Agent 365 مجموعة أدوات التطوير (مجموعة أدوات التطوير هذه) حزمة تطوير Microsoft 365 Agents
لا تنشئ عاملين.
يوسّع وكيلاً موجودًا بالفعل لإضافة الهوية، والأدوات، والإشعارات. استخدم Microsoft OpenTelemetry لإضافة الرصد.		 إطار عمل لبناء وكلاء المحادثة.
يتعامل مع توصيل الرسائل عبر قنوات مثل Teams و Microsoft Copilot، ويدير حالة المحادثة.

تعمل هذه حِزم SDK معًا. يمكنك بناء وكيل باستخدام Microsoft 365 Agents SDK، واستخدام Agent 365 SDK للهوية، والأدوات، والإشعارات، واستخدام Microsoft OpenTelemetry للرصد.

ما هو وما ليس كذلك

تستمر في امتلاك الطبقات الثلاث التي تجعل الوكيل يعمل:

الطبقة Description
النموذج نموذج اللغة أو محرك التفكير الذي يتصل به وكيلك. حزمة تطوير البرمجيات لا تستدعي النماذج أو تختارها.
إطار العمل أو بيئة التشغيل LangChain، Microsoft Agent Framework، نواة دلالية، OpenAI Agents SDK، Claude Agent SDK، أو كود مخصص. لا يقوم SDK ببناء وكلاء، أو يخطط للخطوات أو ينسقها، أو ينفذ الأدوات.
المضيف أينما يعمل الوكيل اليوم، مثل Azure أو AWS أو Google Cloud أو في البيئة المحلية. حزمة تطوير البرمجيات لا تستضيف وكيلك أو تنشّره.

تعمل مجموعة تطوير البرمجيات الخاصة ب Microsoft Agent 365 جنبا إلى جنب مع هذه الطبقات. لا تنشئ الْعامل أو تستضيفه أو تنشره أو تنظمه أو تنفذه.

Note

تسجل مجموعة تطوير البرمجيات الخاصة ب Microsoft Agent 365 خوادم MCP المحكومة بحيث يمكن لوكيلك الوصول إلى أحمال عمل Microsoft 365، لكن وقت التشغيل لا يزال ينفذ استدعاءات الأدوات.

عملية الإعداد الأولي

يتبع التكامل أربع مراحل:

مرحلة Description
1. التسجيل أنشئ المخطط التفصيلي لهوية الوكيل وهوية الوكيل في Microsoft Entra.
2. وسّع أضف القدرات التي يحتاجها وكيلك. استخدم مجموعة تطوير البرامج Agent 365 SDK لأدوات أو إشعارات Work IQ، واستخدم Microsoft OpenTelemetry لأغراض الرصد.
3. تحقق شغل الوكيل كما كان من قبل وتأكد من هويته، وبيانات التليمترية، والوصول إلى الأداة، والتعامل مع الرسائل.
4. شغّل استخدم عناصر التحكم في Agent 365 لإدارة وتدقيق الوكيل المتصل.

يمكنك إكمال هذه الخطوات يدويًا أو استخدام Agent 365 Skills من مساعد ترميز مدعوم. الْمهارات توجّه الْإعداد، وتجري الْتغييرات الْمطلوبة، وتتحقق مِنْ الْنتيجة.

كيف يتدفق الطلب

يمكن لتفاعل واحد أن يستخدم جميع القدرات الأربع. عند @mentions شخص ما لعاملك فِي مستند Word:

  1. تقوم الإشعارات بتسليم الإشارة إلى العامل.
  2. الهوية والمصادقة تحددان ما إذا كان الوكيل يتصرف كنفسه، نيابة عن مستخدم مسجل، أو من خلال حساب مستخدم وكيل. الوضع المختار، والأذونات، والموافقة، وموضوع الرمز تحدد البيانات والإجراءات التي تكون متاحة.
  3. توفر الأدوات للوكيل وصولًا خاضعًا للحوكمة إلى بيانات Microsoft 365 التي يحتاجها.
  4. يسجل الرصد الاستدعاء، واستدعاءات الأدوات، واستدلال النموذج.

ثم يرد وكيلك في سلسلة التعليقات.

حزم SDK للوكيل 365

ابحث عن حزم SDK الخاصة بالعميل 365 في مديري الحزم الخاصة باللغات المدعومة.

مهم

حزم إمكانية المراقبة فِي الجداول التالية مهملة. لا تستخدمها في التكاملات الجديدة. استخدم توزيعة Microsoft OpenTelemetry، أو راجع وثائق SDK لميزة الرصد الخاصة ب Agent 365 المهجورة قبل نقل تكامل موجود.

يمكنك العثور على حزم SDK الخاصة ب Agent 365 ل Python في فهرس حزم Python (PYPI).

الحزمة Description
microsoft-agents-a365-notifications إضافات الإشعارات والمراسلة لتطبيقات الوكيل الذكي. يوفر أدوات مساعدة لمعالجة إشعارات العامل وأحداث دورة الحياة والتوجيه عبر قنوات وقنوات فرعية مختلفة في تطبيقات Microsoft 365.
microsoft-agents-a365-observability-core مهملة: مكونات قديمة لبيانات تتبع الاستخدام والتتبع والمراقبة لعاملي الذكاء الاصطناعي الذين تم إنشاؤهم استنادًا إلى OpenTelemetry. توفر مقاطع تتبع منظمة لاستدعاء العامل، وتنفيذ الأدوات، والاستدلال باستخدام نماذج اللغة الكبيرة، مَعَ تمرير السياق وأدوات تصدير قابلة للتوصيل. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.
microsoft-agents-a365-observability-extensions-agent-framework مهجورة: امتدادات قابلية الملاحظة القديمة لإطار عمل Microsoft Agent. يوفر تكامل تتبع OpenTelemetry خصيصا للتطبيقات المستندة إلى Agent Framework. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.
microsoft-agents-a365-observability-extensions-openai مهجورة: امتدادات قابلية المراقبة القديمة لحزمة تطوير OpenAI Agents. يوفر تكامل تتبع OpenTelemetry للتطبيقات المستندة إلى OpenAI Agents مع الأجهزة التلقائية لسير عمل العامل واستدعاءات الأدوات. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.
microsoft-agents-a365-observability-extensions-langchain مُهمَلة: امتدادات الرصد القديمة لإطار عمل LangChain. توفر تكامل OpenTelemetry لتطبيقات الذكاء الاصطناعي المستندة إلى LangChain مَعَ التجهيز التلقائي للسلاسل والعاملين والأدوات. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.
microsoft-agents-a365-observability-extensions-semantic-kernel مهملة: ملحقات إمكانية المراقبة القديمة لإطار عمل نواة دلالية. توفر تكامل تتبع OpenTelemetry للتطبيقات المستندة إلى نواة دلالية مَعَ التجهيز التلقائي لوظائف النواة والمكونات الإضافية والمخططين. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.
microsoft-agents-a365-runtime أدوات وقت التشغيل الأساسية وإدارة البيئة لتطبيقات عامل الذَّكَاءُ الاصْطِنَاعِيُّ. يوفر عملية اكتشاف واجهة برمجة تطبيقات Power Platform الأساسية، وتكوين البيئة، وتحديد نطاق المصادقة.
microsoft-agents-a365-tooling وظيفة الأَدَوَات الأساسية لإدارة خَادِم أداة MCP (بروتوكول سياق النموذج) في التطبيقات التي تم إنشاؤها باِسْتِخْدَام Microsoft Agent 365 SDK. يوفر الأساس لاكتشاف خوادم الأَدَوَات وتسجيلها وإدارتها عبر أطر عمل الذَّكَاءُ الاصْطِنَاعِيُّ مختلفة.
microsoft-agents-a365-tooling-extensions-agentframework أدوات وخدمات Agent Framework الخاصة لتطوير عامل الذَّكَاءُ الاصْطِنَاعِيُّ. يوفر خدمة تسجيل أداة MCP (بروتوكول سياق النموذج) لإضافة خوادم MCP ديناميكيا إلى عوامل Agent Framework.
microsoft-agents-a365-tooling-extensions-openai أدوات وخدمات SDK مخصصة لوكلاء OpenAI لتطوير وكلاء الذَّكَاءُ الاصْطِنَاعِيُّ. يوفر خدمة تسجيل أداة MCP (بروتوكول سياق النموذج) لإضافة خوادم MCP ديناميكيا إلى العوامل المستندة إلى OpenAI Agents SDK.
microsoft-agents-a365-tooling-extensions-semantickernel نواة دلالية أدوات وخدمات محددة لتطوير عامل الذكاء الاصطناعي. يوفر خدمة تسجيل أداة MCP (بروتوكول سياق النموذج) لإضافة خوادم MCP ديناميكيا إلى العوامل المستندة إلى نواة دلالية.
microsoft-agents-a365-tooling-extensions-azureaifoundry منصة Azure للذكاء الاصطناعي أدوات وخدمات محددة لتطوير عامل الذكاء الاصطناعي. يوفر خدمة تسجيل أداة MCP (بروتوكول سياق النموذج) لإضافة خوادم MCP ديناميكيا إلى عوامل منصة Azure للذكاء الاصطناعي.

المحتوى ذو الصلة

  • تاريخ آخر تحديث في