Skip to main content

قابل مستخدميك حيث هم بالفعل

وكيل CrewAI الذي بنيته في النظرة العامة لا يجب أن يعيش خلف تطبيق ويب فقط. يمكن لنفس الـ Crew أو الـ Flow أن يعمل كروبوت داخل منصة مراسلة. لا حاجة لإعادة البناء ولا لنسخة ثانية من منطق وكيلك: يبقى الوكيل مكشوفًا عبر بروتوكول AG-UI، وتقوم قناة بتشغيله من Slack أو Microsoft Teams. يوفّر Channels SDK من CopilotKit تلك القناة. تُعرّف createChannel في وقت تشغيل صغير، وتوجّهه إلى وكيل CrewAI الخاص بك، وتتولى منصة Intelligence المُدارة من CopilotKit التوسّط في الاتصال مع مزوّد المراسلة.
على خلاف بقية هذا القسم، فإن Channels ليست ذاتية الاستضافة. تعمل من خلال CopilotKit Intelligence — وهي سطح مطلوب لـ Channels، بحكم التصميم (تتوفر طبقة مجانية). تحتفظ Intelligence باتصال المنصة وبيانات الاعتماد، وتستقبل كل حدث من المنصة، وتسلّم الدور إلى عملية قناتك؛ تشغّل عمليتك الوكيل وتبثّ الرد مرة أخرى. تقوم بإعداد Slack مرة واحدة في لوحة تحكم Intelligence، ولا تدخل بيانات اعتماد المنصة عمليتك أبدًا. يبقى وكيلك وأدواتك وحالتك ملكًا لك.

كيف تتكامل الأجزاء معًا

لا يتغير أي شيء بخصوص خادم وكيل CrewAI الخاص بك. يستمر في تقديم الـ Crew أو الـ Flow عبر AG-UI تمامًا كما في النظرة العامة. ما تضيفه هو عملية Node منفصلة طويلة الأمد مبنية باستخدام @copilotkit/channels: تسجّل قناة على CopilotRuntime، وتتصل بـ Intelligence، وتشغّل وكيلك كلما وصلت رسالة.
تحتفظ عملية القناة باتصال دائم مع بوابة Intelligence، لذا فهي تحتاج إلى مضيف طويل الأمد — لا يمكن لمعالج طلبات بلا خادم (serverless) أن يملك ذلك الاتصال. يمكن لخادم CrewAI الخاص بك أن يستمر في تقديم واجهة الويب الأمامية من النظرة العامة في الوقت نفسه: تطبيق الويب والقناة ما هما إلا عميلان لنقطة نهاية AG-UI واحدة.

دليل التكامل

1

ثبّت حزم Channels

يأتي Channels SDK مكتمل العناصر — كل منصة تُشحن في الحزمة الواحدة، بلا محوّل خاص بكل منصة لتثبيته. أضفه إلى جانب وقت التشغيل الذي يستضيف القناة وعميل CrewAI AG-UI:
2

أنشئ قناة في Intelligence

في لوحة تحكم CopilotKit، أنشئ قناة واربط Slack — ترشدك Intelligence خلال إنشاء تطبيق Slack وتحتفظ ببيانات اعتماده. يترك ذلك متغيّري بيئة لعمليتك، كلاهما من لوحة التحكم:
3

عرّف القناة

تُعرّف createChannel القناة وتربط وكيلك بها. ابنِ الوكيل كمصنع لكل خيط (thread) بحيث تحصل كل محادثة على جلستها الخاصة، مستخدمًا نفس CrewAIAgent الذي تستخدمه النظرة العامة في وقت تشغيل الويب، موجّهًا إلى نقطة نهاية AG-UI الخاصة بك. تتيح identifyUser: "platform" لـ Intelligence ربط كل مستخدم من المنصة بهوية ثابتة.
4

سجّل القناة على وقت التشغيل

أنشئ CopilotRuntime مع بوابة Intelligence وقناتك، ثم قدّمه باستخدام createCopilotNodeListener. تبقى خريطة agents فارغة — القناة توفّر وكيلها الخاص. انتظر حتى تكون القناة جاهزة كي يفشل بدء التشغيل بصوت عالٍ عند وجود إعداد معطوب.
5

شغّل وقت تشغيل القناة

ابدأه إلى جانب خادم وكيل CrewAI الخاص بك:
اذكر الروبوت في Slack أو Teams فيشغّل الـ Crew أو الـ Flow الخاص بك، ويبثّ الرد مرة أخرى داخل الخيط. يبقى الخيط مشتركًا، لذا تعمل رسائل المتابعة دون الحاجة إلى ذكر آخر.

نموذج الأحداث

تتفاعل القناة مع أحداث المنصة عبر معالِجات، ويستقبل كل معالِج خيطًا (thread) تديره بعدد قليل من الدوال:
  • channel.onMention يُطلَق عندما يذكر مستخدم الروبوت بـ @. استدعِ thread.subscribe() للانضمام إلى الخيط، ثم thread.runAgent() لتشغيل وكيل CrewAI الخاص بك عند الذكر.
  • channel.onMessage يُطلَق عند كل رسالة في خيط يمكن للروبوت رؤيته. قيّده بـ thread.isSubscribed() كي لا يستجيب الوكيل إلا حيث انضمّ، ثم thread.runAgent().
  • thread.runAgent() يشغّل وكيل CrewAI المرفق للدور الحالي ويبثّ مخرجاته مرة أخرى داخل القناة. مرّر { prompt } لتجاوز النص الذي يعمل عليه الوكيل.
يستقبل وكيلك RunAgentInput عاديًا من AG-UI ويصدر أحداث AG-UI عادية؛ تبقى آليات المنصة خلف القناة، لذا يعمل نفس الـ Crew أو الـ Flow دون تغيير عبر كل منصة. تكشف القناة أيضًا معالِجات للترحيبات والمقاطعات والأوامر والتفاعلات والنوافذ (modals) — راجع مرجع Channel للاطلاع على السطح الكامل.

دعم المنصات

يغطي مسار Intelligence المُدار Slack وMicrosoft Teams اليوم — يعمل نفس كود القناة على أيٍّ منهما، وتفيد message.platform / thread.platform بالأصل الأصلي. تُبلَغ المنصات الأخرى (Discord وTelegram وWhatsApp) عبر محوّلات مباشرة يشغّلها المطوّر بدلًا من المسار المُدار — تملك عمليتك الخاصة بيانات اعتماد المنصة والنقل. راجع توثيق CopilotKit Channels للاطلاع على قائمة المنصات الحالية والإعداد الخاص بكل منصة.

ذات صلة

النظرة العامة على الواجهة الأمامية

قدّم الـ Crew أو الـ Flow الخاص بك عبر AG-UI — الأساس الذي تُبنى عليه كل قناة.

التدخل البشري (Human-in-the-Loop)

أوقف الوكيل مؤقتًا لجمع موافقة المستخدم أو مدخلاته في منتصف التشغيل.