Anthropic Claude Managed Agents 公测上线：5 分钟跑通全托管 AI 代理

في 8 أبريل 2026، أطلقت شركة Anthropic رسمياً النسخة التجريبية العامة (Public Beta) من Claude Managed Agents ضمن منصة Claude. تتيح مجموعة الأدوات المدارة هذه (Managed Agent Harness) دمج "حلقة الوكيل + تنفيذ الأدوات + بيئة الحاوية المعزولة + استمرارية الحالة" في مجموعة من واجهات برمجة تطبيقات REST. بفضل ذلك، لم يعد المطورون بحاجة لبناء حلقة الوكيل (agent loop) أو طبقة تنفيذ الأدوات أو بيئة التشغيل بأنفسهم؛ إذ يكفي استدعاء نقاط النهاية الثلاث /v1/agents و /v1/environments و /v1/sessions لتمكين Claude من تنفيذ المهام طويلة الأمد كوكيل مستقل داخل بيئة محصنة وآمنة.

بالتزامن مع الإطلاق التجريبي، تم إصدار ترويسة الطلب managed-agents-2026-04-01 التجريبية، ومجموعة أدوات جديدة agent_toolset_20260401، وبروتوكول تدفق الأحداث القائم على أحداث الخادم المرسلة (Server-Sent Events). يستعرض هذا المقال، بناءً على الوثائق الرسمية وأحدث ملاحظات الإصدار، المفاهيم الأساسية لـ Claude Managed Agents، وطرق دمج واجهة البرمجة، ونموذج الأحداث، وقواعد الفوترة، مع توفير كود Python / curl جاهز للاستخدام لمساعدتك في تشغيل جلسة وكيل مدار فعلي خلال 5 دقائق.

ما هو Claude Managed Agents: التموضع الأساسي للوكلاء المدارين

قبل فهم الوكلاء المدارين (Managed Agents)، يجب توضيح علاقتهم بـ Messages API التقليدية. توفر Anthropic الآن مسارين للبناء: واجهة Messages API وهي المسؤولة عن استدعاء النموذج مباشرة، وتناسب السيناريوهات التي تتطلب تحكماً كاملاً في حلقة الوكيل؛ بينما توفر Managed Agents بيئة تشغيل وكيل مجهزة مسبقاً وقابلة للتهيئة، وهي مناسبة لأعباء العمل التي تستغرق وقتاً طويلاً، وتتطلب معالجة غير متزامنة، أو عزلاً في بيئة الحاوية.

الاختلافات في التموضع مع Messages API

🎯 نصيحة اختيار المسار: إذا كنت تبني مهمة خلفية تتطلب "كتابة ذكاء اصطناعي للأكواد، وتشغيل سكربتات، وتصفح الويب ثم تلخيص النتائج"، فإن Managed Agents ستوفر عليك عناءً أكبر من ربط Messages API يدوياً مع بيئة تشغيل خاصة بك. ننصح بإجراء اختبار مقارنة بينهما على منصة APIYI apiyi.com لتحديد المسار الأنسب لأعمالك بسرعة.

المفاهيم الأساسية الأربعة

يتم بناء Claude Managed Agents حول أربعة مفاهيم أساسية:

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

نظرة فاحصة على القدرات الجوهرية لـ Managed Agents: الصناديق الرملية، مجموعات الأدوات، وتدفق SSE

بعد فهم المفاهيم الأربعة الأساسية، دعونا نلقي نظرة على القدرات العملية التي توفرها في نسخة الإصدار التجريبي (Beta).

الصندوق الرملي الآمن (Sandbox) وإعدادات الحاوية

تعمل كل جلسة (Session) داخل حاوية سحابية معزولة، وتتميز بالخصائص التالية:

• بيئة تشغيل جاهزة: بيئات لغات البرمجة الرئيسية مثل Python وNode.js وGo متاحة للاستخدام المباشر.
• سياسات الشبكة: تدعم نمط unrestricted (غير مقيد) وأنماط شبكة أكثر صرامة ومقيدة، لمنع تحول الصندوق الرملي إلى قناة لتسريب البيانات.
• نظام الملفات: يتم الاحتفاظ بالملفات داخل الحاوية طوال دورة حياة الجلسة، مما يسمح للـ Agent بقراءة وكتابة البيانات عبر جولات المحادثة.
• الموارد القابلة للتركيب: يمكن تحميل ملفات البيانات أو النصوص البرمجية مسبقاً في البيئة (Environment).

مجموعة الأدوات المدمجة agent_toolset_20260401

يوفر إصدار المعاينة العامة معرفاً موحداً لمجموعة الأدوات agent_toolset_20260401، مما يسمح بتفعيل جميع الأدوات المبنية مسبقاً دفعة واحدة:

