مرجع هندسي · Socialhub Harness

بيئة التشغيل التي تُنفّذ جميع عمليات الذكاء الاصطناعي.

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

كل عنصر ذكاء اصطناعي في Flash - مديرو التسويق والولاء والمخاطر، وموظف خدمة العملاء، وكل مولد يعمل خلف الكواليس - هو تعريف الوكيل: مخطط هيكلي (توجيه النموذج، ومصادر السياق، والمهارات، والأدوات، لكل منها نطاق، وسطح MCP، وسير العمل، والذاكرة، وسياسة التكرار) يُنفذه هذا وقت التشغيل. ولأن كل عنصر يعمل من خلال وقت تشغيل واحد، فإن الحوكمة ليست منتجًا منفصلاً، بل هي خاصية هيكلية للتنفيذ الموحد: يُعطي النموذج اللغة؛ ويُعطي وقت التشغيل الإجراء؛ توفر بيئة التشغيل الموحدة إدارةً مجانية.

هذا المرجع هو عرض المطور لوقت التشغيل هذا - ما يفعله أثناء التنفيذ، ونوع التعريف الذي ينفذه ومحاوره، وكيفية تجميع المهارات في خطوات منفذة، والمسار القابل للتكرار الذي يصدره كل تشغيل في سجل الأحداث، والضمانات الناتجة عن تشغيل كل شيء في مكان واحد. للاطلاع على نظرة عامة على العمل، راجع صفحة المنتج Socialhub Harness.

ما يفعله وقت التشغيل أثناء التنفيذ

ابدأ من هنا، لأن هذه هي فكرة النظام بأكمله. عند بدء التشغيل، يقوم وقت التشغيل Harness بالعمل الذي لا يستطيع نموذج اللغة القيام به بنفسه - الأمور الخمسة التالية، بالترتيب - والنتيجة هي مهمة مكتملة و مسار يمكنك إعادة تشغيله.

1 · Context assembly

يُحدد وقت التشغيل آلية عمل النظام: حيث يقوم بتجميع الموجز وحقائق العمل الفعلية - المهمة، وتجميعات الأعضاء/الشرائح، ومجموعة العلامة التجارية، والمقاييس - لكل عملية تشغيل، مع تقليل المعلومات الشخصية الحساسة. لا يقوم النموذج بتخمين بياناتك أبدًا؛ بل يتم تزويده بها.

2 · Model routing

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

3 · Skill composition into steps

يقوم وقت التشغيل بإدخال خطوات المهارات المُركبة المُرتبة وتوجيهات اتخاذ القرار في نافذة الأوامر، بحيث يتم تنفيذ إجراء مُسمى ومُرقم الإصدار - وليس أي إجراء ارتجالي.

4 · The tool loop

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

5 · A reproducible trajectory

يتم تسجيل كل خطوة، بالتسلسل، في سجل الأحداث (للإضافة فقط) - مع ختم بمعرف التشغيل وإصدار المخطط الدقيق - ما يجعل التشغيل قابلاً للتدقيق والإعادة خطوة بخطوة.

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

تشريح تعريف الوكيل - ما ينفذه وقت التشغيل

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

جزء من المخطط	ما يتكون منه
توجيه النموذج	محرك الاستدلال الذي يُنفذ كل خطوة — والخيارات البديلة. يُسمي النموذج؛ ويقوم وقت التشغيل بحلّه.
مصادر السياق	يتم تجميع المعلومات الأساسية وبيانات العمل التي يبدأ منها المستخدم - المهمة، وبيانات الأعضاء/الشرائح، ومجموعة العلامة التجارية، والمقاييس - لكل عملية تشغيل، مع تقليل المعلومات الشخصية الحساسة.
مهارات	كتيبات الإجراءات المنظمة المُدمجة في العنصر الفاعل (انظر أدناه). إجراءات مُسماة، وليست توجيهات حرة.
أدوات	الإجراءات المحددة التي يمكن للفاعل اتخاذها - لكل منها نطاق محدد. التعريف يحدد أداة، ولكنه لا يمنحها. قاعدة البيانات هي المرجع. الإجراءات التي يمكن للفاعل اتخاذها - لكل منها نطاق محدد.
MCP الظهور	ما هي الأدوات المتاحة عبر بروتوكول سياق النموذج لوكيل خارجي يمتلك مفتاحًا محدد النطاق، وما هي آليات عملها؟
سير العمل	الخطوات المرتبة أو الرسم البياني الذي يُحرك وقت التشغيل - المطالبة، القراءة، اتخاذ القرار، التنفيذ، الإكمال - لقوائم العمل والجهات الفاعلة المُنسقة.
ذاكرة	ما قد يحمله الممثل عبر الخطوات والجري، وما يجب عليه إعادة قراءته من جديد في كل مرة. مُقيد، وليس مجرد مسودة للمعلومات الشخصية الحساسة.
سياسة التكرار.	قاعدة التوقف: الحد الأقصى للخطوات، وسقف الميزانية، وشرط التصعيد إلى التدخل البشري. يفرضها وقت التشغيل؛ ولا يمكن للمنفذ تجاوزها. قاعدة التوقف: الحد الأقصى للخطوات، وسقف الميزانية، وشرط التصعيد إلى التدخل البشري.

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

