n8n AI Agent: بناء وكيل ذكاء اصطناعي خطوة بخطوة

n8n AI Agent هو node في n8n بيخلّيك تبني وكيل ذكاء اصطناعي: نموذج لغوي بيفهم رسالة العميل، ويقرر بنفسه يستخدم أنهي أداة (يدوّر في شيت المنتجات، يسجّل أوردر، يبعت تنبيه) ويرد بعدين. يعني بدل workflow ثابت بيمشي نفس الخطوات كل مرة، عندك وكيل بيقرر الخطوة الجاية حسب الموقف. في المقال ده هبنيلك مثال حقيقي خطوة بخطوة: وكيل بيرد على أسئلة المنتجات ويسجّل الطلبات، مع الذاكرة والأدوات والحدود اللي لازم تحطها عشان ما يتحولش لمصدر مشاكل.

أنا أحمد عبدالحميد، ببني أتمتة بـ n8n وApps Script للمتاجر والشركات من سنين، وبشتغل في التسويق والإعلانات من 11 سنة. لو لسه مش عارف يعني إيه وكيل أصلًا، ابدأ بمقال وكيل ذكاء اصطناعي: يعني إيه وإزاي يفيد صاحب بيزنس، وهو بيشرح المفهوم والقرار. أما هنا فالكلام بناء عملي جوه n8n. ولو n8n نفسه جديد عليك، اقرا الأول شرح n8n بالعربي لأن المقال ده بيفترض إنك فاهم يعني إيه workflow وnode.

محتويات المقال

n8n AI Agent إيه بالظبط وإمتى يستاهل؟

الـ n8n AI Agent حاجة مختلفة عن الـ workflow العادي. الـ workflow العادي زي وصفة: خطوة ١ بعدها ٢ بعدها ٣، ومفيش تفكير. الوكيل بياخد هدف (مثلًا: «ساعد العميل يعرف سعر المنتج ويطلبه»)، وبيفكر، وبيختار من الأدوات اللي إنت إدّيتهاله اللي يناسب، وممكن يستخدم أكتر من أداة في نفس الرد.

الفكرة مبنية على نموذج لغوي (LLM) هو العقل، وعلى أدوات بتوصله بالعالم الحقيقي. من غير الأدوات هو مجرد شات بيتكلم من معلومات عامة. مع الأدوات يقدر يقرا من شيتك ويكتب فيه.

إمتى الوكيل أنسب من workflow عادي؟

لما الرسالة غير متوقعة: العميل بيسأل بأسلوب حر، مش بنموذج فورم ثابت.
لما الرد محتاج يدوّر في بيانات الأول (سعر، توفر، مقاس) قبل ما يتكتب.
لما فيه أكتر من مسار ممكن: سؤال، أو شكوى، أو طلب شراء.

وإمتى ما تستخدموش؟

لو العملية ثابتة وواضحة (فورم لشيت لإيميل)، workflow عادي أرخص وأضمن وأسرع. الوكيل بيضيف تكلفة استخدام النموذج وبيضيف احتمال إنه يغلط. فلو مش محتاج مرونة اللغة الحرة، ما تعقّدش الدنيا.

مكونات n8n AI Agent: النموذج والذاكرة والأدوات

الـ node ما بيشتغلش لوحده، بيتوصّل بيه كذا جزء. الأسماء والواجهة بتتغير حسب النسخة، بس المفاهيم ثابتة:

Chat Model: النموذج اللي بيفكر ويكتب. بتختار مزوّد (OpenAI أو Gemini أو Claude أو غيره) وبتحط مفتاح الـ API في بيانات الاعتماد (Credentials) بتاعة n8n. التكلفة بتتحسب من المزوّد حسب الاستخدام، فراجع صفحة أسعاره الرسمية.
Memory: الذاكرة اللي بتخلّي الوكيل يفتكر الرسائل السابقة في نفس المحادثة. من غيرها كل رسالة تتعامل كأنها أول مرة.
Tools: الأدوات اللي الوكيل يقدر يستدعيها، زي قراءة من جوجل شيت أو إضافة صف أو طلب HTTP على API أو تشغيل workflow تاني.
System Message: التعليمات الأساسية اللي بتحدد دوره وأسلوبه وحدوده. دي أهم حاجة في الجودة.
Trigger: اللي بيشغّل الوكيل. ممكن Chat Trigger للتجربة، أو Webhook بيستقبل الرسايل من موقعك أو من منصة المحادثة.

