كلود للوكلاء المدارة ضد حزمة تطوير الوكيل (2026): أيهما تختار؟

لقد قررت إطلاق وكيل ذكاء اصطناعي إنتاجي على Claude. القرار المعماري الأول ليس اختيار النموذج فقط، بل اختيار مكان تشغيل حلقة الوكيل: هل تستخدم وكلاء Claude المُدارين (Claude Managed Agents) لتدير Anthropic الحلقة وبيئة الاختبار وحالة الجلسة، أم تستخدم حزمة تطوير وكيل Claude (Claude Agent SDK) لتشغيل الحلقة داخل خدمتك وبنيتك التحتية؟ هذا الدليل يحوّل المقارنة إلى خطوات قرار عملية باستخدام أمثلة مثل وكيل استرداد مدفوعات ووكيل فرز تذاكر دعم.

جرّب Apidog اليوم

خلاصة القرار

اختر وكلاء Claude المُدارين عندما تريد تقليل عبء التشغيل: Anthropic تستضيف حلقة الوكيل، بيئة الاختبار، وسجل الجلسة، وهذا مناسب للأعمال الطويلة أو غير المتزامنة.

اختر حزمة تطوير وكيل Claude عندما تحتاج إلى تشغيل الحلقة داخل بيئتك: تحكم كامل في الأدوات، الأذونات، الخطافات، محلية البيانات، والتكلفة التشغيلية.

كلا الخيارين يدعمان نماذج Claude وMCP، لكنهما يختلفان جذريًا في الملكية التشغيلية.

قبل الاختيار: حدّد أين ستفشل المنظومة

معظم وكلاء الإنتاج لا “يفكرون” فقط؛ هم يستدعون APIs:

• إصدار استرداد مدفوعات.
• إنشاء تذكرة Zendesk.
• قراءة مخزون.
• استدعاء خدمة تسعير داخلية.
• تشغيل أداة عبر MCP.

لذلك لا تختبر الوكيل وحده. اختبر كل API وأداة MCP يستدعيها. يمكنك استخدام Apidog لمحاكاة التبعيات، تشغيل اختبارات العقود، وتصحيح طلبات الوكيل قبل وصوله إلى بيئة الإنتاج.

للمقدمة الخاصة بالخيار المستضاف، راجع دليل وكلاء Claude المُدارين.

ما هو وكلاء Claude المُدارون؟

وكلاء Claude المُدارون هو وقت تشغيل مستضاف للوكيل. بدل أن تبني حلقة الوكيل، بيئة الاختبار، وتنفيذ الجلسات بنفسك، تصف الوكيل وترسل له الأحداث عبر API.

تم إطلاقه في نسخة تجريبية عامة في أبريل 2026 ويتطلب حاليًا الرأس التجريبي:

anthropic-beta: managed-agents-2026-04-01

تدور البنية حول أربعة مفاهيم:

• Agent: النموذج، موجه النظام، الأدوات، خوادم MCP، والمهارات.
• Environment: قالب حاوية يحتوي على حزم مثبتة مسبقًا وقواعد شبكة.
• Session: تشغيل فعلي لوكيل داخل بيئة لتنفيذ مهمة واحدة.
• Events: الرسائل، نتائج الأدوات، وتحديثات الحالة المتدفقة بين تطبيقك والوكيل عبر SSE.

التدفق العملي يكون كالتالي:

1. أنشئ Agent.
2. اربطه ببيئة Environment.
3. ابدأ Session.
4. أرسل رسالة المستخدم كحدث.
5. استقبل النتائج والأحداث المتدفقة.
6. استعد سجل الأحداث عند التصحيح أو التدقيق.

يدعم الخيار أدوات مدمجة مثل Bash، عمليات الملفات، البحث عبر الويب، والاسترجاع، إضافة إلى خوادم MCP. وهو مناسب عندما تحتاج إلى:

• تنفيذ طويل من دقائق إلى ساعات.
• جلسات ذات حالة دائمة.
• تشغيل غير متزامن.
• تقليل عبء البنية التحتية.
• سجل أحداث مستضاف.

لكن انتبه إلى نقطتين:

1. الأدوات المخصصة لا تُنفَّذ داخل Anthropic تلقائيًا. Claude يطلب استدعاء الأداة، وتطبيقك ينفذها ويرجع النتيجة عبر تدفق الأحداث.
2. بعض الميزات مثل النتائج والوكلاء المتعددين قد تكون مقيدة بطلب وصول منفصل كمعاينة بحثية.

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

ما هي حزمة تطوير وكيل Claude؟

