OpenAI Agents SDK

يُعد OpenAI Agents SDK إطار العمل الرسمي بلغتي Python و TypeScript من OpenAI لبناء تطبيقات الوكلاء المتعددين الجاهزة للإنتاج. أُصدر في 15 مارس 2025، ليحل محل Swarm، وهو النموذج الأولي التجريبي السابق للتنسيق من OpenAI، ويتوفر كمكتبة مجانية بترخيص MIT على PyPI و npm. يعمل SDK جنبًا إلى جنب مع Responses API من OpenAI ويمنح المطورين طريقة منظمة لتحديد الوكلاء، وربطهم بالأدوات، وتسليم المهام فيما بينهم، والتحقق من مدخلاتهم ومخرجاتهم قبل أن يصل أي شيء إلى المستخدم.

تُعد الأساسيات الجوهرية بسيطة عن قصد: الوكلاء (نماذج لغوية كبيرة LLMs تُعطى تعليمات وأدوات)، وعمليات التسليم (التوجيه من وكيل إلى آخر بناءً على القصد)، وحواجز الحماية (التحقق من المدخلات والمخرجات والذي يمكنه إيقاف التنفيذ أو إعادة توجيهه)، والتتبع (تصور مدمج لسير العمل من أجل تصحيح الأخطاء والمراقبة). وإلى جانب ذلك، يدعم SDK تكامل خادم Model Context Protocol (MCP)، وإدارة الجلسات المستمرة، وبوابات الموافقة التي تتطلب تدخلًا بشريًا (human-in-the-loop)، والوكلاء الصوتيين عبر Realtime API باستخدام gpt-realtime-1.5، واعتبارًا من تحديث أبريل 2026، وكلاء Sandbox الذين يمكنهم تنفيذ التعليمات البرمجية، وفحص الملفات، وتشغيل الأوامر داخل بيئات حاويات معزولة.

ما يفعله OpenAI Agents SDK فعليًا في مايو 2026

وصل إصدار Python SDK إلى v0.15.1 (الصادر في 2 مايو 2026) مع 92 إصدارًا إجماليًا وأكثر من 25,800 نجمة على GitHub منذ إطلاقه. أما إصدار TypeScript، الذي أُضيف في يونيو 2025، فقد وصل إلى v0.8.5 في أبريل 2026. كلاهما مرخص بموجب MIT ويعملان مع Responses API من OpenAI بالإضافة إلى أي نقطة نهاية متوافقة مع Chat Completions، مما يعني أنه يمكن للمطورين التوجيه إلى نماذج غير تابعة لـ OpenAI من خلال LiteLLM أو محولات مشابهة.

يتطلب الوكيل البسيط في Python أربعة أسطر من التعليمات البرمجية. يتم تعريف الوكلاء باسم، ومجموعة من التعليمات، وقائمة اختيارية من الأدوات. يتولى استدعاء Runner.run_sync() معالجة حلقة الوكيل بالكامل: استدعاء النموذج، ومعالجة استدعاءات الأدوات، وإدارة عمليات التسليم، وإرجاع المخرجات النهائية. يسجل نظام التتبع كل خطوة تلقائيًا ويعرضها في لوحة تحكم مرئية مرتبطة بمنصة OpenAI.

قدم تحديث Sandbox Agents في أبريل 2026 التنفيذ القائم على الحاويات: يمكن للوكلاء الآن فحص الملفات، وتشغيل أوامر الصدفة (shell)، وتطبيق تصحيحات التعليمات البرمجية، وتثبيت الحزم، ونقل حالة مساحة العمل عبر مهمة أطول. تتوفر هذه الميزة حاليًا في Python SDK فقط، مع إدراج دعم TypeScript كميزة مخطط لها ولكن دون جدول زمني محدد. استعرض التحديث نفسه "الوكلاء الفرعيين" (تقسيم المهام المتوازية تحت وكيل أساسي) و "وضع التعليمات البرمجية"، وكلاهما لا يزال على خارطة الطريق وقت كتابة هذا التقرير.

يعني دعم خادم MCP أن أي أداة مكشوفة من خلال Model Context Protocol تتصل بـ SDK بنفس الطريقة التي تعمل بها أداة الوظيفة، مما يمنح Agents SDK إمكانية الوصول إلى نظام MCP البيئي المتنامي دون الحاجة إلى أعمال تكامل مخصصة. تتوفر الأدوات المستضافة من OpenAI، بما في ذلك البحث في الويب، والبحث في الملفات، ومفسر التعليمات البرمجية، بشكل أصلي ولكنها تربط بيانات الوكيل بتخزين منصة OpenAI.

موقع Agents SDK مقارنةً بـ LangGraph و Anthropic Claude Agent SDK

