CopilotKit لبناء مساعد ذكاء اصطناعي داخل التطبيقات

ما وظيفة CopilotKit؟ شرح مبسط

CopilotKit إطار عمل مفتوح المصدر من Tawkit, Inc. يساعد المطورين على إضافة مساعد ذكاء اصطناعي إلى تطبيقاتهم. يربط الوكيل بالشاشة التي يعمل فيها المستخدم، فتظهر الإجابة كنص أو رسم بياني أو نتيجة عملية أتاحها فريق التطوير.

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

مساعد ينفذ مهام داخل تطبيقك

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

تتوفر حزم رسمية لـ React وAngular وVue وReact Native. ويمكن استخدام الوكيل المدمج أو ربط أطر مثل LangGraph وGoogle ADK وMastra وPydanticAI. يتولى AG-UI الاتصال بين الوكيل والواجهة، بينما يوفر CopilotKit المكونات وأنماط التفاعل. وهناك أيضًا مسارات Channels لربط Slack وMicrosoft Teams، مع مراجعة شروط كل تكامل.

واجهات توليدية وحالة مشتركة وموافقة المستخدم

تسمح الواجهة التوليدية بعرض البيانات عبر بطاقات وجداول ورسوم من نظام تصميمك. في React، تسجّل useComponent مكون عرض ومعاملاته المحددة، ثم يختار الوكيل عرضه ويملأ بياناته. عرض البطاقة ليس بحد ذاته تنفيذًا لمعاملة على الخادم.

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

خطوات ربط التطبيق بالوكيل

يوضح دليل البدء الرسمي مسارًا عمليًا لتطبيق React:

1. جهّز المشروع وNode.js 20+ ومفتاح API لمزود النموذج.
2. ثبّت @copilotkit/react-core و@copilotkit/runtime، واضبط بيانات الاعتماد على الخادم وأنشئ نقطة اتصال runtime.
3. اربط Provider بعنوان runtime، واستورد التنسيقات وأضف مكون المحادثة أو اللوحة الجانبية.
4. اختبر محادثة عادية، ثم سجّل وظيفة محددة يمكن التحقق من نتيجتها.
5. راجع التغيير الفعلي في التطبيق وأحداث AG-UI داخل Inspector محليًا.

إذا كان لديك وكيل جاهز، فاتبع تكامل إطاره. المكون BuiltInAgent يتصل بالنموذج مباشرة ولا يربط منطق الوكيل الموجود تلقائيًا. ويحتاج تطبيق SPA دون خادم إلى runtime مستقل.

الخطة المجانية والأسعار والحدود

بحسب الأسعار العامة بالدولار الأمريكي التي جرى التحقق منها في 18 أكتوبر 2026، خطة Developer مجانية لمطور واحد، بحد أقصى 200 سلسلة محادثة واحتفاظ لثلاثة أيام و1 جيجابايت من التخزين متعدد الوسائط. تبلغ Pro مقدار 39 دولارًا شهريًا، وTeam مقدار 100 دولار للمقعد شهريًا حتى خمسة مقاعد. الدعوات المعلقة تشغل مقاعد أيضًا. أما Enterprise فلها شروط وأسعار مخصصة. هذه ليست أسعارًا بالريال أو إجماليًا مؤكدًا شاملًا للضريبة.

تضيف Intelligence محادثات مستمرة وذاكرة للمستخدم. ويعرض الجدول الحالي Analytics وSelf-Learning كإتاحة مبكرة ضمن Enterprise. احسب تكلفة النموذج والبنية التحتية بصورة منفصلة، وراجع الخطط وحدودها الحالية.

الاستضافة الذاتية والخصوصية والترخيص

يستخدم المستودع ترخيص MIT، الذي يسمح بالاستخدام التجاري مع الالتزام بشروطه والإبقاء على الإشعارات اللازمة. للخدمات المستضافة شروط أخرى. وتختلف استضافة runtime فقط في Developer وPro عن نشر المنصة الكاملة.

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

الأسئلة الشائعة

هل CopilotKit مجاني؟

حزمة التطوير مفتوحة المصدر وتوجد خطة Developer مجانية بحدود. قد تبقى تكاليف النموذج والخوادم والميزات الإضافية.

هل يمكن ربط وكيل LangGraph موجود؟

نعم. استخدم تكامل LangGraph للحفاظ على منطق وكيلك بدل استبداله دون قصد بالوكيل المدمج.

هل يمكن استضافة CopilotKit على خوادمي؟

نعم، مع التمييز بين runtime والمنصة الكاملة، والتحقق من الخطة والاتصالات الخارجية ومسار البيانات.

المصادر الرسمية ومجتمع المطورين

• الوثائق الرسمية: اختيار مسار الواجهة والوكيل.
• مستودع GitHub: مراجعة المصدر والترخيص والمشكلات.
• مجتمع Discord الرسمي: مناقشة أسئلة التنفيذ.