Table of Contents

Deep Agents هو أول خيار لدي لوكيل عام بنماذج قابلة للتهيئة وإدارة سياق مدمجة. يناسب Claude Agent SDK تضمين سلوك تنفيذ Claude Code. يستحق OpenAI Agents SDK وPydantic AI تجربة للوكلاء الخاصين بالتطبيقات، بينما يفضل Pi نواة صغيرة قابلة للتوسعة ويفضل LangGraph التحكم الصريح في سير العمل.

يعتمد الاختيار الأفضل على العمل الذي ستقبله. يحتاج مساعد البحث ومحرر المستودع وخدمة معالجة طلبات العملاء إلى أدوات وقواعد استرداد مختلفة. هذه التوصيات أحكام تحريرية مستندة إلى الوثائق الرسمية التي فُحصت في 10 أكتوبر 2026، وليست نتائج اختبار أداء عملي.

الخلاصات الرئيسية

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

ما الذي يوفره الإطار

إطار الوكيل هو البرنامج المحيط باستدعاء النموذج. يجهز السياق، ويعرض الأدوات، وينفذ الأفعال الموافق عليها، ويعيد النتائج، ويقرر متى يستمر أو يتوقف. ووفقاً للتنفيذ، يدير أيضاً الذاكرة والتفويضات والأذونات والاسترداد.

يقترح النموذج الفعل التالي. تنفذ الأداة العملية. تشغل بيئة التشغيل سير العمل وتحفظه. تتداخل هذه المسؤوليات في المنتجات المجمعة، لكن فصلها يساعدك على تحديد القدرات الناقصة.

المكوّنالسؤال الذي يجب طرحه
إدارة السياقما المتطلبات التي تبقى خلال التشغيل الطويل؟
تنفيذ الأدواتمن يتحقق من الوسائط ويحد السلطة؟
تخزين الحالةما الذي يبقى بعد إعادة تشغيل العملية؟
التحققما الدليل الذي يثبت اكتمال العمل؟

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

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

القائمة العملية المختصرة

المتطلب الأوليالخيار الأول للتقييمالمسؤولية الرئيسية التي تبقى عليك
وكيل عامDeep Agentsتهيئة الواجهة الخلفية والأذونات والنموذج
Claude Code داخل تطبيقClaude Agent SDKتشغيل عملية التنفيذ وعزلها
سير عمل أدوات لتطبيقOpenAI Agents SDKتعريف الأدوات والموافقات ومعايير القبول
تطبيق Python مقيّد بالأنواعPydantic AI وحزمة Harness التابعة لهااختيار القدرات ومساحة العمل
نواة برمجة قابلة للتضمين وبسيطةPi SDKتجميع الإضافات وسياسة التنفيذ
سير عمل متين وصريحLangGraphتصميم حالة الرسم البياني وسلوك الاسترداد

هذه نقاط بداية مختلفة. يستخدم Deep Agents LangGraph بالفعل، لذلك لا يعني اختياره بالضرورة قراراً ثنائياً. ويفصل Pydantic AI أيضاً بين إطار الوكيل الأساسي وقدرات الإطار المجمعة. قارن مقدار كود التطبيق الذي تحتاج إلى امتلاكه، ولا تعامل كل صف كأنه مكتبة قابلة للاستبدال.

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

Deep Agents: قدرات مجمعة

اختر Deep Agents أولاً لوكيل يعمل عبر الملفات والأدوات والمحادثات الطويلة. يوثق الملخص الرسمي واجهات الملفات الخلفية وتفريغ السياق والتلخيص والوكلاء الفرعيين والموافقة البشرية. وهو مبني على LangChain وبيئة تشغيل LangGraph، مع تكاملات لمزودي نماذج متعددين.

ما زالت التهيئة تحدد السلوك. توضح الوثائق الحالية أن تخطيط المهام اختياري بدءاً من الإصدار 0.7. لا تفترض أن درساً لإصدار أقدم يصف الإعدادات الحالية. سجل إصدار الحزمة والبرمجيات الوسيطة المفعلة في تقييمك.

افحص نطاق الأذونات بعناية. تغطي قواعد نظام الملفات الموثقة أدوات الملفات المدمجة، ولا تغطي أوامر shell العشوائية عبر خلفيات sandbox. رفض أداة ملف غير كافٍ إذا وصل مسار تنفيذ آخر إلى الملف نفسه. اختبر الخلفية وحد shell معاً.

توصيتي: أدرجه في القائمة المختصرة لخدمة تحليل مستندات أو مستودعات حين تريد قدرات مجمعة واختيار المزود. فضل نقطة بداية أصغر حين تتكون المهمة من استدعاءَي API محددين واستجابة متحقق منها. الأدوات الإضافية تضيف سلوكاً إضافياً للتقييم.

Claude: تنفيذ مضمّن

