واجهة برمجة Work IQ من مايكروسوفت: بناء وكلاء الذكاء الاصطناعي للمؤسسات

أصبحت واجهة برمجة تطبيقات Work IQ من مايكروسوفت متاحةً للعموم رسمياً في 16 يونيو 2026، وقد غيّرت بشكل جوهري الطريقة التي يبني بها المطورون وكلاء الذكاء الاصطناعي المؤسسية. بدلاً من بناء خطوط أنابيب بيانات مخصصة وأنظمة أذونات وفحوصات امتثال منفصلة، تلف Work IQ كل هذا التعقيد في طبقة ذكاء واحدة يمكن للوكلاء الاستعلام عنها عبر ثلاثة بروتوكولات: من وكيل إلى وكيل (A2A)، وبروتوكول سياق النموذج (MCP)، وواجهة REST.

يغطي هذا الدليل ماهية Work IQ وكيفية عمل كل بروتوكول، وكيفية جعل وكيلك الأول يستدل على بيانات Microsoft 365 في دقائق.

ما هي Work IQ؟

Work IQ هي طبقة الذكاء المهني من مايكروسوفت — سطح موحد لواجهة برمجة التطبيقات يتيح لوكلاء الذكاء الاصطناعي الوصول إلى بيانات المؤسسة والاستدلال عليها، بما فيها: رسائل البريد الإلكتروني، وأحداث التقويم، ورسائل Teams، ومستندات SharePoint، وملفات OneDrive، وسياق الأشخاص. تجلس بين وكلائك وبيانات Microsoft 365 الخام، وتتولى المصادقة وتقليص الأذونات وإنفاذ الامتثال تلقائياً.

الفكرة الجوهرية بسيطة: يحتاج وكلاء الذكاء الاصطناعي المؤسسي إلى سياق تنظيمي ليكونوا مفيدين، لكن بناء هذه الطبقة بشكل صحيح أمر عسير. تحتاج إلى نطاقات OAuth، ووظائف مزامنة دلتا، ومخازن متجهات، ومعالجة ملصقات الحساسية، وتدقيق السجلات. تُلغي Work IQ كل ذلك بجعله مسؤولية النظام الأساسي بدلاً من المطور.

لماذا Work IQ بدلاً من خطوط الأنابيب المخصصة؟

تتطلب تكاملات الذكاء الاصطناعي المؤسسية التقليدية منك:

استخراج البيانات وفهرستها من واجهات برمجة M365 المختلفة
الحفاظ على مخازن متجهات للبحث الدلالي
التعامل مع تقليص الأذونات يدوياً للتأكد من أن الوكيل لا يقرأ بيانات لا يملك المستخدم صلاحية الوصول إليها
تنفيذ سياسات الامتثال ومسارات التدقيق
إدارة تجديد الرموز وتقييد معدل الطلبات ومعالجة الأخطاء عبر عشرات من نقاط نهاية Graph API

تضغط Work IQ كل هذا في نقطة نهاية API واحدة واعية بالسياسات. كل طلب يقتصر تلقائياً على أذونات المستخدم المسجل. يُحترم تصنيف الحساسية. سجلات التدقيق مدمجة.

ما البيانات التي يمكن للوكلاء الاستدلال عليها؟

تُتيح Work IQ ست فئات من بيانات مكان العمل:

رسائل البريد الإلكتروني — قراءة محتوى البريد الوارد والبحث فيه وتلخيصه
التقويم والاجتماعات — الاستعلام عن الأحداث القادمة وسياق الاجتماعات والحضور
الملفات — الوصول إلى المستندات في OneDrive وSharePoint
رسائل Teams — البحث في القنوات والمحادثات
سياق الأشخاص — التسلسل الهرمي للمؤسسة والخبرات والعلاقات
البحث المؤسسي — البحث الدلالي عبر مصادر البيانات

تُقدَّم جميع البيانات عبر نفس نقطة النهاية، مع تقليص الأذونات في الوقت الفعلي.

ثلاثة بروتوكولات، طبقة ذكاء واحدة

تدعم Work IQ ثلاثة بروتوكولات للتفاعل، كل منها مناسب لنمط تكامل مختلف.

A2A: بروتوكول من وكيل إلى وكيل

