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

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

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

يظهر نموذج التكامل الحدود بين التكاملات المدمجة، ومزامنة السجل، وسيناريوهات حزمة تطوير التطوير الخاصة بعامل 365 المدمجة من قبل المطورين.

مخطط نموذج تكامل الوكيل 365 يوضح مكان وضع SDK للوكيل 365.

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

ما الذي تضيفه حزمة تطوير البرمجيات

توفر مجموعة تطوير التطوير أربع قدرات:

Capability الوصف
الهوية استخدم هوية وكيل مدعومة من Microsoft Entra للمصادقة الآمنة والوصول المتحكم به إلى الأدوات والبيانات. الوكلاء الذين يحتاجون إلى حساب مستخدم وصندوق بريد خاص بهم متاحون فقط للمستأجرين المشاركين في برنامج معاينة فرونتير.
إمكانية المراقبة يرسل بيانات التليمترية عبر OpenTelemetry، مما ينتج تفاعلات مدققة وقابلة للتتبع، وأحداث استدلال، واستخدام الأدوات.
الأدوات خوادم بروتوكول السياق النموذجي (MCP) التي تحكم Invoke في WorkIQ Model Protocol للوصول إلى أحمال عمل Microsoft 365 مثل البريد والتقويم وWord وSharePoint وTeams تحت سيطرة المسؤول.
الإعلامات استلام ورد على الرسائل من Teams وOutlook وتعليقات Word والبريد الإلكتروني، مثل مشارك بشري في تطبيقات Microsoft 365. تتطلب هذه القدرة حساب مستخدم وكيل ومتاحة فقط للمستأجرين المشاركين في برنامج معاينة فرونتير.

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

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

قارن بين مجموعة تطوير Microsoft Agent 365 وحزمة تطوير Microsoft 365 Agents SDK

مجموعة تطوير Microsoft Agent 365 وحزمة تطوير Microsoft 365 Agents SDK هما منتجان مختلفان.

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

تعمل هاتان المجموعتان معا، بحيث يمكنك بناء وكيل باستخدام Microsoft 365 Agents SDK ثم استخدام Agent 365 SDK لمنحه هوية، وقابلية الملاحظة، وأدواته، وإشعارات.

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

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

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

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

ملحوظة

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

سير الانضمام

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

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

يمكنك إكمال هذه الخطوات يدويا أو استخدام مهارات الوكيل 365 من مساعد ترميز مدعوم. المهارات توجه الإعداد، وتجري التغييرات المطلوبة، وتؤكد النتيجة.

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

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

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

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

حزم SDK للوكيل 365

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

حزم حزمة تطوير Agent 365 الخاصة ب Python موجودة على مؤشر حزم Python (PYPI).

الحزمة الوصف
microsoft-agents-a365-notifications إضافات الإشعارات والمراسلة لتطبيقات الوكيل الذكي. يوفر أدوات مساعدة لمعالجة إشعارات العامل وأحداث دورة الحياة والتوجيه عبر قنوات وقنوات فرعية مختلفة في تطبيقات Microsoft 365.
microsoft-agents-a365-observability-core مكونات القياس عن بعد والتتبع والمراقبة لعوامل الذَّكَاءُ الاصْطِنَاعِيُّ المبنية على OpenTelemetry. يوفر امتدادات منظمة لاستدعاء الوكيل وتنفيذ الأدوات واستنتاج LLM مع نشر السياق والتصدير القابل للإضافة.
microsoft-agents-a365-observability-extensions-agent-framework ملحقات إمكانية المراقبة لـ Microsoft Agent Framework. يوفر تكامل تتبع OpenTelemetry خصيصا للتطبيقات المستندة إلى Agent Framework.
microsoft-agents-a365-observability-extensions-openai ملحقات إمكانية المراقبة ل OpenAI Agents SDK. يوفر تكامل تتبع OpenTelemetry للتطبيقات المستندة إلى OpenAI Agents مع الأجهزة التلقائية لسير عمل العامل واستدعاءات الأَدَوَات.
microsoft-agents-a365-observability-extensions-langchain ملحقات إمكانية المراقبة لإطار عمل LangChain. يوفر التكامل مع OpenTelemetry لتتبع تطبيقات الذكاء الاصطناعي المستندة إلى LangChain، مع التفعيل التلقائي للسلاسل والوكلاء والأدوات.
microsoft-agents-a365-observability-extensions-semantic-kernel ملحقات إمكانية المراقبة لإطار عمل نواة دلالية. يوفر تكامل تتبع 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 للذكاء الاصطناعي.