اختر Claude Agent SDK حين تريد وكيل Claude Code داخل تطبيقك. تصف Anthropic مكتبة Python وTypeScript تستخدم حلقة التنفيذ والأدوات وإدارة السياق نفسها الموجودة في Claude Code. يشغل SDK ملف Claude Code الثنائي في عملية تديرها. وهو مختلف عن عميل API الأساسي لدى Anthropic وعن Managed Agents المستضاف. نظرة عامة على Agent SDK .

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

يبقى الاستضافة قراراً هندسياً. تناقش إرشادات النشر لدى Anthropic ضوابط نظام الملفات وقيود الشبكة والعزل. اضبط هذه الأمور حول العملية، ولا تعامل مطالبة الإذن كحد لنظام التشغيل.

توصيتي: قيّمه لأتمتة المستندات أو البرمجة المعتمدة على Claude مع عمل كبير في الملفات والأوامر. اختر بديلاً مرناً تجاه المزود إذا كانت مقارنة النماذج المحلية وعدة مزودين مستضافين متطلباً أساسياً للمنتج.

الخيار المجمعمحور التكامل
Deep Agentsاختيار النموذج والبرمجيات الوسيطة وتهيئة الخلفية
Claude Agent SDKتنفيذ Claude Code داخل عملية تطبيق

OpenAI: سير عمل أدوات التطبيقات

اختر OpenAI Agents SDK لتطبيق منظم حول الدوال والمهام المفوضة والمخرجات الصريحة. يوثق الملخص حلقة الوكيل والتسليمات والضوابط والتتبع وقدرات وكلاء sandbox. SDK واجهة للبناة، وهي مختلفة عن تطبيق Codex للمطورين.

الموافقة سلوك قابل للتهيئة. يصف دليل الإنسان في الحلقة التشغيلات المتوقفة والحالة المتسلسلة للاستئناف بعد القرار. موافقة shell والأدوات التصحيحية المحلية اختيارية. إضافة رد اتصال للموافقة وحدها لا تفعّل شرط الموافقة.

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

توصيتي: أدرجه لخدمة توجد أفعالها المفيدة مسبقاً كدوال تطبيق محددة جيداً. مثلاً، اجلب طلباً، واحسب الأهلية في كود عادي، وأعد طلباً منظماً. أبق التفويض وفحوص الأهلية في التطبيق حتى حين يختار النموذج الأداة التالية.

Pydantic AI: تطبيقات مقيّدة بالأنواع

اختر Pydantic AI حين تكون أنواع Python والمخرجات المتحققة محور تطبيقك. تغطي الوثائق الأساسية الأدوات المقيّدة بالأنواع وحقن الاعتماديات والمخرجات المنظمة وتكاملات التنفيذ المتين. يثبت التحقق البنية المطلوبة للمخرج. ولا يثبت صحة كل حقل.

تضيف حزمة Harness المنفصلة قدرات مجمعة. تشمل وثائقها مكدسات Coder وResearcher ووصول الملفات وshell والذاكرة وتكاملات مساحة العمل. مساحة العمل المحلية وsandbox المعزول خياران مختلفان للتنفيذ. تحتاج قدرات Harness ذات الصلة إلى مساحة عمل بدلاً من اختيار واحدة بصمت.

توصيتي: أدرج الإطار الأساسي لخدمة Python تعيد سجلات مقيّدة بالأنواع. أضف قدرات Harness حين تحتاج المهمة أيضاً إلى استكشاف مساحة العمل أو بحث مفتوح. هذا يمنع خدمة استخراج محدودة من وراثة وصول shell دون حاجة واضحة.

بالنسبة إلى وكيل مراجعة فواتير توضيحي، يتحقق فحص المخطط من أن الإجمالي رقمي وأن العملة ضمن مجموعة مسموحة. يقارن منطق التطبيق المنفصل الإجمالي ببنود السطور ويتحقق من دليل المصدر. ينتمي الفحصان إلى التجربة.

اهتمام التطبيقفحص القبول
مخرج منظمتحقق من الحقول وتحقق مستقلاً من معناها
توقف للموافقةاحفظ الفعل المعلق والقرار الدقيقين
تغيير المزودأعد اختبارات توافق استدعاء الأداة والمخرج

Pi: نواة صغيرة قابلة للتوسعة

اختر SDK الخاص بـ Pi حين تريد تحكماً مباشراً في تنفيذ وكيل برمجة مدمج ومضغوط. تصف وثائق المشروع تكامل SDK وRPC إلى جانب الواجهة التفاعلية. تتكون مجموعة أدواته الافتراضية من القراءة والكتابة والتحرير وتنفيذ shell، مع إضافات لسلوك إضافي.

تنقل البساطة العمل إلى المدمج. يحذف Pi عمداً نوافذ الأذونات المدمجة وتنسيق الوكلاء الفرعيين. توجه وثائقه المستخدمين إلى الحاويات أو الإضافات المخصصة لتدفقات التأكيد. قيّم SDK المدمج هنا، لا واجهة الطرفية مقابل محرر رسومي لمورد آخر.

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

LangGraph: تحكم صريح في سير العمل

