OpenAI Agents API و Responses API و Agents SDK و AgentKit: أيهما تختار للبناء عليه؟

تجلس هذه الأسماء الأربعة في طبقات مختلفة، ويفصل بينها سؤال واحد: من يدير حلقة الوكيل (agent loop)؟ واجهة برمجة تطبيقات Responses API هي استدعاء للنموذج، وتنفذ تعليماتك البرمجية الحلقة حولها. مجموعة أدوات تطوير البرامج Agents SDK هي مكتبة لـ TypeScript وPython، وينفذ مُشغلها الحلقة داخل تطبيقك. واجهة برمجة تطبيقات Agents API، وهي في مرحلة بيتا العامة منذ 10 سبتمبر 2026، تشغل نظام Codex الخاص بـ OpenAI نيابة عنك وتحافظ على الجلسة، واختياريًا، البيئة المعزولة (sandbox). أما AgentKit فهي حزمة أكتوبر 2025 التي تضم Agent Builder وChatKit وConnector Registry وEvals، ومن المقرر إيقاف Agent Builder في 30 نوفمبر 2026.

جرّب Apidog اليوم

أضاف DevDay في 29 سبتمبر استخدام الكمبيوتر إلى Agents API (راجع ملخص DevDay 2026)، ما جعل تمييز الأسماء أكثر أهمية. ستجد أدناه مقارنة للحلقة والحساب والحالة والتكلفة والنضج، ثم جدول قرار ومسار ترحيل من حلقة Responses مخصصة. للاطلاع على تطبيق عملي للجلسات والموافقات، اقرأ دليل OpenAI Agents API. ويمكنك اختبار واجهات HTTP لأي خيار في Apidog.

خيارات وكيل OpenAI جنبًا إلى جنب

	Agents API	Responses API	Agents SDK	AgentKit
ما هو	بيئة تشغيل وكيل مُدارة على نظام Codex	نقطة نهاية للنموذج: POST /v1/responses	مكتبة لـ TypeScript وPython	حزمة: Agent Builder وChatKit وConnector Registry وEvals
من يدير الحلقة	OpenAI	تعليماتك البرمجية	مشغل SDK داخل تطبيقك	سير عمل Agent Builder، يُصدَّر إلى كود SDK أو يُضمَّن مع ChatKit
أين يُشغَّل الحساب	بيئة معزولة مستضافة من OpenAI، أو بيئتك المعزولة، أو لا شيء	بيئتك، بالإضافة إلى الأدوات المستضافة	بيئة التشغيل وموفرو البيئات المعزولة لديك	غير قابل للتطبيق
أين تعيش الحالة	جلسة OpenAI: الإعدادات والأدوار والعناصر	سجلك، أو previous_response_id، أو Conversations API	مساحة التخزين الخاصة بك، أو جلسات SDK، أو حالة Responses	سير عمل منشور ومُصدَر له إصدارات
ما الذي تدفعه	الرموز والأدوات والحاويات المستضافة؛ بلا رسوم إضافية	الرموز والأدوات	الرموز والأدوات، بالإضافة إلى استضافتك	استخدام واجهة برمجة التطبيقات الأساسية؛ بلا اشتراك منفصل
جهد التكامل وفقًا لـ OpenAI	منخفض	عالٍ	متوسط	غير مُصنف
الحالة	بيتا عامة (OpenAI-Beta: agents=v1)	موصى به للمشاريع الجديدة	حالي	سيتم إيقاف Agent Builder وEvals في 30 نوفمبر 2026؛ ويبقى ChatKit
ضوابط البيانات	إقامة بيانات في الولايات المتحدة فقط؛ غير مؤهل لـ ZDR؛ تُحفظ الحالة حتى الحذف	مؤهل لـ ZDR مع قيود؛ يدعم نقاط نهاية إقليمية	يعتمد على واجهات API التي يستدعيها	غير قابل للتطبيق

المصادر: مقارنة بيئات تشغيل الوكيل من OpenAI، ونظرة عامة على Agents API، وصفحة الإيقافات.

من يدير الحلقة؟

هذا هو العامل الذي يحدد معظم الفروق العملية بين الخيارات.

Responses API: أنت تدير الحلقة

يمكن للأدوات المستضافة، مثل البحث عبر الويب والبحث في الملفات ومفسر الأكواد وMCP البعيد، تنفيذ استدعاءات متعددة ضمن طلب واحد. لكن تنفيذ وظائفك الخاصة يبقى مسؤوليتك.

عندما يستدعي النموذج وظيفة مخصصة:

1. تستقبل عنصر function_call.
2. تنفذ الوظيفة في خدمتك.
3. ترسل function_call_output باستخدام call_id نفسه في الطلب التالي.
4. تقرر متى تنهي الحلقة وكيف تخزن السجل.

تُخزَّن الاستجابات افتراضيًا؛ استخدم store: false لإيقاف التخزين. ويمكنك ضغط السياقات الطويلة باستخدام context_management وcompact_threshold.

راجع دليل Responses API ودليل استدعاء الوظائف لتطبيق هذه الحلقة.

Agents SDK: تطبيقك يدير الحلقة

