استكشاف OpenAI’s Agents SDK: دليل

تقدّم OpenAI عدة عروض جديدة: Responses API، وأدوات مدمجة للبحث على الويب والملفات، وأداة لاستخدام الحاسوب، وAgents SDK مفتوح المصدر. وبينما يتيح Responses API للمطورين بناء وكلاء فوق تقنيتها، يساعد Agents SDK على ربط الوكلاء بأدوات الويب والعمليات الأخرى، لتنفيذ “سير عمل” تُنجز ما يريده المستخدم أو العمل بشكل مستقل.

يُشاد بعام 2025 كثيراً بوصفه “عام الوكلاء”، وتُعد خطوة OpenAI حجر زاوية للصناعة. يتيح Agents SDK للمطورين الاستفادة بسهولة من أحدث تقدم لدى OpenAI (مثل تحسين الاستدلال، والتفاعلات متعددة الوسائط، وتقنيات الأمان الجديدة) في سيناريوهات واقعية متعددة الخطوات. وبالنسبة لمطوري LLM وبناة وكلاء الذكاء الاصطناعي، يوفر Agents SDK مجموعة من “اللبنات الأساسية” لإنشاء أنظمتهم الذاتية وإدارتها.

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

ما هو Agents SDK

تعود OpenAI بقوة إلى عالم المصدر المفتوح عبر إصدار Agents SDK، وهي مجموعة أدوات صُمّمت لمساعدة المطورين على إدارة سير عمل الوكلاء وتنسيقه وتحسينه — وحتى بناء وكلاء مدعومين بنماذج أخرى غير تابعة لـ OpenAI مثل نماذج المنافسين Anthropic وGoogle، أو النماذج مفتوحة المصدر من DeepSeek وQwen وMistral وعائلة Llama من Meta.

لماذا تستخدم Agents SDK

يقوم SDK على مبدأين تصميميين محوريين:

1. مزايا كافية تستحق الاستخدام، مع عدد قليل من البدائيات لتسهيل سرعة التعلم.
2. يعمل بكفاءة مباشرة من الصندوق، ومع ذلك يمكنك تخصيص ما يحدث بالضبط.

فيما يلي الميزات الرئيسية للـ SDK:

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

كيفية استخدام Openai Agents SDK

1. اضبط بيئة بايثون لديك

python -m venv env
source env/bin/activate

2. ثبّت Agents SDK

pip install openai-agents

3. اضبط متغير البيئة OPENAI_API_KEY

اضبط بحرية OPENAI_API_KEY عبر CometAPI

• تسجيل الدخول إلى cometapi.com. إذا لم تكن مستخدماً لدينا بعد، الرجاء التسجيل أولاً
• احصل على مفتاح واجهة برمجة التطبيقات للاعتماد للخدمة. انقر "Add Token" ضمن API token في المركز الشخصي، واحصل على مفتاح الرمز: sk-xxxxx ثم أرسل.
• احصل على رابط هذا الموقع: https://api.cometapi.com/
• اختر واجهة OPENAI_API_KEY لإرسال طلب API واضبط جسم الطلب. يتم الحصول على طريقة الطلب وجسم الطلب من وثائق واجهة برمجة التطبيقات على موقعنا. كما يوفر موقعنا اختبار Apifox لراحتك.

4. أعدد وكيلك

حدّد الأدوات التي يمكن للذكاء الاصطناعي استخدامها. لنفترض أننا نريد تمكين البحث على الويب واسترجاع الملفات:

from agent_sdk import Agent, WebSearchTool, FileRetrievalTool

search_tool = WebSearchTool(api_key="your_api_key")
file_tool = FileRetrievalTool()

agent = Agent(tools=)

الآن يعرف وكيلك كيفية البحث على الويب وجلب المستندات.

5. التشغيل

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

def agent_task(query):
    result = agent.use_tool("web_search", query)
    return result

response = agent_task("أحدث أوراق البحث في مجال الذكاء الاصطناعي")
print(response)

دون أي تدخّل يدوي — مجرد تنفيذ ذاتي.

حلقة الوكيل

عند استدعاء Runner.run()، يُشغّل الـ SDK حلقة حتى يحصل على مخرج نهائي:

1. يُستدعى الـ LLM باستخدام النموذج والإعدادات على الوكيل، إلى جانب سجل الرسائل.
2. يعيد الـ LLM استجابة قد تتضمن استدعاءات أدوات.
3. إذا احتوت الاستجابة على مخرج نهائي، تنتهي الحلقة وتُعيده.
4. إذا احتوت الاستجابة على تسليم، يُضبط الوكيل على الوكيل الجديد وتستأنف الحلقة من الخطوة 1.
5. تُعالَج استدعاءات الأدوات (إن وُجدت) وتُضاف رسائل استجابة الأداة. ثم تستأنف الحلقة من الخطوة 1.

يمكنك استخدام المعامل max_turns للحد من عدد دورات الحلقة.

​المخرج النهائي

المخرج النهائي هو آخر ما ينتجه الوكيل في الحلقة:

• إذا ضبطت output_type على الوكيل، يكون المخرج النهائي عندما يعيد الـ LLM شيئاً من ذلك النوع باستخدام مخارج مُهيكلة.
• إذا لم يكن هناك output_type (أي مخارج نصية عادية)، فإن أول استجابة من الـ LLM بدون أي استدعاءات أدوات أو تسليمات تعتبر المخرج النهائي.

مثال Hello world

from agents import Agent, Runner

