وكلاء OpenAI لـ Python

OpenAI Agents SDK هو إطار عمل خفيف الوزن لكنه قوي لبناء سير عمل متعدد الوكلاء. إنه مستقل عن مزود الخدمة، ويدعم واجهات OpenAI Responses وChat Completions، بالإضافة إلى أكثر من 100 نموذج لغوي آخر.

هل تبحث عن إصدار JavaScript/TypeScript؟ تحقق من Agents SDK JS/TS.

1. الوكلاء: نماذج لغوية مضبوطة مع تعليمات وأدوات وحواجز وحالات نقل.
2. وكلاء صناديق الرمل: وكلاء مُعدّون مسبقاً للعمل مع حاوية لأداء الأعمال على مدى فترات زمنية طويلة.
3. الوكلاء كأدوات / حالات نقل: تفويض لوكلاء آخرين لمهام محددة.
4. الأدوات: أدوات متنوعة تمكّن الوكلاء من اتخاذ الإجراءات (وظائف، MCP، أدوات مستضافة).
5. الحواجز: فحوصات سلامة قابلة للتكوين للتحقق من صحة المدخلات والمخرجات.
6. الإنسان في الحلقة: آليات مدمجة لإشراك البشر عبر عمليات الوكلاء.
7. الجلسات: إدارة تلقائية لسجل المحادثات عبر عمليات الوكلاء.
8. تتبع: تتبع مدمج لعمليات الوكلاء، مما يتيح لك عرضها وتصحيحها وتحسين سير العمل الخاص بك.
9. وكلاء الوقت الحقيقي: بناء وكلاء صوتيين قوية مع `gpt-realtime-2.1` وميزات الوكلاء الكاملة.

استكشف دليل الأمثلة لرؤية إطار SDK أثناء العمل، واقرأ الوثائق لمزيد من التفاصيل.

للبداية، قم بإعداد بيئة Python لديك (يلزم وجود Python 3.10 أو أحدث)، ثم قم بتثبيت حزمة OpenAI Agents SDK.

لدعم الصوت، قم بالتثبيت مع مجموعة `voice` الاختيارية: `pip install ‘openai-agents[voice]’`. لدعم جلسات Redis، قم بالتثبيت مع مجموعة `redis` الاختيارية: `pip install ‘openai-agents[redis]’`.

إذا كنت مألوفاً مع uv، سيكون تثبيت الحزمة أسهل بكثير:

لدعم الصوت، استخدم المجموعة الاختيارية `voice`: `uv add ‘openai-agents[voice]’`. لدعم جلسات Redis، استخدم المجموعة الاختيارية `redis`: `uv add ‘openai-agents[redis]’`.

يدعم SDK ثلاث طرق أساسية لتشغيل الوكلاء. قم بتعيين متغير البيئة `OPENAI_API_KEY` قبل تشغيل أي من هذه الأمثلة.

استخدم `SandboxAgent` عند حاجة وكيل إلى فحص الملفات، تشغيل الأوامر، تطبيق التصحيحات، أو الحفاظ على مساحة العمل.