وكلاء الذكاء الاصطناعي

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

استخدم الوكيل عندما يحتاج الطلب إلى عدة خطوات، مثل "ابحث عن طلب العميل، وتحقق من حالة التسليم، واعرض موعدًا جديدًا". أما للحصول على إجابة مباشرة من التعليمات وقاعدة المعرفة، فعقدة AI أبسط وأرخص.

اللبنات الأساسية

الجزء	ما هو	أين تضبطه
AI Harness	المحرّك الذي يشغّل حلقة الوكيل: المحرّك الخاص بـ MonoChat، أو SDK للوكلاء، أو خدمة وكلاء مستضافة.	الإعدادات › الأتمتة › AI Harness
النماذج	نماذج AI التي يفكر بها الوكيل: نموذج رئيسي، ونموذج بديل اختياري، ونموذج سريع اختياري. تستخدم الـ harness المستضافة نماذج مزوّدها الخاص بدلًا من ذلك.	عقدة وكيل AI
الأدوات	نطاقات AI ودوال أداة AI وأدوات MCP.	عقدة وكيل AI
ميزانية التنفيذ	حدود لاستدعاءات النموذج والأدوات والرموز والمدة وإعادة المحاولات لكل تشغيل.	عقدة وكيل AI
التشغيل	تنفيذ واحد للوكيل. يُسجَّل كل تشغيل في عمليات تشغيل وكيل الذكاء الاصطناعي.	تنشئه العقدة أو واجهة API

AI Harness

تعرض الإعدادات › الأتمتة › AI Harness الـ harness التي يمكن لوكلائك العمل عليها: التي يقدمها MonoChat لكل مساحات العمل، والتي تضيفها ببيانات اعتمادك الخاصة.

Harness	أين يعمل	النماذج التي يستخدمها	من يضيفه
MonoChat Native	داخل MonoChat	نماذج AI لديك	MonoChat
OpenAI Agents SDK	داخل MonoChat	نماذج AI لديك	MonoChat
Claude Agent SDK	على مشغّل الوكلاء الخاص بـ MonoChat	نماذج AI لديك	MonoChat
pi	على مشغّل الوكلاء الخاص بـ MonoChat	نماذج AI لديك	MonoChat
OpenAI Agents API	في سحابة OpenAI	النماذج المسموح بها في الـ harness	أنت، بمفتاح OpenAI API الخاص بك (وقد يوفّر MonoChat مفتاحًا أيضًا)
Claude Managed Agents	في سحابة Anthropic	النماذج المسموح بها في الـ harness	أنت، بمفتاح Anthropic API الخاص بك (وقد يوفّر MonoChat مفتاحًا أيضًا)
نقطة نهاية مخصصة	على خادمك الخاص	نماذج AI لديك (اختياري)	أنت، بنقطة النهاية والسر الخاصين بك

يقدّم MonoChat الـ harness التي تعمل على MonoChat؛ ويمكن لمساحة عملك إضافة الـ harness التي تقبل بيانات اعتمادها الخاصة فقط. يحتاج كل من Claude Agent SDK وpi إلى مشغّل الوكلاء الخاص بـ MonoChat: وحيث لا يكون مُعدًّا، يفشل التشغيل عليهما مع الرسالة "هذا الـ harness غير متاح على هذا الخادم."

أيًّا كان الـ harness، يبقى MonoChat متحكمًا: يمر كل استدعاء نموذج في harness تستخدم نماذج AI لديك عبر MonoChat (فتنطبق الفوترة والميزانية)، ويشغّل كل استدعاء أداة دوالك وأدوات MCP ونطاقات AI في مساحة عملك، وتُطبَّق الميزانية على كل harness.

إضافة harness