تشير وثائق OpenAI إلى أن مشغل SDK «يتعامل مع حلقة الوكيل والتسليمات»، لكن خادمك يبقى مسؤولًا عن:

• النشر.
• تطبيقات الأدوات.
• تخزين الحالة.
• قرارات الموافقة.
• المصادقة وسجلات التدقيق.
• المراجعة البشرية.

مع Sandbox Agents، يمكن للنظام البقاء في بنيتك التحتية، بينما تُشغَّل الأوامر في مساحة عمل محلية بنظام Unix، أو Docker، أو مزود استضافة.

Agents API: OpenAI تدير الحلقة

يتولى النظام المُدار:

• معالجة الجلسات.
• التنسيق بين الخطوات.
• ضغط السياق.
• الاسترداد.
• إضافة وكلاء فرعيين.
• البحث عن الأدوات.
• استدعاء الأدوات برمجيًا.

تستدعي OpenAI خوادم MCP البعيدة مباشرة. أما وظائفك المخصصة، فتبقى ضمن تطبيقك: عندما تُبلغ الجلسة عن function_call في required_actions، أرسل حدث agent.session.input.tool_result متضمنًا turn_id وcall_id.

نفس المهمة، لكن مع مسؤوليتين مختلفتين للحلقة:

# Responses API: استدعاء نموذج واحد؛ كودك يملك الحلقة
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: جلسة دائمة؛ OpenAI تملك الحلقة
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

تستخدم أمثلة وثائق Agents API النموذج gpt-6-astra. لا توضح الوثائق ما إذا كانت نماذج أخرى مقبولة، لذا تحقق قبل التحويل إلى gpt-6.1-sol.

الحساب والحالة والتكلفة

الحساب

يمكن لـ Agents API توفير وإدارة بيئة معزولة للجلسة كاملة. اضبط environment.type على أحد الخيارات التالية:

• openai_hosted
• self_hosted
• none

مع Agents SDK، تختار مزود البيئة المعزولة وتدفع تكلفته. مع Responses API، تُشغَّل تعليماتك البرمجية في بنيتك التحتية، بصرف النظر عن الأدوات المستضافة.

الحالة

تحتفظ جلسة Agents API بالإعدادات والأدوار والعناصر على جانب OpenAI. لذلك تكون المتابعة حدثًا جديدًا على معرّف الجلسة نفسه.

مع Responses API، لديك خياران شائعان:

• ربط الطلب الجديد بـ previous_response_id.
• استخدام Conversations API.

مع Agents SDK، تعيش الحالة في مساحة التخزين الخاصة بك أو في جلسات SDK.

التكلفة

أسعار الرموز متطابقة بين الخيارات لأنها تستدعي النماذج نفسها.

لا تفرض Agents API «رسومًا إضافية»، لكن الحاويات المستضافة تكلف من 0.03 دولار لحاوية 1 جيجابايت إلى 0.48 دولار لحاوية 16 جيجابايت لكل جلسة مدتها 20 دقيقة. التكلفة الإضافية مع SDK هي تكلفة استضافتك الخاصة.

لا يحتوي AgentKit على اشتراك منفصل، وفقًا لشرح AgentKit.

البيانات

تدعم Agents API إقامة البيانات في الولايات المتحدة فقط، ولا تدعم الاحتفاظ الصفري بالبيانات (Zero Data Retention أو ZDR)، حتى مع بيئة معزولة مستضافة ذاتيًا.

تذكر صفحة ضوابط البيانات من OpenAI أن المسار /v1/agents غير مؤهل لـ ZDR، وأن الحالة تُحتفظ بها حتى الحذف. في المقابل، يُعد /v1/responses مؤهلًا لـ ZDR مع قيود، ومتاحًا على نقاط نهاية إقليمية مثل eu.api.openai.com.

إذا كانت ZDR أو إقامة البيانات في الاتحاد الأوروبي شرطًا، فإن Agents API غير مناسب حاليًا.

AgentKit في أواخر عام 2026: ما الذي بقي؟

أُطلق AgentKit في 6 أكتوبر 2025 بأربعة أجزاء. وهذه حالة كل جزء:

• Agent Builder: أُعلن عن إيقافه في 3 يونيو 2026، ومن المقرر إيقافه في 30 نوفمبر 2026. يشرح دليل الترحيل من OpenAI كيفية تصدير سير العمل ككود Agents SDK، أو إعادة بنائه كوكيل ChatGPT Workspace Agent على خطط Business أو Enterprise أو Edu.
• Evals: تصبح التقييمات الحالية للقراءة فقط في 31 أكتوبر 2026، ومن المقرر إيقاف لوحة التحكم وواجهة API في 30 نوفمبر.
• ChatKit: يبقى متاحًا للدردشة المضمنة.
• Connector Registry: لوحة تحكم إدارية للموصلات وخوادم MCP عبر منتجات OpenAI.

كما يوضح دليل AgentKit، فإن المسار المستدام والقائم على الكود أولًا عبر AgentKit هو Agents SDK.

أي خيار تبني عليه؟