ازاي تبني وكيل بيرد ويسجّل الأوردرات: خطوة بخطوة

المثال: متجر ملابس عنده شيت فيه المنتجات (الاسم، الوصف، المقاسات المتاحة، السعر، الكمية) وشيت تاني للأوردرات. عايزين وكيل يرد على أسئلة العملاء، ولو العميل قرر يطلب، يسجّل الطلب ويطلب منا مراجعة. اتبع الخطوات دي:

جهّز الشيتين. شيت المنتجات بأعمدة واضحة وثابتة، وشيت الأوردرات فاضي بأعمدة: الاسم، الموبايل، المنتج، المقاس، الكمية، الحالة، التاريخ. ممكن تستلهم من شيت أوردرات.
ابدأ workflow جديد في n8n وضيف Chat Trigger للتجربة. بعد ما تتأكد إن كل حاجة تمام، هتبدّله بـ Webhook أو منصة المحادثة اللي عندك.
ضيف AI Agent node ووصّله بالـ Trigger.
اربط Chat Model. اختار المزوّد وأنشئ بيانات الاعتماد بمفتاح الـ API. المفتاح بيتخزن في Credentials مش في الـ workflow ولا في أي شيت مشترك.
ضيف Memory. ابدأ بذاكرة بسيطة بعدد رسائل محدود (نافذة صغيرة)، عشان التكلفة والدقة ما يبوظوش مع المحادثات الطويلة.
ضيف أداة قراءة المنتجات. أداة Google Sheets بعملية قراءة أو بحث في شيت المنتجات. اكتب لها وصف واضح («استخدمها لما العميل يسأل عن سعر أو توفر أو مقاس»)، لأن الوكيل بيقرر يستخدمها بناءً على الوصف ده.
ضيف أداة تسجيل الأوردر. أداة Google Sheets بعملية إضافة صف في شيت الأوردرات، ووصفها يقول «استخدمها بس بعد ما العميل يأكد الاسم والموبايل والمنتج والمقاس والكمية صراحة».
اكتب System Message. ده القلب. فيه دور الوكيل، أسلوب الرد، والحدود (هنفصّلها تحت).
جرّب بسيناريوهات حقيقية وراجع كل نتيجة في تبويب التنفيذ: الوكيل استدعى أنهي أداة وبأنهي مدخلات.
حوّل للإنتاج تدريجيًا. ابدأ بتجربة داخلية مع الفريق، وبعدين نسبة صغيرة من الرسايل، وبعدين وسّع.

كتابة System Message فعّالة

System Message كويس بيجاوب على خمس حاجات: مين أنت (مساعد متجر كذا)، بتساعد في إيه بالظبط، إزاي تتكلم (عامية مهذبة، ردود قصيرة)، إمتى تستخدم كل أداة، وإيه اللي ممنوع. ومثال لجملة حدود: «لو المنتج مش موجود في نتيجة البحث، قول للعميل إنك هتراجع مع الفريق، وماتخترعش سعر ولا توفر». الجملة دي بتحميك من أكبر مشكلة في النماذج اللغوية، وهي الهلوسة لما تجاوب بثقة بمعلومة مش حقيقية.

الذاكرة والأدوات في n8n AI Agent: التفاصيل اللي بتفرق

الذاكرة

الذاكرة بتخلّي العميل يقول «وعايزه بمقاس لارج» والوكيل يفتكر إنه بيتكلم عن القميص الأزرق. المهم تحدد مفتاح الجلسة (Session ID) صح، زي رقم العميل أو معرّف المحادثة، عشان محادثات ناس مختلفة ما تتخلطش. ده خطأ شائع جدًا وأثره خطير: عميل يشوف معلومات عميل تاني. وخلي النافذة محدودة، لأن إدخال كل المحادثة القديمة في كل رد بيزوّد التكلفة وبيشتّت النموذج.

