ها هو الفصل الأخير. حتى هنا بلغت مرحلة أن تفهم بنية الوكيل، وتبني أول وكيل، وتصل الأدوات، وتقسّمه إلى عدّة، وتقيس بالتقييم، وتحمي بالحواجز الواقية. بقي موضوع واحد — أن تجعله «نظام إنتاجٍ يعمل كلّ يوم». في هذا الفصل نتناول كيف تختار الإطار، والدربين للبناء بـClaude، ثم مفاتيح التشغيل: النشر والمراقبة والتكلفة والموثوقية. تصميمُ الحماية الذي تعلّمته في الحواجز الواقية والأمان بالفصل السابق يثمر هنا تشغيلاً.

ما ستصبح قادراً عليه في هذا الفصل

الهدف «أن تحوّل النموذج التجريبيّ إلى وكيل إنتاج يعمل بثبات»

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

صناعة ذاتية أم إطار جاهز

«أأبني الوكيل بإطار أم أكتب الحلقة بنفسي؟» — سؤال يحار فيه الجميع أوّلاً. الجواب بسيط: ما دام صغيراً، تعلّم الآلية بالصناعة الذاتية، وحين يكبر ارفع الإنتاجية بـSDK أو إطار. حين ركّبنا الأدنى بأيدينا في الفصل الثاني، كانت تلك بالضبط مرحلة «افهم أوّلاً بالصناعة الذاتية». إن كان الداخل مرئيّاً، أمكنك — حتى بعد نقله إلى إطار لاحقاً — أن تشغّله وأنت ممسك بما يجري. وبالعكس، إن رميت كلّ شيء إلى إطارٍ دون معرفة الآلية، عجزت عن التصرّف حين تتعثّر.

💡 دليل الحكم. حين يصير الاستمرار بكتابة الحلقة واستدعاء الأدوات وإدارة الحالة بنفسك عبئاً، فتلك علامة إدخال الإطار. وبالعكس، ما دمت صغيراً في طور التجريب، فالشيفرة الذاتية الرقيقة أسرع وأعمق فهماً. أدخِله لأنّ «التكرار يقلّ» لا لأنّه «مريح».

كيف تختار الإطار

الأطر كثيرة، لكن قبل ملاحقة الأسماء والنسخ الأحدث، المهمّ أن تمتلك «مقياس ما تختار به». تتبدّل الأدوات، لكن هذه الزاوية تدوم طويلاً. جرّب تقييم المرشّحين بالخمسة التالية.

🎚 درجة التجريد

كلّما ارتفعت عمل بشيفرة أقلّ، لكن يصعب رؤية ما يجري في الداخل. اختر بموازنة مع التعلّم والتنقيح.

🔧 درجة الحرّية

أيمكن إدراج حلقة أو تحكّم خاصّ بك؟ كلّما دقّت المتطلّبات، نفع التصميم المرن ذو منافذ الخروج.

🌐 المنظومة

ثخانة أجزاء الربط والوثائق والأمثلة والمجتمع. أن تجد المعلومة حين تتعثّر يُحدث فرقاً في العمل الفعليّ.

👁 القابلية للمراقبة

أيملك آليات الأثر والسجلّ والتقييم؟ أيسند «جعل الحركة مرئيّة» الذي تعلّمته في الفصل الخامس أصلاً؟

🔒 الاعتماد على المورّد

ألا يقيّدك بنموذج أو منصّة بعينها أكثر من اللازم؟ سهولةُ الانتقال ومنفعةُ الاحتباس مفاضلةٌ متبادلة.

إن نظّمت الأمثلة الممثِّلة إجمالاً بالفئات، اتّضحت الرؤية: فئة التنسيق العامّ (مكتبات تركّب معالجة الـLLM بسلاسل أو رسوم بيانية، أي طراز LangChain)، وفئة تعدّد الوكلاء (أطر محورها تقسيم عدّة وكلاء وتنسيقهم)، وSDK الرسميّ لكلّ شركة (عُدّة تطوير تصدرها جهة النموذج، مُحسّنة لذلك النموذج). وغالباً هذه ليست متنافية بل تُستخدم مركّبةً.

📊 اختر بـ«الزاوية» لا بالاسم المفرد. خريطة قوى الأطر تتحرّك بسرعة، وما كان معياراً العام الماضي قد لا يبقى كذلك هذا العام. لهذا بالذات، الأوثق أن تسقط الزوايا الخمس أعلاه على متطلّباتك. للأسماء الملموسة لكلّ فئة وتوزيع استخدامها، تحقّق من أحدث الوجوه في مقارنة أطر وكلاء الذكاء الاصطناعي.

خياران للبناء بـClaude

جعلنا هذه الدورة محورها Claude. حين تُنتِج وكيلاً بـClaude، ثمّة دربان كبيران. كلاهما خيار قائم فعلاً، والفرق الجوهريّ «مَن يستضيف حلقة الوكيل وصندوق العزل».

