كيف تشغّل وكيل Claude Agent SDK على WhatsApp (مع MonoChat)

Claude Agent SDK هو agent harness من Anthropic: حلقة التفكير واستخدام الأدوات والتحقق الذاتي نفسها التي تشغّل Claude Code، مغلّفة ليبني المطورون وكلاءهم الخاصين. ولتشغيل واحد منها على WhatsApp تحتاج إلى ثلاثة أشياء أخرى حوله: اتصال بـ WhatsApp Business Platform، وطريقة لإعطاء الوكيل أدوات نشاطك، ومسار آمن إلى إنسان عندما ينبغي للوكيل أن يتوقف. مع Agent Harness من MonoChat، تضيف Claude Agent SDK كـ AI Harness، وتضع عقدة وكيل ذكاء اصطناعي في مسار، وتربط رقم WhatsApp الخاص بك وتختبر. لا خوادم لتشغيلها.

يشرح هذا الدليل ما يقدمه Claude Agent SDK لمحادثات العملاء، وكيف يعمل الإعداد في MonoChat، وما يجب إتقانه قبل أن يبدأ العملاء بالكتابة.

ما هو Claude Agent SDK (ولماذا يناسب الدعم)

معظم الذكاء الاصطناعي على WhatsApp اليوم استدعاء نموذج واحد: تصل رسالة، فيكتب النموذج رداً، وينتهي الأمر. وهذا مناسب لسؤال مثل «ما ساعات عملكم؟». لكنه ينهار مع «طلبي لم يصل وأنا مسافر يوم الجمعة».

يشغّل الـ harness النموذج في حلقة. يقرر النموذج ما يفعله بعد ذلك، وينفذ الـ harness تلك الخطوة (البحث عن شيء، أو استدعاء أداة، أو قراءة ملف)، ويعيد النتيجة، ويكرر حتى تكتمل المهمة أو تلزم الاستعانة بشخص. Claude Agent SDK هو نسخة Anthropic من تلك الحلقة. وهو أساس Claude Code ويأتي بلبنات البناء التي يعتمد عليها المطورون هناك: استخدام الأدوات ودعم MCP والوكلاء الفرعيين وإدارة السياق للجلسات الطويلة وضوابط الصلاحيات.

وفي مراسلة العملاء، هذه الحلقة هي ما يحوّل الإجابة إلى حل:

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

إذا أردت الخلفية عن الـ harness مقابل الاستدلال العادي، فاقرأ ما هو agent harness ولماذا يحتاجه دعم WhatsApp.

ثلاث طرق لاستخدام وكلاء Claude في MonoChat

يدعم MonoChat ثلاث طرق للوصول إلى وكيل مدعوم بـ Claude. وتستخدم الثلاث عقدة وكيل الذكاء الاصطناعي نفسها والقنوات نفسها والتحويل نفسه.

الخيار	أين يعمل	ما الذي تحتاجه
Claude Agent SDK	مشغّل الوكلاء الخاص بـ MonoChat؛ كل تشغيل عملية وكيل معزولة على نمط Claude Code	لا شيء إضافي؛ نماذج الذكاء الاصطناعي لديك عبر بوابة MonoChat
Claude Managed Agents	سحابة Anthropic	مفتاح Anthropic API الخاص بك
مخصص (خدمة Claude Agent SDK الخاصة بك)	خادمك الخاص	عنوان URL لنقطة النهاية وسر مشترك

بالنسبة لمعظم الفرق، الخيار الأول هو البداية الصحيحة: تحصل على harness الخاص بـ Claude Agent SDK دون نشر أو صيانة أي شيء. اختر Claude Managed Agents إذا كنت تبني أصلاً على وكلاء Anthropic المستضافين وتريد إبقاءهم هناك. واختر المخصص إذا كان مطوروك قد بنوا واختبروا وكيلهم الخاص بالـ SDK ويريدون مواصلة تشغيله على بنيتهم التحتية؛ ويغطي دليلنا عن ربط وكيل الذكاء الاصطناعي الخاص بك بـ WhatsApp هذا المسار.

خطوة بخطوة: وكيل Claude Agent SDK على WhatsApp

1. أضف AI Harness

في MonoChat، AI Harness هو تعريف خدمة تضيفه مرة واحدة وتعيد استخدامه. أضف واحداً واختر Claude Agent SDK كمزود. لا شيء آخر يلزم تهيئته للمزود نفسه: فهو يعمل على مشغّل الوكلاء الخاص بـ MonoChat ويصل إلى نماذج الذكاء الاصطناعي لديك عبر بوابة MonoChat.

2. أضف عقدة وكيل ذكاء اصطناعي إلى مسار

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

