الوكلاء الثلاثة في n8n: عقدة AI Agent، والوكلاء كمنتج مستقل، وn8n Assistant — أيّهم تستخدم ومتى؟

في n8n (تُنطق "n-eight-n") ثلاثة أشياء مختلفة اسمها «وكيل»، وكل واحد منها يُبنى ويُشغَّل ويُحسَب بطريقة لا تشبه الأخرى. من يقول «الوكيل» بلا تحديد يوصل قارئه — أو يصل نفسه — إلى الغرض الخطأ: يبني وكيلاً داخل سير عمل حين كان يحتاج وكيلاً في مشروعه، أو يظنّ أن n8n Assistant وكيلٌ يعمل وحده، والحقيقة أنه يبني لك سير عمل عادياً ثم يسلّمه إليك.

وهذا المقال عمودُ هذه السلسلة: كل ما يأتي بعده في دليل n8n العربي يشير إلى هنا بدل إعادة الشرح.

⚠️ قبل أن تبدأ الوكلاء في حالة معاينة على كل المنصات: «Agents are in Preview. They can make mistakes, and their behavior may change while the feature is in development.» اقرأ هذا قبل أن تبني عليه شيئاً في الإنتاج، وقبل أن تصدّق أن ما بنيته أمس ما زال يعمل اليوم.

---

لماذا يحدث الالتباس؟ لأن المسميات نفسها تغيّرت ثلاث مرات

السبب الأول أن n8n أعاد تسمية مساعده مرّتين، وكل تسمية تركت أثراً في التوثيق وفي مقالات ومدوّنات قديمة ما زالت تُقرأ.

السلسلة كاملة كما يوثّقها n8n نفسه: AI Workflow Builder ثم AI Assistant ثم n8n Assistant — والجملة الحاسمة في سجلّ الإصدارات: «n8n Assistant supersedes the AI Workflow Builder».

أمّا المواعيد فهي هذه:

• «## n8n Assistant: describe a goal, get a working automation» — أُطلق في 2026-07-09 ضمن n8n 2.29.9.
• «## n8n Assistant on self-hosted n8n: set up in minutes» — 2026-08-18 ضمن n8n 2.35.
• «## Build agents you set up once and use anywhere» — 2026-09-21 ضمن n8n 2.40. هنا وُلدت الوكلاء كمنتجات مستقلة، لا كعقدة داخل سير عمل.

وإعادة التسمية الأخيرة نفسها موثّقة في إعلان المجتمع: «We've renamed it from "AI Assistant" to n8n Assistant» — وهي الجملة التي تشرح لماذا تجد في أدلة قديمة اسماً لا وجود له اليوم.

⚠️ واسمٌ رابع لا علاقة له بالوكلاء: Ask n8n AI «Ask n8n AI is n8n's built-in help assistant and is no longer actively developed.» «The assistant is available on all n8n Cloud plans. It isn't available on self-hosted.» هو مساعدُ مساعدةٍ قديم: يقرأ ما على شاشتك ليشرح لك — «Ask n8n AI has access to all elements displayed on your n8n screen, excluding actual input and output data values (like customer information).» — ولا يبني شيئاً ولا يُشغّل شيئاً. إن قرأتَ في مكان ما «استخدم Ask n8n AI ليبني سير العمل»، فالجملة خطأ في مصدرها لا في فهمك.

القاعدة العملية، وهي جملة واحدة تكفي: حدّد أيّ الثلاثة تقصد قبل أن تبني.

---

الجدول الذي يحسم الأمر: ثلاثة أنواع في ثلاثة أماكن

أسرع طريقة للفهم أن تراها جنباً إلى جنب:

	النوع	أين يعيش	ماذا يُنتج لك	كيف يُستدعى
(أ)	عقدة AI Agent	داخل سير عمل، على اللوحة	لا شيء — هي جزء من سير عملك	عقدة تسبقها تمرّر إليها رسالة
(ب)	وكيل Agent	داخل مشروعك، بجانب سيرَيات العمل	كياناً له مسودة ومنشور وقنوات وجدول زمني ووكلاء فرعيين	رسالة، أو قناة، أو جدول زمني، أو عقدة Message an Agent
(ج)	n8n Assistant	داخل لوحة محادثة	سير عمل عادي تفتحه وتفحصه وتعدّله	أنت، بمحادثة نصية

