نظرة جانبية على OpenAI Agents SDK وClaude Agent SDK: كيف يشغّل كل منهما حلقة الوكيل، ويتعامل مع التسليم والوكلاء الفرعيين، ويوفّر الأدوات، ويحدّ من المخاطر بالضوابط أو الأذونات، ويحسب التكلفة، مع اختيارات واضحة للمشاريع الحقيقية.
الاختيار بين OpenAI Agents SDK وClaude Agent SDK يبدو أشبه بالتخمين حتى تبني الوكيل الصغير نفسه مرتين. عندها تظهر الفروق بسرعة. أحد الحزمتين يمنحك مجموعة خفيفة من اللبنات الأساسية ويتوقع منك توصيل الباقي. أما الأخرى فتمنحك بيئة تشغيل جاهزة للوكيل تحتوي على الملفات وشل الأوامر والبحث متصلة بها من البداية. لا يفوز أي منهما في المطلق. كل واحد يتفوق في نوع محدد من المشاريع، والاختيار الخاطئ يكلّف أسابيع من إعادة العمل.
يضع هذا المقال الحزمتين جنبًا إلى جنب في الأمور التي تحسم المشاريع الحقيقية: كيف تعمل حلقة الوكيل، وكيف تُبنى إعدادات الأنظمة متعددة الوكلاء، وأي الأدوات تأتي مدمجة، وأي النماذج يمكنك ربطها، وكيف تعمل فحوصات الأمان، وكيف تبدو الفاتورة. وفي النهاية ستحصل على قاعدة بسيطة لحالتك، إضافةً إلى طريقة مجانية لاختبار عائلات النماذج قبل أن تلتزم بأي منها.
💡 تنبيه: تصدر الحزمتان تحديثات كثيرة. تتغير أسماء الفئات والخيارات بين الإصدارات، لذا تعامل مع المفاهيم الواردة أدناه على أنها ثابتة، وتحقّق من الصيغة الدقيقة في وثائق كل مشروع قبل أن تنسخ أي شيفرة.
إذا كنت تريد الحكم قبل الأسباب، فها هو.
| وضعك | الخيار الأنسب | السبب |
|---|---|---|
| وكلاء الدعم أو المبيعات الذين يوجّهون العملاء إلى المختصين | OpenAI Agents SDK | التسليم والضوابط ميزات أساسية |
| وكلاء يقرؤون الملفات ويعدّلونها ويشغّلون الشيفرة | Claude Agent SDK | أدوات الملفات والشل مدمجة |
| تريد حرية تبديل مزودي النماذج | OpenAI Agents SDK | مصمم للعمل مع نماذج أكثر من مزود واحد |
| تريد سلوك Claude Code داخل تطبيقك | Claude Agent SDK | البيئة نفسها والأدوات نفسها |
| مساعدات صوتية أو فورية | OpenAI Agents SDK | دعم الوكلاء الفوريين |
| مهام مستقلة طويلة عبر مستودع كامل | Claude Agent SDK | وكلاء فرعيون، وإدارة للسياق، وأوضاع أذونات |
القاعدة في سطر واحد: اختر OpenAI SDK عندما يكون وكيلك موجِّهًا ومتحدثًا. اختر Claude SDK عندما يكون وكيلك منفّذًا يلمس نظام الملفات.
ما زلت غير متأكد؟ أجب عن هذه الأسئلة الخمسة بصدق:
إذا جاءت ثلاث إجابات أو أكثر في جهة واحدة، فغالبًا هذا هو قرارك. أما النتيجة المنقسمة فتعني أن مشروعك يضم نوعين من العمل، وسيهمك القسم الخاص بالجمع بين الحزمتين.
يحل المشروعان المشكلة الرئيسية نفسها، وهي منح نموذج لغوي أدوات وحلقة عمل، لكن من اتجاهين متقابلين.
OpenAI Agents SDK مكتبة صغيرة تعتمد على الشيفرة، متاحة لـ Python وTypeScript. وهي الخلف الجاهز للإنتاج لتجربة سابقة اسمها Swarm، وتحافظ على روحها: مفاهيم قليلة جدًا، وكلها قابلة للتركيب. اللبنات الأساسية هي:
تكتب دوالًا عادية وتحددها كأدوات، فتولّد الحزمة المخططات من تلميحات الأنواع في شيفرتك. ثم يدور المشغّل في حلقة حتى يُعيد الوكيل إجابة نهائية، أو يسلّم المحادثة، أو يبلغ حد الأدوار.
يحزم Claude Agent SDK، الذي كان يُسمى سابقًا Claude Code SDK، بيئة التشغيل التي تقف خلف Claude Code كمكتبة لـ Python وTypeScript. وبدلًا من تجميع الوكيل من لبنات أولية، تبدأ بوكيل يستطيع أصلًا قراءة الملفات وتعديلها والبحث في الشيفرة وتشغيل أوامر الشل وجلب صفحات الويب. وتوجّهه عبر:
💡 نموذج ذهني: OpenAI SDK هو صندوق قطع. أما Claude SDK فهو ورشة مجهزة تقرّر أنت فيها أي أبواب تُغلق.
تشغّل الحزمتان الدورة الأساسية نفسها: ترسل السياق إلى النموذج، وتقرأ استدعاءات الأدوات، وتنفّذها، وتعيد النتائج، وتكرر حتى ينتهي العمل. والفرق الحقيقي هو مقدار ما تملكه من هذه الدورة.
مع OpenAI SDK تملك أكثر. تختار الأدوات، وتحدد الحد الأقصى للأدوار، وتعرّف شكل المخرج النهائي، وتقرر بدقة أين يحدث التسليم. والحلقة صغيرة بما يكفي لقراءتها في فترة بعد الظهر، وهذا يجعل تصحيح الأخطاء واضحًا: حين ينكسر شيء ما، تشير إلى السطر المسؤول. كما يعتمد على المخرجات المُنمّطة. تعلن مخططًا، فيعود الجواب النهائي ككائن متحقق منه يمكن لتطبيقك استخدامه مباشرة، وهذا مناسب للوكلاء الذين تنتهي مهمتهم ببيانات منظّمة، مثل تصنيف تذكرة أو ملخص طلب.
مع Claude SDK تأتي الحلقة مضبوطة مسبقًا. تتولى بيئة التشغيل نفسها إدارة السياق ومعالجة نتائج الأدوات وإعادة المحاولة التي تشغّل منتج برمجة منشورًا. أنت تهيّئها بدلًا من تجميعها. وهذا يوفّر أيامًا في البداية، لكنه يكلّف بعض الرؤية لاحقًا، لأنك توجّه الوكيل عبر الخيارات والخطافات لا عبر شيفرة الحلقة الخاصة بك. وهي تبث تسلسلًا من الرسائل المُنمّطة: نص المساعد، واستدعاءات الأدوات، ونتائجها، ورسالة نتيجة نهائية تُبلغ عن الاستخدام والتكلفة. وهذا مناسب للوكلاء الذين تنتهي مهمتهم بآثار جانبية، مثل ملفات معدّلة، أو اختبارات ناجحة، أو تقرير مكتوب على القرص.
ينقل التسليم التحكم. يقرأ وكيل الفرز رسالة واردة، ويقرر أنها سؤال عن الفوترة، ثم يمرر المحادثة إلى وكيل الفوترة الذي يتولاها بالسجل الكامل. فكّر في عصا التتابع: عدّاء ينهي مرحلته، وآخر يركض المرحلة التالية.
تدعم الحزمة أيضًا الوكلاء كأدوات. في هذا النمط يحتفظ وكيل المدير بالتحكم، ويستدعي المختصين كدوال، ثم يدمج إجاباتهم. والتسليم يناسب المحادثات التي ينبغي أن ينتهي بها الأمر إلى أن يتحدث المستخدم مع المختص مباشرة. أما الوكلاء كأدوات فيناسبان خطوط المعالجة التي يملك فيها منسّق واحد الإجابة النهائية.
يعمل الوكلاء الفرعيون بطريقة مختلفة. يفوّض الوكيل الرئيسي مهمة إلى مساعد يعمل في نافذة سياق جديدة ولا يعيد سوى ملخص. وهذا أهم مما يبدو. فوكيل بحث فرعي يستطيع قراءة خمسين ملفًا دون أن يملأ ذاكرة الوكيل الرئيسي بها.
تحدد كل وكيل فرعي بوصف قصير، وتعليمات خاصة به، وقائمة محدودة من الأدوات. ويمكن أن يعمل مراجع للقراءة فقط إلى جانب كاتب مسموح له بالتعديل، ولا يتجاوز أيٌّ منهما صلاحيات الآخر.
تعمل الأدوات المستضافة لدى OpenAI، مثل البحث على الويب وبحث الملفات ومفسّر الشيفرة، على جانب OpenAI عبر Responses API. لا تضيف أي بنية تحتية، لكن الوكيل لا يستطيع أيضًا رؤية قرصك. أما الأدوات المدمجة في Claude فتعمل داخل بيئتك. تقرأ ملفاتك، وتعدّل شيفرتك، وتنفّذ الأوامر في الشل الخاص بك. وهذا قوي، ويعني أنه ينبغي أن تشغّل الوكيل داخل حاوية أو بيئة معزولة تثق بها.
| القدرة | OpenAI Agents SDK | Claude Agent SDK |
|---|---|---|
| اللغات | Python، TypeScript | Python، TypeScript |
| اختيار النموذج | OpenAI افتراضيًا، وغيره عبر المحوّلات | نماذج Claude |
| نمط الأنظمة متعددة الوكلاء | التسليم، والوكلاء كأدوات | وكلاء فرعيون بسياق معزول |
| الأدوات المدمجة | البحث المستضاف على الويب، وبحث الملفات، ومفسّر الشيفرة | قراءة الملفات وكتابتها وتعديلها، والشل، والبحث، والويب |
| الأدوات المخصصة | دوال مُزخرفة، وخوادم MCP | خوادم MCP، وأدوات داخل العملية |
| طبقة الأمان | ضوابط إدخال وإخراج | أوضاع أذونات، وخطافات |
| المراقبة | تتبع مدمج | تدفق الرسائل والخطافات |
| مكان تشغيل الأدوات | غالبًا على جانب المزود | جهازك أو حاويتك |
| أشهر ما يُعرف به | التنسيق والصوت | البرمجة المستقلة وعمل الملفات |
تستخدم OpenAI SDK نماذج OpenAI افتراضيًا، لكنها مصممة للتواصل مع مزودين آخرين عبر نقاط نهاية متوافقة ومحوّلات. والجمع بين نموذج أرخص من طرف ثالث للتوجيه ونموذج أقوى للإجابة النهائية إعداد واقعي، وليس حيلة.
تدير Claude SDK نماذج Claude. يمكنك الوصول إليها عبر API الخاصة بـ Anthropic أو عبر منصات السحابة الكبرى التي تقدم Claude، وهذا مفيد عندما تنص قواعد المشتريات على "عدم التعامل مع مزودين جدد". المقايضة حقيقية: بيئة التشغيل والنموذج مضبوطان معًا، ولهذا يعملان بهذه الكفاءة، ولهذا أيضًا لا يمكنك استبدال "العقل".
الحزمتان مكتبتان مجانيتان. فاتورتك هي التوكنات إضافةً إلى أي رسوم للأدوات المستضافة. وحلقات الوكلاء تضاعف استهلاك التوكنات، لأن كل دور يعيد إرسال السياق، لذلك تكلّف عملية من عشرة أدوار أكثر بكثير من عشرة استدعاءات منفردة.
عادات تخفض الفاتورة في الحالتين:
💡 قاعدة عملية: غالبًا ما يكون التصميم الجيد متعدد الوكلاء أقل تكلفة من وكيل عملاق واحد، لأن كل وكيل يحمل سياقًا قصيرًا بدلًا من السجل كله.
تفحص الضوابط ما يدخل وما يخرج. يستطيع ضابط المدخلات أن يرفض رسالة تحاول إخراج الوكيل عن الموضوع أو تسرّب بيانات شخصية. ويستطيع ضابط المخرجات أن يحجب إجابة تخالف سياسة قبل أن يراها المستخدم. وعند تفعيل أحدها يتوقف التشغيل بإشارة واضحة يمكنك معالجتها في الشيفرة. ويمكن أن تعمل فحوصات المدخلات بالتوازي مع استدعاء النموذج الرئيسي، وهذا يبقي زمن الاستجابة منخفضًا.
يركّز Claude SDK على ما يفعله الوكيل، لا على ما يقوله فقط. تختار وضع الأذونات، وتسمح بأدوات محددة أو تمنعها، وترفق خطافات تفحص استدعاء الأداة قبل تنفيذه. ويستطيع الخطاف أن يرفض أي أمر شل يحتوي على نمط مدمّر، أو يسجّل كل كتابة على ملف، أو يطلب موافقة بشرية على خطوة محفوفة بالمخاطر.
اختر بناءً على مخاطرك. إذا كان أسوأ احتمال هو جملة سيئة، فالضوابط هي الأنسب. وإذا كان أسوأ احتمال هو حذف مجلد، فالأذونات والخطافات هي الأنسب.
اختر OpenAI SDK. لديك عدة مختصين مثل الفوترة والشحن والمساعدة التقنية، ومحادثة يجب أن تبقى سلسة حين ينتقل التحكم، وحاجة إلى تصفية البيانات الشخصية. والتسليم والضوابط والتتبع المدمج تتوافق مع هذه القائمة. كما يتيح التتبع لمسؤول الدعم أن يعيد عرض محادثة سيئة خطوة بخطوة.
اختر Claude SDK. ترحيل قاعدة شيفرة، أو إصلاح أخطاء lint عبر مئتي ملف، أو كتابة الاختبارات الناقصة، أو تحويل مجلد من المستندات المبعثرة إلى ملخصات نظيفة، كلها تحتاج إلى وصول حقيقي إلى الملفات وإلى الشل. وإعادة بناء هذه الأدوات فوق حزمة أخرى ممكنة، لكنك ستعيد إنشاء ما يأتي جاهزًا أصلًا.
يصلح الاثنان، والناتج هو الذي يحسم. إذا كان تطبيقك يريد نتيجة منظمة، مثل جدول للمنافسين بصيغة JSON، فإن المخرجات المُنمّطة في OpenAI SDK أنسب. أما إذا كان المطلوب تقريرًا طويلًا يُحفظ على القرص بعد عشرات عمليات البحث وقراءة الملفات، فالوكلاء الفرعيون وأدوات الملفات في Claude SDK أنسب.
هل يمكن استخدام الاثنين معًا؟ نعم، وكثير من الفرق يفعل ذلك. ومن التقسيم الشائع أن يتولى الواجهة الأمامية (التوجيه والضوابط والصوت) OpenAI SDK، ويتولى العامل الثقيل (تغييرات المستودع ومعالجة المستندات) Claude SDK، ويتصل الاثنان عبر خادم MCP أو نقطة نهاية HTTP بسيطة. والثمن هو مجموعتان من السجلات ومجموعتان من الترقيات، لذا لا تقسّم إلا حين تختلف أعباء العمل فعلًا.
قبل أن توصّل أيًا من الحزمتين، تحقق من أن النموذج الأساسي يتعامل مع أوامرك. تستضيف PicassoIA نماذج من العائلتين، لذا يمكنك تشغيل المدخل نفسه عبر كل منهما في مكان واحد ومقارنة النتائج جنبًا إلى جنب.
احتفظ بجدول من ثلاثة أعمدة (الأمر، وإجابة Claude، وإجابة OpenAI) وحدد الفائز في كل صف. إذا فاز أحد الفريقين في معظم الصفوف على بياناتك، فهذا يشير إلى الحزمة المطابقة. وإذا تعادلا، فاختر بناءً على البنية التحتية: المرونة مع المزودين تميل إلى OpenAI، وعمل الملفات يميل إلى Claude.
💡 كن صادقًا بشأن ما يختبره هذا. إنه يختبر النموذج، لا الحزمة. ما زالت حلقة الأدوات والتسليم والأذونات تحتاج إلى تشغيل حقيقي للحزمة. فكّر في PicassoIA كجولة فحص سريعة تمنعك من البناء حول نموذج يسيء قراءة أوامرك.
تحتاج مشاريع الوكلاء إلى صور بقدر أي منتج آخر: رسوم تخطيطية للمعمارية في الوثائق، وصور رئيسية لمنشور الإطلاق، وصورة مصغرة لفيديو العرض. تجمع PicassoIA نماذج تحويل النص إلى صورة وتحويل النص إلى فيديو في مكان واحد، فيمكنك الانتقال من وصف إلى صورة جاهزة في دقائق.
جرّب مشهدًا واقعيًا كالصور الفوتوغرافية مع Seedream 5 Pro للحصول على مخرج حاد ومفصّل، أو مع GPT Image 2 حين تريد تحويل إحاطة مكتوبة مباشرة إلى صورة. صف الموضوع والضوء والعدسة والأجواء، ثم أنشئ عدة اختلافات واحتفظ بالأفضل لديك.
لا تحتاج إلى فريق تصميم. تحتاج إلى وصف واضح وبضع دقائق. افتح PicassoIA، واختر نموذجًا، وأنشئ أول صورة لك اليوم. وإذا جاءت النتيجة الأولى قريبة لكنها غير دقيقة، فغيّر تفصيلًا واحدًا في الأمر وشغّله من جديد. هذه الحلقة من الوصف والتوليد والتعديل هي أسرع طريقة للتعوّد عليها، وهي الحلقة نفسها التي ستضبطها في وكيلك.
اختر لغتك
