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