الذكاء الاصطناعي الفاعل هو نموذج يختار أداة، ويرى النتيجة، ويتخذ خطوة أخرى حتى تكتمل المهمة أو يوقفها شيء ما. روبوت المحادثة لا يصل إلى ذلك الحد. المساعد يطلب منك قبول الخطوة.
الحلقة
يصف Claude Code’s Agent SDK و OpenAI’s function-calling guide نفس الدورة بأسماء أدوات مختلفة.
flowchart LR
prompt[Prompt plus tool list] --> decide[Model responds]
decide --> tools[Host runs tool calls]
tools --> decide
decide --> done[Text, no tool call]
- الاستقبال. النموذج يحصل على الموجه والتعليمات وتعاريف الأدوات والسجل.
- التصرف. يُرجع نصاً أو استدعاءات أدوات أو كليهما. الاستدعاء هو اسم بالإضافة إلى حجج. المضيف ينفذه. النموذج لا ينفذه.
- المراقبة. يرسل المضيف نتيجة الأداة مرة أخرى: طلب، استدعاء، تنفيذ، إرسال النتيجة، الرد التالي.
- التكرار. الدور التالي يمكن أن يغير الأسلوب لأن النتيجة الآن في السياق. Claude Code يتوقف عندما لا توجد استدعاءات أدوات في الرد، ثم يُرجع النص بالإضافة إلى الاستخدام.
- التوقف من الخارج. رفض إذن، أو وضع القراءة فقط، أو موجه بشري، أو أداة لم تربطها.
التخطيط أحياناً يكون وضعاً منفصلاً. وضع Cursor Plan و Claude Code’s plan permission mode تحقق بدون تحرير. توثق تطبيق سطح المكتب ChatGPT /plan قبل /goal عندما تكون ميزة الهدف متاحة.
الأدوات واستدعاء الدوال
على OpenAI API أداة دالة هي مخطط JSON (اسم وصف، معاملات). قد يُرجع النموذج استدعاء. الكود الخاص بك ينفذه ويرسل النتيجة مرة أخرى، مربوطة بهذا الاستدعاء. الأسماء المجهولة لا تعمل. مثال الدليل الصارم يعيّن additionalProperties: false.
تتضمن حلقة Claude Code Read و Edit و Write و Glob و Grep و Bash و WebSearch و WebFetch و Agent. يضيف MCP أدوات. انظر Claude Code cheat sheet. يبحث Cursor Agent ويحرر وينفذ الأصداف ويستخدم الويب وراصد الويب ويمكنه طرح الأسئلة. تنص نظرته على عدم وجود حد لاستدعاءات الأدوات لكل مهمة. يطلب قبل أداة MCP ما لم يسمح له وضع Run Mode.
يحتاج n8n’s AI Agent إلى نموذج محادثة وأداة واحدة على الأقل (سير عمل آخر أو كود مخصص أو HTTP أو خدمة مثل ويكيبيديا). من n8n 1.82.0 منتقي نوع الوكيل القديم لا يُستخدم بعد الآن؛ تتصرف العقد كـ Tools Agent. يترك v1 picker في n8n 3.0. إجراء GPT هو مستند OpenAPI واحد، وقد يضطر المستخدم إلى الموافقة على الاستدعاء.
الذاكرة والتخطيط
- النسخة. تعود الأدوار السابقة ونتائج الأدوات في الطلب التالي. هذا هو السبب في أن المهمة الطويلة تملأ النافذة. توثق تطبيق سطح المكتب ChatGPT
/compactعندما تكون تلك الأوامر متاحة. الذاكرة المحفوظة في ChatGPT هي متجر مختلف: prompting cheat sheet. - الملفات التي يقرأها الوكيل أولاً. يقرأ Codex
AGENTS.mdقبل العمل: ملف عام تحت مجلد Codex الرئيسي (الافتراضي~/.codex)، ثم ملف واحد لكل دليل من جذر المستودع إلى دليل العمل. الملفات اللاحقة تستبدل الملفات السابقة. يتوقف الحجم المدمج عندproject_doc_max_bytesافتراضياً 32 KiB./initينشئ ملف بدء. - ذاكرة n8n. عقد الذاكرة الفرعية تربط فقط بـ AI Agent وليس لسلسلة العقد. Simple Memory يحافظ على شريحة من الجلسة. Redis و Postgres و Motorhead و Xata و Zep هي متاجر البيانات المحفوظة الموثقة. يدرج Chat Memory Manager أو يحمل أو يحذف الرسائل عندما تحتاج إلى خطوة لا توفرها تلك العقد.
- سياق الوكيل الفرعي. يبدأ وكلاء Cursor نظيفاً. يجب على الوالد وضع الحقائق في المسلمة. يمكنك استئناف واحد بواسطة معرّف الوكيل.
وضع Cursor Plan (Shift+Tab أو /plan في CLI) يكتب خطة تحررها قبل البناء. وضع الطلب (/ask أو --mode=ask) لا يحرر. البقية على القراءة فقط حتى تسمح سياسة الموافقة بمزيد من الأشياء.
أنماط متعددة الوكلاء
وكيل واحد، أدوات كثيرة. الافتراضي في Claude Code و Cursor Agent و Codex و n8n Tools Agent. يختار النموذج الأداة التالية. أنت تقرر أي أدوات موجودة.
خطط ثم تصرف. ممر القراءة فقط يكتب الخطوات. قد يحرر ممر ثان. يخزن Cursor الخطة ويتركك تبنيها بعد المراجعة. توثق التطبيق /plan قبل /goal عندما تكون ميزة الهدف متاحة. البوابة بين النية والتحريرات.
وكلاء فرعيون. مهمة جانبية تعمل في سياقها الخاص وتُرجع ملخصاً. يعطي Claude Code كل وكيل فرعي موجهه الخاص وقائمة أدواته ووضع إذنه. حذف tools وسيحصل على كل أداة يمكن للوكلاء الفرعيين استخدامها. tools: ["Read", "Grep", "Glob"] لا يمكنه التحرير. تحسب طلباته نحو حدود الاستخدام ذاتها مثل الوالد. الإعداد هو subagents guide. في وضع plan يبقى الوكيل الفرعي في وضع plan مع استثناء تنصه الأوثاق لزملاء فريق agent-team.
وكلاء Cursor في المقدمة أو الخلفية (is_background: true). readonly: true يسد التحريرات والأصداف التي تغيّر الحالة. يرثون أدوات MCP، باستثناء وكلاء السحابة الذين يستخدمون خوادم الفريق على موقع وكيل Cursor.
يضع n8n الوكيل في سير عمل. الأداة يمكن أن تكون سير عمل آخر، لذا يبقى الرسم البياني خارج النموذج. تسرد قائمة الأدوات مثالاً على “fallback بشري” يستخدم Call n8n Workflow Tool. بناء سير عمل عادي أولاً: first n8n workflow. يمكن لخطافات Claude Code حجب استدعاء أداة قبل تشغيله. هذا منفصل عن وكيل فرعي: hooks guide.
حيث يفشل
استدعاءات الأدوات غير المتطابقة. النموذج ينبعث اسماً وحجج. وصف غامض يُنتج اسماً خاطئاً أو نوعاً سيئاً. يرفض MCP Python SDK نوعاً سيئاً قبل تشغيل الدالة. على API استدعاء دالة خام، هذا الفحص هو لك. JSON طلب وليس إجراء منتهي.
حلقات جامحة. الإيقاف هو “لا مزيد من استدعاءات الأدوات.” توثق نظرة Cursor عدم وجود حد لكل مهمة. تضيف وكلاء فرعيون Claude Code طلبات على نفس مجموعة الاستخدام.
نمو السياق. كل دور يُعيد إرسال السجل. ملف كامل أو سجل طويل يجعل الدور التالي أكبر. سلّم الخطوة الضوضائية إلى وكيل فرعي أو أرجع الأسطر فقط التي تهم.
الثقة المشتركة. خوادم MCP في جلسة واحدة تشارك سياق النموذج، لذا قد يوجّه خادم معيب الأدوات الأخرى. stdio المحلي ليس sandbox. انظر MCP servers explained.
الإفراط الصامت. يمكن لـ Codex workspace-write تحرير وتشغيل الأوامر المحلية داخل مساحة العمل دون موجه. يبدأ الموافقة عندما يجب أن تغادر تلك الحدود أو تستخدم الشبكة.
الحواجز
| التحكم | حيث موثق | ما يوقفه |
|---|---|---|
| موجه إذن | Claude Code default؛ Cursor MCP approval |
يعمل استدعاء فقط بعد شخص أو قاعدة السماح |
| القراءة فقط / خطة | Claude Code plan؛ Codex --sandbox read-only؛ Cursor Ask |
التحريرات |
| Sandbox بالإضافة إلى الموافقة | Codex workspace-write مع on-request أو untrusted أو never |
مغادرة مساحة العمل أو الشبكة أو الأوامر غير الموثوقة حسب الزوج |
| قائمة أدوات ضيقة | وكيل فرعي tools؛ عقد أدوات n8n تربطها |
الاستدعاءات التي لم تربطها مطلقاً |
| Hook أو المراجع | خطافات Claude Code؛ Codex approvals_reviewer = auto_review؛ Cursor Auto-review |
يتم مراجعة الاستدعاء قبل التشغيل |
| خطوة بشرية | Claude Code AskUserQuestion؛ أسئلة Cursor؛ أداة سير عمل n8n |
تنتظر الحلقة |
الوصول الكامل إلى Codex هو danger-full-access بالإضافة إلى approval_policy = never، أيضاً --dangerously-bypass-approvals-and-sandbox. لا تستخدم هذا كافتراضي. codex exec يبدأ القراءة فقط ما لم تمرر --sandbox workspace-write. يحصل الوكيل الفرعي على bypassPermissions فقط عندما تكون جلسة الوالد بالفعل في هذا الوضع.
متى تختار كل واحد
استخدم روبوت محادثة عندما ستنفذ كل أمر بنفسك. prompting cheat sheet كافٍ. استخدم مساعد (Cursor Ask و Codex read-only) عندما تريد اقتراحاً وقبول بشري. استخدم وكيل عندما تكون المهمة البحث والإصلاح والاختبار وقراءة الفشل: Claude Code أو Cursor Agent أو Codex في المستودع أو n8n عندما تكون الخطوات HTTP وخدمات أخرى. استخدم وكيل فرعي عندما تكون خطوة واحدة هي أبحاث ضوضائية والوالد يجب أن يرى الملخص فقط.
مسار الهجرة
- إذا كان المسلّم نصاً توقف. بلا أدوات.
- أضف أداة قراءة فقط واحدة. ارفض الأسماء المجهولة. سجّل كل استدعاء.
- السماح بالتحريرات في دليل واحد فقط. Codex:
--sandbox workspace-write --ask-for-approval on-request. Claude Code: ابقَ علىdefault. Cursor: احتفظ بموجه موافقة MCP. - انقل الخطوة الضوضائية إلى وكيل فرعي للقراءة فقط. ضع القواعس الدائمة في
AGENTS.md. أضف خطاف قبل أي أداة تحذف أو تنشر.
الأسئلة الشائعة
ما هو الفرق بين روبوت المحادثة والوكيل الذكاء الاصطناعي؟
روبوت المحادثة يُرجع نصاً. الوكيل يستدعي أيضاً أدوات، ويقرأ النتيجة، ويختار الخطوة التالية. المساعد يقترح تغييراً توافق عليه. ما يهم هو ما إذا كان المنتج يمكنه التصرف دون موجه جديد.
ما هي حلقة الوكيل؟
النموذج يطلب استدعاء أداة، والمضيف ينفذها، والنتيجة تعود في الدور التالي. يتوقف عندما لا يرسل النموذج استدعاء إضافي، أو عندما توقفه قاعدة إذن أو حد تكلفة. يصف Claude Code SDK: استقبل، وقيّم، وأدوات التنفيذ، وكرر، ثم النتيجة.
كيف يختلف الوكلاء الفرعيون عن وكيل واحد بأدوات كثيرة؟
الوكيل الفرعي له سياقه الخاص وتعليماته وعادةً قائمة أدوات أقصر. يستخدم Claude Code و Cursor هذا الفصل بحيث تبقى نتائج البحث خارج الخيط الأبوي. يرى الوالد الملخص.
لماذا يختلق الوكلاء استدعاءات أدوات أو يستمرون في الحلقة؟
النموذج يختار أداة من وصفها، لذا وصف غامض أو فحص حجة مفقود يُنتج استدعاء يجب عليك رفضه. تستمر الحلقة طالما تستمر الاستدعاءات. توثق Cursor عدم وجود حد على استدعاءات الأدوات لكل مهمة.
هل عقدة AI Agent في n8n هي نفس Claude Code؟
لا. عقدة AI Agent في n8n هي عقدة سير عمل بنموذج محادثة وأداة واحدة على الأقل. Claude Code هو وكيل ترميز بأدوات الملف والبحث والأصداف في مشروع. كلاهما وكلاء، بنماذج إذن مختلفة.
كيف تم التحقق من هذا الدليل
كُتب يدويًا من الوثائق الرسمية، وأُعيد فحص كل أمر، ثم رُوجع مرة ثانية قبل النشر. آخر مراجعة في .
المصادر الرسمية التي قُرئت لهذا المقال
- platform.openai.com/docs/guides/function-calling
- code.claude.com/docs/en/agent-sdk/agent-loop
- code.claude.com/docs/en/sub-agents
- developers.openai.com/codex/sandboxing
- developers.openai.com/codex/agent-approvals-security
- developers.openai.com/codex/guides/agents-md
- cursor.com/docs/agent/overview
- cursor.com/docs/agent/plan-mode
- cursor.com/docs/subagents
- docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/
- docs.n8n.io/build/integrate-ai/understand-ai-components/how-tools-work
- docs.n8n.io/build/integrate-ai/understand-ai-components/how-memory-works