① Claude Agent SDK
تدير الحلقة على بنيتك التحتية

عُدّة لتشغيل حلقة الوكيل وتنفيذ الأدوات وإدارة الحالة في بيئتك (خادم أو حاوية). تحكّمٌ دقيق، وإمكان دمجٍ عميق في نظامك القائم.

مناسب حين: تريد اقتراناً وثيقاً ببيئة تنفيذ وأدوات وبيانات خاصّة.

② الوكلاء المُدارون (Managed Agents)
Anthropic تستضيف الحلقة

أسلوبٌ تستضيف فيه Anthropic من جهة الخادم حلقة الوكيل وصندوق العزل (بيئة تنفيذ معزولة). يقلّ عبء تشغيل منصّة التنفيذ، ويعمل في بيئة معزولة آمنة.

مناسب حين: تريد تقليل عناء بيئة التنفيذ، والانطلاق بسرعة وأمان.

إجمالاً، من الأيسر إدراكه بمحور: إن أردت تحكّماً دقيقاً بنفسك فالـSDK، وإن أردت أن تكل عناء التشغيل فالمُدار. وكلاهما، بناءً على قدرة Claude، يتيح لك أن تحيي كما هي ربطَ الأدوات والتقييم والحواجز الواقية التي تعلّمتها في الفصول. والإعداد الملموس ونطاق الدعم قد يتغيّران، فنكل التفصيل إلى مقالات الشرح والوثائق الرسمية.

💡 المفهوم أوّلاً، والتفصيل من المصدر الأوّليّ. يكفي أن تبقي في ذهنك هذا التقابل: «تدير الحلقة بنفسك (SDK)» أم «تُستضاف لك (المُدار)». لخطوات التنفيذ راجع مدخل Claude Agent SDK، ولفكرة الأسلوب المُدار راجع ما هم الوكلاء المُدارون. المواصفات تُحدَّث، فالأأمن في النهاية أن ترجع إلى الوثائق الرسمية مصدراً أوّلياً.

مفاتيح التشغيل في الإنتاج

الفرق بين النموذج التجريبيّ والإنتاج هو القفزة من «يعمل مرّةً» إلى «يظلّ يعمل». العرض يقوم بأن ينجح مرّاتٍ قليلة، أمّا الإنتاج فيتعرّض لدخلٍ يوميّ وكثيف ومتنوّع. لنمسك بالمفاتيح النافعة هنا في ستّة صناديق.

🚀 النشر

أدِر المفاتيح بمتغيّرات بيئة، وافصل الإعداد عن الشيفرة. اطرح بصيغة قابلة لإعادة الإنتاج (حاويات مثلاً)، واجعل التراجع ممكناً في أيّ وقت.

👁 المراقبة

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

💰 إدارة التكلفة

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

🔁 حدّ المعدّل وإعادة المحاولة

افترِض حدود API والإخفاقات المؤقّتة، وثابِر بتراجع أسّيّ (إعادة محاولة بفواصل متزايدة). تجنّب إعادة المحاولة اللانهائية، وحدّد سقفاً.

💾 إدارة الحالة والجلسة

احفظ حالة المحادثة أو العمل الوسطى بأمان واسترجعها. تصميمٌ يستأنف من حيث توقّف حتى لو سقط في المنتصف، يسند المهامّ الطويلة.

🔄 تحديث النسخة

تحديثات النموذج أو الـSDK: تأكّد من السلوك بمجموعة التقييم أوّلاً. بمقارنة ما قبل التحديث وبعده، لا يفوتك تغيّر جودة صامت.

⚠️ التكلفة يحسمها «التصميم». لأنّ الوكيل يستدعي النموذج مراراً في مهمّة واحدة، فبنيته تقفز فيها التكلفة بسهولة. المراحل التي تكفيها نماذج رخيصة أوكِلها إلى الرخيص، ومرّر السياق بالقدر اللازم فقط — تنفع هذه الحيل المتواضعة. طرقُ التقليص الملموسة عمليّة في تحسين تكلفة البرمجة بالذكاء الاصطناعي، وتُطبَّق على تشغيل الوكلاء كما هي.

تصميم لا ينهار

وكيل الإنتاج، سيلاقي حتماً يوماً دخلاً غير متوقّع، وعطلَ API خارجيّ، ونزوةَ النموذج. المهمّ ليس «ألّا تفشله إطلاقاً»، بل أن تركّبه بحيث لا يتّسع الضرر وإن فشل، ويتعافى بهدوء. لنُتمّ الحواجز الواقية للفصل السابق آليةَ تشغيل.

🪜 الإطلاق المتدرّج