الفرق الجوهري في سطر واحد: (أ) جزءٌ من مخطّط تكتبه، و**(ب)** كيانٌ له دورة حياة، و**(ج)** مُولِّدٌ لا مُشغِّل. ولهذا لا يصلح أن يُقاسوا بمقياس واحد.

---

(أ) عقدة AI Agent: أبسط الثلاثة وأشدّها قيداً

هي عقدة داخل سير العمل، لا كيان مستقل: «The AI Agent node lets you build an AI agent in n8n. Connect a chat model and one or more tools, and the agent decides which tools to call to complete a task.»

⚠️ شرط واحد غير قابل للتجاوز «You must connect at least one tool sub-node to an AI Agent node.» جرّب أن تحفظ سير عمل وفيه عقدة AI Agent بلا أدوات: لن يعمل. العقدة بلا أداة ليست «وكيلاً يجيب من ذاكرته»، بل حالة بلا معنى. اربط بها عقدة نموذج لغوي وعقدة أداة واحدة على الأقل، ثم ابدأ.

تحذير الإصدار: agent type مهجور، والنسخة v1 ستُزال

«The AI Agent node's agent type setting is deprecated from n8n 1.82.0. All AI Agent nodes now work as a Tools Agent, which was the recommended and most frequently used setting. Workflows or templates using an older AI Agent node set to Tools Agent continue to work as expected.»

«The version of the node (v1) that has the agent type setting will be removed from n8n 3.0. If you're using v1 of the AI Agent node, update to the latest version. For use cases like an SQL Agent, use a Postgres/MySQL tool sub-node with a recent Agent node instead.»

عملياً: إن كنت تستخدم عقدة من النسخات القديمة، طوّرها الآن لا بعد ترقية n8n. و«SQL Agent» لم يعد وضعاً تختاره من قائمة، بل عملٌ تتولّاه عقدة أداة قاعدة بيانات حديثة.

وفي المقابل تطمئنك n8n: «The AI Agent node hasn't changed, and everything you've built with it keeps working.» — أي أن العقدة نفسها لم تتغيّر؛ الجديد هو النوع (ب) لا هذا.

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

---

(ب) الوكلاء كمنتجات مستقلة: لها مسودة ومنشور، وقنوات، وجدول زمني

الجديد ليس اسم العقدة، بل موقعها: «Agents live alongside your workflows as first-class artifacts in your project. Use an agent when work is too open-ended for a fixed workflow, and you need an assistant that can reason about requests, pick the right tools, and adapt to responses.»

كلمة «too open-ended» هي معيار الاختيار الحقيقي. إن كان عملك ثابتاً ومحدّداً، فسيرُ عمل عادي أنضفُ وأرخصُ وأسهلُ صيانة. الوكيل يبدأ حين يتغيّر السؤال، لا حين تتغيّر بقية التفاصيل.

حلقة الاستدلال: لماذا تُكلّفك دورةٌ واحدة أكثر مما تتوقّع

«An agent runs a reasoning loop. When you send it a message, or a schedule triggers it, the agent reads your instructions, looks at the request, and decides what to do next: call a tool, search your knowledge base, hand off to another agent, or ask a follow-up question. It repeats this loop until it produces a final response.»

اقرأ الجملة الأخيرة لا الأولى: يتكرر حتى رد نهائي. هذه الحلقة هي التي تجعل الوكيل يتكيّف، وهي نفسها التي تجعل كل دورة فيها ثمناً حقيقياً في الوقت والتكلفة.

ما الذي يتكوّن منه وكيل؟

الأجزاء التي يعرضها n8n: Model · Instructions · Tools · Web search · Skills · Channels · Schedules · Sub-agents · Knowledge base · Memory