انتقل إلى الإعدادات › الأتمتة › AI Harness وانقر على + (إنشاء).
أدخل الاسم والوصف اختياريًا.
اختر Harness. يوضح كل خيار أين يعمل.
ضمن بيانات الاعتماد، أدخل ما يحتاجه الـ harness:
- OpenAI Agents API وClaude Managed Agents: مفتاح API.
- نقطة نهاية مخصصة: نقطة النهاية ومفتاح API.
لـ harness مستضاف، املأ النماذج المسموح بها: أدخل أسماء نماذج المزوّد (مثل معرّف نموذج OpenAI أو Anthropic). استخدم إضافة نموذج لإضافة ما يصل إلى 10 نماذج. يمكن للوكلاء على هذا الـ harness الاختيار من هذه القائمة فقط.
انقر على حفظ.

عند تعديل harness، لا يمكن تغيير نوع Harness، ويظهر في حقل المفتاح مفتاح API (اتركه فارغًا للإبقاء على المفتاح المحفوظ).

Claude Managed Agents

عند أول استخدام لـ harness من هذا النوع، ينشئ MonoChat وكيلًا واحدًا وبيئة واحدة في حساب Anthropic ذاك ويعيد استخدامهما بعد ذلك.

نقطة نهاية مخصصة

يرسل harness من نوع نقطة نهاية مخصصة عمليات التشغيل إلى خدمتك الخاصة، مثل وكيل مستضاف ذاتيًا. لكل تشغيل يرسل MonoChat طلب POST إلى <Endpoint>/runs مع Authorization: Bearer <API Key>. يحتوي الجسم على معرّف التشغيل والتعليمات والمدخلات ورسائل المحادثة والميزانية وأسماء النماذج المستعارة (agent-main وagent-fallback وagent-fast) وثلاثة عناوين URL مع رمز خاص بهذا التشغيل:

بوابة نماذج (عناوين أساسية متوافقة مع OpenAI …/v1 ومع Anthropic) تستدعي نماذج AI الخاصة بالعقدة وتطبّق الميزانية،
خادم MCP يوفّر أدوات التشغيل،
عنوان URL للأحداث تبلّغ فيه خدمتك بالنتيجة (completed مع result، أو failed مع error).

يتوقف رمز التشغيل عن العمل عند انتهاء التشغيل.

عقدة وكيل AI

أضف وكيلًا إلى تدفق بواسطة عقدة وكيل AI، ضمن العقد الهجينة في مصمّم التدفقات. راجع التدفقات لمعرفة كيفية إضافة العقد وربطها.

الحقول

القسم	الحقل	الوصف
	الاسم	اسم العقدة الظاهر على اللوحة.
	AI Harness	مطلوب. الـ harness الذي يشغّل الوكيل.
	التعليمات	تعليمات النظام للوكيل: دوره ونبرته وقواعده وما يُسمح له به أو لا يُسمح.
	المهمة (تُضاف إلى تعليمات الوكيل؛ يمكن استخدام الوسوم)	ما تطلب هذه العقدة من الوكيل فعله. تُضاف بعد التعليمات ويمكنها استخدام الوسوم نفسها المتاحة في موجّه عقدة AI، مثلًا لتضمين بيانات العميل.
النماذج	النموذج الرئيسي	النموذج الذي يستخدمه الوكيل. مطلوب لكل harness عدا نقطة النهاية المخصصة.
	النموذج البديل (بعد الحد المرن)	النموذج الذي يتحول إليه الوكيل عند بلوغ الحد المرن لاستدعاءات النموذج، وهو عادةً نموذج أرخص أو أسرع.
	النموذج السريع (مهام خلفية خفيفة)	نموذج يمكن للـ harness استخدامه لاستدعاءاتها الخلفية الخفيفة.
	النموذج (أحد النماذج المسموح بها في الـ harness)	يظهر بدلًا من الحقول الثلاثة أعلاه لـ harness مستضاف.