يُعد LangGraph البديل المعماري الأقرب للفرق التي تبني مسارات عمل معقدة. فهو يستخدم نموذج الرسم البياني الموجه: الوكلاء هم العقد، وتتحكم الحواف الشرطية في انتقالات الحالة، ويدعم إطار العمل مسارات العمل الدورية، وتصحيح الأخطاء الحقيقي عبر الزمن من خلال نقاط الفحص المدمجة، وطبقة المراقبة LangSmith. يُعد LangGraph محايدًا تمامًا للنماذج؛ فالتبديل من GPT-4o إلى Claude 3.5 أو Gemini 1.5 Pro لا يتطلب أي تغييرات هيكلية على الرسم البياني. يُعد نموذج التسليم في OpenAI Agents SDK أبسط وأسرع في التنفيذ، لكن أساسيات الرسم البياني في LangGraph تمنح تحكمًا أكثر دقة في منطق التفرع واستعادة الأخطاء في مسارات العمل ذات المسارات الشرطية المتعددة. المقايضة حقيقية: منحنى التعلم في LangGraph أكثر حدة بشكل ملحوظ، وتبلغ الفرق باستمرار أن الوثائق ليست صديقة للمبتدئين.

يقع Anthropic Claude Agent SDK على الطرف الآخر من الطيف التنافسي. ومثل OpenAI Agents SDK، فهو إطار عمل رسمي يحتفظ به المورد، ومبني حول سلاسل استخدام الأدوات والوكلاء الفرعيين، مع إدارة الحالة التي تتم من خلال خوادم MCP. يدمج تصميمه الذي يضع الأمان أولاً التفكير الممتد مباشرة في حلقة الوكيل وهو مُحسّن خصيصًا لنماذج Claude. هذا يعني أن ديناميكية التقييد متماثلة: يربطك OpenAI SDK بأدوات OpenAI المستضافة و Responses API؛ بينما يربطك Claude Agent SDK بعائلة نماذج Anthropic. بالنسبة للفرق المستثمرة بالفعل في أحد النظامين البيئيين، فإن SDK المعني هو الخيار الطبيعي. أما بالنسبة للفرق التي تحتاج إلى البقاء محايدة للمزود على مستوى التنسيق، فلا يُعد أي منهما إجابة واضحة، ويصبح LangGraph أو Agno أكثر جاذبية.

مقارنةً بـ CrewAI، يستبدل OpenAI Agents SDK لغة DSL القائمة على الأدوار في CrewAI (والتي يمكنها تشغيل طاقم متعدد الوكلاء في حوالي 20 سطرًا مع حد أدنى من المعرفة بإطار العمل) بواجهة برمجة تطبيقات (API) ذات مستوى أدنى وأكثر وضوحًا. يحتوي CrewAI على وحدات ذاكرة مدمجة؛ بينما لا يحتوي Agents SDK على ذلك. ومع ذلك، فإن ميزة التدخل البشري (human-in-the-loop) في CrewAI لا تعمل إلا في نهاية المهمة، بينما يدعم Agents SDK بوابات الموافقة في منتصف سير العمل. بالنسبة للفرق التي تقارن مع AutoGen، فإن الاختلاف الرئيسي هو أن AutoGen يركز على طوبولوجيا الوكلاء الحواريين مع شبكات وكلاء مرنة، بينما يمتلك Agents SDK رأيًا محددًا حول نموذج التسليم ويتوقع منك العمل ضمن أساسياته بدلاً من تكوين أساسياتك الخاصة.

"إذا كان فريقك يستخدم OpenAI بالفعل ويحتاج إلى عمليات تسليم نظيفة من وكيل إلى وكيل، فإن OpenAI Agents SDK هو إطار العمل الأكثر تحديدًا للرأي، وهو ما يُعد ميزة: قرارات أقل، وتنفيذ أسرع، وأساسيات التتبع/حواجز الحماية توفر أسابيع من التطوير المخصص." - مراجعة مدونة mem0.ai، ديسمبر 2025

كيف يبدو واقع حلقة الوكيل

سير العمل القياسي: تحديد الوكلاء، وتعيين الأدوات، وربط عمليات التسليم، وإضافة حواجز الحماية، ثم التشغيل. التتبع يتم تلقائيًا. يتلقى وكيل مراجعة التعليمات البرمجية باستخدام أساسيات Sandbox اختلافات طلب السحب (pull request diff)، ويقوم بتشغيل حاوية، وإجراء الاختبارات، وتطبيق التصحيحات، وإرجاع مخرجات منظمة. يصف المطورون الذين يبنون مسارات دعم العملاء وكيل توجيه يصنف نية المستخدم ويسلمها إلى متخصصي الفواتير أو الدعم الفني أو المرتجعات، ولكل منهم تعليماته وأدواته الخاصة، وكل ذلك مرئي في تتبع واحد في لوحة تحكم OpenAI. هذه ليست حالات استخدام طموحة بل أنماط إنتاج موثقة من قبل فريق SDK.

نمط التكلفة الخفية هو أحد الأشياء التي يشير إليها المطورون مرارًا وتكرارًا بعد أول نشر حقيقي لهم. تعيد كل دورة وكيل إرسال سياق المحادثة بالكامل إلى النموذج. لا يستهلك سير العمل المكون من 5 خطوات 5 أضعاف الرموز (tokens) لمكالمة واحدة؛ فاعتمادًا على طول السياق، قد يستهلك 3-4 أضعاف أكثر. تحتاج الفرق التي تدير أحجامًا كبيرة من مسارات عمل الوكلاء إلى نمذجة هذه التكلفة مسبقًا. يبدأ مسار مراجعة التعليمات البرمجية المقدر بـ $0.075-$0.14 لكل مراجعة في إحداث فرق عند عدة آلاف من المراجعات يوميًا.