• Instructions هو الموجّه النظامي: دور الوكيل ونبرته وقيوده.
• Skills: «A skill packages instructions with the tools needed for a specific task.» — حزمة سلوك قابلة لإعادة الاستخدام، لا مجرّد نص.
• Sub-agents: «Sub-agents | Other published agents this agent can delegate work to.»
• Knowledge base: «Knowledge base | Files the agent can search and read for context (n8n Cloud, or self-hosted in Preview with a configured sandbox).»
• Memory: «Memory | Session memory keeps the current conversation. Episodic memory recalls context from earlier sessions.» — ذاكرة الجلسة تُبقي الحوار الحالي، والذاكرة القصصية تستحضر ما جرى في جلسات سابقة.

الوكلاء الفرعيون: انتبه لكلمة published

«Sub-agents let this agent hand off work to other published agents. Use sub-agents when a task has clearly separate parts and a specialized agent can handle each part better.»

الوكيل الفرعي يجب أن يكون منشوراً، لا مسودة. هذه من المرات النادرة التي يصبح فيها «انشر» شرطاً في منتصف المسألة لا في نهايتها.

القنوات: ثلاثة موثّقة، ورابع معلَن

صفحة التوثيق تذكر ثلاثة تحت «Available channels:» — Slack وTelegram وLinear. أمّا سجلّ الإصدارات فيذكر «Connect one agent to Slack, Telegram, Linear, or Discord». الطبّق الثلاثة الموثّقة، واعلم أن Discord معلَن في سجلّ الإصدارات وغير موثّق في صفحة القنوات.

---

⚠️ الدرع الذي يحمي نسختك من إنتاجك: المسودة مقابل المنشور

تشغيلُ الإنتاج يستخدم النسخة المنشورة، لا المسودة — وهذه أهم جملة في المقال كلّه.

عقدة Message an Agent هي الجسر بين النوعين: «Use the Message an Agent node to send a message to an agent from a workflow, then use the agent's reply in the nodes that follow. The agent runs its own reasoning loop, calls its own tools and skills, and returns a response to the workflow.»

⚠️ أخطر فخّ هنا «Manual and chat executions use the agent's current draft, so testing always picks up your latest changes.» «Production executions use the agent's published version.» السيناريو: عدّلتَ الوكيل، اختبرته في المحادثة فبدا صحيحاً، ثم نشرتَ سير العمل ونسيتَ أن تنشر الوكيل نفسه. النتيجة أن الإنتاج يتكلّم مع النسخة القديمة — بصمت، بلا خطأ، بلا تنبيه — وأنت تظنّ أنه يكلّم نسختك. القاعدة: تعديل بلا نشر يعني اختباراً بلا أثر. وراجع «Only the published version runs in production» بعد كل تعديل.

ولهذا يأخذ النشر لقطةً كاملة: «Every agent has a draft version and, once you're ready, a published version.» و«Publishing takes a snapshot of the draft, so the running agent doesn't change while you edit.» — أي أن الوكيل العامل لا يتبدّل تحت يدك أثناء تحريرك للمسودة. وهذا بالضبط ما يجعل «انشر بعد الاختبار» ضرورياً لا مستحسناً: لو كانت المسودة هي ما يعمل، لاختبرتَ شيئاً غير ما سيعمل.

المخرجات الستّ التي تستحق انتباهك

«text» (رد الوكيل) · «structuredOutput» (الكائن المطابق لمخططك عندما يكون Require Specific Output Format مفعّلاً، وإلا null) · «usage» (استهلاك الرموز) · «toolCalls» (الأدوات التي استدعاها) · «finishReason» (لماذا توقّف) · «session» (الجلسة التي جُرِي فيها).

وتلميح عملي: «This page describes version 3.1.» — أي أن ما تقرأه عن هذه العقدة يخصّ نسختها 3.1 تحديداً.

الجسر في الاتجاهين

«The node is also available as Message an Agent Tool, so an AI Agent can hand work to one of your agents. Connect it to the Tool input of the AI Agent node»

«An agent can use any workflow as a tool: the agent decides when the workflow runs, and the workflow runs the way you built it, with its own credentials.»