🎯 نصيحة للمطورين: agent_toolset_20260401 هي "مفتاح تشغيل جماعي" لتسهيل التحقق من النماذج الأولية بسرعة. في بيئة الإنتاج، نوصي بتفعيل المجموعات الفرعية للأدوات حسب الحاجة وفقاً لمبدأ الامتيازات الأقل. إذا كنت ترغب في مقارنة تكلفة الـ token لمجموعات أدوات مختلفة عبر APIYI (apiyi.com)، يمكنك تبديل base_url مباشرة وإعادة استخدام نفس الكود.

نموذج أحداث التدفق (Server-Sent Events)

على عكس نموذج "طلب واحد ← استجابة واحدة" التقليدي في واجهة البرمجة (Messages API)، تعتمد Managed Agents على نموذج الأحداث الموجهة + دفع البيانات عبر SSE. أنواع الأحداث الرئيسية هي:

البدء السريع مع Claude Managed Agents: المسار الكامل للربط بـ API

فيما يلي عرض لأقصر كود لتنفيذ جلسة Managed Agent كاملة. تشمل الخطوات الأساسية: إنشاء Agent ← إنشاء Environment ← إنشاء Session ← إرسال رسالة والاشتراك في تدفق SSE.

المتطلبات المسبقة

1. مفتاح API خاص بـ Claude (أو مفتاح متوافق من APIYI apiyi.com).
2. إدراج الترويسة anthropic-beta: managed-agents-2026-04-01 في كل طلب؛ تقوم مكتبة SDK الرسمية بإضافتها تلقائياً، أما عند استخدام curl يدوياً فيجب التصريح بها.
3. تحديث مكتبة Python SDK إلى أحدث إصدار: pip install -U anthropic.

مثال Python مبسط

from anthropic import Anthropic

client = Anthropic(
    # يمكن إعادة استخدام الكود الحالي عند استخدام خدمة وسيط APIYI، دون الحاجة لتغيير طريقة استخدام SDK
    base_url="https://api.apiyi.com",
    api_key="YOUR_API_KEY",
)

# 1. إنشاء Agent
agent = client.beta.agents.create(
    name="Coding Assistant",
    model="claude-sonnet-4-6",
    system="You are a helpful coding assistant.",
    tools=[{"type": "agent_toolset_20260401"}],
)

# 2. إنشاء Environment (شبكة غير مقيدة)
env = client.beta.environments.create(
    name="quickstart-env",
    config={"type": "cloud", "networking": {"type": "unrestricted"}},
)

# 3. إنشاء Session
session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=env.id,
    title="Quickstart session",
)

# 4. فتح تدفق SSE وإرسال رسالة المستخدم
with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[{
            "type": "user.message",
            "content": [{
                "type": "text",
                "text": "Generate the first 20 Fibonacci numbers to fibonacci.txt",
            }],
        }],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                print(block.text, end="")
        elif event.type == "agent.tool_use":
            print(f"\n[Using tool: {event.name}]")
        elif event.type == "session.status_idle":
            print("\n\nAgent finished.")
            break

# إنشاء Agent مع إدراج ترويسة Beta
curl -sS https://api.apiyi.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant",
    "model": "claude-sonnet-4-6",
    "system": "You are a helpful coding assistant.",
    "tools": [{"type": "agent_toolset_20260401"}]
  }'

# هيكلية طلب إنشاء البيئة والجلسة متشابهة، راجع وثائق البداية السريعة الرسمية
# عند الاشتراك في تدفق SSE استخدم:
# curl -N -H "Accept: text/event-stream" \
#   https://api.apiyi.com/v1/sessions/$SESSION_ID/stream

🎯 نصيحة لإعادة استخدام الكود: الكود أعلاه يشير إلى base_url الخاص بـ APIYI apiyi.com، مما يتيح لك الوصول إلى واجهات Managed Agents التجريبية من داخل الصين بوضوح وزمن انتقال منخفض. جميع المعاملات، ترويسات Beta، وأنواع الأحداث في SDK الرسمية متوافقة تماماً، ولا حاجة لأي تغليف إضافي.

رسم توضيحي للعملية من خمس خطوات

[العميل] ──1. إنشاء الوكيل──────────▶ [API]
[العميل] ──2. إنشاء البيئة────▶ [API]
[العميل] ──3. إنشاء الجلسة────────▶ [API]
[العميل] ──4. فتح تدفق SSE───────▶ [API]
[العميل] ──5. إرسال user.message─────▶ [API]
         ◀─ agent.message / tool_use / tool_result / status_idle ──

جوهر العملية برمتها هو: الأحداث أولاً، ثم الاستقبال المتدفق. توصي الوثائق الرسمية بفتح تدفق SSE قبل إرسال حدث المستخدم، وذلك لضمان عدم تفويت أي حالة وسيطة.

