أحد منتجاتنا · مذكرة هندسية

AgentMug: عمّال ذكاء اصطناعي قابلون للنقل

AgentMug منتج من مختبرات دهشان لتعريف عمّال ذكاء اصطناعي قابلين للنقل وتشغيلهم. طوّره استوديونا في الرياض لفصل تعليمات العامل القابلة لإعادة الاستخدام عن حسابات المالك ومصادره الخاصة. تشرح هذه المذكرة الهندسية من فريق المنتج مسار عمل معرفيًّا موثقًا، مع شيفرة وأمثلة عامة يمكن فحصها.

بقلم مختبرات دهشان ·

فصل تعريف العامل عن الحسابات والملفات الخاصة

يتيح لك AgentMug إنشاء عُمّال ذكاء اصطناعي يمكن نقلهم، وربطهم بأنظمة حقيقية ومعرفة موثوقة، وتشغيلهم أينما يحتاجهم العمل، مع سجل واضح لكل تشغيل.

يحتاج العامل القابل لإعادة الاستخدام إلى وصف مهمته، والأدوات المسموح له باستخدامها، والأدلة التي يتطلبها. وينبغي ألا يوزّع مستندات منشئه الخاصة أو بيانات الدخول إلى حساباته. يحفظ AgentMug التعريف القابل للنقل في ملف ‎.agent يمكن تتبّع إصداراته. ويربط كل مالك جديد حساباته ومصادره الخاصة.

يفصل محرك التشغيل العام الوصول إلى النماذج والتخزين وقراءة المصادر والتتبّع عبر موائمات مستقلة. بذلك يصبح الحد الفاصل بين تعريف العامل وبيئة تنفيذه واضحًا. ومع ذلك، يتطلب نقل العامل التحقق من الأدوات وموائمات المصادر التي توفرها البيئة المستقبلة.

اطّلع على نواة AgentMug

مسار عمل عملي: الإجابة من سياسة تشغيلية

تعرض وثائق المحرك عاملًا يتطلب مستند سياسة تشغيلية ويجيب عن سؤال حول قاعدة اعتماد استرداد المبالغ. يطلب التعريف القابل للنقل صلاحية القراءة والاستشهاد، بينما تربط بيئة التشغيل ملف السياسة الفعلي بصورة خاصة. ولا يتضمن العامل المشارك ذلك الملف أو مكانه.

قبل أول طلب إلى النموذج، يتحقق المحرك من عمليات الربط المطلوبة والصلاحيات والموائمات ومتطلبات حداثة المصادر. يتوقف التشغيل عند غياب دليل مطلوب. تحمل المقاطع المسترجعة مراجع المصدر والإصدار، وينتج التشغيل سجلًا يمكن مراجعته. هذا مثال تنفيذ موثّق، وليس مشروعًا معلنًا لعميل سعودي.

اقرأ مثال متطلبات المصادر

ربط العامل بمسار عمل قائم

يتيح جسر MCP استدعاء عامل AgentMug مستضاف بوصفه أداة. يستطيع العميل المتوافق فحص حالة جاهزية المصادر واستلام سجل تشغيل منظّم. يظل التنفيذ على نقطة اتصال AgentMug المحددة؛ ولا ينقل الجسر العامل المستضاف إلى جهاز العميل.

يتضمن مصدر عقدة n8n المجتمعية مثالًا قابلًا للاستيراد: يرسل مشغّل يدوي رسالة إلى عامل محدد ويستقبل النتيجة. ويمكنه إرجاع المخرجات وحدها أو استجابة أشمل. نقطة الاتصال الافتراضية مستضافة، وتُحتسب تكلفة استدلال النموذج على مشغّل نقطة الاتصال.

وثائق جسر MCP

تكامل n8n والمثال التطبيقي

إتاحة مراجعة التنفيذ

تسجّل سجلات التشغيل المصادر المقروءة وإصداراتها ومراجع الأدلة والحالة النهائية ونتائج الفحوص المدعومة. تشمل الفحوص القابلة للنقل جاهزية المصادر وحداثتها والاستشهادات وحدود الكتابة والمخرجات المنظّمة ضمن النطاق المدعوم. أما الشروط التي لا يستطيع المحرك تقييمها، فتُسجّل بوصفها متجاوزة، ولا تُعد ناجحة ضمنًا.

يرسل موائم OpenTelemetry منفصل بيانات تتبّع لاستدعاءات النماذج والتفريغ الصوتي إلى نظام يضبطه المشغّل. تتضمن الحقول الموثقة استهلاك الرموز وزمن الاستجابة ومعاينات المدخلات والمخرجات. تتطلب هذه المعاينات سياسة مناسبة للتعامل مع البيانات؛ فكون الموائم مفتوح المصدر لا يجعل التتبّع خاصًّا تلقائيًّا.

فحوص محرك التشغيل

موائم OpenTelemetry

تطبيق هذا النمط في مشروعك

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

النواة العامة في مرحلة ما قبل الإصدار 1.0، وتتضمن الخدمة المستضافة مكونات مملوكة. في المشروع المخصص، حدّد المصادر المدعومة والإجراءات المسموحة ومكان النشر ومعايير القبول، ثم تحقّق من مسار العمل الكامل في البيئة المقصودة.

حدود النواة العامة والخدمة المستضافة

مشروعك القادم