نوع تعريف واحد، موصوف عبر ثلاثة محاور.

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

Axis	القيم	ما الذي يغطيه
runtimeForm	`mcp_external · server_orchestrator · inline_function`	كيفية تنفيذ التعريف. mcp_external = وكيل خارجي يحمل مفتاحًا محدد النطاق، ويتم استدعاؤه عبر MCP. server_orchestrator = حلقة داخلية Flash يديرها وقت التشغيل خطوة بخطوة. inline_function = مولد أحادي اللقطة يتم استدعاؤه في تدفق الشاشة.
agentType	`employee · chatbot · function`	ماذا يعني ذلك للشركة؟ الموظف = عامل محدد تديره (أهداف، مهام، ملاحظات). روبوت الدردشة = واجهة محادثة مبنية على بيانات حقيقية. الوظيفة = مولد أو مصنف ذو غرض واحد بدون شخصية.
نوع تقني	`agent · generator · embedded · custom · workflow`	التصنيف الهندسي للمخطط: وكيل متعدد الخطوات مُركّب، أو مُولّد مُدمج، أو قدرة مُضمّنة، أو تعريف مُخصّص لمساحة العمل، أو رسم بياني لسير العمل متعدد الخطوات.
مجال الأعمال	أحد المجالات الثمانية (يمين)	أي جزء من العمل يخدمه: التسويق والحملات، الولاء والاحتفاظ بالعملاء، إدارة المخاطر والامتثال، خدمة الأعضاء، المحتوى والإبداع، ذكاء العملاء، التحليلات والرؤى، البحث والمحاكاة.

أكثر من 40 جهة فاعلة مُدارة، نموذج واحد. تتكون قائمة الموظفين المباشرين من: 5 وكلاء مُركبين (متعدد الخطوات، مُنسق بواسطة الخادم: المدراء الأربعة بالإضافة إلى مُنسق الأعضاء)، 28 وظيفة مُضمنة (مولدات ومُصنفات أحادية اللقطة مُدمجة في المنتج)، و8 إمكانيات مُدمجة (مُساعدات مُدمجة على الشاشة). جميعها من نفس نوع التعريف، وتختلف فقط على المحاور المذكورة أعلاه.

المهارات: أدلة إرشادية موثوقة في قواعد البيانات مُصممة خصيصًا للوكيل.

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

trigger

الشرط الذي تُطبّق بموجبه هذه المهارة على التشغيل الحالي.

required state

حالة العضو/العمل التجاري التي يجب أن تكون موجودة لكي تعمل المهارة بشكل مسؤول - في حال عدم وجودها، تفشل المهارة. حالة العضو/العمل التجاري التي يجب أن تكون موجودة لكي تعمل المهارة بشكل صحيح - في حال عدم وجودها، تفشل المهارة.

tool allowlist

مجموعة الأدوات التي يُمكن للوكيل استخدامها في هذه المهارة - وهي تضييق، وليس توسيعاً، لما تسمح به الخطة المُسبقة.

ordered steps

الإجراء الذي يتبعه وقت التشغيل، بالتسلسل.

verifier rules

الفحوصات التي يجب اجتيازها على النتيجة قبل اعتبار الخطوة مُنجزة.

decision guidance

كيفية الاختيار - بما في ذلك متى تُؤجل أو تُصعّد - مُقدمة كإرشادات، وليست خيارًا مُحددًا مُسبقًا.

أثناء التشغيل، يقوم وقت التشغيل ، وبالتالي فإن ما يتم تنفيذه ليس "ما توصل إليه النموذج"، بل إجراء مُسمى ومُرقم الإصدار يمكن لفريقك قراءته والموافقة عليه. ولأن المهارات تعتمد على قاعدة البيانات، يمكن دمج المهارة نفسها على أكثر من وكيل، وتغييرها يؤثر على جميع الوكلاء الذين يستخدمونها، دون الحاجة إلى إعادة نشر.

مخرجات وقت التشغيل: مسار قابل للتكرار

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

01بدأ التشغيل02نية المستخدم03تم تحميل السياق04تم اختيار النموذج05تم تجميع المكونات06التفسير07التحقق من الأذونات08أداة تسمى09نتيجة الأداة10الإجراء / النتيجة11التكلفة12انتهى التشغيل

إلى جانب ذلك، يسجل السجل استدعاءات الأدوات المُطابقة MCP (عندما يُفعّل المستخدم Flash فوق MCP) والنتيجة النهائية - وبذلك، يكون مسار العملية، من النية إلى النتيجة، مُسجلًا في مكان واحد.