القواعد الأساسية لـ Claude Managed Agents: حدود المعدل، الفوترة، والامتثال للعلامة التجارية

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

قواعد حدود المعدل (Rate Limiting)

يتم احتساب حدود المعدل على مستوى المؤسسة (Organization)، وهي مستقلة عن مستوى الاستخدام (Tier) الخاص بالحساب:

بالإضافة إلى ذلك، تظل حدود استهلاك المؤسسة والحد الأقصى لمعدل الاستخدام (Tier) سارية المفعول. تتطلب مهام الوكيل ذات التزامن العالي تخطيطًا مسبقًا للحد من المعدل، أو توزيعها عبر مجموعة موارد متعددة الحسابات من خلال خدمة وكيل API الخاص بـ APIYI على apiyi.com.

نموذج الفوترة

تتكون فوترة Managed Agents من جزأين:

1. رسوم وقت تشغيل الجلسة: 0.08 دولار أمريكي لكل ساعة جلسة.
2. رسوم توكن النموذج: تُحسب وفقًا للسعر القياسي للنموذج المختار من Claude (مثل Sonnet 4.6 / Opus 4.6).

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

نقاط الامتثال للعلامة التجارية

تضع شركة Anthropic قيودًا واضحة على استخدام الشركاء لعلامة Claude التجارية:

• ✅ مسموح به: Claude Agent، Claude (ضمن سياق القائمة)، {YourAgentName} Powered by Claude.
• ❌ ممنوع: أسماء مثل Claude Code، Claude Code Agent، Claude Cowork؛ ويُمنع تقليد فن الـ ASCII أو العناصر المرئية الخاصة بـ Claude Code.

🎯 نصيحة امتثال: بالنسبة لمنتجات الوكيل المدارة المقدمة للمؤسسات، يُنصح بالحفاظ على هوية علامتك التجارية الخاصة، والاكتفاء بالإشارة إلى "Powered by Claude" في التوثيق التقني فقط. إذا كنت بحاجة إلى تفويض رسمي للعلامة التجارية أو واجهة مستخدم (UI) جاهزة، يمكنك الحصول على إرشادات الربط عبر خدمة APIYI على موقع apiyi.com.

حالات الاستخدام النموذجية لـ Claude Managed Agents: ما هي الأعمال الأكثر جدوى للنقل؟

على الرغم من أن النسخة التجريبية العامة لا تزال تحتوي على بعض الميزات (مثل النتائج، الوكلاء المتعددون، والذاكرة) في مرحلة "معاينة الأبحاث" (Research Preview)، إلا أنه يمكن تطبيقها فوراً على الفئات الأربع التالية.

أربع فئات من أعباء العمل المناسبة للنقل الفوري

سيناريوهات لا يُنصح بها حاليًا

• المحادثات الفورية ذات التأخير المنخفض للغاية: إن تكاليف بدء الجلسة و SSE (أحداث جانب الخادم) ليست مثالية لواجهات المستخدم التي تتطلب استجابة بجزء من الثانية.
• النشر المحلي الصارم للامتثال: Managed Agents هي خدمة سحابية، ولا تدعم النشر المحلي (on-prem).
• المشاريع البحثية التي تتطلب تخصيصًا كاملاً لحلقة الوكيل: لا يزال يُنصح باستخدام Messages API لبناء الحلقة البرمجية الخاصة بك.

🎯 نصيحة مسار النقل: قم بإجراء تطبيق مقارن لأعمال الوكيل الحالية التي تستخدم "Messages API + جدولة الأدوات المخصصة" باستخدام Managed Agents، وقم بتشغيل النسختين باستخدام نفس الموجه (Prompt)، ثم قارن بين تكلفة التوكن ومعدل الإنجاز. من خلال APIYI على apiyi.com، يمكنك الوصول إلى كلا النوعين من الواجهات باستخدام مفتاح API واحد، مما يغنيك عن تبديل المفاتيح أثناء التقييم الموازي.

الأسئلة الشائعة FAQ: تجنب الأخطاء الشائعة عند البدء مع Managed Agents

س1: هل أحتاج إلى إرفاق managed-agents-2026-04-01 يدوياً؟

