طبقة الاسترجاع للذكاء الاصطناعي
عبر حدود كل نظام
ما رآه الذكاء الاصطناعي في أي قرار يصل عبر طبقة الموصلات. Microsoft Graph، وSharePoint، وخادم MCP، والخدمة المرافقة للجداول الزمنية، والبريد الوارد، وخطافات الويب الصادرة، ومدير تكاملات OAuth. معزولة لكل مؤسسة، وكل استدعاء من الذكاء الاصطناعي لأداة يُسجَّل بمدخلاته ونتيجته والشخص الذي وراءه.
طبقة الاسترجاع خلف قرارات الذكاء الاصطناعي
نموذج القرار ذو المناطق الثلاث في Onplana (راجع المقال الكامل (بالإنجليزية)) يطبّق في منطقة الفعل ويقترح في منطقة الاقتراح. وفي كل قرار، يستدل الذكاء الاصطناعي على سياق، ومعظم ذلك السياق ليس في قاعدة بيانات Onplana. والموصلات هي الطريق الذي يصل منه.
كل استدعاء من الذكاء الاصطناعي لأداة، من مساعد التطبيق أو من وكيل متصل، يُسجَّل بالأداة ومدخلاتها ونتيجتها والشخص والوقت. ويقرأ مالكو المؤسسة ومسؤولوها هذه السجلات بدءًا من خطة Enterprise في صفحة Audit Logs، ضمن Agent Activity. ولا تُحفظ المطالبة الكاملة ولا السياق الذي استرجعه النموذج، فالسجل يُظهر ما فعله الذكاء الاصطناعي، لا كل ما قرأه.
تتبع الموصلات كلها النهج نفسه: OAuth حيث يتطلبه النظام المصدر (Microsoft Graph، وSharePoint، وسحابات الملفات الخارجية)، وPAT للعملاء البرمجيين (MCP، وREST API، وخطافات الويب)، والعزل لكل مؤسسة منذ الإنشاء، فلا يستطيع رمز المؤسسة A القراءة من المؤسسة B ولا الكتابة فيها، وكل استدعاء من الذكاء الاصطناعي لأداة عبرها يُسجَّل.
سبعة موصلات متاحة اليوم
الاتجاه، والمصادقة، والخطة، وما يفعله كل منها. وتنمو قائمة التكاملات حسب طلب العملاء؛ والمزوّدون الأكثر تداخلًا يأتون أولًا.
خادم MCP
كتالوج أدوات Onplana معروضًا عبر Model Context Protocol. يستطيع Claude Desktop وCursor وGoose وContinue وأي عميل آخر متوافق مع MCP الاتصال واستخدام 351 من الأدوات محددة الأنواع (قراءة المشاريع، وإنشاء المهام، وتسجيل الساعات، والاطلاع على المخاطر، وإجراء مراجعات الحوكمة). بالقيود نفسها والسجل نفسه في محادثة التطبيق.
المصادقة: OAuth 2.1 مع Dynamic Client Registration (RFC 7591) أو Personal Access Token
Microsoft Graph (M365)
OAuth لكل مستخدم إلى Microsoft Graph للبريد (Mail.ReadWrite)، والتقويم (Calendars.ReadWrite)، والنشر في قنوات Teams (ChannelMessage.Send)، والملفات (Files.ReadWrite)، والأشخاص (User.Read). تستخدمه ميزات الذكاء الاصطناعي لتلخيص محادثة، وجدولة اجتماع مع أصحاب المصلحة، ونشر تحديثات الحالة في قنوات Teams، وإرفاق مستندات SharePoint بالمهام.
المصادقة: OAuth لكل مستخدم، وتتجدد الرموز عبر lib/oauthTokens.ts، وinvalid_grant يضبط revokedAt
مواقع SharePoint + مكتبات المستندات
يتصفح مواقع SharePoint التي يملك الشخص حق الوصول إليها، ويرفق مستندات SharePoint بالمهام أو المشاريع دون نسخها إلى Onplana. وضع مرتبط (يبقى الملف في SharePoint ويحتفظ Onplana بالرابط). ويعرض التكامل أيضًا البيانات الوصفية للمستند في مساحة عمل المشروع.
المصادقة: يرث نطاق OAuth الخاص بالمستخدم في Microsoft Graph
خطاف ويب للبريد الوارد (صندوق بريد المشروع)
لكل مشروع عنوان بريد وارد. أعد توجيه رسالة إليه فتصبح مهمة جديدة، بالموضوع عنوانًا والمتن وصفًا. والرد على رسالة مهمة يصل تعليقًا على تلك المهمة، وكلمة حالة في السطر الأول يمكن أن تنقل المهمة. ولا تُحفظ المرفقات. وطلبات أصحاب المصلحة لا تبقى في صناديق البريد بانتظار من يفرزها يدويًا.
المصادقة: خطاف ويب عام على /api/inbound-email، مرتبط بالمشروع عبر العنوان الوارد
الخدمة المرافقة للجداول الزمنية (استيراد .mpp / .xml / .xer)
ارفع ملف Microsoft Project (.mpp، و.mpx، و.xml بصيغة MSPDI، و.xer من Primavera) فتحوّله الخدمة المرافقة المبنية على MPXJ إلى شجرة مهام Onplana: المهام، والتبعيات (FS/SS/FF/SF + التأخير)، وExtendedAttributes حقولًا مخصصة، وخط الأساس + التكلفة المخططة (من MSPDI). ثم يُشغَّل رصد المخاطر بالذكاء الاصطناعي على الجدول الزمني المستورد.
المصادقة: الرفع داخل التطبيق (multer، بحد 50 MB) أو النسخة العامة المجانية على /tools/schedule-health-check
خطافات الويب الصادرة
أحداث المشاريع، والمهام، والتعليقات، والأعضاء، وعمليات الانتقال (project.created، وtask.status_changed، وcomment.created، وmigration.completed وغيرها). حمولات موقّعة بـ HMAC-SHA256، وإعادة محاولة بانتظار متزايد، وسجل تسليم لكل نقطة نهاية. اربط Onplana بـ Zapier أو n8n أو مسار ETL لديك أو دليل الاستجابة للحوادث.
المصادقة: سر لكل خطاف ويب، وترويسة الحمولة الموقّعة (X-Webhook-Signature)
مدير تكاملات OAuth
واجهة إدارة المؤسسة لربط الخدمات الخارجية (Google Drive، وMicrosoft 365 مع OneDrive وSharePoint، وBox، وDropbox). وتمر دورة حياة الرموز عبر lib/oauthTokens.ts: التجديد عند انتهائها، والإلغاء عند قطع الاتصال، ووسمها بأنها غير صالحة عند invalid_grant. وقطع الاتصال خفيف (يبقى الصف وتُفرَّغ رموزه)، لا حذف نهائي.
المصادقة: صلاحية المؤسسة (org.integration.manage، ADMIN أو أعلى افتراضيًا)
Microsoft Planner: احتفظ بـ Planner وأضف المحفظة
Business+تواصل الفرق العمل في Planner. اربط خططها بمحفظة في Onplana بخطوة واحدة، فتصبح كل خطة مشروعًا يبقيه اشتراك في Microsoft Graph محدّثًا: التعديل في Planner يجعل Onplana يعيد قراءة الخطة ويعيد حساب تقدم المشروع وتواريخه.
- حالة لكل خطة، انطلاقًا من تواريخ Planner ونسبة الإنجاز فيه. والخطة التي لا تواريخ لها تظهر غير مقيَّمة.
- تبعيات بين مهام خطط مختلفة، تُختار من المحفظة وتُرسم على خطها الزمني.
- المعالم المتأخرة، والتبعيات المعرضة للخطر، والمشكلات والمخاطر المفتوحة من كل الخطط، وكل صف مرتبط بعنصره.
- في التكاملات تظهر الخطط المرتبطة مع آخر مزامنة، و«مزامنة الآن»، و«إلغاء الربط». Planner هو مالك حقول المهام؛ وOnplana لا يكتب عائدًا إلى Planner.
المصادقة: اتصال Microsoft الخاص بمن يربط، بصلاحيتي Tasks وGroups؛ وكل إشعار تغيير يُتحقق منه بسر محفوظ لكل اشتراك.
احتفظ بـ Planner. وأضف المحفظة.المصادقة + الأمان
ثلاثة عناصر تبقى ثابتة في الموصلات كلها.
بيانات اعتماد في Key Vault
أسرار عميل Onplana لدى الأطراف الخارجية (Microsoft، وGoogle، وhCaptcha، وStripe، وغيرها) موجودة في Azure Key Vault ويدوّرها فريق العمليات على حدة. ورموز OAuth لكل مستخدم محفوظة مشفرة في صفوف OauthConnection.
رموز معزولة لكل مؤسسة
كل PAT وكل رمز OAuth ينتمي إلى مؤسسة واحدة منذ الإنشاء. ولا تستطيع استدعاءات الموصلات تجاوز حدود المؤسسة لأن organizationId مربوط بصف الرمز ولا يُقرأ أبدًا من ترويسة الطلب.
سجل لكل استدعاء من الذكاء الاصطناعي
كل استدعاء من الذكاء الاصطناعي لأداة عبر موصل يكتب سجله: الأداة، ومدخلاتها، ونتيجتها، والشخص، والوقت. وتضيف خطافات الويب الصادرة صف WebhookDelivery بالمتن الكامل للطلب والرد + التوقيتات. ويمر البريد الوارد بالسجل العادي للمهام والتعليقات.
ما الذي لا تفعله الموصلات
القائمة الصادقة لهذه الطبقة.
إرسال البريد باسمك
بريد Outlook مسودات فقط: يكتب الذكاء الاصطناعي المسودة في صندوقك وأنت تراجعها وترسلها. والنشر في قناة Teams لا مسودة له، فلا تنشر الأداة دون تأكيد صريح، ولا يستطيع وكيل التطبيق النشر. وتنطلق خطافات الويب الصادرة مع الأحداث التي اشتركت فيها.
تجاوز حدود المؤسسة
رمز PAT أو OAuth أُنشئ في المؤسسة A لا يصل إلى بيانات المؤسسة B. ومن ينتمي إلى عدة مؤسسات يربط كلًا منها على حدة. والقيد مطبَّق على الخادم، على صف الرمز، لا على ترويسة الطلب.
الالتفاف على قيود الخطة
يتبع الوصول إلى الموصلات خطة المؤسسة: خادم MCP، والبريد الوارد، والبريد والتقويم وTeams عبر Microsoft Graph متاحة في جميع الخطط، بما فيها الخطة المجانية، وروابط ملفات SharePoint وOneDrive بدءًا من خطة Professional، وخطافات الويب الصادرة بدءًا من خطة Business. والقيد على الخادم؛ يستطيع عميل MCP المصادقة، لكن الاستدعاءات التي تتجاوز الخطة تعيد 402 مع مسار الانتقال إلى خطة أعلى.
تنفيذ عمل مستقل متعدد الخطوات عبر الأنظمة
تعرض الموصلات ميزات؛ وتستخدمها محادثة التطبيق والوكلاء الخارجيون استدعاءً واحدًا في كل مرة. أما تدفقات الوكلاء متعددة الخطوات التي تخطط وتنفذ عبر استدعاءات كثيرة فتنتمي إلى طبقة الوكلاء.
الأسئلة الشائعة
كيف تُحفظ بيانات اعتماد الموصلات؟
على مستويين. أسرار Onplana الخاصة (مفاتيح Anthropic API، ونقاط نهاية Azure OpenAI، وأسرار عملاء OAuth لدى الأطراف الخارجية، وبيانات اعتماد SMTP، وhCaptcha، وStripe، وغيرها) موجودة في Azure Key Vault ويدوّرها فريق العمليات على حدة. ورموز OAuth لكل مستخدم (رموز الوصول والتحديث في Microsoft Graph) في صفوف OauthConnection موسومة بالمؤسسة، مشفرة، وتُجدَّد تلقائيًا عند انتهائها. وقطع الاتصال إلغاء خفيف: يبقى الصف وتُفرَّغ رموزه.
هل يستطيع موصل تجاوز الحدود بين المستأجرين؟
لا. كل استدعاء لموصل مربوط بمؤسسة واحدة. تمر الاستدعاءات من التطبيق بوسيط withOrganization نفسه في REST API، فيحمل كل استعلام organizationId. وينتمي رمز PAT أو OAuth إلى مؤسسة منذ الإنشاء، فتأخذ استدعاءات الوكيل المتصل المؤسسة من الرمز، لا من ترويسة الطلب أبدًا. ومن ينتمي إلى عدة مؤسسات يربط كلًا منها على حدة.
ما الذي يحتويه سجل استدعاء الموصل؟
كل استدعاء من الذكاء الاصطناعي لأداة عبر موصل يُسجَّل بالأداة ومدخلاتها ونتيجتها والشخص والوقت، ويُقرأ في صفحة Audit Logs، ضمن Agent Activity. وتكتب خطافات الويب الصادرة أيضًا في WebhookDelivery، بالمتن الكامل للطلب والرد والتوقيتات. ويكتب البريد الوارد عبر السجل العادي للمهام والتعليقات. ويقرأ المراجع السجل دون اتصالات إضافية.
بماذا يختلف خادم MCP عن REST API؟
الميزات نفسها، وبروتوكول آخر. يتحدث خادم MCP بروتوكول Streamable HTTP (معيار النقل في MCP) ويجيب عن استدعاء MCP tools/list بكتالوج أدوات محددة الأنواع، فيكتشف عملاء الوكلاء المتوافقون مع MCP إجراءات Onplana بأنفسهم. ويتحدث REST API بـ HTTP+JSON وهو موثق في /api/openapi.json. استخدم MCP من جلسة Claude Desktop أو Cursor؛ واستخدم REST من نص برمجي في الخادم. وكلاهما يستدعي المعالجات نفسها، بالقيود نفسها والسجل نفسه.
هل أستطيع طلب موصل جديد ليُضمَّن في Onplana؟
قائمة الموصلات اليوم هي ما ورد أعلاه. مدير التكاملات + تجديد OAuth قابلان لإعادة الاستخدام؛ والاختناق هو إعداد OAuth لكل مزوّد + تعريفات الأدوات. ويتلقى فريق Onplana طلبات التكامل على hi@onplana.com؛ والمزوّدون الأكثر تداخلًا مع العملاء (مثل Atlassian وServiceNow وSalesforce) لهم الأولوية.
لماذا الخدمة المرافقة للجداول الزمنية بين الموصلات؟
لأنها تخرج من نموذج بيانات Onplana لتقرأ تنسيق ملف خارجيًا. الخدمة المرافقة MPXJ المكتوبة بلغة Java (تطبيق حاوية منفصل) تقرأ .mpp / .xml / .xer، وتعيد البنية المقروءة عبر HTTP، ويكتبها مسار الاستيراد في Onplana في شجرة المشروع. إنها موصل نحو عالم ملفات Microsoft Project، كما أن التكامل مع SharePoint موصل نحو عالم سحابات المستندات.
تابع في قسم الذكاء الاصطناعي
الموصلات واحدة من ثلاث طبقات. والطبقتان الأخريان تخصان ميزات الذكاء الاصطناعي في المنتج وعمل الوكلاء متعدد الخطوات.
أنت هنا: الموصلات
طبقة الاسترجاع للذكاء الاصطناعي عبر حدود كل نظام.
التعاون
أشخاص + وكلاء ذكاء اصطناعي في الفريق نفسه: أسند العمل إلى الذكاء الاصطناعي، وتعاون في تعليقات المهام، واعتمد المسودات.
اقرأ المزيدالذكاء الاصطناعي الأصيل
منطقة الفعل: يطبّق الذكاء الاصطناعي مباشرة. مسودة الخطة، واللغة الطبيعية، ومسودة الحالة، وأسئلة المحفظة، والتوصيات.
اقرأ المزيدالوكلاء
نموذج منطقة الاقتراح، الاقتراح ثم الاعتماد: تنبيهات المخاطر، وتغييرات الموارد، والجداول الزمنية المقترحة.
اقرأ المزيدشاهد الموصلات في مؤسستك
سجّل مجانًا، واربط Microsoft Graph أو ارفع ملف .mpp في دقيقتين، وشاهد ميزات الذكاء الاصطناعي تبدأ في جلب السياق من أدواتك.