نظرة عامة على سير العمل

هذا سير عمل لوكيل ذكي مبني على OpenAI وMongoDB، مخصص لتوصية الأفلام وإدارتها. يمكن لهذا السير استقبال رسائل الدردشة، واستعلام بيانات الأفلام عبر إطار التجميع (Aggregation Framework) في MongoDB، ويدعم أيضًا حفظ الأفلام المفضلة لدى المستخدم في قاعدة البيانات.

اسم سير العمل

MongoDB Agent (الوكيل الذكي لـ MongoDB)

الميزات الأساسية

1. التفاعل الذكي عبر الدردشة: استقبال طلبات المستخدم المتعلقة بالأفلام من خلال واجهة الدردشة
2. استعلام بيانات MongoDB: استرجاع المعلومات ذات الصلة من قاعدة بيانات أفلام MongoDB باستخدام أنابيب التجميع (Aggregation Pipelines)
3. توصية الأفلام: تقديم توصيات أفلام مخصصة بناءً على احتياجات المستخدم
4. إدارة المفضلة: تمكين المستخدم من حفظ الأفلام المفضلة لديه في قاعدة البيانات

شرح العُقد

1. عند استلام رسالة دردشة (When chat message received)

• النوع: @n8n/n8n-nodes-langchain.chatTrigger
• الوظيفة: نقطة الدخول إلى سير العمل، تستقبل رسائل الدردشة عبر Webhook
• الإعدادات:
  • الوضع: Webhook (وصول عام)
  • السماح بطلبات من جميع المصادر (allowedOrigins: "*")

2. الوكيل الذكي – توصية الأفلام (AI Agent - Movie Recommendation)

• النوع: @n8n/n8n-nodes-langchain.agent
• الوظيفة: الوكيل الذكي الأساسي الذي ينسّق منطق سير العمل بالكامل
• مطالِب الذكاء الاصطناعي (Prompts):
  • العمل كمساعد سياقي للأفلام
  • استخدام أداة MongoDBAggregate للبحث
  • يجب توفير مصفوفة تحتوي على كود أنابيب التجميع في MongoDB
  • استخدام أداة insertFavorite لحفظ المفضلة فقط عند تأكيد المستخدم

3. نموذج دردشة OpenAI (OpenAI Chat Model)

• النوع: @n8n/n8n-nodes-langchain.lmChatOpenAi
• الوظيفة: يوفّر قدرات فهم وتوليد اللغة للذكاء الاصطناعي
• بيانات الاعتماد: الاتصال بواجهة برمجة تطبيقات OpenAI (OpenAI API)

4. ذاكرة النافذة المؤقتة (Window Buffer Memory)

• النوع: @n8n/n8n-nodes-langchain.memoryBufferWindow
• الوظيفة: الحفاظ على سياق المحادثة
• الإعدادات: الاحتفاظ بنافذة سياقية تحتوي على آخر 10 رسائل

5. أداة MongoDBAggregate (MongoDB Aggregation Tool)

• النوع: n8n-nodes-base.mongoDbTool
• الوظيفة: تنفيذ استعلامات التجميع في MongoDB
• العملية: تجميع (aggregate)
• المجموعة: movies (مجموعة الأفلام)
• هيكل المستند: يحتوي على الحقول التالية:
  • plot: ملخص قصة الفيلم
  • genres: أنواع الفيلم (مصفوفة)
  • runtime: مدة العرض
  • cast: طاقم التمثيل
  • poster: رابط الملصق
  • title: عنوان الفيلم
  • fullplot: القصة الكاملة
  • languages: اللغات
  • released: تاريخ الإصدار
  • directors: المخرجون
  • rated: التصنيف العمري
  • awards: معلومات الجوائز
  • year: السنة
  • imdb: معلومات تقييم IMDb

6. insertFavorite (أداة إدراج المفضلة)

• النوع: @n8n/n8n-nodes-langchain.toolWorkflow
• الوظيفة: استدعاء سير عمل فرعي لإدراج الفيلم المفضل للمستخدم في قاعدة البيانات
• معرّف سير العمل: 6QuKnOrpusQVu66Q (insertMongoDB)
• هيكل البيانات: {"title": "عنوان الفيلم"}

7-8. ملاحظة لاصقة (Sticky Note)

• الوظيفة: تقديم شرح وتوثيق لسير العمل وشرح خطواته

سير العمل

1. استلام الرسالة: يرسل المستخدم استعلامًا متعلقًا بالأفلام عبر واجهة الدردشة
2. تحليل الذكاء الاصطناعي: يحلّل نموذج OpenAI نيّة المستخدم واحتياجاته
3. استرجاع البيانات: يتم استدعاء أداة MongoDBAggregate لاستعلام بيانات الأفلام عند الحاجة
4. تحسين النتائج: يعالج الوكيل الذكي نتائج الاستعلام ويولّد ردًّا ودودًا
5. حفظ المفضلة: إذا أكد المستخدم إعجابه بفيلم معين، يتم استدعاء أداة insertFavorite لحفظه
6. الحفاظ على السياق: تحافظ ذاكرة النافذة المؤقتة على استمرارية المحادثة

علاقات الاتصال

• عند استلام رسالة دردشة → الوكيل الذكي – توصية الأفلام
• نموذج دردشة OpenAI → الوكيل الذكي – توصية الأفلام (نموذج اللغة)
• ذاكرة النافذة المؤقتة → الوكيل الذكي – توصية الأفلام (الذاكرة)
• MongoDBAggregate → الوكيل الذكي – توصية الأفلام (الأداة)
• insertFavorite → الوكيل الذكي – توصية الأفلام (الأداة)

الخصائص التقنية

1. بنية وكيل مستقل: يستطيع الذكاء الاصطناعي اتخاذ قرار مستقل بشأن متى يستخدم أي أداة
2. الحفاظ على السياق: الحفاظ على استمرارية المحادثة عبر ذاكرة النافذة
3. استعلامات مرنة: دعم استعلامات تجميع معقدة في MongoDB
4. تفاعل ثنائي الاتجاه: قادر على كلٍ من قراءة البيانات وكتابتها
5. وصول عام: يمكن استدعاؤه من أنظمة خارجية عبر Webhook

حالات الاستخدام

• روبوت دردشة لتوصية الأفلام
• نظام استعلام ذكي لقاعدة بيانات الأفلام
• إدارة مخصصة لمجموعة الأفلام المفضلة
• مساعد لاسترجاع معلومات الأفلام

الحالة

• الحالة النشطة: true (تم تفعيل سير العمل)
• ترتيب التنفيذ: v1

المكدس التقني

• إطار الذكاء الاصطناعي: LangChain
• نموذج اللغة: OpenAI
• قاعدة البيانات: MongoDB
• المنصة: n8n workflow automation