جلسة الوكيل	الجلسة	متابعة جلسة الوكيل الحالية (الافتراضي) أو بدء جلسة وكيل جديدة. راجع جلسات الوكيل.
	مفتاح المهمة (جلسة وكيل منفصلة لكل مهمة)	اختياري. يحتفظ بجلسة وكيل منفصلة لكل مفتاح في المحادثة نفسها، مثل `booking` و`support`.
	حد سجل الرسائل	عدد رسائل المحادثة التي يتلقاها الوكيل.
	نماذج AI لتحويل الكلام إلى نص	نموذج يدعم تفريغ نصي. تصل الرسائل الصوتية في المحادثة إلى الوكيل كنص.
إعدادات الأداة	نطاقات AI	قواعد المعرفة التي يمكن للوكيل البحث فيها. تُقدَّم للوكيل كأداة بحث في قاعدة المعرفة.
	أداة AI	الدوال من نوع أداة AI التي يمكن للوكيل استدعاؤها.
	تعيين أدوات محتوى عميل AI MCP	يفتح الدرج الذي تضيف فيه أدوات MCP. راجع عملاء MCP.
الرسائل	إرسال الرسائل الوسيطة إلى العميل	معطّل افتراضيًا. ما يكتبه الوكيل أثناء عمله (مثل "دعني أتحقق من طلبك") يُرسل إلى العميل عند التفعيل؛ وعند التعطيل يُضاف إلى الجلسة كرسالة همس لا يراها سوى فريقك.
	إرسال الإجابة	مفعّل افتراضيًا. يرسل الإجابة النهائية للوكيل إلى العميل. عطّله لاستخدام الإجابة داخل التدفق فقط.
ميزانية التنفيذ	الحد الأقصى لاستدعاءات النموذج	الافتراضي 4.
	الحد المرن: استدعاءات النموذج	اختياري. بعد هذا العدد من استدعاءات النموذج يتحول الوكيل إلى النموذج البديل. يجب أن يكون أقل من الحد الأقصى لاستدعاءات النموذج ويتطلب نموذجًا بديلًا.
	الحد الأقصى لاستدعاءات الأدوات	الافتراضي 6. مع القيمة `0`، ينتهي التشغيل بحالة تم تجاوز الميزانية بمجرد محاولة الوكيل استدعاء أداة.
	الحد الأقصى لإجمالي الرموز	الافتراضي 20000. رموز الإدخال والإخراج لجميع استدعاءات النموذج في التشغيل.
	المدة القصوى (بالثواني)	الافتراضي 30.
	الحد الأقصى لإعادة المحاولات	الافتراضي 2. عدد مرات إعادة محاولة استدعاء نموذج فاشل.

تلميح

اكتب القواعد الثابتة في التعليمات والمهمة المحددة لهذه الخطوة في المهمة. بهذه الطريقة يمكن لعدة عقد وكيل AI في تدفق واحد أن تشترك في التعليمات نفسها وتختلف في مهمتها فقط.

تحذير

لا تدعم الـ harness المستضافة الحد المرن لأنها لا تستطيع التحول إلى نموذج بديل. اترك الحد المرن: استدعاءات النموذج فارغًا لها.

ما يحدث عندما يصل التدفق إلى العقدة

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

تُعالَج عمليات تشغيل جلسة الوكيل نفسها واحدة تلو الأخرى بالترتيب.

المخرجات

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

اربط مكتمل وعند الفشل على الأقل. من الأنماط الشائعة توجيه تم تجاوز الميزانية وانتهت المهلة وعند الفشل إلى عقدة إسناد الجلسة ليتولى أحد الزملاء الأمر.

جلسات الوكيل

جلسة الوكيل هي ذاكرة الوكيل عبر عمليات التشغيل. يحتفظ MonoChat بجلسة وكيل نشطة واحدة لكل محادثة وharness ومفتاح مهمة.

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

الفوترة