التصريحُ ضعف: الوكيل (ب) يستطيع استدعاء سير عمل، وسير العمل يستطيع استدعاء وكيل. الجسر ثنائي الاتجاه، ولهذا يتكرر السؤال عن الفرق — والجواب أن الاتجاه هو الذي يحدّد من يملك القرار.

---

(ج) n8n Assistant: يبني لك سير عمل، لا وكيلاً

لا، ليس وكيلاً — رغم أن توثيق n8n نفسه يصفه بكلمة agent.

«n8n Assistant is a chat-based agent in n8n that helps you create, edit, test, and troubleshoot workflows from natural language.»

فهذه الجملة وحدها تزرع بذرة الالتباس، ثم الجملة التالية تطرح كل الثقل على الأرض:

«The result is a normal n8n workflow. You can open it, inspect it, edit it, test it, and publish it like any other workflow.»

لا حلقة استدلال، ولا قناة، ولا جدول زمني، ولا مسودة ومنشور. المخرجُ شيء واحد ينتهي عندك: سير عمل. ومَن يتحدّث بعد ذلك هو سير عملك — بأدواته وبيانات اعتماده وحدود معدّله.

وحالة المعاينة صريحة: «n8n Assistant is in Preview. It can make mistakes, and behavior may change while the feature is in development. Always review generated workflows before using them in production.» — ولاحظ أن الجملة الأخيرة إرشادٌ تشغيلي لا نصحٌ عام.

أين يعمل؟

«n8n Cloud: Starter, Pro» · «Self-hosted: Community, Registered Community, Business» «It isn't ready for n8n Cloud Enterprise or self-hosted Enterprise yet.»

⚠️ وهنا تعارضٌ لم نُحسمه: صفحة الأسعار تعرض Assistant (preview) تحت Business وOn request تحت Enterprise، بينما صفحة التوثيق لا تذكر Business أصلاً في القائمة. لن نحسم لك تعارضاً بين صفحتين رسميتين؛ القرار العملي لو كنت على Business: جرّبه.

الفرق الذي يمسّ جيبك

«Agents share the same execution quota as workflows.» — الوكيل (ب) يستهلك من حصّة التنفيذات، وكل دورور له تنفيذ واحد. أمّا n8n Assistant فلا ينفّذ شيئاً لحين أن تنشر ما ولّده؛ فقرارُ النشر يبقى بيدك.

---

⚠️ تعارض الإصدارات: التوثيق يقول 2.32.3… والإطلاق الرسمي كان في 2.40

لا تطبع رقماً واحداً منهما بلا سياق — فهذه من حالات عدم اتّفاق التوثيق مع نفسه.

توثيق n8n يقول إن الوكلاء على الاستضافة الذاتية متاحون من نسخة بعينها: «Self-hosted: All plans from n8n 2.32.3. See Self-hosted for setup details.»

لكن سجلّ الإصدارات يقول إن إطلاق الوكلاء ككائنات مستقلة جاء في: «Released: 2026-09-21 in n8n 2.40» — تحت عنوان المدخل نفسه: «## Build agents you set up once and use anywhere».

والمشكلة المنطقية واضحة: 2.32.3 أقدم زمنياً من 2.40 بتاريخ 2026-09-21، ونسخةُ تصحيحٍ مؤقّتة لا يمكن أن تحمل ميزة أُطلقت في نسخة لاحقة منها.

القراءة الأرجح — وهي تأويلٌ لنا ولا نعدّه حقيقة موثّقة: رقعةُ وحدة الوكلاء وعلم التفعيل وصلا عند 2.32.3، والإطلاق العام جاء بعد ذلك في 2.40. لم نجد ملاحظة إصدار تُثبّت 2.32.3، ولن نخمّن نيابةً عن n8n.

⚠️ كيف تتعامل مع هذا عملياً اكتب ما تقوله الوثائق بلفظها، وأضف تاريخ الإطلاق بجانبها لا تحته: الوحدة متاحة على الاستضافة الذاتية بحسب التوثيق منذ 2.32.3، والإطلاق العام في n8n 2.40 بتاريخ 2026-09-21 بحسب سجلّ الإصدارات. أمّا عملياً فالأمر واحد: حدّث إلى نسخة حديثة، وتحقّق بنفسك من لوحة المشروع عندك.