agent = Agent(name="Assistant", instructions="أنت مساعد مفيد")

result = Runner.run_sync(agent, "اكتب هايكو عن الاستدعاء الذاتي في البرمجة.")
print(result.final_output)

# كود داخل الكود،
# دوالّ تستدعي نفسها،
# رقصة الحلقة اللانهائية.

البنية التقنية

“يهدف OpenAI Agents SDK إلى أن يكون إطاراً مفاهيمياً يوضح كيف يمكن لوكلاء مختلفين، مثل ‘وكيل الفرز’ أو ‘وكيل CRM’، التعاون لإكمال المهام عبر تفاعلات الأدوات وآليات التفويض.”

المكونات الجوهرية ومعمارية Agents SDK

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

قطعة محورية أخرى في Agents SDK هي حلقة الوكيل، التي تحدد العملية التكرارية لحل المهام. بدءاً بمحاولة أولية للإجابة عن الاستعلام، يقيّم الوكيل ما إذا كانت لديه معلومات كافية أم أنه يحتاج إلى تنفيذ إجراءات خارجية. عند الحاجة، يستدعي الوكيل الأداة المناسبة، ويعالج المخرجات، ثم يعيد تقييم المهمة. تتكرر هذه الدورة حتى يعلن الوكيل اكتمال المهمة باستجابة من نوع “لقد انتهيت”. يدير Agents SDK هذه العملية ذاتياً، مما يبسّط عملية التطوير من خلال أتمتة المهام المتكررة مثل استدعاء الأدوات، ومعالجة النتائج، والمحاولات التكرارية. يتيح ذلك للمطورين التركيز أكثر على تعريف سير العمل وقدرات الوكلاء دون القلق بشأن الآليات الأساسية. تصف OpenAI هذا النهج بأنه موجّه لبايثون، مع التأكيد على استخدام تراكيب بايثون المألوفة — مثل الحلقات، والجمل الشرطية، واستدعاءات الدوال — بدلاً من لغات المجالات الخاصة (DSLs). ومع هذه المرونة، يمكن للمطورين تنسيق وكلاء مترابطين بالاعتماد على صياغة بايثون الأصلية.

التسليم وبنية الوكلاء المتعددين

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

التنسيق والمراقبة

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

المزايا

لا يقتصر OpenAI Agents SDK على المطورين الأفراد، بل يقدم أيضاً مزايا كبيرة للشركات التي تبني منتجات قائمة على وكلاء الذكاء الاصطناعي. لنبدأ بالمزايا:

النمذجة السريعة والإنتاج: يطبّق Agents SDK سلوكيات معقّدة للوكلاء مع أقل قدر من الشيفرة والإعداد، مختصراً الدورة من الفكرة إلى المنتج. على سبيل المثال، تستخدم منصة العملات المشفرة الرائدة Coinbase الـ SDK لبناء نماذج أولية ونشر أنظمة دعم متعددة الوكلاء بسرعة. وبالمثل، في مجالات مثل مساعدين بحث المؤسسات، يمكن للشركات دمج أدوات البحث على الويب والملفات في الـ SDK لتقديم قيمة بسرعة. عبر إزاحة عبء تفاصيل التنسيق، يمكن للمطورين التركيز على ميزات المنتج الخاصة.

خفض تكاليف التطوير: يتطلب بناء نظام وكلاء من الصفر استثماراً هندسياً كبيراً. يقلل Agents SDK التكاليف عبر توفير حلول جاهزة للاحتياجات الشائعة — إدارة الحلقة، مزامنة استدعاءات API، معالجة الأخطاء، وخَرْج الأدوات المنسّق لـ LLM. وباعتباره مفتوح المصدر، يتيح أيضاً تخصيصاً يناسب احتياجات الشركة. وهذا مكسب للشركات الناشئة، إذ يمكّنها من إنشاء منتجات قوية مدفوعة بالوكلاء بموارد محدودة.

إمكانية التتبع وتصحيح الأخطاء: يحوّل لوحة التتبع المدمجة في الـ SDK تطبيقات الأعمال. فبدلاً من بقاء الذكاء الاصطناعي “صندوقاً أسود”، يمكن الآن تسجيل كل خطوة للوكيل وتدقيقها. إذا قدّم وكيل الدعم إجابة خاطئة، يوضّح التتبع استدعاء الأداة أو الخطوة التي فشلت. تُحسّن شاشة السجلات/التتبّع في منصة OpenAI قابلية تدقيق الوكلاء — وهي أمر حاسم في الصناعات الخاضعة للتنظيم أو التدقيق الداخلي. يتيح ذلك للشركات دمج الذكاء الاصطناعي بثقة أكبر، مع العلم أنها تستطيع تفسير النتائج عند الحاجة.

الوصول إلى أحدث نماذج وأدوات OpenAI: يعني استخدام Agents SDK الاستفادة من أفضل نماذج OpenAI (مثل GPT-4) وأدواتها الحالية (البحث على الويب، وتنفيذ الشيفرة). يوفر هذا ميزة جودة مقارنة ببناء بدائل قد تعتمد على نماذج أضعف. بالنسبة للتطبيقات التي تتطلب دقة عالية أو معلومات محدّثة (مثل مساعدي البحث، أو وكلاء التحليل المالي)، تُعد أداءات نماذج OpenAI ميزة كبيرة. ومع إضافة OpenAI لأدوات جديدة (مع التلميح إلى المزيد من التكاملات)، يمكن لمستخدمي الـ SDK تبنّيها بسهولة.

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

الخلاصة

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