حزمة تطوير وكيل Claude هي مكتبة بايثون أو تايب سكريبت تشغّل حلقة الوكيل داخل عمليتك. كانت تُعرف سابقًا باسم Claude Code SDK، ثم أُعيدت تسميتها لتعكس استخدامات أوسع من مهام البرمجة.

التثبيت:

pip install claude-agent-sdk

أو:

npm install @anthropic-ai/claude-agent-sdk

الفكرة الأساسية: بدل أن تكتب حلقة أدوات يدويًا مثل:

while response.stop_reason == "tool_use":
    # نفّذ الأداة
    # أرسل النتيجة
    # أكمل الحلقة

تستخدم SDK التي توفر الحلقة، إدارة السياق، الأدوات، الجلسات، والخطافات.

مثال مبسط بالفكرة العامة:

from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Write", "Edit", "Bash"]
)

async for message in query(
    prompt="افحص المشروع واقترح إصلاحًا للاختبارات الفاشلة",
    options=options
):
    print(message)

توفر SDK آليات مهمة للإنتاج:

• أدوات مدمجة: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch.
• Hooks: مثل PreToolUse, PostToolUse, Stop, SessionStart, SessionEnd.
• Subagents: وكلاء فرعيون لمهام مركزة.
• MCP: ربط قواعد بيانات، متصفحات، وخدمات خارجية.
• Permissions: السماح أو الحظر أو طلب موافقة بشرية.
• Sessions: حفظ واستئناف الجلسات، عادة بصيغة JSONL على نظام ملفاتك.

مثال عملي على استخدام Hook لمنع أمر خطير:

def pre_tool_use_hook(event):
    if event.tool_name == "Bash" and "rm -rf" in event.input.get("command", ""):
        return {
            "allow": False,
            "reason": "الأمر محظور لأنه قد يحذف ملفات حرجة"
        }

    return {"allow": True}

هذه النقطة مهمة: مع SDK أنت تملك الحلقة. هذا يعني أنك تملك أيضًا مسؤولية التشغيل، السجلات، التوسع، العزل، والحوكمة.

للبداية العملية، راجع إعداد حزمة تطوير وكيل Claude بخطة Claude وبناء Claude Code الخاص بك.

ملاحظة فوترة: بدءًا من 15 يونيو 2026، سيتم سحب استخدام Agent SDK وclaude -p في خطط الاشتراك من رصيد شهري منفصل لـ Agent SDK، مختلف عن حدود الاستخدام التفاعلي. تحقق دائمًا من شروط Anthropic الحالية قبل بناء توقعات التكلفة.

مقارنة مباشرة

راجع الأسعار والحالة الرسمية من صفحة أسعار Anthropic ووثائق الوكلاء المُدارين قبل اعتماد قرار ميزانية.

المعيار	وكلاء Claude المُدارون	حزمة تطوير وكيل Claude
مكان تشغيل الحلقة	بنية Anthropic التحتية	عمليتك وبنيتك التحتية
الواجهة	REST API + SSE	مكتبة Python أو TypeScript
التحكم في الحلقة	تكوين وتوجيه عبر الأحداث	تحكم كامل داخل العملية
التكلفة	رموز Claude + رسوم تشغيل لكل ساعة جلسة نشطة	رموز Claude + تكلفة البنية التي تشغلها
عبء التشغيل	منخفض	أعلى
قابلية المراقبة	سجل أحداث مستضاف وقابل للاستعادة	Hooks وسجلات ومراقبة تبنيها أنت
زمن الوصول	قفزة إلى وقت تشغيل مستضاف	قرب أعلى من خدماتك الداخلية
محلية البيانات	الجلسة والبيئة لدى Anthropic أو AWS حسب الخيار	الحالة والأدوات داخل بنيتك
تنفيذ الأدوات المخصصة	تطبيقك ينفذ ويرجع النتيجة عبر الأحداث	دوال داخل العملية
أفضل استخدام	أعمال طويلة وغير متزامنة	بيانات حساسة، VPC، تحكم دقيق

كيف تقرأ المقارنة عمليًا؟

1. التكلفة ليست رقمًا واحدًا

وكلاء Claude المُدارون يضيفون تكلفة تشغيل لكل ساعة جلسة نشطة. إذا كان الوكيل يعمل طويلًا أو ينتظر بين أدوات كثيرة، فهذا يؤثر على التكلفة.

مع SDK لا توجد رسوم تشغيل مستضافة من Anthropic لكل ساعة، لكنك تدفع مقابل:

• الخوادم.
• العزل.
• التخزين.
• المراقبة.
• التوسع.
• وقت فريق التشغيل.

