OpenAI Agents SDK

في DevDay 2025، قدمت OpenAI Agents SDK—إطار خفيف الوزن وجاهز للإنتاج مبني حول ثلاثة بدائيات أساسية: الوكلاء والتسليم وحواجز الحماية.

البدائيات الثلاثة

1. الوكلاء

لبنة البناء الأساسية—نموذج لغة كبير مع تعليمات وأدوات:

from openai import Agent

support_agent = Agent(
    name="دعم العملاء",
    instructions="""تساعد العملاء في طلباتهم.
    كن ودوداً وفعالاً. إذا لم تستطع المساعدة،
    سلّم لمتخصص.""",
    tools=[order_lookup, refund_tool]
)

sales_agent = Agent(
    name="متخصص المبيعات",
    instructions="تساعد العملاء في إيجاد المنتجات المناسبة.",
    tools=[product_search, inventory_check]
)

2. التسليم

انتقالات سلسة بين الوكلاء:

from openai import handoff

# تحديد متى يتم التسليم
support_agent = Agent(
    name="الدعم",
    instructions="ساعد في الدعم. سلّم أسئلة المبيعات.",
    handoffs=[
        handoff(
            to=sales_agent,
            condition="العميل يسأل عن شراء المنتجات"
        ),
        handoff(
            to=billing_agent,
            condition="العميل لديه مشاكل في الفوترة"
        )
    ]
)

3. حواجز الحماية

التحقق من المدخلات/المخرجات والأمان:

from openai import guardrail

# حاجز حماية المدخلات
@guardrail(type="input")
def check_pii(message):
    """منع الرسائل التي تحتوي معلومات شخصية"""
    if contains_pii(message):
        return "من فضلك لا تشارك معلومات شخصية."
    return None  # السماح بالرسالة

# حاجز حماية المخرجات
@guardrail(type="output")
def check_response(response):
    """التأكد من أن الردود مناسبة"""
    if is_harmful(response):
        return "لا أستطيع المساعدة في هذا الطلب."
    return None  # السماح بالرد

agent = Agent(
    name="وكيل آمن",
    guardrails=[check_pii, check_response]
)

تشغيل الوكلاء

from openai import Runner

# إنشاء مُشغّل
runner = Runner(agents=[support_agent, sales_agent, billing_agent])

# معالجة محادثة
result = runner.run(
    initial_agent=support_agent,
    messages=[
        {"role": "user", "content": "أريد إرجاع طلبي"}
    ]
)

print(result.messages)  # المحادثة الكاملة
print(result.final_agent)  # أي وكيل أنهى المحادثة

المزايا الرئيسية

الميزة	الفائدة
واجهة بسيطة	سهل التعلم، سريع التنفيذ
تكامل أصلي	يعمل بسلاسة مع نماذج OpenAI
أمان مدمج	حواجز الحماية مواطنون من الدرجة الأولى
تتبع مضمن	التصحيح مع لوحة تحكم OpenAI
جاهز للإنتاج	مصمم للتوسع من اليوم الأول

المقارنة مع الأُطر الأخرى

OpenAI Agents SDK    LangChain           CrewAI
─────────────────    ─────────           ──────
خفيف الوزن           غني بالميزات        مركز على الأدوار
3 بدائيات           تجريدات كثيرة        استعارة الفريق
أصلي لـ OpenAI      لا يعتمد على نموذج   لا يعتمد على نموذج
حواجز حماية مدمجة   أمان إضافي           أمان أساسي

متى تختار OpenAI Agents SDK

✅ الأفضل لـ:

• التطبيقات التي تعتمد على OpenAI أولاً
• الهندسات البسيطة والنظيفة
• المشاريع التي تحتاج أماناً مدمجاً
• الفرق التي تريد أقل اعتماديات

⚠️ فكر في البدائل عندما:

• تحتاج دعم نماذج متعددة
• تريد أدوات مجتمع واسعة
• تبني أنظمة وكلاء متعددة معقدة

بعد ذلك، سنتعلم كيف نختار الإطار المناسب لمشروعك. :::