كيف تبني وكيل WhatsApp باستخدام OpenAI Agents SDK

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

يغطي هذا الدليل ما يمنحك إياه الـ SDK، والطرق الثلاث لاستخدام وكلاء OpenAI في MonoChat، وإعداداً خطوة بخطوة، وتفاصيل WhatsApp التي تحدد ما إذا كان العملاء سيثقون بالوكيل.

ما الذي يمنحك إياه OpenAI Agents SDK

يقوم الـ SDK على مجموعة صغيرة من الأفكار:

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

معاً، هذا هو agent harness: الحلقة التي تتيح للنموذج أن يتصرف ويتحقق من عمله ويواصل، بدلاً من أن يجيب مرة واحدة. وفي مراسلة العملاء، هذا هو الفرق بين شرح سياسة الإرجاع وإنشاء المرتجع فعلاً.

ما الذي يضيفه WhatsApp إلى المسألة

بناء الوكيل نصف العمل. ووضعه أمام العملاء على WhatsApp يعني التعامل مع:

• WhatsApp Business Platform. اتصال API رسمي، ونشاط موثّق، ورقم معتمد.
• نافذة 24 ساعة. الردود الحرة مسموحة خلال 24 ساعة من آخر رسالة للعميل؛ وبعد ذلك تحتاج إلى قالب معتمد.
• السياسة. منذ 15 يناير 2026، تُبعد WhatsApp المساعدين العامين الغرض عن المنصة. الوكيل الذي يخدم عملاءك أنت مسموح، ويُتوقع وجود طريق واضح إلى إنسان عندما تكون الردود آلية.
• الأشخاص. بعض المحادثات يجب أن تذهب إلى شخص، مع بقاء السجل سليماً، داخل الأداة التي يستخدمها فريقك أصلاً.
• القنوات الأخرى. العملاء الذين يكتبون على Instagram أو Messenger أو موقعك يتوقعون الإجابات نفسها.

يتولى MonoChat هذه الأمور حول الوكيل، فيبقى عملك على الوكيل نفسه.

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

الخيار	أين يعمل	ما الذي تحتاجه
OpenAI Agents SDK	داخل MonoChat	لا شيء إضافي؛ يستخدم نماذج الذكاء الاصطناعي لديك
OpenAI Agents API (مستضاف لدى OpenAI)	سحابة OpenAI	مفتاح OpenAI API الخاص بك
مخصص (خدمة Agents SDK الخاصة بك)	خادمك الخاص	عنوان URL لنقطة النهاية وسر مشترك

ابدأ بـ harness الخاص بـ OpenAI Agents SDK إذا أردت وكيلاً على نمط OpenAI دون نشر أي شيء. اختر OpenAI Agents API إذا كانت وكلاؤك موجودة أصلاً على منصة OpenAI المستضافة. اختر المخصص إذا كتب مطوروك وكيلهم الخاص بالـ SDK، بأدواتهم وتسليماتهم واختباراتهم، ويريدون مواصلة تشغيل ذلك الكود؛ راجع كيف تربط وكيل الذكاء الاصطناعي الخاص بك بـ WhatsApp.

خطوة بخطوة: وكيل OpenAI Agents SDK على WhatsApp

1. أضف AI Harness

أضف AI Harness في MonoChat واختر OpenAI Agents SDK كمزود. يعمل داخل MonoChat ويستخدم نماذج الذكاء الاصطناعي التي أعددتها بالفعل، فلا مفاتيح ولا خوادم إضافية لهذه الخطوة.

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

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

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

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

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

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

4. اربط أدواتك

زوّد الوكيل بالأدوات التي تناسب أكثر طلباتك تكراراً:

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

ثلاث أدوات جيدة خير من خمس عشرة أداة نصف مختبرة. أضف المزيد بعد أن ترى محادثات حقيقية.

5. اربط WhatsApp (وكل شيء آخر)

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

6. اختبر برسائل حقيقية

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

أنماط تعمل جيداً على WhatsApp

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

أكّد قبل الإجراءات التي لا رجعة فيها. دع الوكيل يقترح، والعميل يؤكد، قبل أي إلغاء أو استرداد أو تغيير حجز.

المتخصصون عبر التسليمات، والأشخاص عبر صندوق الوارد. التسليمات في الـ SDK ممتازة للتوجيه بين الوكلاء (المبيعات والدعم والمرتجعات). أما التحويل إلى شخص فمكانه صندوق وارد الفريق المشترك في MonoChat، حيث تصل المحادثة مع سجلها الكامل.

تعليمات تسمّي الحدود. «الاستردادات حتى €50 يمكنك الموافقة عليها؛ وما فوق ذلك حوّلها إلى فريق الفوترة.» الأرقام الصريحة أفضل من القواعد الغامضة.

ابقَ ضمن نشاطك. الوكيل الذي يساعد عملاءك مسموح على WhatsApp. أما الذي يجيب عن أي شيء فيخاطر بمخالفة قواعد WhatsApp لعام 2026؛ ويشرح دليل سياسة روبوتات الدردشة بالذكاء الاصطناعي على WhatsApp أين يقع الخط.

التكاليف

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

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

دون قيود

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