بيئة التشغيل التي تُنفّذ جميع عمليات الذكاء الاصطناعي.
يمنحك النموذج اللغة. لا يستطيع وحده أن يثبّت نفسه بثبات في بياناتك الحقيقية، أو يختار الأداة الصحيحة ويستدعيها بشكل صحيح، أو يتعافى حين تفشل الدعوة، أو يُتم مهمة متعددة الخطوات، أو يترك مسارًا يمكنك إعادة تشغيله. SocialHub.AI Harness هو وقت تشغيل وكيل المؤسسة الذي يفعل كل ذلك — محرك التنفيذ الذي يحوّل نموذجًا قادرًا إلى وكيل يُعتمد عليه.
كل عنصر ذكاء اصطناعي في SocialHub.AI - مديرو التسويق والولاء والمخاطر، وموظف خدمة العملاء، وكل مولد يعمل خلف الكواليس - هو تعريف الوكيل: مخطط هيكلي (توجيه النموذج، ومصادر السياق، والمهارات، والأدوات، لكل منها نطاق، وسطح MCP، وسير العمل، والذاكرة، وسياسة التكرار) يُنفذه هذا وقت التشغيل. ولأن كل عنصر يعمل من خلال وقت تشغيل واحد، فإن الحوكمة ليست منتجًا منفصلاً، بل هي خاصية هيكلية للتنفيذ الموحد: النموذج يعطي اللغة؛ ووقت التشغيل يعطي الفعل؛ ووقت التشغيل الموحد يُبقي خمسة ضوابط أمان على كل مسار إجراء — تحدد السقوف ويمكنك إيقاف الكتابة مؤقتًا، لكن لا يمكنك إيقاف ضوابط الأمان هذه. تسجيل التدقيق بأفضل جهد وقد يترك فجوات.
هذا المرجع هو نظرة المطوّر إلى وقت التشغيل ذاك: ماذا يفعل عند التنفيذ، ونوع Definition الذي ينفّذه ومحاوره، وكيف تتركّب المهارات في خطوات منفَّذة، والمسار القابل لإعادة الإنتاج الذي يكتبه كل تشغيل في سجل الأحداث، والحواجز التي تظهر حين يعمل كل شيء في مكان واحد. لنظرة العمل انظر صفحة منتج SocialHub.AI 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كيفية الاختيار - بما في ذلك متى تُؤجل أو تُصعّد - مُقدمة كإرشادات، وليست خيارًا مُحددًا مُسبقًا.
أثناء التشغيل، يقوم وقت التشغيل ، وبالتالي فإن ما يتم تنفيذه ليس "ما توصل إليه النموذج"، بل إجراء مُسمى ومُرقم الإصدار يمكن لفريقك قراءته والموافقة عليه. ولأن المهارات تعتمد على قاعدة البيانات، يمكن دمج المهارة نفسها على أكثر من وكيل، وتغييرها يؤثر على جميع الوكلاء الذين يستخدمونها، دون الحاجة إلى إعادة نشر.
مخرجات وقت التشغيل: مسار قابل للتكرار
إنتاج مسار قابل للتكرار هو الخطوة الخامسة من مهام وقت التشغيل، وهو أيضاً دليل التدقيق الخاص بك. بغض النظر عن الفاعل وكيفية تشغيله، فإن كل تشغيل يُصدر سلسلة من الأحداث في مسار واحد. سجل الأحداث للإضافة فقطيتم ختم كل حدث بـ معرف التشغيل و نسخة المخطط الدقيق (التعريف) الذي أنتجها - لذا فإن عملية التشغيل قابلة للتدقيق والإعادة. أنواع الأحداث المرتبة التي تصدرها عملية التشغيل:
إلى جانب ذلك، يسجل السجل استدعاءات الأدوات المُطابقة 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. - آليات التفويض والموافقات. تم توثيق آلية كل إجراء (تلقائي/مراجعة/ممنوع)، ودلالات الكتابة المعلقة/المرفوضة، ودورة حياة الموافقة التي تُضاف إلى نظام حماية التفويض في حوكمة الذكاء الاصطناعي: الاستبطان والموافقات. حوكمة الذكاء الاصطناعي: الاستبطان والموافقات