لا تنشر للجميع دفعةً، بل ابدأ من قلّة من المستخدمين أو جزء من حركة المرور. إن سلِم فوسّع، وإن ساء فتراجع فوراً.

🛟 بديل السقوط (fallback)

حين لا تستجيب أداة أو نموذج، انسحب إلى مسار بديل أو استجابة افتراضية آمنة. اختر التقلّص الجزئيّ على التوقّف الكلّيّ.

🙋 بوّابة الموافقة البشرية

أدرِج تأكيدَ إنسانٍ قبل العمليات غير الرجعية أو عظيمة الأثر (انظر الفصل السادس). حدّد الحدّ الذي ينبغي عنده تقديم الأمان على السرعة.

🔁 إعادة تقييم دوريّة

النجاح مرّةً لا يعني الانتهاء. يتغيّر ميل الدخل والنموذج. شغّل مجموعة التقييم دورياً، واكشف تدهور الجودة.

✅ صمّم «التعافي بهدوء». النظام الإنتاجيّ الجيّد لا يثير ضجّةً وإن وقعت مشكلة. يُبقي الأثر صغيراً بالإطلاق المتدرّج، ويتقلّص جزئياً ببديل السقوط، ويمنع الإصابة القاتلة ببوّابة الموافقة، ويسبق التدهور بإعادة التقييم. لا يصير «لا ينهار» إلا حين تتشابك الأربعة.

تعلّمك من الآن

أخيراً، حديثٌ قليلٌ عمّا هو أبعد. منظومة الوكلاء — الأطر والـSDK والنماذج ومعايير الربط — ستظلّ تتحرّك بسرعةٍ هائلة. الحلّ الأمثل اليوم ليس بالضرورة أمثل العام القادم. لهذا بالذات، ما ينبغي أن تلاحقه ليس أسماء الأدوات الرائجة، بل الأساس الذي لا يتغيّر.

📊 ما يصير أصلاً هو الأساس. المكوّنات الأربعة (العقل والأدوات والذاكرة والحلقة) من الفصل الأول، والتقييم والقابلية للمراقبة من الخامس، وتصميم الأمان من السادس — هذه أساسٌ يصلح مهما راج أيّ إطار. مع كلّ أداة جديدة، تستطيع بهذا المقياس أن تبصر سريعاً «ماذا يجرّد هذا». تتبدّل الأدوات ويبقى الأساس. الفهم الذي راكمته حتى هنا هو أعظم أصولك.

بقي أن تطرح واحداً في الإنتاج فعلاً ولو صغيراً. شغّله، وقِس، وأصلِح — تجربةُ إدارة هذه الحلقة في مشروعك أنفع من أيّ مادّة تعليمية.

خلاصة هذا الفصل
  • ما دام صغيراً تعلّم بالصناعة الذاتية، وحين يكبر ارفع الإنتاجية بالإطار. أدخِله لأنّ «التكرار يقلّ» لا لأنّه «مريح».
  • اختر الإطار بخمس زوايا — درجة التجريد والحرّية والمنظومة والقابلية للمراقبة والاعتماد على المورّد. المقياس قبل الاسم المفرد.
  • للبناء بـClaude: Claude Agent SDK بحلقةٍ ذاتية، أو وكلاء مُدارون مُستضافون. اختر بين التحكّم والسهولة.
  • مفاتيح الإنتاج: النشر والمراقبة والتكلفة وإعادة المحاولة وإدارة الحالة والتحديث. ولا تنهار بـالإطلاق المتدرّج وبديل السقوط وبوّابة الموافقة وإعادة التقييم.
  • المنظومة تتحرّك بسرعة. الأساسُ — العناصر الأربعة والتقييم والأمان — هو الأصل الذي يدوم أثره طويلاً.
🎉 أتممت الدورة

سبعة فصول كاملة، أحسنت. لقد قطعت الدرب كاملاً حتى تصمّم الوكيل وتبنيه وتربطه وتكثّره وتقيسه وتحميه وتشغّله. من هنا، حان دورك لتعمل بيديك في منتَجك أنت.

💼 صِر من جانب المستخدِم في العمل

لمن يريد أن يتراجع خطوةً عن جانب الصنع، ويصقل زاوية توظيف الذكاء الاصطناعي في العمل.

إلى دورة فنون العمل بالذكاء الاصطناعي ←
⌨ اكتب الشيفرة مع الذكاء الاصطناعي

لمن يريد إتقان أدوات البرمجة مثل Claude Code.

إلى دورة البرمجة بالذكاء الاصطناعي ←
🚀 حوّله إلى منتَج

لمن يريد أن يربّي الوكيل الذي بناه ليصير منتَج تطويرٍ فرديّ يطرحه للعالم.

إلى دورة التطوير الفرديّ بالذكاء الاصطناعي ←

📚 شاهد كلّ الدورات (قائمة الدورات)