// one run's trajectory (abbreviated — every event carries runId + definitionVersion)
{
  "runId": "run_a1f9…",
  "definition": "loyalty-manager",
  "definitionVersion": 4,
  "events": [
    { "type": "run_started",     "at": "2026-08-26T09:14:02Z" },
    { "type": "user_intent",     "intent": "work the win-back worklist" },
    { "type": "context_loaded",  "sources": ["task", "member_rollup", "churn_signal"] },
    { "type": "model_selected",  "model": "…" },
    { "type": "prompt_assembled","skill": "winback-worklist-execution" },
    { "type": "reasoning",       "summary": "high value, at-risk, consented" },
    { "type": "permission_check","tool": "issue_coupon", "result": "allowed" },
    { "type": "tool_called",     "tool": "issue_coupon", "args": { "value": 10 } },
    { "type": "tool_result",     "ok": true },
    { "type": "cost",            "tokens": 3120, "usd": 0.04 },
    { "type": "run_ended",       "outcome": "coupon issued · within budget" }
  ]
}

اقرأ مسار كل عملية شراء من خلال تطبيق Flash. يمكنك استعراض عملية شراء واحدة باستخدام المعرّف، أو عرض قائمة بعمليات الشراء الأخيرة:

# one run's full trajectory
GET https://flash.socialhub.ai/api/flash/agent-runs/{runId}

# list recent runs
GET https://flash.socialhub.ai/api/flash/agent-runs

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

إدارة مجانية: خمسة أنظمة حماية تعمل عند الفشل

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

الحارس	ما تُطبّقه
نطاق التفويض × مستوى الخطة	يتم التحقق من كل استدعاء أداة مقابل نطاق المفتاح ومستوى خطة مساحة العمل. يُحدد التعريف أداةً؛ وتُخزَّن صلاحية تشغيلها في قاعدة البيانات، ويتم تحديدها عند الاستدعاء. أما الأداة التي لا يمكن للمفتاح الوصول إليها، فتُخفى ببساطة.
حدود قيمة الكتابة + المعدل	تُحدَّد عمليات الكتابة التي تُغيِّر القيمة (النقاط، القسائم) بحد أقصى لقيمة كل استدعاء وحد أقصى لمعدل الكتابة لكل مفتاح، وكلاهما يُطبَّق تلقائيًا على الخادم - بغض النظر عن أي شيء يُشير إليه مُوجِّه المستخدم أو تأكيد العميل.
سجل الميزانية	يتم تنفيذ كل عملية ضمن ميزانية رمزية + تكلفة، يتم شحنها مسبقًا قبل قيام المستخدم بالإجراء ويتم خصمها أثناء التنفيذ. عند نفاد الرصيد، يتوقف التنفيذ - لا يمكن لأي طرف التلاعب بالموارد.
مفتاح الإيقاف التلقائي	يُمكن إيقاف أي عنصر - سواء كان تعريفًا كاملاً أو إجراءً واحدًا - مؤقتًا على الفور. مُعطّل افتراضيًا، ومحدود عند التشغيل، وقابل للإيقاف في أي لحظة. يُمكن إيقاف أي عنصر - سواء كان تعريفًا كاملاً أو إجراءً واحدًا - فورًا.
التدقيق	تُسجَّل كل خطوة في سجل الأحداث (المُلحق فقط) مع مُعرِّف التشغيل وإصدار المخطط الدقيق. لا يُفوَّت أي إجراء يقوم به المُنفِّذ، ولا يُمكن لأي إعداد إخفاء إدخال في السجل.

اضبط التكوين في /flash/agents.. وحدة تحكم موظفي الذكاء الاصطناعي هي المكان الذي يمكنك فيه تعديل مهارات المستخدم، وأدواته، ونموذجه، وسياقه، مما ينتج عنه مخطط جديد مُرقّم. ما لا يمكنك تعديله هناك هو الحد الأدنى للأمان: فالحواجز الخمسة المذكورة أعلاه مُطبقة في الكود، وليس في التكوين.

موقع Harness ضمن المنصة

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

MCP surface. يمتلك الممثل mcp_external مفتاحًا محدد النطاق ويستدعي الأدوات المُدارة بواسطة Flash عبر بروتوكول سياق النموذج. توجد نقطة النهاية والمصادقة وتكوين العميل وقائمة الأدوات الكاملة في دليل التكامل MCP.
آليات التفويض والموافقات. تم توثيق آلية كل إجراء (تلقائي/مراجعة/ممنوع)، ودلالات الكتابة المعلقة/المرفوضة، ودورة حياة الموافقة التي تُضاف إلى نظام حماية التفويض في حوكمة الذكاء الاصطناعي: الاستبطان والموافقات. حوكمة الذكاء الاصطناعي: الاستبطان والموافقات

Socialhub Harness نظرة عامة MCP دليل التكامل حوكمة الذكاء الاصطناعي: التقييم الذاتي والموافقات العودة إلى مركز المطورين

افتح وحدة تحكم موظفي الذكاء الاصطناعي