دليل وكلاء الذكاء الاصطناعي في n8n: بناء سير عمل ذكية خطوة بخطوة
الفجوة بين "أريد وكيل ذكاء اصطناعي" و"لديّ وكيل ذكاء اصطناعي يعمل فعلاً" تتمثل عادةً في مئات الأسطر من كود Python الرابط. وكلاء الذكاء الاصطناعي في n8n يسدّون هذه الفجوة بمحرر سير عمل مرئي حيث تسحب وتُفلت وتربط وكلاء مدعومة بنماذج اللغة الكبيرة تؤدي مهاماً حقيقية — تبحث في الويب، وتستعلم قواعد البيانات، وترسل البريد الإلكتروني، وتُحدّث جداول البيانات. تكتب موجّهاً للنظام بدلاً من الكود المعياري للإطار.
يرشدك هذا الدليل خلال بناء سيرَي عمل وكلاء حقيقيَّين من الصفر: وكيل بحث على الويب وبوت دعم عملاء مزوّد بذاكرة. بنهاية الدليل، ستفهم كل نوع من عقد الوكلاء التي تحتاجها وكيفية تنسيقها معاً.
ما هو n8n (ولماذا استخدامه لوكلاء الذكاء الاصطناعي)؟
n8n منصة أتمتة سير عمل مفتوحة المصدر — تخيّلها مثل Zapier لكن مع إمكانية الاستضافة الذاتية وفلسفة "كود عند الحاجة". تربط أكثر من 500 خدمة عبر محرر مرئي قائم على العقد.
ما يجعل n8n مثيراً للاهتمام تحديداً لوكلاء الذكاء الاصطناعي هو التكامل الأصلي مع LangChain. بدلاً من كتابة كود Python لـ LangChain، تُهيّئ نفس المفاهيم (الوكلاء، والأدوات، والذاكرة، والنماذج) كعقد مرئية. تتولى عقدة AI Agent حلقة التفكير — أنت تربط فقط ما يجب أن يفكر به وما يمكنه فعله.
لماذا تختار n8n على الكود الخالص؟
- تصحيح أخطاء مرئي: ترى بالضبط أين تنكسر سلسلة تفكير الوكيل
- أكثر من 500 تكامل تصبح أدوات وكيل فورية (Slack وGmail وGoogle Sheets وقواعد البيانات)
- استضافة ذاتية مجانية (Community Edition) أو n8n Cloud بدءاً من 20 دولاراً شهرياً
- دعم MCP يتيح لسير عمل n8n أن تصبح أدوات لوكلاء الذكاء الاصطناعي الخارجية والعكس صحيح
إذا كنت تقيّم أطر عمل وكلاء مختلفة مثل LangGraph وCrewAI وOpenAI Agents SDK، فإن n8n ينتمي إلى فئة مختلفة — إنه للأشخاص الذين يريدون وكلاء جاهزين للإنتاج دون إدارة بيئة Python.
كيف تعمل عقدة AI Agent في n8n
كل سير عمل لوكيل ذكاء اصطناعي في n8n له هيكل هرمي. عقدة Agent في المركز، وتتصل العقد الفرعية أسفلها لتوفير القدرات.
<!-- IMAGE: n8n AI agent node architecture diagram showing trigger, agent, model, tools, and memory connections -->إليك التشريح التفصيلي:
| المكوّن | ما يفعله | عقد مثال |
|---|---|---|
| Trigger | يبدأ سير العمل | Chat Trigger وWebhook وSchedule |
| AI Agent | محرك التفكير (حلقة ReAct) | Tools Agent وOpenAI Functions Agent |
| Chat Model | نموذج اللغة الكبير المحرّك للتفكير | OpenAI GPT-4o وAnthropic Claude وOllama |
| Tools | الإجراءات التي يمكن للوكيل تنفيذها | HTTP Request وCalculator وSerpAPI وCode |
| Memory | سياق المحادثة عبر الدورات | Window Buffer وPostgres وRedis |
| Output | وجهة النتائج | Respond to Webhook وSend Email وUpdate Sheet |
Tools Agent هو الوكيل الذي ستستخدمه في 90% من الحالات. إنه أكثر أنواع الوكلاء مرونةً — يأخذ موجّهك، يفكر في الأدوات التي يجب استدعاؤها، ينفّذها، ويكرر حتى يحصل على إجابة. تحت الغطاء، يشغّل حلقة ReAct (Reason + Act): فكّر، تصرّف، راقب، كرّر.
تقدّم n8n أيضاً وكلاء متخصصة — SQL Agent لاستعلامات قواعد البيانات، وPlan and Execute Agent الذي يقسّم المهام إلى خطوات فرعية، وConversational Agent لتدفقات الدردشة الأبسط. لكن Tools Agent يغطي معظم حالات الاستخدام.
ما تحتاجه قبل البدء
قبل بناء أي شيء، رتّب هذه الأمور الثلاثة:
- نسخة n8n — إما التسجيل في n8n Cloud (20 دولاراً شهرياً - Starter) أو الاستضافة الذاتية باستخدام Docker:
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n-
مفتاح API لنموذج اللغة الكبير — OpenAI أو Anthropic أو Google Gemini. يمكنك أيضاً استخدام Ollama للنماذج المحلية المجانية، رغم أن أداء استدعاء الأدوات يتفاوت.
-
مفتاح API للأداة (اختياري) — SerpAPI للبحث على الويب (50 دولاراً شهرياً) أو Brave Search API (مستوى مجاني). يمكنك بناء وكلاء دون بحث، لكنه الأداة الأولى الأكثر شيوعاً.
بمجرد تشغيل n8n، افتح http://localhost:5678 (الاستضافة الذاتية) أو لوحة تحكم السحابة. أنشئ سير عمل جديداً وأنت جاهز.
بناء الوكيل الأول: وكيل بحث على الويب
هذا الوكيل يأخذ موضوعاً، يبحث على الويب، يقرأ النتائج، ويكتب ملخصاً منظّماً. إنه "مرحباً بالعالم" لوكلاء الذكاء الاصطناعي في n8n ومفيد حقاً لأبحاث المحتوى.
الخطوة الأولى: إضافة Manual Trigger
انقر على + وابحث عن "Manual Trigger". أسقطه على اللوحة. هذا يتيح لك اختبار سير العمل بالنقر على "Test Workflow" — ستستبدله لاحقاً بـ webhook أو chat trigger.
الخطوة الثانية: إضافة عقدة Edit Fields
أضف عقدة Edit Fields بعد المُشغّل. اضبط حقلاً يُسمى topic بقيمة نصية مثل "أحدث التطورات في Model Context Protocol". هذا يحاكي إدخال المستخدم.
الخطوة الثالثة: إضافة عقدة AI Agent
ابحث عن "AI Agent" وأضفها. اختر Tools Agent كنوع الوكيل.
في حقل System Message، اكتب موجّهاً يحدد السلوك:
You are a research assistant. When given a topic:
1. Search the web for the latest information
2. Read at least 3 different sources
3. Write a structured summary with:
- Key findings (bullet points)
- Notable quotes or data points
- Sources used
Be specific. Include dates, names, and numbers when available.
Do NOT make up information. If search results are unclear, say so.تحت Prompt، اضبط التعبير: {{ $json.topic }} — هذا يسحب الموضوع من عقدة Edit Fields.
الخطوة الرابعة: ربط Chat Model
انقر على + أسفل عقدة Agent لإضافة عقدة فرعية. اختر OpenAI Chat Model (أو أي نموذج لغة كبير تستخدمه).
هيّئها:
- Model:
gpt-4o(أوgpt-4o-miniللتشغيلات الأرخص) - Temperature:
0.3(أقل = أكثر واقعية، أقل إبداعاً)
ألصق مفتاح API الخاص بك في قسم بيانات الاعتماد.
الخطوة الخامسة: إضافة أداة البحث
انقر على + مرة أخرى لإضافة عقدة فرعية للأداة. اختر SerpAPI (أو HTTP Request Tool إذا أردت الوصول إلى API بحث مخصص).
لـ SerpAPI:
- أضف مفتاح API الخاص بك كبيانات اعتماد
- سيستدعي الوكيل هذه الأداة عندما يقرر أنه يحتاج للبحث
كبديل مجاني، استخدم HTTP Request Tool المُهيّأ لـ Brave Search API:
URL: https://api.search.brave.com/res/v1/web/search
Method: GET
Query Parameters: q={{ $fromAI("query", "search query") }}
Headers: X-Subscription-Token: YOUR_BRAVE_KEYتعبير $fromAI() هو السحر — يخبر الوكيل "أنت تقرر أي قيمة تمرر هنا."
الخطوة السادسة: الاختبار
انقر على Test Workflow. راقب لوحة التنفيذ على اليمين. سترى:
- الوكيل يستقبل الموضوع
- يقرر البحث (استدعاء أداة)
- SerpAPI يُعيد النتائج
- الوكيل يُفكّر في النتائج
- قد يبحث مرة أخرى للحصول على مزيد من التفاصيل
- يُنتج ملخصاً نهائياً
إذا كان الوكيل يدور في حلقة دون تقارب، فمن المرجح أن موجّه النظام يحتاج إلى تعليمات أكثر دقة. أخبره بالضبط متى يتوقف عن البحث.
<!-- IMAGE: n8n workflow canvas showing completed research agent with connected nodes -->بناء الوكيل الثاني: بوت دعم عملاء بذاكرة
وكيل البحث كان عديم الحالة — ينسى كل شيء بعد كل تشغيل. بوت دعم العملاء يحتاج إلى تذكّر المحادثة. هنا يأتي دور ذاكرة الوكيل.
الخطوة الأولى: استخدام Chat Trigger
هذه المرة، ابدأ بعقدة Chat Trigger بدلاً من Manual Trigger. هذا يمنحك أداة الدردشة المدمجة في n8n لاختبار المحادثات.
الخطوة الثانية: تهيئة الوكيل
أضف عقدة Tools Agent. موجّه النظام:
You are a customer support agent for a SaaS project management tool called "TaskFlow."
Rules:
- Always greet the user by name if provided
- Check the knowledge base before answering questions
- If you cannot find an answer, say: "Let me connect you with a human agent"
- Never make up features or pricing that you don't find in the knowledge base
- Keep responses concise (2-3 sentences max unless the user asks for detail)
Available tools:
- Knowledge base search: use this for product questions
- Ticket creation: use this when the user reports a bug or requests a featureالخطوة الثالثة: إضافة الذاكرة
انقر على + في Agent لإضافة عقدة فرعية واختر Window Buffer Memory.
- Context Window Length:
10(يتذكر آخر 10 أزواج من الرسائل) - Session ID:
{{ $json.sessionId }}(من chat trigger)
هذا هو خيار الذاكرة الأبسط — يحتفظ بالرسائل الأخيرة في نافذة متحركة. للبوتات الإنتاجية التي تحتاج ذاكرة دائمة عبر الجلسات، استخدم Postgres Chat Memory أو Redis Chat Memory بدلاً من ذلك. يغطي دليلنا حول أفضل أدوات ذاكرة وكلاء الذكاء الاصطناعي المفاضلات بين هذه المقاربات.
الخطوة الرابعة: إضافة الأدوات
أضف عقدتين فرعيتين للأدوات:
الأداة 1 — قاعدة المعرفة (Vector Store QA): إذا كان لديك وثائق المنتج في مخزن متجهات (Pinecone أو Qdrant أو Supabase)، استخدم Vector Store Question Answer Tool. هذا في جوهره RAG (Retrieval-Augmented Generation) في عقدة واحدة.
الأداة 2 — إنشاء التذاكر (HTTP Request): أضف HTTP Request Tool مُهيّأً للإرسال إلى API التذاكر الخاصة بك:
URL: https://api.yourapp.com/tickets
Method: POST
Body (JSON):
{
"title": "{{ $fromAI('title', 'ticket title') }}",
"description": "{{ $fromAI('description', 'issue description') }}",
"priority": "{{ $fromAI('priority', 'low, medium, or high') }}"
}الخطوة الخامسة: اختبار المحادثة
انقر على Test Workflow وافتح لوحة الدردشة. جرّب محادثة متعددة الأدوار:
- "مرحباً، أنا Alex. كيف أُصدّر مهامي إلى CSV؟"
- "وماذا عن تصدير PDF؟"
- "في الواقع، تصدير PDF لا يعمل معي — هل يمكنك الإبلاغ عن خلل؟"
راقب كيف يبحث الوكيل في قاعدة المعرفة للسؤالين الأولين وينشئ تذكرة للثالث. عقدة الذاكرة تضمن تذكّره لاسم Alex وسياق مشكلة PDF.
استخدام MCP لتوسيع وكلائك
n8n يدعم الآن Model Context Protocol (MCP) في الاتجاهين — وهنا تصبح الأمور قوية حقاً.
استهلاك خوادم MCP: أضف العقدة الفرعية MCP Client Tool إلى وكيلك. وجّهها إلى أي رابط لخادم MCP وسيكتشف الوكيل تلقائياً جميع الأدوات التي يُعرضها ذلك الخادم ويمكنه استدعاؤها. عقدة واحدة، عشرات الأدوات.
تعريض سير العمل كأدوات MCP: استخدم عقدة MCP Server Trigger لتحويل أي سير عمل n8n إلى أداة متوافقة مع MCP. بعد ذلك يمكن للوكلاء الخارجية العاملة في Claude Desktop أو Cursor أو VS Code اكتشاف سير عمل n8n واستدعاؤها. ابنِ سير عمل "إرسال إشعار Slack" مرة واحدة وكل وكيل متوافق مع MCP في مكدسك يمكنه استخدامه.
يحوّل دعم MCP ثنائي الاتجاه هذا n8n إلى مركز للوكلاء — وكلاؤك في n8n يستدعون أدوات خارجية عبر MCP، والوكلاء الخارجية تستدعي سير عمل n8n عبر MCP.
نصائح عملية لوكلاء n8n أفضل
بعد بناء عشرات سير عمل الوكلاء، إليك ما يهم فعلاً:
احتفظ بعدد الأدوات منخفضاً. يرتبك الوكلاء مع أكثر من 5–7 أدوات. إذا احتجت المزيد، أنشئ "وكيل مدير" يُفوّض إلى "وكلاء عمال" متخصصة — n8n يدعم سير عمل من وكيل إلى وكيل.
كن توجيهياً في موجّهات النظام. لا تقل فقط "ساعد المستخدم". حدّد قواعد دقيقة وتنسيقات الإخراج ومتى تستخدم كل أداة. كلما كان موجّهك أكثر تحديداً، قلّت استدعاءات الأدوات المفاجئة.
اضبط حدود الرموز. في تهيئة Chat Model، اضبط حداً أقصى للرموز. بدونه، يمكن لوكيل مرتبك استنزاف ميزانية API الخاصة بك في حلقة واحدة.
استخدم عقد معالجة الأخطاء. أضف سير عمل Error Trigger يلتقط الأعطال ويُخطرك عبر Slack أو البريد الإلكتروني. وإلا فسيفشل الوكلاء بصمت.
اختبر بالحالات الحدية أولاً. اسأل وكيلك عن شيء لا يجب أن يعرفه. إذا هلوَس بدلاً من قول "لا أعرف"، فإن موجّهك يحتاج إلى ضوابط.
سجّل كل شيء أثناء التطوير. مكّن تسجيل التنفيذ (متاح في خطة Pro أو الاستضافة الذاتية) حتى تتمكن من إعادة التشغيل وتصحيح الأخطاء بالضبط أين أخطأ الوكيل.
متى يكون وكلاء n8n مناسبين (ومتى لا يكونون)
n8n خيار جيد إذا:
- أردت وكلاء إنتاجية دون إدارة بنية تحتية Python
- كانت سير عملك تربط أدوات SaaS متعددة (Slack وGmail وNotion وقواعد البيانات)
- تضمّن فريقك غير المطورين الذين يحتاجون إلى تعديل سلوك الوكيل
- احتجت تصحيح أخطاء مرئي لسلاسل تفكير الوكيل
n8n على الأرجح الخيار الخاطئ إذا:
- احتجت تحكماً دقيقاً في معماريات الوكلاء (استخدم LangGraph أو CrewAI بدلاً من ذلك)
- كان وكيلك حوسبياً بحتاً (خط أنابيب تعلم الآلة، معالجة البيانات) بدون تكاملات
- كنت تبني نظام بحث متعدد الوكلاء مع إدارة حالة معقدة
لـحالات استخدام أتمتة الأعمال — بوتات دعم العملاء ووكلاء معالجة البيانات والمساعدين البحثيين وتأهيل العملاء المحتملين — يصل n8n إلى نقطة التوازن المثلى بين القوة وسهولة الاستخدام.
الأسئلة الشائعة
ما نماذج اللغة الكبيرة التي يدعمها n8n لوكلاء الذكاء الاصطناعي؟
يدعم n8n: OpenAI (GPT-4o وGPT-4 وGPT-3.5) وAnthropic Claude (عائلة Claude 3.5 و4) وGoogle Gemini وMistral وCohere ونماذج HuggingFace والنماذج المحلية عبر Ollama. تُبدّل النماذج بتغيير عقدة فرعية واحدة فقط — دون أي تغييرات في سير العمل.
هل n8n مجاني لبناء وكلاء الذكاء الاصطناعي؟
Community Edition ذاتية الاستضافة مجانية تماماً بلا حدود للتنفيذ. n8n Cloud يبدأ من 20 دولاراً شهرياً (Starter) مع 2500 تنفيذ. ستدفع أيضاً لمزوّد نموذج اللغة الكبير (OpenAI أو Anthropic وما إلى ذلك) بشكل منفصل لاستدعاءات API.
كيف يُقارن وكيل الذكاء الاصطناعي في n8n بكتابة الوكلاء بـ Python؟
n8n يتبادل التخصيص مقابل السرعة. وكيل Python مع LangChain يمنحك تحكماً كاملاً في كل خطوة تفكير. n8n يمنحك 80% من تلك القدرة في 20% من الوقت، مع تصحيح أخطاء مرئي وأكثر من 500 تكامل مدمج. اختر Python للبحث أو المعماريات الجديدة؛ واختر n8n لأتمتة الأعمال.
هل يمكن لوكلاء n8n استخدام أدوات مثل البحث على الويب وقواعد البيانات؟
نعم. يمكن لوكلاء n8n استخدام أي أداة متاحة كعقدة — SerpAPI وBrave Search وHTTP Request (لأي API) وقواعد بيانات SQL وGoogle Sheets وSlack والمئات غيرها. تُضيفها كعقد فرعية أسفل عقدة Agent.
ما هي MCP Client Tool في n8n؟
MCP Client Tool تربط وكيلك في n8n بخوادم MCP (Model Context Protocol) الخارجية. يكتشف وكيلك تلقائياً جميع الأدوات التي يُعرضها ذلك الخادم ويمكنه استدعاؤها أثناء التفكير. إنها عقدة واحدة يمكنها فتح عشرات الأدوات الخارجية.
كيف أُضيف ذاكرة لوكيل الذكاء الاصطناعي في n8n؟
أضف عقدة فرعية للذاكرة أسفل عقدة Agent الخاصة بك. Window Buffer Memory هو الخيار الأبسط (يحتفظ بآخر N رسالة). للذاكرة الدائمة عبر الجلسات، استخدم Postgres Chat Memory أو Redis Chat Memory أو Zep Memory. اضبط معرّف جلسة لتتبع المحادثات الفردية.
هل يمكنني ربط وكلاء متعددين في n8n؟
نعم. يدعم n8n سير عمل من وكيل إلى وكيل حيث يُفوّض وكيل "المدير" المهام إلى وكلاء "عمال" متخصصة. تبني كل عامل كسير عمل فرعي منفصل وتربطها عبر أداة Call n8n Workflow.
ما الفرق بين Tools Agent وأنواع الوكلاء الأخرى؟
يستخدم Tools Agent حلقة تفكير ReAct ويعمل مع أي أداة. يستخدم OpenAI Functions Agent API استدعاء الوظائف الأصلي من OpenAI (أسرع قليلاً لكن حصراً لـ OpenAI). SQL Agent متخصص في استعلامات قواعد البيانات. Plan and Execute Agent يُقسّم المهام المعقدة إلى خطوات فرعية. ابدأ بـ Tools Agent لمعظم حالات الاستخدام.
كيف أنشر وكيل n8n في بيئة الإنتاج؟
للاستضافة الذاتية: استخدم Docker Compose مع PostgreSQL وRedis، وفعّل وضع قائمة الانتظار للتوسع الأفقي، وضعه خلف وكيل عكسي مع SSL. للسحابة: فعّل سير العمل فقط — n8n يتولى البنية التحتية. في كلتا الحالتين، استبدل Chat Trigger بـ Webhook trigger حتى تتمكن التطبيقات الخارجية من استدعاء وكيلك.
هل يمكن لوكلاء n8n معالجة تحميل الملفات والصور؟
يمكن لـ n8n معالجة الملفات عبر معالجة البيانات الثنائية. يمكنك بناء وكلاء تستقبل تحميلات الملفات عبر webhook، وتستخرج النص (باستخدام عقدة Code مع محلل PDF، مثلاً)، وتُفكّر في المحتوى. يعتمد تحليل الرؤية/الصور الأصلي على ما إذا كان نموذج اللغة الكبير الخاص بك يدعم الإدخال متعدد الوسائط (GPT-4o يدعم ذلك، على سبيل المثال).