لذلك اسأل:

هل أريد دفع تكلفة تشغيل مُدارة، أم أريد امتلاك البنية وتشغيلها؟

2. محلية البيانات قد تحسم القرار

إذا كان الوكيل يتعامل مع بيانات منظمة، مالية، صحية، أو محصورة داخل VPC، فغالبًا ستحتاج SDK.

مع SDK:

• تنفيذ الأدوات داخل بنيتك.
• حالة الجلسة على نظامك.
• يمكنك ربط سياسات تدقيق داخلية.
• فقط الاستنتاج يذهب إلى Claude.

مع الوكلاء المُدارين:

• بيئة الاختبار وسجل الأحداث مستضافان لدى Anthropic أو AWS حسب التوفر والقيود.

3. قابلية المراقبة تختلف في مكانها

الوكلاء المُدارون يعطونك سجل أحداث مستضافًا.

SDK تعطيك Hooks، لكن عليك ربطها بـ:

• OpenTelemetry.
• Datadog.
• Grafana.
• سجلات داخلية.
• نظام تدقيق.

مثال Hook لتسجيل كل استخدام أداة:

def post_tool_use_hook(event):
    audit_log.write({
        "tool": event.tool_name,
        "input": event.input,
        "result_status": event.result.status,
        "session_id": event.session_id
    })

اختبر APIs التي يستدعيها الوكيل

بغض النظر عن نموذج الاستضافة، فشل الوكيل غالبًا لا يأتي من Claude نفسه، بل من API غير مستقرة أو أداة MCP تعيد شكلًا غير متوقع.

اختبر ثلاث طبقات قبل الإطلاق.

1. عقود API

كل أداة يستدعيها الوكيل لها مخطط طلب واستجابة. إذا تغيرت الواجهة الخلفية، قد يفشل الوكيل بصمت أو يبدأ في اتخاذ قرارات خاطئة.

باستخدام Apidog، يمكنك:

1. تعريف مخطط endpoint.
2. إنشاء mock service.
3. تشغيل اختبارات عقود.
4. إعادة تشغيل سيناريوهات وكيل حقيقية ضد المحاكاة.

مثال عقد مبسط لاسترداد مدفوعات:

{
  "endpoint": "/refunds",
  "method": "POST",
  "request": {
    "transaction_id": "string",
    "amount": "number",
    "reason": "string"
  },
  "response": {
    "refund_id": "string",
    "status": "approved|pending|rejected"
  }
}

إذا بدأت الخدمة الحقيقية بإرجاع state بدل status، يجب أن يفشل اختبار العقد قبل أن يفشل وكيلك في الإنتاج.

راجع كيفية اختبار وكلاء الذكاء الاصطناعي الذين يستدعون واجهات برمجة التطبيقات.

2. خوادم MCP

كلا الخيارين يدعمان MCP. لكن خادم MCP نفسه قد يفشل بطرق شائعة:

• أداة ترجع JSON غير مطابق.
• مهلة لا تُعالج.
• خطأ يرجع نصًا حرًا بدل كائن منظم.
• اختلاف أسماء الحقول.
• غياب pagination أو rate limits واضحة.

اختبر كل أداة MCP مباشرة قبل ربطها بوكيل. راجع اختبار خادم MCP باستخدام Apidog.

3. نمط طلبات الوكيل

الوكلاء لا يتصرفون مثل المستخدمين البشر. قد يفعلون الآتي:

• يعيدون المحاولة بسرعة.
• يستدعون نفس endpoint عدة مرات.
• يقرؤون بيانات جزئية.
• يكررون استدعاء أداة بعد خطأ غامض.
• يخلطون بين أخطاء مؤقتة ونجاح جزئي.

لذلك أعد تشغيل حركة مرور الوكيل ضد mocks. استخدم مصححًا يلتقط الطلبات والاستجابات الفعلية بدل الاعتماد على التوقعات.

يمكنك تنزيل Apidog لاختبار هذه التبعيات قبل ربط الوكيل بعميل حقيقي.

إطار قرار سريع

ابدأ بهذه الأسئلة. أول “نعم” قوية غالبًا تحدد الخيار.

اختر وكلاء Claude المُدارين إذا:

• الوكيل يعمل دقائق أو ساعات.
• العمل غير متزامن.
• لا تريد تشغيل workers أو sandbox أو session store.
• فريقك صغير وعبء العمليات هو القيد الأساسي.
• تحتاج سجل أحداث مستضاف وقابل للاستعادة.
• بياناتك تسمح بوجود الجلسة في بيئة Anthropic أو AWS.
• أنت مرتاح للتعامل مع منتج في مرحلة بيتا وبعض الميزات المقيدة.

