أحضر وكيل الذكاء الاصطناعي الخاص بك إلى WhatsApp: اربط أي إطار (LangGraph وADK وكود مخصص) عبر نقطة نهاية webhook

يمكنك ربط أي وكيل ذكاء اصطناعي تقريباً بـ WhatsApp دون إعادة كتابته. شغّل وكيلك، المبني بـ LangGraph أو Google ADK أو CrewAI أو كودك الخاص، خلف نقطة نهاية HTTPS، ثم أضفه في MonoChat كـ AI Harness بالمزود Custom: عنوان URL لنقطة النهاية وسر مشترك. ضع عقدة وكيل ذكاء اصطناعي في مسار، واربط رقم WhatsApp الخاص بك، فيجيب وكيلك العملاء على WhatsApp وكل قناة أخرى يتصل بها MonoChat، مع صندوق وارد مشترك وتحويل إلى موظف حوله.

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

لماذا تحضر وكيلك الخاص؟

تأتي معظم منصات مراسلة العملاء بوكيل ذكاء اصطناعي مدمج واحد. وهذا مريح إلى أن:

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

صُمم Agent Harness من MonoChat لهذا: أحضر إطار وكيلك الخاص وأبقِ كل ما حوله، القنوات وصندوق الوارد والأشخاص، في مكان واحد.

كيف يعمل harness المخصص

فكّر فيه كتقسيم للعمل.

يتولى MonoChat طبقة المحادثة:

• الاتصالات الرسمية بـ WhatsApp وInstagram وMessenger وTikTok وTelegram ودردشة الويب والرسائل النصية SMS والصوت (MonoChat شريك أعمال رسمي لدى Meta).
• المسار الذي يقرر متى يُستدعى الوكيل، عبر عقدة وكيل الذكاء الاصطناعي.
• صندوق وارد الفريق المشترك، حيث يستطيع شخص التدخل مع السجل الكامل.

تتولى نقطة النهاية لديك الوكيل:

• استقبال المحادثة من MonoChat.
• تشغيل وكيلك: تفكيره وأدواته وذاكرته.
• إعادة رد الوكيل.

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

ما الذي يجب أن تفعله نقطة النهاية لديك

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

تحقق من كل طلب

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

أبقِ كل محادثة منفصلة

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

أجب برسائل بحجم الدردشة

الوكلاء المبنيون لتطبيقات الويب يميلون إلى كتابة إجابات طويلة ومنسقة. أما WhatsApp فيُقرأ على الهاتف. اطلب من وكيلك رسائل قصيرة، وسؤالاً واحداً في كل مرة، وأبقِ Markdown الثقيل خارج الردود.

افشل بوضوح، لا بصمت

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

كن سريعاً

يتوقع العملاء رداً خلال ثوانٍ. أبعد الأعمال الطويلة عن مسار الرد حيثما أمكن، واجعل أدواتك سريعة أو غير متزامنة.

خطوة بخطوة في MonoChat

1. انشر وكيلك خلف HTTPS

استضف وكيل LangGraph أو ADK أو CrewAI أو الوكيل المخصص على خادمك أو سحابتك، بحيث يمكن الوصول إليه عبر HTTPS. نفّذ تنسيق الطلب والاستجابة الخاص بـ MonoChat وفحص السر المشترك.

2. أضف AI Harness بالمزود Custom

في MonoChat، أضف AI Harness، واختر Custom وأدخل عنوان URL لنقطة النهاية والسر المشترك. تضيف الـ harness مرة واحدة ويمكنك استخدامه في أي عدد تشاء من المسارات.

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

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

4. حدّد ميزانية لكل تشغيل

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

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

اربط رقم WhatsApp Business الخاص بك، ثم ألحق المسار نفسه بالقنوات الأخرى التي تستخدمها. لا يوجد عمل تكامل إضافي لكل قناة: نقطة النهاية لديك ترى محادثات، وليس واجهات API للقنوات.

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

أعد تشغيل رسائل عملاء حقيقية عبر المسار. تحقق من استدعاءات الأدوات وأزمنة الاستجابة والنبرة والتحويل. راقب الأيام الأولى من الحركة الحية عن كثب، ثم وسّع ما يُسمح للوكيل بفعله.

ملاحظات حول الأطر

LangGraph. رسم من العقد والحواف مناسب بطبيعته لرحلات الدعم (الفرز والبحث والحل والتصعيد). غلّف الرسم المترجم بخدمة HTTP صغيرة، وحمّل حالة المحادثة عند كل طلب وأعد الرسالة النهائية.

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

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

كودك الخاص. حلقة عادية مع واجهة نموذج وبضع دوال تكفي غالباً. تحتفظ بالتحكم الكامل، ويمنحك MonoChat القنوات وصندوق الوارد.

التحويل: قرره في المسار

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

وأبقِ وكيلك داخل نشاطك أيضاً. منذ 15 يناير 2026، تُبعد WhatsApp المساعدين العامين الغرض عن المنصة؛ أما الوكلاء الذين يخدمون عملاءك أنت فمقبولون. يشرح دليل سياسة روبوتات الدردشة بالذكاء الاصطناعي على WhatsApp هذه القاعدة.

متى لا تبني وكيلك الخاص

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

• harness المدمج في MonoChat على نماذج MonoChat AI لديك.
• OpenAI Agents SDK، يعمل داخل MonoChat (الدليل).
• Claude Agent SDK أو Pi، يعملان على مشغّل الوكلاء الخاص بـ MonoChat (دليل Claude).
• الوكلاء المستضافون: OpenAI Agents API أو Claude Managed Agents، بمفتاحك الخاص.

ولأن كل خيار يستخدم عقدة وكيل الذكاء الاصطناعي نفسها، يمكنك البدء بأحدها والانتقال إلى وكيلك الخاص لاحقاً دون المساس بقنواتك أو التحويل. قارن بينها في صفحة Agent Harness.