استخدم A2A عندما يحتاج وكيلك إلى تفويض العمل إلى Work IQ كوكيل نظير. هذا مثالي لأنظمة متعددة الوكلاء حيث يُفوّض وكيل منسق المهام الخاصة بـ M365.

يستخدم A2A غلاف JSON-RPC ويُرسل إلى عنوان URL أساسي واحد. اسم الطريقة موجود داخل جسم الطلب وليس في مسار URL.

POST https://workiq.svc.cloud.microsoft/a2a/
Authorization: Bearer {access-token}
Content-Type: application/json
A2A-Version: 1.0
 
{
  "jsonrpc": "2.0",
  "id": "req-001",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "msg-001",
      "parts": [
        { "text": "ما الاجتماعات التي لديّ هذا المساء؟" }
      ],
      "metadata": {
        "Location": {
          "timeZone": "Africa/Tunis",
          "timeZoneOffset": 60
        }
      }
    }
  }
}

تتضمن الاستجابة قطعة أثرية للمهمة مع الإجابة:

{
  "jsonrpc": "2.0",
  "id": "req-001",
  "result": {
    "task": {
      "id": "task-abc",
      "contextId": "ctx-xyz",
      "status": { "state": "TASK_STATE_COMPLETED" },
      "artifacts": [
        {
          "parts": [
            { "text": "هذا المساء: مراجعة مع العميل الساعة 2، اجتماع الفريق الساعة 4." }
          ]
        }
      ]
    }
  }
}

للمحادثات متعددة الأدوار، أرسل contextId من الاستجابة السابقة مع الرسائل التالية. تحافظ Work IQ على سياق المحادثة عبر الأدوار.

متى تستخدم A2A: أنظمة متعددة الوكلاء، تفويض المهام المستقل، خطوط أنابيب تنسيق الوكلاء.

MCP: بروتوكول سياق النموذج

استخدم MCP عندما يحتاج مساعد ذكاء اصطناعي في بيئة التطوير أو سطر الأوامر إلى سحب سياق M365 ديناميكياً كأدوات. توفر Work IQ خادم MCP محلياً تثبته عبر واجهة سطر الأوامر workiq، مما يضغط مئات استدعاءات Graph API المحتملة في 10 أفعال أداة عامة فقط.

قم بتكوينه في بيئتك المدعومة لـ MCP:

{
  "workiq": {
    "type": "stdio",
    "command": "workiq",
    "args": ["mcp"]
  }
}

بمجرد تكوينه، يمكن لمساعد الذكاء الاصطناعي استدعاء Work IQ كأداة. على سبيل المثال، السؤال عن "لخّص المناقشات الأخيرة حول مخاطر المشروع" يُطلق:

{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}

تُعيد Work IQ نتائج مؤسسة ومُقيَّدة بالأذونات دون أن يحتاج المساعد إلى وصول مباشر لـ Graph API.

متى تستخدم MCP: مساعدو الترميز بالذكاء الاصطناعي، بيئات التطوير، سطر الأوامر، أي أداة قائمة على نماذج اللغة تدعم استدعاء الأدوات.

REST API: طلب واستجابة تحادثية

استخدم REST عند بناء تطبيق ويب أو خدمة خلفية ترسل الأسئلة إلى Work IQ وتعرض الاستجابات.

POST https://workiq.svc.cloud.microsoft/v1/conversations
Authorization: Bearer {access-token}
Content-Type: application/json
 
{
  "query": "أرني رسائل بريد إلكتروني من دانا حول توقعات الربع الثالث"
}

تُعيد Work IQ استجابة باللغة الطبيعية المؤسَّسة مع مقتطفات البريد الإلكتروني ذات الصلة، مُصفَّاة بالأذونات لما يُسمح للمستخدم المسجل برؤيته.

متى تستخدم REST: تطبيقات الويب، الوكلاء المستضافون كخدمة، أنظمة التنسيق الخلفية التي لا تحتاج إلى تفويض الوكيل.

اختيار البروتوكول المناسب

السيناريو	البروتوكول
وكيل آخر يحتاج إلى تفويض مهمة M365	A2A
تطبيق ويب أو خدمة خلفية ترسل استعلامات	REST
مساعد ذكاء اصطناعي في بيئة التطوير يحتاج إلى سياق M365	MCP

المصادقة والأمان

