بناء وكيل SRE للاستجابة للحوادث باستخدام Claude Managed Agents — دليل عملي خطوة بخطوة

Ship Your First Managed Agent — الشريحة الافتتاحية من ورشة العمل

1. تطور أدوات بناء الوكلاء: من Messages API إلى Managed Agents

عندما أطلقت Anthropic أول نموذج Claude في 2023، كان الوصول عبر Messages API — tokens in / tokens out. كل مطور كان عليه تنفيذ إدارة السياق، حلقة الوكيل، والضغط بنفسه. مع تطور النماذج وزادت تعقيد المهام، ظهر Agent SDK الذي سمح باستدعاء Claude Code برمجياً ضمن harness موحد، لكن بقي على المطور إدارة الاستضافة والتوسع.

هذا قاد إلى Claude Managed Agents — أول harness مُدار بالكامل من Anthropic يتولى التوسع والمكونات الجاهزة للإنتاج. أوضحت إيزابيلا هي (مهندسة في فريق Applied AI في Anthropic) خلال الورشة أن الـ harness يجب أن يتطور مع الوكلاء. مثلاً عندما أصدر Sonnet 4.5 سلوك “قلق السياق” (إنهاء المهام مبكراً)، أضاف الفريق تحسينات في الـ harness. لكن مع Opus 4.5 اختفى هذا السلوك تماماً.

Messages API ← Agent SDK ← Claude Managed Agents

2. الهندسة المعمارية: فصل الدماغ عن الأيدي

أهم قرار تصميمي في Managed Agents هو فصل حلقة الوكيل (Agent Loop) عن تنفيذ الأدوات (Tool Execution). في الأطر التقليدية كانتا مقترنتين في نفس الحاوية، مما يبسط التصميم لكنه يخلق تحديات في الأمان والأداء.

Agent Loop (الدماغ) منفصل عن Tool Execution (الأيدي)

• الأمان: الوكيل “يفكر” على خوادم Anthropic المُدارة، بينما تنفذ “الأيدي” الأدوات في بيئتك — بيانات الاعتماد مشفرة ومحمية
• زمن الاستجابة: انخفاض > 90% في Time to First Token (TTFT) مقارنة بإنشاء حاوية جديدة لكل جلسة
• المرونة: BYOC (Bring Your Own Container) — أُطلقت خلال الورشة — تتيح تشغيل البيئة في بنيتك التحتية

3. المكونات الأساسية الثلاثة: الوكيل، البيئة، الجلسة

Agent (الدماغ) — Environment (الأيدي) — Session (الربط)

أ. الوكيل (Agent) — الدماغ 🧠
الـ system prompt الأساسي. يحدد الشخصية والنموذج (مثل Opus 4.7)، خوادم MCP، والمهارات. الوكيل لا ينفذ الأدوات مباشرة — بل يفكر ويقرر أي أداة ينادي بها.

Agent: النموذج، system prompt، MCP servers، والمهارات

ب. البيئة (Environment) — الأيدي 👐
مساحة ينفذ فيها الوكيل إجراءاته — أشبه بحاوية أو Sandbox. يمكن تقييد الوصول عبر قائمة السماح (Allowed List).

Environment: مساحة التنفيذ مع قائمة السماح للشبكة

ج. الجلسة (Session) — الربط 🔗
تربط الوكيل بالبيئة. تسمح ببث الأحداث للمستخدم وتسجيل كل شيء للمراقبة. الجلسات مُدارة على الخادم — يمكنك إغلاق اللابتوب والعودة لاحقاً.

4. ورشة العمل: بناء وكيل SRE عملي خطوة بخطوة

قسمت إيزابيلا الورشة إلى أجزاء، حيث ينسخ الحضور الكود من agent_complete.py إلى agent.py على تطبيق Streamlit.

استنساخ المستودع وتشغيل Streamlit — كل ما تحتاج للبدء

الخطوة 1: تعريف وكيل SRE

System prompt بسيط: “أنت وكيل SRE مسؤول عن تشخيص الحوادث. لديك أدوات: metrics, recent deployments, get diff, logs.” — النموذج: Claude Opus 4.7.

الخطوة 2: تعريف البيئة

بيئة Anthropic Cloud مع وصول شبكة غير مقيد. مع BYOC يمكن تشغيل البيئة في بنيتك التحتية الخاصة. كما أُعلنت Claude MCP Tunnels التي تتيح تشغيل MCP servers في بيئة خاصة.

Bring Your Own Container: البيئة في حاوياتك الخاصة

الخطوة 3: رفع الملفات

رفع سجلات الحادثة كملف عبر Files API. المبدأ: كلما زادت البيانات، زادت قوة الوكيل. هندسة السياق (Context Engineering) هي أكبر استثمار للمطورين.

رفع logs/metrics عبر Files API — السياق هو كل شيء

الخطوة 4: تعريف الجلسة وربط المكونات

