حزمة Claude Agent SDK

أصدرت Anthropic حزمة Claude Agent SDK - نفس البنية التحتية التي تشغل Claude Code - لمساعدة المطورين على بناء وكلاء متطورين دون إعادة اختراع العجلة.

ما هي حزمة Agent SDK؟

توفر حزمة Agent SDK:

• حلقات وكيل مبنية مسبقاً لاستخدام الحاسوب واستدعاء الأدوات
• إدارة الحالة للجلسات طويلة التشغيل
• أنماط استعادة الأخطاء
• خطافات المراقبة للتصحيح

المكونات الأساسية

from anthropic import Anthropic

# تهيئة العميل
client = Anthropic()

# تعريفات الأدوات تُمرَّر كقواميس إلى واجهة API
tools = [
    {
        "type": "computer_20250124",
        "name": "computer",
        "display_width_px": 1024,
        "display_height_px": 768,
        "display_number": 0
    },
    {
        "type": "bash_20250124",
        "name": "bash"
    },
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

نمط حلقة الوكيل

تبسط SDK حلقة الوكيل:

async def run_agent(task: str):
    messages = [{"role": "user", "content": task}]

    while True:
        response = await client.messages.create(
            model="claude-sonnet-4-5-20250514",
            max_tokens=4096,
            tools=tools,
            messages=messages,
            betas=["computer-use-2025-01-24"]
        )

        # التحقق من انتهاء الوكيل
        if response.stop_reason == "end_turn":
            return extract_result(response)

        # تنفيذ استدعاءات الأدوات
        tool_results = await execute_tools(response.content)

        # الإضافة إلى المحادثة
        messages.append({"role": "assistant", "content": response.content})
        messages.append({"role": "user", "content": tool_results})

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

بدون SDK	مع SDK
بناء الحلقة من الصفر	حلقة وكيل مبنية مسبقاً
معالجة جميع الحالات الحدية	استعادة أخطاء مدمجة
تتبع الحالة يدوياً	إدارة حالة تلقائية
تصحيح مخصص	خطافات مراقبة

ملاحظة: تستخدم حزمة Agent SDK نفس الأنماط التي تشغل Claude Code، مساعد البرمجة بالذكاء الاصطناعي من Anthropic.

في الوحدة التالية، سنقوم بإعداد بيئة التطوير الخاصة بك للبدء في البناء. :::