اختر حزمة تطوير وكيل Claude إذا:

• الوكيل يجب أن يعمل داخل VPC.
• يحتاج الوصول إلى قواعد بيانات أو خدمات داخلية.
• لا يمكن تخزين حالة الجلسة لدى طرف ثالث.
• تحتاج Hooks للتدقيق والسياسات.
• تحتاج أذونات دقيقة وموافقات بشرية.
• تريد تنفيذ الأدوات داخل العملية.
• تريد الاستفادة من عقود Bedrock أو Vertex أو Azure القائمة مع إبقاء الحلقة داخليًا.
• تعمل على نموذج أولي محلي سريع.

مسار شائع

مسار عملي للفرق:

1. ابدأ بـ Agent SDK محليًا لتسريع التجربة.
2. اختبر APIs وMCP بعقود ومحاكاة.
3. قيّم عبء التشغيل.
4. انقل الإنتاج إلى الوكلاء المُدارين إذا كانت وفورات التشغيل أكبر من خسارة التحكم.

لكن لا تعامل النقل كتغيير إعدادات فقط. الواجهات مختلفة، تنفيذ الأدوات مختلف، وحالة الجلسة تنتقل من نظام ملفاتك إلى سجل مستضاف.

إذا كنت تقارن أيضًا بين النماذج أو وكلاء البرمجة، راجع مقارنة Claude و Codex لعام 2026.

حالات استخدام عملية

1. وكيل استرداد مدفوعات

المهمة:

1. قراءة تذكرة دعم.
2. البحث عن المعاملة.
3. التحقق من سياسة الاسترداد.
4. استدعاء API المدفوعات.
5. كتابة ملخص إلى التذكرة.

هذا الوكيل يتعامل مع المال، لذلك تحتاج:

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

الخيار الأنسب غالبًا: Agent SDK.

سبب الاختيار:

• يعمل داخل VPC.
• حالة الجلسة تبقى داخل الشركة.
• يمكن استخدام PreToolUse لفرض الموافقات.
• يمكن تسجيل كل استدعاء API.

مثال سياسة:

def pre_tool_use_hook(event):
    if event.tool_name == "issue_refund":
        amount = event.input["amount"]

        if amount > 500:
            return {
                "allow": False,
                "requires_human_approval": True,
                "reason": "استرداد يتجاوز الحد المسموح آليًا"
            }

    return {"allow": True}

قبل الإطلاق، يحاكي الفريق نقاط نهاية المدفوعات في Apidog، يشغل اختبارات عقود، ثم يعيد تشغيل تذاكر تاريخية ضد المحاكاة. إذا اكتشف أن الوكيل يعيد طلب الاسترداد بعد 504 رغم نجاح العملية في الخلفية، فهذا فشل يجب اكتشافه قبل الإنتاج.

2. وكيل فرز تذاكر دعم غير متزامن

المهمة:

1. استقبال آلاف التذاكر يوميًا.
2. تصنيف كل تذكرة.
3. سحب سجلات مرتبطة.
4. صياغة رد.
5. حل التذكرة أو تصعيدها.

الخصائص:

• كل مهمة تستغرق عدة دقائق.
• العمل غير متزامن.
• البيانات منخفضة الحساسية.
• الفريق لا يريد تشغيل أسطول workers.

الخيار الأنسب غالبًا: وكلاء Claude المُدارون.

سبب الاختيار:

• Anthropic تدير الجلسات.
• مناسب للأعمال الطويلة.
• سجل الأحداث المستضاف يساعد في تتبع كل تذكرة.
• عبء التشغيل أقل.

لكن ما زال يجب اختبار:

• API السجلات.
• MCP الخاص بنظام التذاكر.
• مخططات الطلبات والاستجابات.
• حالات المهلة وإعادة المحاولة.

3. وكيل عمليات بيانات داخلي خلف جدار الحماية

المهمة:

“أعد تشغيل أقسام ETL الفاشلة بالأمس، ثم أرسل تقرير الحالة.”

يتطلب ذلك:

• الوصول إلى API مهام داخلية.
• تشغيل سكريبت إصلاح.
• قراءة سجلات داخلية.
• التعامل مع بيانات حساسة.

الخيار الأنسب: Agent SDK.

سبب الاختيار:

• الخدمات ليست متاحة من الإنترنت العام.
• البيانات لا يجب أن تغادر البيئة.
• يمكن ربط الأدوات عبر MCP داخلي.
• يمكن تسجيل كل أمر في نظام التدقيق الحالي.

