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.

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

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

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

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

هذا هو المحور الذي يحدد معظم الصفوف الأخرى.

Responses API: أنت تديرها. يمكن للأدوات المستضافة مثل البحث عبر الويب، والبحث عن الملفات، ومفسر الأكواد، و MCP البعيد تشغيل عدة استدعاءات داخل طلب واحد، لكن وظائفك الخاصة تعود إليك. عندما يستدعي النموذج إحداها، تحصل على عنصر function_call، تقوم بتشغيله، وترسل function_call_output بنفس call_id في الطلب التالي. أنت تقرر متى تتوقف، وكيف تخزن السجل (يتم تخزين الاستجابات افتراضيًا؛ store: false يوقف ذلك)، ومتى تضغط السياقات الطويلة باستخدام context_management و compact_threshold. يغطي دليل Responses API ودليل استدعاء الوظائف تلك الحلقة.

Agents SDK: عمليتك تديرها. تشير وثائق OpenAI إلى أن مشغل SDK "يتعامل مع حلقة الوكيل والتسليمات"، بينما يمتلك خادمك عملية النشر، وتطبيقات الأدوات، وتخزين الحالة، وقرارات الموافقة. مع Sandbox Agents، يمكن أن يبقى النظام في البنية التحتية الخاصة بك بينما يتم تشغيل الأوامر في مساحة عمل محلية بنظام Unix، أو Docker، أو مزود استضافة، بحيث تظل المصادقة وسجلات التدقيق والمراجعة البشرية خارج الحاوية.

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

نفس المهمة، بطريقتين:

# Responses API: one model call; your code owns the loop
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: a durable session; OpenAI owns the loop
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 توفير وإدارة بيئة معزولة (sandbox) للجلسة بأكملها: اضبط environment.type على openai_hosted، أو self_hosted، أو none. باستخدام SDK، تختار وتدفع لمزود البيئة المعزولة. مع Responses، يتم تشغيل التعليمات البرمجية حيث تقوم بتشغيلها، بصرف النظر عن الأدوات المستضافة.

الحالة. تحتفظ جلسة Agents API بالإعدادات، والأدوار، والعناصر على جانب OpenAI، لذا فإن المتابعة هي حدث واحد على نفس معرف الجلسة. مع Responses، تقوم بربط previous_response_id أو تستخدم Conversations. مع SDK، تعيش الحالة في مساحة التخزين الخاصة بك أو في جلسات SDK.

التكلفة. أسعار الرموز متطابقة في كل مكان، حيث تستدعي كل خيار نفس النماذج. لا تفرض Agents API "رسومًا إضافية"، لكن الحاويات المستضافة تكلف من 0.03 دولار (1 جيجابايت) إلى 0.48 دولار (16 جيجابايت) لكل جلسة مدتها 20 دقيقة. التكلفة الإضافية لـ SDK هي استضافتك الخاصة. لا يحتوي AgentKit على اشتراك منفصل، وفقًا لشرح AgentKit الخاص بنا.

البيانات. تدعم Agents API إقامة البيانات في الولايات المتحدة فقط ولا تدعم الاحتفاظ بالبيانات الصفرية (Zero Data Retention)، حتى مع بيئة معزولة (sandbox) مستضافة ذاتيًا. تدرج صفحة ضوابط البيانات الخاصة بـ 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، ومن المقرر إيقاف لوحة التحكم وواجهة برمجة التطبيقات في 30 نوفمبر.
• ChatKit: يظل متاحًا للدردشة المضمنة.
• Connector Registry: لوحة التحكم الإدارية للموصلات وخوادم MCP عبر منتجات OpenAI.

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

أي واحد للبناء عليه

على 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. لا يمكن للوكلاء الفرعيين استدعاء أدوات الوظائف، لذا احتفظ بها على الوكيل الرئيسي.
4. احذف كود الضغط الخاص بك. يقوم النظام بضغط السياق تلقائيًا.
5. التحول إلى الأحداث. بث نتائج الدور (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled) أو استخدم خطافات الويب. الجلسة الخاملة لا تعني النجاح.
6. تحقق من القيود. الإقامة في الولايات المتحدة فقط، لا يوجد ZDR، ورأس بيتا.

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

قبل التبديل، قم بتشغيل القديم والجديد جنبًا إلى جنب. في مشروع Apidog واحد، أنشئ مجلد Responses ومجلد Agents API يشاركان بيئة مع {{OPENAI_API_KEY}} ومتغير نموذج. أرسل نفس المطالبات عبر الاثنين، وتأكد من رموز الحالة وحقول الإخراج المطلوبة، وافتح تدفق Agents API كطلب SSE لمراقبة أحداث الدور. احفظ التشغيلات كسيناريو اختبار وقم بتشغيلها في 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 و Conversations APIs.

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

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

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