3. اختر النماذج الرئيسي والاحتياطي والسريع

لكل عقدة وكيل ذكاء اصطناعي ثلاثة أدوار للنماذج:

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

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

4. زوّد الوكيل بالأدوات

الوكيل بلا أدوات لا يستطيع إلا الكلام. في MonoChat يستطيع الوكيل استخدام:

• أدوات الوظائف للذكاء الاصطناعي لاستدعاء واجهات API الخاصة بك بمدخلات منظمة، مثل «الحصول على حالة الطلب» أو «إنشاء مرتجع».
• خوادم MCP لجلب أدوات من أي نظام متوافق مع MCP.
• قاعدة المعرفة الذكية لإجابات مستندة إلى سياساتك ومستنداتك.
• الوظائف المخصصة لمنطق الأعمال الذي يعمل داخل المحادثة.

ابدأ بأداتين أو ثلاث تغطي أكثر طلباتك شيوعاً. كل أداة تضيفها هي شيء إضافي يستطيع الوكيل فعله، وشيء إضافي عليك اختباره.

5. اربط WhatsApp وقنواتك الأخرى

اربط رقم WhatsApp Business الخاص بك بـ MonoChat إن لم تكن قد فعلت (MonoChat شريك أعمال رسمي لدى Meta ويستخدم WhatsApp Business Platform الرسمية). ولأن الوكيل يعيش في مسار، يمكنك ربط المسار نفسه بـ Instagram وMessenger وTikTok وTelegram ودردشة الويب والرسائل النصية SMS والصوت دون إعادة بناء أي شيء.

6. اختبر، ثم أطلق

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

كتابة التعليمات لوكيل WhatsApp

نشأ Claude Agent SDK في مجال البرمجة، حيث تكون الإجابات الطويلة والمفصلة مرحباً بها. أما WhatsApp فعلى العكس تماماً. بعض القواعد تحدث فرقاً كبيراً:

• اجعل الردود قصيرة. جملتان أو ثلاث في كل رسالة، وسؤال واحد في كل مرة. العملاء يقرؤون على الهاتف.
• أكّد قبل التنفيذ. «يمكنني إلغاء الطلب 4821 واسترداد €39. هل أمضي في ذلك؟» قبل أي شيء يكلف مالاً أو لا يمكن التراجع عنه.
• اذكر قاعدة التحويل صراحة. مثلاً: «حوّل إلى شخص عند الشكاوى من الموظفين أو التهديدات القانونية أو الاستردادات التي تتجاوز €100 أو عندما يطلب العميل إنساناً.»
• ابقَ داخل نشاطك. منذ 15 يناير 2026، تُبعد شروط WhatsApp المساعدين العامين الغرض عن المنصة. الوكيل الذي يخدم عملاءك أنت مقبول؛ والذي يكتب مقالات في أي موضوع غير مقبول. يشرح دليل سياسة روبوتات الدردشة بالذكاء الاصطناعي على WhatsApp هذه القاعدة.
• احترم نافذة 24 ساعة. الردود الحرة مسموحة خلال 24 ساعة من آخر رسالة للعميل. وبعد ذلك تحتاج الرسالة إلى قالب معتمد.

التحويل: الجزء الذي يصنع الثقة أو يهدمها

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

خطط لقواعد التحويل قبل أن تخطط لأدواتك. حدد الحالات التي لا ينبغي للوكيل التعامل معها بمفرده أبداً، ومن يتلقاها، وما الذي يقوله الوكيل للعميل أثناء انتظاره.

التكاليف والتحكم

مع الوكيل هناك بندان للتكلفة فوق باقة MonoChat: استخدام نماذج الذكاء الاصطناعي ورسوم WhatsApp لدى Meta. منذ 1 أكتوبر 2026، تحتسب Meta رسوماً على ردود الخدمة بعد أول 1,000 لكل رقم أعمال شهرياً؛ وتجد التفاصيل في دليل أسعار WhatsApp API.

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

متى تختار harness مختلفاً

Claude Agent SDK خيار افتراضي قوي للوكلاء الذين يحتاجون إلى التفكير عبر عدة خطوات. لكن Agent Harness مبني بحيث لا تكون مقيداً. إذا كان فريقك يعمل أصلاً مع OpenAI Agents SDK أو Pi أو وكيل OpenAI أو Anthropic مستضاف أو إطاره الخاص، فيمكنك إضافة AI Harness آخر وتحويل عقدة وكيل الذكاء الاصطناعي إليه، دون المساس بقنواتك أو أدواتك أو التحويل. اطلع على كل الخيارات في صفحة Agent Harness.