اختر LangGraph حين يحتاج سير العمل نفسه إلى حالة وانتقالات صريحة. تميز وثائق الاستمرارية بين نقاط فحص مرتبطة بالخيط ومخازن عابرة للخيوط. يدعم checkpointer مستمر الاسترداد بعد إعادة تشغيل العملية. ولا يدعمه checkpointer داخل الذاكرة.

LangGraph أساس لبيئة تشغيل. أنت تعرف سير العمل وتقرر أين يندرج السلوك المدفوع بالنموذج. يستخدم Deep Agents هذا الأساس بالفعل، لذلك يناسب الانتقال إلى LangGraph حين تحتاج تحكماً مباشراً أكبر في مسارات التنفيذ.

توصيتي: أدرجه لعملية ذات مراحل مسماة وتوقفات مراجعة وقواعد استرداد منفصلة. قد يستخرج سير عمل إدخال المستندات الحقول ويتحقق منها ويطلب المراجعة وينشر سجلاً موافقاً عليه. تفيد الانتقالات الثابتة حين يجب أن يختار النموذج المحتوى دون اختراع عملية العمل.

مرحلة سير العملدليل الاكتمال
الاستخراجسجل مرشح مرتبط بالمصدر
التحققفحوص حتمية واستثناءات
المراجعةقرار مرفق بالمرشح المحدد
النشرإيصال خارجي مسجل مقابل العملية

تحتاج الآثار الخارجية إلى تصميم استرداد خاص بها. لا يجعل حفظ حالة الرسم البياني معاملة خدمة بعيدة ذرية مع نقطة الفحص. استخدم معرف عملية وسوِّ النتيجة الخارجية قبل إعادة إرسال الطلب.

اختبر الأجزاء الناقصة

قائمة الميزات نقطة بداية فقط. مرر كل مرشح عبر إخفاقات تشبه عبء عملك. استخدم مساحة عمل مؤقتة واختبر الخدمات بسجلات اصطناعية.

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

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

افحص الدليل بعد ضغط السياق. ضع متطلباً مهماً مبكراً في المهمة، ثم قدم مادة واقعية كافية لتفعيل استراتيجية السياق المهيأة. اطلب من الوكيل إنتاج أثره النهائي ومراجع المصدر الداعمة. يوضح تحليل CLM وذاكرة الوكيل سبب اختلاف حفظ الملاحظات عن حفظ الدليل الدقيق.

راجع وجهات القياس عن بعد. غالباً ما تحتوي آثار الأدوات ومخازن الذاكرة على بيانات المهمة. سجل الأنظمة التي تستلمها ومدة بقائها. لا يعني استدلال النموذج المحلي أن التسجيل أو الاسترجاع أو التنفيذ محلي فقط.

قارن التكلفة لكل مهمة مقبولة

استخدم مساري تقييم. تضبط المقارنة المتحكم بها النموذج والأدوات ومجموعة المهام والميزانيات حيثما كان الدعم متاحاً. تستخدم مقارنة النشر التهيئة المقصودة لكل مرشح. يعزل الأول بعض آثار البرنامج. ويجيب الثاني عن الإعداد الكامل الأنسب لعملك.

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

# Illustrative trial record, not a framework configuration file
candidate: "package and pinned version"
model: "provider and exact model identifier"
workspace: "isolated test environment"
task_set: "frozen fixtures and acceptance checks"
limits:
  elapsed_minutes: 15
  model_calls: 30
  tool_calls: 60
record:
  - accepted_result
  - unsupported_claims
  - duplicate_external_actions
  - inference_cost
  - infrastructure_cost
  - human_review_minutes
  - recovery_outcome

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

حساب تكلفة توضيحي: افترض أن الإعداد A ينفق 12 دولاراً عبر عشر محاولات وينتج ثماني نتائج مقبولة. تكلفته الاستدلالية لكل مهمة مقبولة 1.50 دولار. ينفق الإعداد B ثمانية دولارات وينتج أربع نتائج مقبولة، لذلك تكلفته المقابلة 2.00 دولار. لا يشمل أي رقم المراجعة البشرية أو البنية التحتية، وهما ضمن إجمالي منفصل مسجل.

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

اتخذ خياراً محدوداً

ابدأ بمرشحين اثنين وسير عمل حقيقي واحد. لوكيل مجمع مرن تجاه المزود، قارن Deep Agents ببديل أضيق يناسب تطبيقك. لسلوك Claude Code داخل خدمة، جرّب Claude Agent SDK. للعمل التطبيقي المقيّد بالأنواع، قارن Pydantic AI مع OpenAI Agents SDK. اختر Pi حين يستحق السلوك المخصص جهد التكامل الإضافي، وLangGraph حين يكون التحكم الصريح في سير العمل هو الأولوية.

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

اختر أصغر نظام يحقق متطلباتك. احتفظ ببيانات التجربة وإصدارات الحزم وسجلات الإخفاق. أعد تشغيلها عند تغيير النموذج أو استراتيجية السياق أو الأدوات أو خلفية التنفيذ. تغيّر هذه التعديلات النظام الذي قيّمته.

المراجع