عند استخدام حزمة تطوير البرمجيات (SDK) الرسمية (Python / TypeScript / Go / Java / C# / Ruby / PHP)، لا حاجة للإرفاق اليدوي، حيث ستقوم الحزمة بحقنه تلقائياً في مسار النسخة التجريبية. فقط عند استخدام curl الأصلي أو عميل HTTP مخصص، ستحتاج إلى إضافة anthropic-beta: managed-agents-2026-04-01 بشكل صريح. نوصي بالطلب عبر المسار القياسي عند استخدام خدمة وكيل API من APIYI (apiyi.com) للحصول على أفضل توافقية.

س2: هل ستضيع الجلسة في حال انقطاع تدفق SSE؟

لا. يتم حفظ سجل أحداث الجلسة (Session) على جانب الخادم بشكل دائم. بعد إعادة الاتصال بنقطة النهاية /v1/sessions/{id}/stream، يمكنك الاستمرار في تلقي الأحداث اللاحقة، حيث ستقوم واجهة برمجة التطبيقات (API) بإعادة إرسال البيانات من نقطة الانقطاع. يختلف هذا تماماً عن واجهة Messages API التي تعتمد على "طلب واحد واستجابة واحدة".

س3: كيف يمكن مقاطعة وكيل (Agent) قيد التشغيل؟

يدعم Managed Agents التوجيه أثناء التنفيذ (mid-execution steering): بإرسال رسالة user.message إضافية إلى نقطة النهاية /events لنفس الجلسة، يمكنك مقاطعة حلقة استدعاء الأدوات الحالية وتغيير مسار العمل. كما يمكنك إنهاء الجلسة قسراً عبر نقطة نهاية مخصصة للمقاطعة.

س4: متى يتم احتساب تكاليف الجلسة؟

يتم احتساب التكلفة بمعدل 0.08 دولار/ساعة طالما أن الجلسة في حالة "قابلة للتشغيل"، حتى لو كان الوكيل في حالة status_idle. نوصي بإغلاق الجلسة صراحةً بعد الانتهاء من المهام لتجنب تكاليف التشغيل الخامل. يمكنك اكتشاف الجلسات الخاملة غير الطبيعية بسرعة من خلال لوحة تفاصيل الفواتير في APIYI (apiyi.com).

س5: ما هي نماذج Claude التي تدعمها Managed Agents؟

يدعم الإصدار التجريبي العام حالياً ثلاثة نماذج رئيسية هي: Claude Sonnet 4.6، Claude Opus 4.6، وClaude Haiku 4.5. سياق النافذة الطويل (1 مليون توكن) متاح افتراضياً في نموذجي Opus 4.6 وSonnet 4.6 دون الحاجة إلى ترويسة تجريبية إضافية.

س6: هل يمكن نقل Agent Skills / MCP Server الحالية؟

نعم. يمكن الإعلان مباشرة عن قائمة خوادم MCP ومراجع المهارات (Skills) داخل تعريف الوكيل. أعادت Managed Agents استخدام بروتوكول Agent Skills التجريبي الصادر في أكتوبر 2025، مما يعني أن حزم المهارات الموجودة يمكن دمجها دون الحاجة إلى تعديلات.

الخلاصة: التحول النموذجي الذي أحدثته Managed Agents

يمثل إطلاق Claude Managed Agents في النسخة التجريبية العامة ترسيم شركة Anthropic لـ "بنية تحتية للوكلاء" كمنتج رسمي. بالنسبة للمطورين، لا تكمن قيمة هذا التحديث في ميزة واحدة، بل في القضاء دفعة واحدة على خمس نقاط ألم في أنظمة الوكلاء الذاتية: تنفيذ الحلقات، تنفيذ الأدوات، العزل في بيئة محمية (Sandbox)، استمرارية الحالة، وبروتوكول تدفق الأحداث. ما عليك سوى إرفاق ترويسة الطلب التجريبية managed-agents-2026-04-01 واستدعاء ثلاث نقاط نهاية لتحويل Claude إلى "وكيل تنفيذي مستقل" بحق.

بالاقتران مع أحدث نماذج Claude Sonnet 4.6 / Opus 4.6، وسياق 1 مليون توكن، وAgent Skills مع التخزين المؤقت التلقائي، تمنح Managed Agents لأول مرة مساراً قابلاً للتطبيق على مستوى المؤسسات لخدمات الوكلاء الخلفية التي تستغرق وقتاً طويلاً أو تعمل بشكل غير متزامن أو تتطلب أدوات متعددة. الخطوة التالية هي البدء بتجربة هذا النموذج في سيناريوهات منخفضة المخاطر (مثل التقارير الآلية أو قوالب الأكواد البرمجية) قبل الانتقال تدريجياً إلى المهام الحيوية.

🎯 نصيحة عملية: للفرق التي تستعد للترحيل، نوصي بتوجيه base_url إلى APIYI (apiyi.com)، حيث يتيح ذلك إعادة استخدام كود SDK الرسمي، والحصول على سرعات وصول مستقرة داخل البلاد، مع دعم التقييم المتوازي لكل من Messages API وManaged Agents لاتخاذ قرارات اختيار دقيقة بناءً على البيانات.

— فريق APIYI (فريق تقنيات APIYI apiyi.com)