الأدوات

كل أداة لازم يكون ليها اسم واضح ووصف دقيق ومدخلات محددة. الوكيل مش بيشوف الشيت بعينيه، هو بيشوف الوصف اللي كتبته. وصف مبهم يعني استدعاء غلط. ولو عندك عملية معقدة، ممكن تعملها كـ workflow منفصل وتديه للوكيل كأداة، فتفضل المنطق الحساس (حساب شحن، تحقق من مخزون) في خطوات ثابتة مضمونة وما تسيبوش للنموذج يحسبه.

الحدود اللي لازم تحطها قبل ما تطلق الوكيل

أي n8n AI Agent بيتصرف فعلًا، فلازم تتحكم في اللي يقدر يعمله:

صلاحيات أضيق ما يمكن: الأداة تقرأ شيت المنتجات بس، ومتقدرش تمسح أو تعدّل. أداة الأوردرات تضيف صف جديد بس.
تأكيد بشري قبل الإجراءات الحساسة: مثلًا الأوردر يتسجّل بحالة «محتاج مراجعة» ويراجعه حد من الفريق قبل التنفيذ أو الشحن.
سقف على التكلفة والتكرار: حدّد عدد الخطوات الأقصى للوكيل في الرد الواحد، وراقب الاستهلاك عند المزوّد.
رد احتياطي: لو الوكيل مش متأكد أو طلب العميل حاجة برا نطاقه، يحوّل لإنسان.
خصوصية البيانات: ما تبعتش للنموذج بيانات أكتر من اللازم، وراجع القوانين والجهات المنظمة لحماية بيانات العملاء في بلدك، فهي بتختلف من بلد لبلد، وده كلام عام مش استشارة قانونية.
حماية المفاتيح: مفاتيح الـ API في Credentials بتاعة n8n، ومش في شيت مشترك ولا في كود صفحة الموقع.

وعلى واتساب تحديدًا: الرد الآلي والإرسال التسويقي لازم يتم بموافقة العميل وعبر الطرق الرسمية، زي WhatsApp Business Platform بقوالب معتمدة. الأدوات غير الرسمية بتعرّض رقمك للحظر. تفاصيل الفرق في واتساب بزنس API وأتمتة رسايل الواتساب والمخاطر.

جدول: إيه اللي يعمله الوكيل وإيه اللي تسيبه لخطوات ثابتة

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

مثال عملي بأرقام افتراضية

افترض متجر بيستقبل حوالي 60 رسالة يوميًا، والمسؤولة بترد عليها يدويًا وبتفتح شيت المنتجات في كل مرة. افترض إن حوالي ٣ من كل ٤ رسائل أسئلة متكررة (سعر، توفر، مقاسات)، وإن الباقي طلبات وشكاوى. (أرقام توضيحية، مش من متجر بعينه.)

مع الـ n8n AI Agent: الأسئلة المتكررة بيجاوب عليها بالأداة من الشيت مباشرة. الطلبات بيجمع بياناتها وبيسجلها بحالة «محتاج مراجعة»، والمسؤولة تراجعها في مرة واحدة آخر ساعة. الشكاوى بيحوّلها فورًا لها. الوقت المتوفر مش معناه ما فيش مجهود بشري، لكن المجهود بيتحول من الرد على نفس السؤال عشرين مرة إلى مراجعة طلبات وحالات حساسة. وبرضه الأوردرات الموجهة اللي جاية من إعلانات لازم تتابعها كويس، لأن رد سريع من الوكيل ممكن يرفع نسبة تحويل الرسائل لأوردرات، بس مفيش ضمان لنتيجة معينة.

أخطاء شائعة في بناء n8n AI Agent

