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

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

موضع SDK

يُظهر نموذج التكامل الحدود بين التكاملات المدمجة، ومزامنة السجل، وسيناريوهات Agent 365 SDK المتكاملة بواسطة المطورين.

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

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

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

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

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

Important

لا تستخدم حزمة 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 لإمكانية الملاحظة.

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

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

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

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

ملحوظة

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

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

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

مرحلة الوصف
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 في مديري الحزم الخاصة باللغات المدعومة.

Important

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

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

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

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

  • Last updated on