تُحتسب استدعاءات النموذج على نماذج AI التي يوفرها MonoChat من رصيدك كالمعتاد. أما الاستدعاءات على نماذجك الخاصة فيحاسبك عليها مزوّدك.
يمكن لـ harness يوفرها MonoChat أن تضيف رسومها الخاصة لكل تشغيل ولكل دقيقة ولكل استدعاء أداة، ولـ harness مستضاف، الرموز التي يبلّغ عنها مزوّده. وتظهر في المعاملات باسم تشغيل وكيل AI ومدة وكيل AI واستدعاء أداة وكيل AI وفئات رموز AI.
لا توجد رسوم من MonoChat على harness تضيفها ببيانات اعتمادك الخاصة؛ يحاسبك مزوّدها.
لا يبدأ التشغيل عندما يكون رصيدك غير كافٍ.

حدث انتهاء تشغيل وكيل AI

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

تشغيل وكيل من الشيفرة

يمكن للدوال المخصصة وعملاء API تشغيل الوكلاء بهذه الطرق (الصلاحية بدء / عرض / إلغاء عمليات تشغيل وكلاء AI في الأتمتة):

الطريقة	ما تفعله
`business.tenants.automation.ai.aiAgentRuns.create`	تبدأ تشغيلًا. تعيد `aiAgentRunId` و`aiAgentSessionId`.
`business.tenants.automation.ai.aiAgentRuns.show`	تعيد تشغيلًا (`_id`) مع حالته واستهلاكه وخطواته ونتيجته.
`business.tenants.automation.ai.aiAgentRuns.cancel`	تلغي تشغيلًا في قائمة الانتظار أو قيد التشغيل (`_id`).

تأخذ create القيم aiHarnessClientId وinput (المهمة)، واختياريًا sessionId (للعمل في محادثة) وaiAgentSessionId وtaskKey وisNewSession، وoptions بالإعدادات نفسها الموجودة في العقدة: instructions وaiModelClientId وfallbackAiModelClientId وfastAiModelClientId وharnessModel وtoolCustomFunctionIds وaiScopeIds وaiMcpClientDatas وmessageHistoryLimit وspeechToTextAiModelClientId وforwardIntermediateMessages وwillSendAnswer وbudget المطلوب. عبر API، القيمة الافتراضية لكل من forwardIntermediateMessages وwillSendAnswer هي false.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

التشغيل غير متزامن: اقرأه لاحقًا باستخدام show، أو تفاعل معه بحدث انتهى تشغيل وكيل AI. وبدون sessionId، يبدأ كل استدعاء جلسة وكيل جديدة ما لم تمرّر aiAgentSessionId الذي أعاده استدعاء سابق؛ عندها يرى الوكيل عمليات التشغيل المكتملة السابقة لجلسة الوكيل تلك كسجل له. راجع Method لمعرفة كيفية استدعاء الطرق من دالة.

الصلاحيات

الصلاحية	تتيح
عرض / إنشاء / تحديث / حذف AI harness في الأتمتة	إدارة AI Harness
عرض عمليات تشغيل وكلاء AI في الأتمتة	رؤية عمليات تشغيل وكيل الذكاء الاصطناعي
بدء تشغيل وكلاء AI في الأتمتة	استدعاء `aiAgentRuns.create`
إلغاء عمليات تشغيل وكلاء AI في الأتمتة	استدعاء `aiAgentRuns.cancel`

راجع الأدوار.

عمليات تشغيل وكيل الذكاء الاصطناعي: اطّلع على ما فعله كل تشغيل
نماذج AI
عملاء MCP
نطاقات AI
التدفقات

اللبنات الأساسية​

AI Harness​

إضافة harness​

نقطة نهاية مخصصة​

عقدة وكيل AI​

الحقول​

ما يحدث عندما يصل التدفق إلى العقدة​

المخرجات​

جلسات الوكيل​

الفوترة​

حدث انتهاء تشغيل وكيل AI​

تشغيل وكيل من الشيفرة​

الصلاحيات​

ذات صلة​