وتعارضٌ ثانٍ في الصفحة نفسها: النسخة الحالية تقول «Agents are on by default on all plans, including Enterprise.»، بينما نسخة أقدم من هذه الصفحة بالذات كانت تستثني Enterprise. هذه المنطقة من التوثيق غير مستقرة، فاعتمد الأحدث وقل لنا إن رايت غيره.

---

⚠️ الحواجز التي لا يذكرها أحد

هذه الحدود لا تظهر في الفرح، فتكتشفها في منتصف النشر:

• وضع الطابور لا يدعم الوكلاء. «Queue mode isn't supported for agents yet, and connecting channels (such as Telegram) can fail. Run agents in regular mode for now.» — أي أنك لا تستطيع أن تجمع بين الوكلاء وبين بنية التوسّع التي نتناولها في الاستضافة الذاتية. الباب نفسه، من الداخل.
• قاعدة المعرفة على الاستضافة الذاتية ما زالت في معاينة وتحتاج بيئة معزولة مُهيّأة. «Knowledge base | Files the agent can search and read for context (n8n Cloud, or self-hosted in Preview with a configured sandbox).» — تهيئةٌ منفصلة تحتاج عملاً منك، لا خانة تُفعَّل.
• كل دورور مع الوكيل تنفيذ واحد. «One turn with an agent counts as one execution. A turn is a single exchange, where you send the agent a message and it produces a response.» — وهذا يُلغي حساباً شائعاً: حلقة استدلال من عدة دورات ليست تنفيذاً واحداً.
• كل ما في (ب) ما زال في حالة معاينة. «Agents are in Preview. They can make mistakes, and their behavior may change while the feature is in development. On self-hosted, knowledge bases are also in Preview.» — وهذا ليس تنويهاً في الهامش، بل بيان أن سلوك الميزة قد يتغيّر دون إشعار.

---

جدول القرار: أيّهم أستخدم؟

إن كان سؤالك…	فاستخدم
أعرف الخطوات، وأريد سير عمل ثابتاً يستطيع أي شخص قراءته	لا وكيل. سير عمل عادي بعقد If
الخطوات تتغيّر مع كل طلب، وأريد من يقرّر بنفسه أيّ أداة يستدعي	وكيل (ب)
أريد خطوة واحدة داخل سير عملي تتصرّف بذكاء	عقدة AI Agent (أ)
أريد لسير عملي أن يستدعي وكيلاً جاهزاً	Message an Agent + وكيل (ب)
أريد للوكيل أن يردّ عليّ في Slack أو Telegram	وكيل (ب) — بلا وضع طابور
أريد مني أن أبني الأداة، ثم أفحصها بنفسي قبل النشر	n8n Assistant (ج)
أرغب في توسّع أفقيّ بلا سقف تنفيذات معروف	لا شيء مما سبق — احسب التشغيلات أولاً

إن ترددت، ابدأ بـ**(أ)**. عقدة AI Agent أرخص الثلاث في الفهم: كل مخرجاتها على اللوحة أمام عينك، ولا حاجة فيها إلى فهم دورة حياة كيان. وما بنيته بها اليوم يستمر غداً: «The AI Agent node hasn't changed, and everything you've built with it keeps working.»

أما (ب) و**(ج)** فمقياساهما مختلف: (ب) كيانٌ يُستدعى ويُكلّف كل دورور تنفيذاً، و**(ج)** مُولِّدٌ يعطيك ملفاً تتولّاه أنت. وحين يتوقف شرط «هل أعرف خطوات هذا العمل؟» عن أن يكون صحيحاً، تلك هي اللحظة التي تنتقل فيها من (أ) إلى (ب).

---

تحتاج أتمتة تعمل فعلاً؟

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

---

أُراجع في n8n 2.42.5 (2026-10-08). n8n يُصدر نسخاً جديدة أسبوعياً تقريباً، فراجع التوثيق إن كان عمرك يتجاوز بضعة أشهر.