الجلسة تربط الوكيل بالبيئة وتُحمّل الموارد. ثم يُضاف البث المباشر لرؤية استجابات الوكيل في الوقت الفعلي.

Session: agent_id + environment_id + الموارد + streaming

الخطوة 5: إضافة الأدوات المحلية

الأدوات المحلية (get_metrics, get_recent_deploys) تُعرّف بصيغة JSON وتُحمّل محلياً. الوكيل يناديها بينما تبقى حلقة الوكيل على خوادم Anthropic.

تعريف الأدوات بصيغة JSON — التنفيذ محلياً

الفرق الجوهري: تنفيذ الأداة يحدث محلياً على حاسوبك، بينما حلقة الوكيل تعمل على خوادم Anthropic.

النتيجة: تشخيص تلقائي للحادثة

الوكيل حلل السجلات، نادى get_metrics، ونادى get_recent_deploys. السبب الجذري: استنزاف تجمع قاعدة البيانات (Database Pool Exhaustion) بسبب commit من Alice أعاد هيكلة Order Summary Builder.

الوكيل يفحص logs و metrics ويحلل البيانات

بإضافة صلاحيات Claude Code، يمكن للوكيل اقتراح إصلاحات وإنشاء PRs — ليكمل دورة الاستجابة بالكامل: اكتشاف → تشخيص → إصلاح.

5. الأحداث (Events) بدلاً من الرموز (Tokens)

user messages, tool calls, agent responses — كل حدث يُسجل

بدلاً من Request/Response مع tokens in/tokens out، تعمل Managed Agents بوحدات تسمى الأحداث: رسائل المستخدم، استدعاءات الأدوات، استجابات الوكيل. كل حدث يُضاف لسجل الجلسة، مما يسهل استئنافها لاحقاً.

• الموثوقية: إذا تعطلت الحاوية، يمكن إعادة تشغيلها دون إعادة تشغيل حلقة الوكيل
• المراقبة: كل حدث يُسجل تلقائياً في Observability Console المدمجة
• الاستئناف: ترك الجلسة والعودة من حيث توقفت

6. الأدوات المحلية: ربط الوكلاء ببنيتك التحتية

نفس البروتوكول — من JSON محلي إلى DataDog أو أي نظام إنتاجي

الأدوات المحلية تسحب بيانات من JSON محلي للعرض التوضيحي، لكن يمكن نقلها إلى أنظمة إنتاجية بسلاسة عبر نفس الـ Wire Protocol:

• DataDog — مقاييس إنتاجية
• PagerDuty — إدارة التنبيهات
• GitHub/GitLab — جلب diffs وإنشاء PRs
• AWS CloudWatch / Azure Monitor — مراقبة سحابية

7. البث المباشر وتحسين تجربة المستخدم

Streaming: المستخدم يرى الوكيل يعمل في الوقت الفعلي

البث يسمح للمستخدم برؤية الوكيل وهو ينادي الأدوات ويحلل النتائج ويكتب الاستجابة تدريجياً — لا حاجة للانتظار حتى يكمل المهمة بأكملها.

8. حالات الجلسة وإدارة الاستمرارية

يمكن تشغيل Webhook على أحداث معينة — عندما يحدث حدث خارجي (مثل تنبيه PagerDuty)، يبدأ الـ Webhook جلسة جديدة تلقائياً دون تدخل بشري.

9. ميزات متقدمة: Sub-agents, Memory, Dreaming, Outcomes

Sub-agents, Memory, Dreaming, Outcomes, Vaults — مدمجة

• Sub-agents: وكيل منظم ينشئ وكلاء فرعيين، لكل منهم نافذة سياق خاصة — يسمح بالتوازي وإدارة السياق بكفاءة
• Memory & Dreaming: الوكيل يتذكر تفضيلات المستخدم عبر الجلسات. Dreaming تسمح لـ Claude بمراجعة ذاكرته وتحديد ما يحتفظ به
• Outcomes: تحديد مصفوفة تقييم للنتيجة — الوكيل يكتشف الأدوات والخطوات اللازمة بنفسه

10. Vaults وإدارة بيانات الاعتماد بأمان

• تخزين مشفر لبيانات الاعتماد على نقطة نهاية منفصلة
• الوصول حسب كل مستخدم وكل جلسة (Per-user, Per-session)
• يستفيد من فصل الدماغ عن الأيدي — بيانات الاعتماد محمية حتى لو اخترقت حاوية التنفيذ
• ميزة مدمجة — لا حاجة لمخازن سرية خاصة

11. الخاتمة: أتمتة الاستجابة للحوادث

3 مكونات + فصل الدماغ عن الأيدي + ميزات متقدمة = وكيل إنتاجي

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

المصادر:
📘 وثائق Claude Managed Agents الرسمية
🎥 فيديو الورشة الأصلي على يوتيوب
🏠 lira-now.com