باختصار
يستخدم وكلاء LangChain منصة OmniChannels.ai عبر خادم MCP البعيد لدينا. فباستخدام langchain-mcp-adapters، يكفي إدخال واحد في MultiServerMCPClient يضبط transport على streamable_http والعنوان https://mcp.broadnet.me/mcp مع ترويسة Authorization، لتحميل أدواتنا للإرسال والقوالب وتقارير التسليم إلى وكيلك. وبديلًا عن ذلك، يمكنك تغليف استدعاءات محددة من واجهة REST API في أدوات خاصة بك، معتمدًا على مواصفات OpenAPI 3.1 لدينا لمعرفة الحقول بدقة.
ما الذي يمكنك فعله
وكيل دعم للتسليم بأدوات قراءة فقط
حمّل أدوات القراءة وحدها ليجيب الوكيل عن أسئلة التسليم دون أن يستطيع إرسال أي شيء.
جرّب أن تطلب
“ابنِ وكيلًا يجيب عن أسئلة التسليم باستخدام أدوات القراءة فقط، ويرفض أي طلب لإرسال رسالة.”
وكيل إشعارات بموافقة بشرية
استخدم interrupt في LangGraph قبل استدعاءات أدوات الإرسال ليوافق شخص على كل رسالة أو دفعة.
جرّب أن تطلب
“ابنِ وكيلًا في LangGraph يكتب مسودات تحديثات الطلبات عبر واتساب، ويتوقف لانتظار موافقة بشرية قبل استدعاء أي أداة إرسال.”
مرسل يراعي القوالب
يعرض الوكيل قوالب واتساب المعتمدة ويعبّئ متغيراتها، فتستخدم الرسائل التي تبادر بها الشركة خارج نافذة الـ 24 ساعة قالبًا معتمدًا.
جرّب أن تطلب
“اكتب وكيلًا يختار قالب واتساب العربي المعتمد المناسب لتأخر التوصيل، ويرسله إلى 966500000000 مع الموعد الجديد.”
أدوات REST محدودة بدلًا من MCP
غلّف عملية أو اثنتين من واجهة REST في دوال @tool عندما تريد تحكمًا كاملًا في الحقول والتحقق والتسجيل.
جرّب أن تطلب
“اكتب أداة LangChain ترسل رسالة SMS واحدة عبر POST /sms/sendSms، وتتحقق من صيغة الرقم، وتقرأ BROADNET_TOKEN من متغيرات البيئة.”
فرز حالات الفشل
يقرأ الوكيل تقارير التسليم، ويصنّف حالات الفشل حسب السبب، ويقترح حلولًا من دليل الأخطاء لدينا.
جرّب أن تطلب
“أنشئ وكيلًا يقرأ تقارير تسليم الأمس، ويصنّف الرسائل FAILED وREJECTED حسب السبب، ويكتب ملخصًا قصيرًا لقناة فريق العمليات.”
كيف يتم الربط
تحوّل حزمة langchain-mcp-adapters أدوات MCP إلى أدوات LangChain. اضبط MultiServerMCPClient بإدخال خادم يضبط transport على streamable_http، والعنوان https://mcp.broadnet.me/mcp، وheaders تتضمن Authorization: Bearer مع رمز الوصول (Token) مقروءًا من متغيرات البيئة، ثم استدعِ get_tools ومرّر النتيجة إلى وكيلك. كما تتضمن الإصدارات الأحدث من LangChain دعم MCP في الحزمة الرئيسية، لذا راجع وثائق LangChain الحالية لمعرفة طريقة الاستيراد الموصى بها.
أنت من يحدد الأدوات التي تصل إلى النموذج: صفِّ القائمة حسب الاسم ليحصل وكيل الدعم على أدوات القراءة فقط، وأضف خطوة موافقة قبل أي إرسال. وإذا كنت تفضّل عدم استخدام MCP، فاكتب أدواتك الخاصة التي تستدعي واجهة REST API لدينا برمز Bearer، علمًا بأن إرسال SMS الفردي بصيغة JSON، بينما يعتمد الإرسال الجماعي ومعظم القنوات الأخرى على multipart/form-data.
- MCP: الكائن MultiServerMCPClient مع transport streamable_http وترويسة Authorization
- صفِّ الأدوات حسب الاسم لتمنح كل وكيل أقل صلاحيات ممكنة
- أضف موافقة بشرية قبل أدوات الإرسال، مثلًا عبر interrupt في LangGraph
- بديل REST: أدواتك الخاصة المبنية من مواصفات OpenAPI 3.1
خطوات الإعداد
- 1
اطلب الوصول إلى API
اطلب وصولًا تجريبيًا واحصل على رمز وصول لواجهة API. تُرسل الرسائل التجريبية إلى أرقامك الموثّقة فقط.
- 2
احصل على مفتاح مؤقت
في بوابة الإدارة افتح Integrations ثم MCP Integration، واختر Get temporary key (الحصول على مفتاح مؤقت)، ثم احفظه في المتغير BROADNET_TOKEN.
الدليل: MCP server for AI agents - 3
ثبّت المحوّلات
ثبّت langchain-mcp-adapters، أو إضافة MCP في LangChain إن كان إصدارك يوفرها، باتباع وثائق LangChain الحالية.
- 4
حمّل الأدوات
أنشئ إدخالًا في MultiServerMCPClient يضبط transport على streamable_http مع عنواننا وترويسة Authorization، ثم استدعِ get_tools.
الدليل: MCP server for AI agents - 5
قيّد الأدوات واضبط الموافقة
مرّر فقط الأدوات التي يحتاجها الوكيل، وضع خطوة موافقة بشرية قبل أي أداة ترسل رسائل.
- 6
اختبر على رقمك
شغّل الوكيل على رقمك الموثّق وتحقق من تقرير التسليم قبل توسيع نطاق الوصول.
توثيق الجهة المطوّرة
LangChain علامة تجارية مملوكة لأصحابها. لا ترتبط OmniChannels.ai بـ LangChain ولا تحظى بتأييدها؛ تصف هذه الصفحة ربطاً يتم عبر ميزات MCP أو HTTP أو Webhooks المتوفرة في LangChain نفسها.
