OpenAI Agents SDK

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

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

1. الوكلاء

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

from agents import Agent

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

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

2. التسليم

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

from agents import handoff

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

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

التحقق من المدخلات والأمان باستخدام دوال حواجز الحماية:

from agents import Agent, InputGuardrail, GuardrailFunctionOutput, Runner

safety_agent = Agent(
    name="فحص السلامة",
    instructions="حدد إذا كان المدخل آمناً. أجب بـ 'safe' أو 'unsafe'."
)

async def content_filter(ctx, agent, input_text):
    """فحص سلامة المحتوى قبل المعالجة"""
    result = await Runner.run(safety_agent, input_text)
    return GuardrailFunctionOutput(
        output_info={"safe": result.final_output == "safe"},
        tripwire_triggered=result.final_output != "safe"
    )

agent = Agent(
    name="وكيل الدعم",
    instructions="تساعد العملاء في طلباتهم.",
    input_guardrails=[InputGuardrail(guardrail_function=content_filter)]
)

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

from agents import Runner

# معالجة محادثة
result = await Runner.run(
    support_agent,
    input="أريد إرجاع طلبي"
)

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

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

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

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

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

متى تختار OpenAI Agents SDK

✅ الأفضل لـ:

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

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

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

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