في هذه الحالة، خاصية “يعمل داخل عمليتك” ليست ميزة إضافية؛ إنها شرط معماري.

للمزيد عن سبب اعتبار الوكلاء مستهلكين أساسيين لـ APIs، راجع وكلاء الذكاء الاصطناعي كمستهلكين جدد لواجهة برمجة التطبيقات.

خلاصة تنفيذية

قرار Claude Managed Agents مقابل Claude Agent SDK هو قرار تشغيل وحوكمة بيانات أكثر من كونه اختيار مكتبة.

تذكّر:

• الوكلاء المُدارون يستضيفون الحلقة وبيئة الاختبار.
• SDK تشغل الحلقة داخل بنيتك.
• الوكلاء المُدارون يقللون عبء التشغيل.
• SDK تعطيك تحكمًا أعلى ومحلية بيانات أقوى.
• التكلفة تعتمد على شكل عبء العمل، لا على سعر الرموز فقط.
• اختبارات API وMCP ضرورية في كلا الخيارين.
• الانتقال من SDK إلى الوكلاء المُدارين ممكن، لكنه مشروع هجرة.

قبل ربط الوكيل بأي نظام حقيقي، ضع كل API وخادم MCP تحت الاختبار. قم بتنزيل Apidog لمحاكاة endpoints، تشغيل اختبارات العقود، وتصحيح حركة مرور الوكيل الفعلية.

الأسئلة الشائعة

ما الفرق الجوهري بين وكلاء Claude المُدارين وAgent SDK؟

وكلاء Claude المُدارون هو REST API مستضاف تدير فيه Anthropic حلقة الوكيل وبيئة الاختبار وحالة الجلسة. Agent SDK هي مكتبة Python أو TypeScript تشغل الحلقة داخل عمليتك وبنيتك التحتية.

هل Agent SDK هي نفسها Claude Code SDK القديمة؟

نعم. تم تغيير اسم Claude Code SDK إلى Claude Agent SDK ليعكس نطاقًا أوسع من مهام البرمجة. الآلية الأساسية ما زالت حلقة وكيل وأدوات مدمجة وإدارة سياق.

أي الخيارين أرخص؟

يعتمد على عبء العمل. الوكلاء المُدارون يضيفون رسوم تشغيل لوقت الجلسة النشط. SDK لا تضيف رسوم تشغيل مستضافة من Anthropic لكل ساعة، لكنك تدفع تكلفة الخوادم والتشغيل والمراقبة. تحقق من الأسعار الرسمية قبل الميزانية.

هل يمكن استخدام MCP مع كلا الخيارين؟

نعم. كلاهما يدعم MCP. لذلك يجب اختبار خوادم MCP قبل ربطها بأي وكيل. راجع اختبار خادم MCP باستخدام Apidog.

كيف أحافظ على بيانات العملاء خارج بنية Anthropic؟

استخدم Agent SDK وشغّل الحلقة داخل بيئتك. بذلك يبقى تنفيذ الأدوات وحالة الجلسة على بنيتك، بينما يذهب استنتاج النموذج فقط إلى Claude. مع الوكلاء المُدارين، تعيش بيئة الاختبار وسجل الأحداث في بيئة Anthropic أو AWS حسب الخيار.

هل وكلاء Claude المُدارون جاهزون للإنتاج؟

تم إطلاقهم في نسخة تجريبية عامة في أبريل 2026 ويتطلبون الرأس التجريبي managed-agents-2026-04-01. بعض الميزات قد تكون مقيدة بطلب معاينة بحثية. تحقق من الوثائق الرسمية قبل الاعتماد الإنتاجي.

كيف أختبر وكيلًا قبل أن يستخدم APIs حقيقية؟

قم بمحاكاة كل API وخادم MCP، واكتب اختبارات عقود، ثم أعد تشغيل حركة مرور واقعية مقابل المحاكاة. يغطي Apidog هذه الخطوات، بما في ذلك تصحيح حركة مرور الوكيل. راجع كيفية اختبار وكلاء الذكاء الاصطناعي الذين يستدعون واجهات برمجة التطبيقات.

هل يمكن البدء بخيار ثم الانتقال للآخر؟

نعم. المسار الشائع هو النموذج الأولي باستخدام Agent SDK ثم الانتقال إلى الوكلاء المُدارين للإنتاج إذا كان تقليل التشغيل أهم من التحكم. لكنه ليس تغيير إعدادات فقط: الواجهة، تنفيذ الأدوات، وإدارة الجلسات تختلف.