إدّي الوكيل أدوات كتير من أول يوم. ابدأ بأداتين وزوّد.
System Message عام ومبهم. «كن مفيدًا» مش تعليمات. حدد دور وحدود وأمثلة.
ما تخزنش الأوردر قبل تأكيد صريح. النموذج ساعات بيفهم سؤال العميل كأنه طلب.
تجاهل مراجعة سجل التنفيذ. اقرا المحادثات الحقيقية أسبوعيًا في الأول، وعدّل التعليمات.
الاعتماد على الوكيل في أرقام حساسة. الحسابات المالية في خطوات ثابتة.
نسيان حالة الفشل. لو الأداة فشلت أو الشيت مش متاح، الوكيل لازم يرد بجملة مهذبة ويحوّل لإنسان بدل ما يخترع إجابة.
خلط جلسات العملاء. Session ID لازم يكون مميز لكل عميل.

بدائل ومتى تحتاج مساعدة

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

كيف تختبر الوكيل قبل ما العميل يشوفه

الاختبار هو الفرق بين وكيل بيساعد ووكيل بيحرجك قدام عملاءك. اعمل قايمة من ٢٠ سؤال على الأقل من أسئلة العملاء الحقيقية: أسئلة سعر بأسلوب مختلف، سؤال عن منتج مش موجود، طلب بمقاس ناقص، عميل بيسأل عن حاجة برا نطاق المتجر، وشكوى غاضبة. شغّل كل سؤال، وراجع في سجل التنفيذ الأداة اللي الوكيل استدعاها، والمدخلات اللي بعتها، والرد اللي رجع.

بعدها غيّر التعليمات حسب الأخطاء اللي لقيتها وأعد الاختبار. وقتها ممكن تلاقي إن وصف أداة محتاج تعديل، أو إن الوكيل بيستخدم أداة التسجيل بدري، فتقوّي جملة التأكيد. كرر ده لحد ما النتايج تثبت، وخلّي القايمة دي مرجع تشغّله كل ما تغيّر حاجة في الـ System Message أو تبدّل النموذج.

راقب بعد الإطلاق

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

كمّل القراءة:

ولو عايز تبدأ من workflow جاهز بدل الصفر، إزاي تختاره وتعدّله في قوالب n8n جاهزة.
ولو عايز تشغّل ChatGPT جوه أدواتك بدل الشات، المفتاح والتكلفة والربط في ChatGPT API.
ولو عايز الـ AI يقرا ويكتب في أدواتك بنفسه، الفكرة متشرحة في MCP يعني إيه وإزاي يربط الذكاء الاصطناعي بأدواتك.

أسئلة شائعة

هل n8n AI Agent محتاج برمجة؟

لا في الاستخدام الأساسي: بتوصّل nodes وتكتب التعليمات بالعربي. الكود اختياري في الحالات المعقدة.

مين المزوّد اللي أستخدمه للنموذج؟

أي مزوّد n8n بيدعمه. الاختيار بيتوقف على جودة العربي عندك والتكلفة والخصوصية، فجرّب أكتر من واحد على نفس الأسئلة وقارن. وراجع صفحة الأسعار الرسمية قبل ما تبني.

هل الوكيل ممكن يغلط؟

أيوه، النماذج ممكن تجاوب بثقة بمعلومة غلط. عشان كده الأدوات بتجيب البيانات من مصدرك، والإجراءات الحساسة بتتراجع بشريًا.

الذاكرة بتخزن بيانات العميل لإمتى؟

حسب نوع الذاكرة اللي اخترتها والإعدادات. راجع مكان التخزين ومدته، وماتخزنش بيانات حساسة بلا داعي.

أبدأ بـ n8n سحابي ولا على سيرفري؟

الاتنين ينفعوا. السحابي أسهل في البداية، والاستضافة الذاتية بتديك تحكم أكتر لكن محتاجة صيانة وأمان.

لو عايز وكيل ذكاء اصطناعي مبني على بيانات شغلك ومتظبط بحدود آمنة، ممكن أبنيهولك ضمن خدمة أتمتة الأعمال، أو تبدأ بـ استشارة نحدد فيها أنهي جزء يستاهل يتأتمت الأول.

بناء AI Agent بـ n8n: وكيل ذكاء اصطناعي يشتغل على بياناتك