باختصار
يتصل وكلاء Gemini بمنصة OmniChannels.ai عبر خادم MCP البعيد على العنوان https://mcp.broadnet.me/mcp. في Agent Development Kit يستخدم MCPToolset اتصال Streamable HTTP مع رمز الوصول (Token) في ترويسة Authorization، ويأخذ Gemini CLI العنوان والترويسة نفسيهما في إعداداته. بعدها يستطيع الوكيل إرسال رسائل واتساب والرسائل النصية SMS وRCS، واستخدام القوالب المعتمدة، والاطلاع على تقارير التسليم. لا يتطلب ذلك أي تطبيق من متجر Google.
ما الذي يمكنك فعله
تحديثات العملاء من وكيل ADK
وكيل مبني بـ Agent Development Kit يرسل تحديثات الشحن أو المواعيد كلما طلب تطبيقك ذلك.
جرّب أن تطلب
“أرسل رسالة واتساب إلى 971500000000 تخبره بأن طلبه قد شُحن وسيصل غدًا.”
قوالب لعملاء السعودية والإمارات
يعرض الوكيل قوالب واتساب المعتمدة ويعبّئ النسخة العربية أو الإنجليزية المناسبة.
جرّب أن تطلب
“اعرض قوالب واتساب المعتمدة باللغة العربية، ثم أرسل القالب order_update إلى 966500000000 برقم الطلب INV-400.”
رسائل تجريبية من Gemini CLI
يرسل المطورون رسالة تجريبية أو يتحققون من تقرير تسليم من الطرفية أثناء التطوير.
جرّب أن تطلب
“أرسل رسالة SMS تجريبية إلى رقمي الموثّق، وأخبرني بحالة تسليمها.”
تحليل حالات التسليم
وكيل للقراءة فقط لا يملك سوى أداة تقارير التسليم، يلخّص حالات الفشل لفريقك.
جرّب أن تطلب
“كم رسالة فشل إرسالها في حملة كشوف الحساب أمس، وما أكثر الأسباب تكرارًا؟”
الجمع مع بيانات أعمالك
إذا كان لدى الوكيل أيضًا أداة لـ BigQuery أو نظام CRM أو متجرك، فيمكنه جلب المستلمين من هناك والإرسال عبر OmniChannels.ai.
جرّب أن تطلب
“أرسل تحديث الطلب عبر واتساب إلى العملاء الذين شُحنت طلباتهم اليوم.”
كيف يتم الربط
تشغّل OmniChannels.ai خادم MCP بعيدًا عبر Streamable HTTP. يحمل كل طلب رمز الوصول (Token) الخاص بواجهة API في ترويسة Authorization: Bearer، وتعمل كل أداة بصلاحيات هذا الرمز وأسماء المرسل ورصيده، تمامًا كما لو كانت شيفرتك البرمجية هي التي ترسل.
في Agent Development Kit، أضف MCPToolset وضمّن معاملات اتصال Streamable HTTP الخاصة به عنوانَنا وترويسة Authorization، ثم اقصره على الأدوات التي يحتاجها الوكيل. ويمكن نشر وكيل ADK على Vertex AI Agent Engine، وعندها احفظ الرمز في Secret Manager بدلًا من الشيفرة. أما Gemini CLI فيقرأ خوادم MCP من ملف إعداداته، مستخدمًا httpUrl لنقطة الاتصال وheaders للرمز.
- نقطة الاتصال: https://mcp.broadnet.me/mcp (Streamable HTTP)
- المصادقة: Authorization: Bearer <token>، واستخدم مفتاحًا مؤقتًا أثناء الاختبار
- ADK: الكائن MCPToolset مع معاملات اتصال Streamable HTTP وheaders
- Gemini CLI: إدخال ضمن mcpServers مع httpUrl وheaders
- حتى دون MCP، يستطيع الوكيل استدعاء واجهة REST API لدينا اعتمادًا على مواصفات OpenAPI
خطوات الإعداد
- 1
اطلب الوصول إلى API
اطلب وصولًا تجريبيًا واحصل على رمز وصول لواجهة API. تُرسل الرسائل التجريبية إلى أرقامك الموثّقة فقط.
- 2
احصل على مفتاح MCP
في بوابة الإدارة افتح Integrations ثم MCP Integration، وانسخ مفتاحًا مؤقتًا.
الدليل: MCP server for AI agents - 3
أضف مجموعة الأدوات إلى وكيلك
في ADK، أنشئ MCPToolset بمعاملات Streamable HTTP تشير إلى https://mcp.broadnet.me/mcp مع ترويسة Authorization، واقرأ الرمز من متغير بيئة أو مخزن أسرار.
- 4
أو أضفه إلى Gemini CLI
أضف إدخالًا ضمن mcpServers تضبط فيه httpUrl على نقطة الاتصال لدينا وترويسة Authorization ضمن headers، ثم أعد تشغيل CLI.
- 5
قيّد الأدوات وأكّد الإرسال
لا تتح إلا الأدوات التي يحتاجها الوكيل، واشترط خطوة تأكيد قبل أي إرسال، لأن كل إرسال رسالة حقيقية تُحتسب عليها رسوم.
- 6
اختبر ثم انشر
أرسل رسالة تجريبية إلى رقمك الموثّق وتحقق من تقرير التسليم قبل نشر الوكيل على Vertex AI Agent Engine.
توثيق الجهة المطوّرة
Google Gemini and Vertex AI علامة تجارية مملوكة لأصحابها. لا ترتبط OmniChannels.ai بـ Google Gemini and Vertex AI ولا تحظى بتأييدها؛ تصف هذه الصفحة ربطاً يتم عبر ميزات MCP أو HTTP أو Webhooks المتوفرة في Google Gemini and Vertex AI نفسها.