اختر	متى تستخدمه
Agents API	لديك مهام تستغرق دقائق وتحتاج إلى ملفات أو أوامر أو متصفح، ولا تريد تشغيل الحلقة أو البيئات المعزولة أو تخزين الجلسة. تقبل إقامة البيانات في الولايات المتحدة وحالة البيتا.
Responses API	تجري استدعاءات منفردة، أو تريد التحكم في كل دور، أو تحتاج إلى ZDR أو إقامة بيانات خارج الولايات المتحدة، أو لديك حلقة عمل قائمة بالفعل.
Agents SDK	يجب أن يمتلك كود التطبيق الأدوات والتخزين والموافقات والتسليمات، وأن تعمل الحلقة داخل بنيتك التحتية.
ChatKit	تحتاج إلى واجهة دردشة مضمنة في منتجك.
Agent Builder	لا تبدأ هنا. صدّر أي سير عمل حالي قبل 30 نوفمبر 2026.

على AWS، تقدم Bedrock Managed Agents المدعومة من OpenAI القدرات الأساسية لـ Agents API لتعمل بشكل أصلي في AWS.

ولتوصيل MCP في أي من المسارين القائمين على الكود أولًا، راجع خوادم MCP مع وكلاء OpenAI.

الانتقال من حلقة Responses الخاصة بك إلى Agents API

إذا كنت قد بنيت حلقة على Responses وتريد أن تديرها OpenAI، اتبع هذه الخطوات:

1. اربط المكونات.
   
   انقل التعليمات والنموذج والأدوات إلى agent. حوّل الحاوية إلى environment. واستبدل مخزن المحادثات بمعرّف جلسة.

2. انقل خوادم MCP البعيدة إلى agent.tools.
   
   ضع الرموز في خزانة متصلة عبر vault_ids، وليس داخل المطالبات.

3. أعد كتابة معالجة الوظائف.
   
   استبدل حلقة function_call_output بمعالج لـ:

   • agent.session.requires_action عند استخدام البث.
   • agent.session.action_required عند استخدام خطافات الويب.

يجب أن يعيد المعالج agent.session.input.tool_result. لا يستطيع الوكلاء الفرعيون استدعاء أدوات الوظائف، لذا أبقِ هذه الأدوات على الوكيل الرئيسي.

1. احذف كود ضغط السياق الخاص بك.
   
   يضغط النظام السياق تلقائيًا.

2. انتقل إلى الأحداث.
   
   راقب نتائج الدور التالية عبر البث أو خطافات الويب:

   • agent.session.turn.completed
   • agent.session.turn.failed
   • agent.session.turn.cancelled

لا يعني خمول الجلسة نجاحها بالضرورة.

1. تحقق من القيود قبل الإنتاج. راجع إقامة البيانات في الولايات المتحدة فقط، وعدم دعم ZDR، ومتطلب رأس البيتا.

احتفظ بالخيارين في مشروع Apidog واحد

قبل التحويل الكامل، شغّل الحل القديم والجديد جنبًا إلى جنب.

في مشروع Apidog واحد:

1. أنشئ مجلدًا باسم Responses.
2. أنشئ مجلدًا باسم Agents API.
3. اجعل المجلدين يستخدمان البيئة نفسها، بما فيها:
   • {{OPENAI_API_KEY}}
   • متغير النموذج.
4. أرسل المطالبات نفسها عبر المسارين.
5. تحقق من رموز الحالة وحقول الإخراج المطلوبة.
6. افتح تدفق Agents API كطلب SSE لمراقبة أحداث الدور.
7. احفظ التشغيلات كسيناريوهات اختبار.
8. شغّلها في CI باستخدام Apidog CLI، حتى يظهر أي تغيير في البيتا كفحص فاشل.

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

الأسئلة الشائعة

هل ستحل Agents API محل Responses API؟

لم يُعلن عن أي إيقاف. تدرج نظرة عامة على وكلاء OpenAI كلًا من Agents API وAgents SDK وResponses API كخيارات حالية لاحتياجات مختلفة.

هل تم إيقاف OpenAI AgentKit؟

جزئيًا. من المقرر إيقاف Agent Builder وEvals في 30 نوفمبر 2026، بينما يبقى ChatKit متاحًا.

هل يستخدم Agents SDK واجهة Agents API؟

لا. يعمل SDK داخل تطبيقك، بينما تدير Agents API نظامًا مُدارًا في خدمة OpenAI.

ماذا حدث لـ Assistants API؟

تحدد صفحة الإيقافات في OpenAI إزالته في 26 أغسطس 2026، وتوجه المطورين إلى Responses API وConversations API.

أي الخيارات هو الأرخص؟

تتطابق أسعار الرموز عبر جميعها. الفرق الأساسي هو تكلفة الحاويات المستضافة في Agents API مقابل استضافتك الخاصة مع SDK أو Responses API.

اختر مسارًا واحدًا هذا الأسبوع

اختر بناءً على الجهة التي يجب أن تدير الحلقة، ثم أثبت القرار بطلبات فعلية قبل كتابة التطبيق.

إذا كنت تبدأ من الصفر، جرّب جلسة Agents API واحدة، ثم قارن مخرجاتها بإعداد Responses الحالي في Apidog.