تعمل مسارات عمل الوكيل الصوتي باستخدام أساسيات RealtimeAgent على gpt-realtime-1.5 مع اكتشاف تلقائي للمقاطعة، وإدارة السياق، وحواجز الحماية. تضمن إطلاق TypeScript SDK في يونيو 2025 ميزة RealtimeAgent، ويمكن للمطورين نشر وكلاء صوتيين إما على جانب العميل أو جانب الخادم. شهد تحديث يونيو 2025 تقارير فورية عن تدهور جودة الصوت، وتشويش في تدفقات الصوت الخلفية، وزيادة في زمن انتقال استدعاء الوظائف من المطورين في منتديات المجتمع، على الرغم من أن هذه كانت منفصلة عن وظائف التسليم وحواجز الحماية الأساسية.

"التحديثات الأكثر إثارة حتى الآن! المحادثة في الوقت الفعلي وقدرات التدخل البشري تغير الصورة تمامًا." - مطور، منتدى مجتمع OpenAI، 3 يونيو 2025

فجوة الذاكرة متسقة عبر المراجعات. يتعامل SDK مع السياق قصير المدى بشكل نظيف من خلال إدارة الجلسات الخاصة به، لكن الذاكرة الدائمة، وطبقات الاسترجاع، والتخصيص تتطلب بنية تحتية خارجية. يجب على الفرق التي تبني وكلاء يحتاجون إلى تذكر المستخدمين عبر الجلسات ربط مخزن المتجهات (vector store) الخاص بهم أو استخدام أداة مثل Letta لإدارة الذاكرة جنبًا إلى جنب مع SDK. هذا ليس عيبًا في التصميم بقدر ما هو خيار نطاق متعمد: يمتلك SDK التنسيق، وليس طبقة البيانات. ومع ذلك، فإن هذا يعني أن إطار "المسار السريع للإنتاج" يحمل علامة نجمية للتطبيقات التي تحتفظ بالحالة (stateful applications).

لمن تم بناء OpenAI Agents SDK

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

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

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

بالنسبة لأولئك الذين يبنون فوق DSPy لتحسين المطالبات أو LangChain لأدوات سلسلة التفكير الأوسع، يمكن لـ Agents SDK أن يكمل تلك الأدوات بدلاً من استبدالها. إنه ليس منصة ذكاء اصطناعي متكاملة (full-stack)؛ بل هو طبقة تنسيق تفترض أنك ستتخذ خياراتك الخاصة حول طبقات البيانات والذاكرة وتقييم النموذج.

ما لا يمثله OpenAI Agents SDK

إنه ليس محايدًا للنماذج في طبقة الأدوات المستضافة. يمكن لطبقة الاستدلال أن تشير إلى أي نقطة نهاية متوافقة مع Chat Completions، ولكن في اللحظة التي تستخدم فيها البحث في الملفات، أو مخازن المتجهات، أو مفسر التعليمات البرمجية، أو سلاسل المحادثات (Threads)، فإن بياناتك تعيش في منصة OpenAI دون مسار تصدير قياسي. أشار Ashpreet Bedi، مؤسس AgnoAGI، إلى أن "Responses API مصممة عمدًا لمنع المطورين من تبديل المزودين عن طريق تغيير base_url." هذا قيد معماري حقيقي، وليس خطرًا افتراضيًا.

إنه ليس محرك سير عمل قائم على الرسم البياني. الفرق التي تبني مسارات عمل ذات حلقات شرطية معقدة، وفروع متوازية، وبوابات موافقة في نقاط عشوائية، وإعادة تشغيل قائمة على نقاط الفحص تحتاج إلى LangGraph. نموذج التسليم في Agents SDK متسلسل وصريح. يمكنك بناء تنفيذ متوازي باستخدام asyncio، ولكن لا يوجد تجريد على مستوى إطار العمل لذلك، وميزة الوكلاء الفرعيين المخطط لها ليس لها تاريخ شحن مؤكد.

إنه ليس حلاً كاملاً للفرق التي تعتمد بشكل أساسي على TypeScript في الوقت الحالي. يتم الحفاظ على Python و TypeScript SDKs بالتوازي، لكن إصدار Python يتلقى باستمرار الميزات الرئيسية أولاً. وكلاء Sandbox، وبنية التسخير (harness) الجديدة، ووضع التعليمات البرمجية، والوكلاء الفرعيون كلها حصرية لـ Python اعتبارًا من مايو 2026، مع إدراج تكافؤ TypeScript على أنه "مخطط لإصدار مستقبلي" دون جدول زمني محدد. إن بناء مسار وكيل إنتاج يعتمد على TypeScript أولاً على Agents SDK اليوم يعني قبول التأخر في الميزات.

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