تستخدم Work IQ مصادقة Entra ID المفوضة من مايكروسوفت. كل طلب يعمل في سياق المستخدم المسجل — لا يوجد وصول تطبيقي فقط. إذا لم يستطع المستخدم قراءة مستند، فلا يستطيع الوكيل العامل بالنيابة عنه ذلك أيضاً.

القواعد الأساسية:

استخدم التدفقات المفوضة (رمز المصادقة، رمز الجهاز، أو نيابة عن)
المصادقة التطبيقية فقط غير مدعومة
للتطبيقات متعددة المستأجرين، سجّل كـ AzureADMultipleOrgs وتأكد من تسجيل دخول المستخدمين عبر سلطة المستأجر الأصلي

تدفق النيابة عن (OBO) مفيد بشكل خاص لبنى الخدمة-إلى-خدمة حيث تستقبل خلفية رمز المستخدم وتستبدله برمز Work IQ.

التسعير: Copilot Credits

تُفوتَر Work IQ من خلال نموذج قائم على الاستهلاك باستخدام Copilot Credits — العملة الموحدة المستخدمة لـ Copilot Studio وخدمات Microsoft AI الأخرى. لا يوجد اشتراك لكل مستخدم أو SKU منفصل لـ Work IQ.

هذا يعني أن التكلفة تتوسع مباشرةً مع الاستخدام وليس مع عدد الموظفين، مما يُعدّ ميزة اقتصادية للوكلاء الذين يخدمون مستخدمين كثيرين عبر تكامل مشترك. أدر الأرصدة وراقب الاستهلاك عبر مركز إدارة Microsoft 365.

البدء

لبناء تكاملك الأول مع Work IQ:

سجّل تطبيق Entra — أنشئ تسجيل تطبيق في بوابة Azure وأضف إذن Work IQ المفوض
اختر بروتوكولك — A2A لتفويض الوكيل، MCP لتكاملات أدوات الذكاء الاصطناعي، REST لتطبيقات الويب
احصل على رمز — استخدم MSAL أو نظام Microsoft Identity للحصول على رمز مفوض
نفّذ أول استدعاء — أرسل SendMessage (A2A) أو استعلاماً تحادثياً (REST) إلى نقطة نهاية Work IQ
هيّئ الفوترة — فعّل فوترة Copilot Credits في مركز إدارة M365 للانتقال من المعاينة إلى الإنتاج

يتضمن مستودع العينات الرسمي على github.com/microsoft/work-iq-samples أمثلة شاملة للبروتوكولات الثلاثة.

ما الذي يعنيه هذا لتطوير الذكاء الاصطناعي المؤسسي

تمثل Work IQ تحولاً في كيفية بناء الذكاء الاصطناعي المؤسسي. بدلاً من معاملة Microsoft 365 كمصدر بيانات للاستخراج والفهرسة، تضعه Work IQ كطبقة ذكاء حية يستعلم عنها الوكلاء في الوقت الفعلي مع الحفاظ الكامل على الحوكمة.

للمطورين، هذا يعني بنية تحتية أقل للبناء والصيانة. للمؤسسات، يعني وكلاء ذكاء اصطناعي يحترمون نفس الأذونات وضوابط الامتثال لكل حمل عمل Microsoft 365.

مزيج A2A وMCP وREST في سطح API واحد يجعل Work IQ قابلة للتركيب بشكل غير عادي. يمكنك ربطها بنظام متعدد الوكلاء الحالي عبر A2A، وكشفها لبيئة تطوير المطور عبر MCP، وتقديمها في تطبيق ويب عبر REST — كل ذلك من نفس طبقة الذكاء الأساسية.

الخلاصة

تُزيل واجهة برمجة Work IQ أصعب جزء في بناء وكلاء الذكاء الاصطناعي المؤسسية: الحصول على وصول موثوق ومُحكوم إلى البيانات التنظيمية. مع التوفر العام في يونيو 2026 وخيار بروتوكول واضح بين A2A وMCP وREST، أصبح من العملي بناء وكلاء يستدلون على البريد الإلكتروني والتقويم والملفات وTeams دون إدارة خط أنابيب بيانات مخصص.

ابدأ بـ التوثيق الرسمي في Microsoft Learn ومستودع work-iq-samples لاستكشاف أمثلة الكود العاملة لكل بروتوكول.