1 
2لقد تحدثنا كثيرًا عن الأطر الفاعلية. LangGraph، CrewAI، AutoGen، مجموعات SDK المتنوعة، الحلقة، استدعاء الأدوات، الذاكرة، المخطط، الناقد، المشرف. كل الكلام المفيد جزاكم الله خيرا. لكن كلما نظرت إلى العوامل المستخدمة فعليًا، بدا لي أن الجزء المثير للاهتمام قد انتقل إلى ما دون مستوى إطار العمل.
3 
4لم يعد السؤال مجرد: ما هي المكتبة التي أستخدمها لجعل النموذج المرحلي يفكر؟
5 
6السؤال الحقيقي هو: أين يعيش هذا العميل عندما يتوقف عن كونه تجريبيًا؟
7 
8لأن الوكيل الجاد ليس وظيفة تستدعي النموذج وترجع النص. إنه نظام موزع صغير. يجب عليه قراءة السياق، واستخدام الأدوات، وتنفيذ التعليمات البرمجية، ولمس الملفات، وتذكر القرارات، وطلب الإذن، والفشل بشكل جيد، وإعادة التشغيل، وترك السجلات، وعدم حرق الميزانية وعدم التحول إلى جرافة داخل مستودع الإنتاج.
9 
10الإطار هو عجلة القيادة. البنية التحتية هي الطريق والفرامل والجراج والتأمين والشخص الذي يعرف مكان المفاتيح.
11 
12##لأن هناك الكثير من الحديث عنه الآن
13 
14في عامي 2023 و2024، كانت المحادثة تتمحور حول النماذج بشكل كبير. أي ماجستير؟ كم السياق؟ كم يكلف؟ ما مدى براعته في البرمجة؟
15 
16وفي عامي 2025 و2026، تغير الحديث. النماذج جيدة بما فيه الكفاية للقيام بعمل حقيقي، ولكن هذا هو السبب في أن الأجزاء المملة تصبح مرئية: وقت التشغيل، والأمن، والموصلات، والهوية، وقابلية المراقبة، وتنفيذ التعليمات البرمجية، والنشر، والتراجع.
17 
18إنه الانتقال الطبيعي من السحر إلى الهندسة.
19 
20عندما يحتاج الوكيل فقط إلى إنشاء استجابة، تكون الدردشة كافية. عندما تحتاج إلى فتح طلب سحب، والاستعلام عن قاعدة بيانات، واستدعاء CRM، وبدء مهمة، والتنقل في موقع، وقراءة Slack، وتجميع التعليمات البرمجية وتحديث مستند، فأنت بحاجة إلى نظام تشغيل من حوله.
21 
22ليس بالمعنى الحرفي. بالمعنى التنظيمي.
23 
24## القطعة الأولى: وقت تشغيل حيث يمكن للوكيل أن يستمر
25 
26غالبًا ما يعمل الوكيل في خطوات. انظر إلى الحالة، اختر إجراءً، استخدم أداة، راقب النتيجة، قم بتحديث الخطة، كرر.
27 
28إذا كانت هذه الحلقة موجودة داخل طلب HTTP واحد، فستواجه مشكلة على الفور. بعض الإجراءات بطيئة. البعض ينتظر المدخلات البشرية. البعض يفشل ويجب المحاولة مرة أخرى. يجب أن ينجو البعض من النشر أو المهلة.
29 
30هذا هو المكان الذي تلعب فيه مسارات العمل الدائمة وقوائم الانتظار وخلفيات الوظائف وأجهزة الحالة دورها. إنها ليست ساحرة، لكنها تمثل الفارق بين الوكيل الذي يبدو ذكيًا في العرض التجريبي والوكيل الذي يمكنك ترك العمل أثناء ذهابك لتناول القهوة.
31 
32بالنسبة لي، يجب أن يجيب وقت التشغيل الوكيل على أسئلة محددة للغاية:
33 
34- أين أحفظ الحالة بين خطوة وأخرى؟
35- ماذا يحدث إذا ماتت العملية في منتصف الطريق؟
36- هل يمكنني التوقف وطلب الموافقة؟
37- هل يمكنني إعادة تشغيل الجولة لأفهم سبب قيامه بهذا الاختيار؟
38- هل يمكنني تحديد المدة والذاكرة والأدوات والتكلفة؟
39 
40تعمل شركة Vercel بقوة على هذه الجبهة من خلال مجموعات SDK للذكاء الاصطناعي والوظائف وسير العمل والأدوات اللازمة لبناء الوكلاء داخل تطبيقات الويب. ولكن النقطة ليست مجرد Vercel. النقطة المهمة هي أن الوكيل يحتاج إلى منزل تشغيلي، وليس نقطة نهاية واحدة.
41 
42##القطعة الثانية: صندوق الرمل، لأن الوكيل يجب أن يكون قادراً على الاتساخ دون أن ينكسر
43 
44بمجرد قيام الوكيل بكتابة التعليمات البرمجية أو تنفيذ الأوامر، تكون هناك حاجة إلى وضع الحماية.
45 
46قد تبدو كلمة فنية، لكن الفكرة محلية: أعطه طاولة عمل. يمكنه فتح الملفات وتثبيت التبعيات وإجراء الاختبارات وإجراء التجارب وإنشاء المخرجات. إذا أخطأ في الأمر، فقد احتوت الضرر. إذا كان يعمل، تعزيز النتيجة.
47 
48يجب أن يتمتع صندوق الحماية الوكيل ببعض الخصائص:
49 
50- نظام الملفات المعزولة؛
51- حدود وحدة المعالجة المركزية والذاكرة والوقت؛
52- شبكة تسيطر عليها؛
53- الأسرار محمولة فقط عند الحاجة إليها؛
54- سجلات كاملة.
55- إمكانية تصدير التحف.
56- إعادة ضبط نظيفة بين عمليات التشغيل، عند الضرورة.
57 
58يسير Vercel Sandbox في هذا الاتجاه تمامًا: بيئات معزولة لتشغيل التعليمات البرمجية وتثبيت التبعيات والعمل مع الملفات وإنتاج العناصر دون تشغيل كل شيء في وقت تشغيل التطبيق الرئيسي.
59 
60هذا الشيء أكثر أهمية مما يبدو. تقفز العديد من النماذج الأولية مباشرة من النموذج إلى النظام الحقيقي. يمكن للنموذج استدعاء الأداة. الأدوات يمكن أن تفعل الأشياء. يبدو كل شيء أنيقًا حتى أول أمر خاطئ، وأول تبعية مثبتة في المكان الخطأ، وأول رمز مميز ينتهي به الأمر في السجل.
61 
62صندوق الرمل هو طريقة البالغين للقول: تفضل، ولكن هنا.
63 
64##القطعة الثالثة: MCP ومشكلة الموصل
65 
66أصبح بروتوكول السياق النموذجي أحد الأجزاء الأكثر إثارة للاهتمام في النظام البيئي لأنه يحاول توحيد شيء يصبح بسرعة غير قابل للإدارة: كيف يكتشف النموذج الأدوات الخارجية ويستخدمها.
67 
68وبدون معيار، يصبح كل تكامل بمثابة جزيرة صغيرة. تم إجراء موصل لـ GitHub بطريقة واحدة، وواحد لـ Slack بطريقة أخرى، وواحد لقواعد البيانات ذات دلالات مختلفة، وواحد لأتمتة المتصفح الذي لا يبدو وكأنه شيء.
69 
70يقترح MCP لغة مشتركة بين العميل والخادم: الأدوات والموارد والمطالبات والتراخيص والنقل والاكتشاف. إنه لا يحل مشكلة الحكم والأمن بطريقة سحرية، ولكنه يقدم قواعد نحوية.
71 
72والمسائل النحوية. عندما يتمكن الوكيل من الاتصال بالعديد من الأدوات، فإن السؤال ليس فقط "هل يمكنه القيام بذلك؟". المشكلة هي «هل يفهم ماذا يستطيع أن يفعل، وبأي حدود، ونيابة عن من، وأي أثر يترك؟».
73 
74بالنسبة لي، فإن MCP ليس ضجيجًا لأنه "يقوم باستدعاء الأداة". لقد فعلنا ذلك بالفعل. إنه ضجيج لأنه يحول مركز الثقل من التكامل الفردي إلى كتالوج الأدوات التشغيلية.
75 
76في بنية وكيلة جيدة، يصبح MCP نوعًا من لوحة التصحيح:
77 
78- GitHub للتعليمات البرمجية والمشكلات؛
79- الركود لسياق المحادثة.
80- الخطي أو جيرا للعمل المخطط؛
81- قاعدة بيانات للقراءة فقط للتحليلات؛
82- متصفح أو مكشطة يتم التحكم فيها للمواقع الخارجية؛
83- تخزين المستندات؛
84- بيئات التنفيذ المعزولة؛
85- الأنظمة الداخلية مكشوفة بأذونات صارمة.
86 
87الجزء الصعب هو أن كتالوج الأدوات الخالية من السياسات هو مجرد وسيلة أكثر أناقة لخلق الفوضى.
88 
89## القطعة الرابعة: الهوية والأذونات
90 
91هذا هو المجال الذي تغض فيه العديد من العروض التوضيحية أعينها.
92 
93وكيل يعمل نيابة عن شخص ما. لذلك يجب أن يكون واضحا من هو موضوع الإجراء.
94 
95هل يستخدم أذونات المستخدم؟ من حساب الخدمة؟ من مساحة العمل؟ هل لديك وصول مؤقت أو دائم؟ هل يمكنك قراءة كل شيء أم بعض الموارد فقط؟ هل يمكنك الكتابة؟ هل يمكنك الإلغاء؟ هل يمكنه إرسال رسائل نصية إلى أشخاص حقيقيين؟
96 
97إذا لم تجب على هذه الأسئلة بشكل جيد، فسوف تقوم عاجلاً أم آجلاً ببناء مساعد بمفاتيح المنزل ولن يتذكر من أعطاها له.
98 
99القاعدة الأساسية التي أحبها هي: يجب أن يكون الوكيل قادرًا على القيام بعمل أقل من الإنسان، وليس أكثر من الإنسان. وعندما يتعين عليه القيام بشيء أكثر خطورة، عليه أن يتوقف ويسأل.
100 
101وهذا يعني OAuth، والرمز المميز، والإدارة السرية، وسجل التدقيق، وسياسة الأداة، والقائمة المسموح بها، وخطوة الموافقة. ليست أشياء رومانسية للغاية. الاشياء الضرورية.
102 
103## القطعة الخامسة: الذاكرة والسياق ولكن دون مراكمة القمامة
104 
105يحتاج العملاء إلى الذاكرة، لكن الذاكرة تكون خطيرة عندما تصبح علية.
106 
107هناك على الأقل ثلاثة أنواع من الذاكرة:
108 
109- تشغيل الذاكرة: ما حدث في هذا التنفيذ؛
110- ذاكرة المشروع: الاتفاقيات والقرارات والقيود؛
111- الذاكرة الشخصية أو الجماعية: التفضيلات والنبرة والطقوس والعمليات.
112 
113وضع كل شيء في الموجه هو الاختصار. إنه يعمل حتى لا يعمل بعد الآن. يجب الاهتمام بالذاكرة المفيدة: فهرستها، وتحديثها، وانتهت صلاحيتها، والتحقق منها، وجعلها قابلة للاستشهاد بها.
114 
115الوكيل الذي يتذكر بشكل سيء هو أسوأ من العميل الذي لا يتذكر. لأنه يتحدث بثقة.
116 
117لذلك يجب أن تتضمن البنية التحتية عمليات الاسترجاع وملفات التعليمات وقاعدة المعرفة والتضمين عند الحاجة، وكذلك التنظيف. نحن بحاجة إلى ثقافة الذاكرة: ما الذي يدخلها، ومن يوافق عليها، ومتى تضمحل، وكيف أصححها.
118 
119## القطعة السادسة: الملاحظة والتقييم والإعادة
120 
121إذا ارتكب الوكيل خطأً، فإن سجل "النموذج المُسمى" لن يكون كافيًا.
122 
123تريد أن ترى الطريق. ما السياق الذي تلقاه؟ ما هي الأدوات التي كانت متاحة؟ ما هي الأداة التي اخترتها؟ بأية حجج؟ ما الرد الذي حصلت عليه؟ كم تكلف؟ أين علقت؟ هل وافق الإنسان على شيء؟ هل نموذج الخطأ أو الأداة أو المطالبة أو البيانات أو الخطأ في الإذن؟
124 
125هنا يشبه الوكلاء الأنظمة الموزعة أكثر من روبوتات الدردشة.
126 
127أنت بحاجة إلى آثار قابلة للقراءة، وليس فقط سجلات نصية. يجب أن تكون قادرًا على إعادة تشغيل الجولة. من الضروري مقارنة نسختين من نفس الوكيل في المهام المعروفة. نحن بحاجة إلى قياس التراجعات: فهي لا "تستجيب بشكل أفضل" فحسب، بل إنها "تغلق التذكرة الصحيحة دون لمس الملفات غير المرغوب فيها".
128 
129تعد عمليات تقييم الوكيل أكثر صعوبة من عمليات تقييم النص لأنها تتضمن إجراءات. لا يكفي مقارنة سلسلة متوقعة. عليك أن تنظر إلى التسلسل والآثار الجانبية وجودة المنتج والوقت والتكلفة وعدد التدخلات البشرية.
130 
131الشيء المضحك هو أننا نعود دائمًا إلى هناك: هندسة البرمجيات. الاختبارات والبيئات والتتبعات والتراجعات. باستثناء أن الكود الآن يقرر أيضًا ما يجب فعله بعد ذلك.
132 
133## القطعة السابعة: الواجهات البشرية
134 
135لا يتعين على الوكيل أن يعيش في الدردشة فقط.
136 
137بعض الوكلاء يحتاجون إلى لوحة. الآخرين صفحة مع الحالة والسجل. أخرى من زر "الموافقة". المزيد من التعليقات المضمنة. لا يزال البعض الآخر من CLI.
138 
139واجهة المستخدم تغير السلوك. إذا كانت الطريقة الوحيدة للتحكم في الوكيل هي كتابة رسالة طويلة، فسيقوم المستخدم بإعطاء الوكيل تعليمات غامضة. ومع ذلك، إذا رأى الخطة والاختلافات والمصادر والمخاطر والإجراء التالي، فيمكنه التدخل بدقة.
140 
141تشتمل البنية التحتية اللائقة للوكيل على أسطح التحكم:
142 
143- الوضع الحالي.
144- خطة قابلة للتحرير.
145- المصنوعات اليدوية المنتجة؛
146- فرق؛
147- طلبات الموافقة؛
148- التسلسل الزمني.
149- زر التوقف؛
150- زر إعادة المحاولة؛
151- أذونات مرئية.
152 
153يبدو الأمر تافها، لكنه ليس كذلك. غالبًا ما يكون الفرق بين "الذكاء الاصطناعي المخيف" و"المساعد الموثوق" هو ​​أن الأخير يوضح لك مكان وجوده.
154 
155## المكدس العقلي
156 
157إذا كنت سأرسمه اليوم، فسيكون الحد الأدنى لمجموعة الوكيل هو:
158 
1591. النموذج: الاستدلال، والتوليد، واستدعاء الأدوات، والوسائط المتعددة إذا لزم الأمر.
1602. التنسيق: الحلقة، الخطوة، المخطط، السياسة، الإنسان في الحلقة.
1613. وقت تشغيل متين: سير العمل، وقائمة الانتظار، وإعادة المحاولة، والإيقاف المؤقت، والاستئناف.
1624. Sandbox: تنفيذ التعليمات البرمجية، ونظام الملفات المعزول، والقيود، والتحف.
1635. طبقة الأدوات: MCP، واجهة برمجة التطبيقات الداخلية، المتصفح، قاعدة البيانات، المستودع.
1646. طبقة الهوية: OAuth، النطاق، السر، التدقيق، السياسة.
1657. طبقة الذاكرة: سياق المشروع، الاسترجاع، التعليمات، انتهاء الصلاحية.
1668. إمكانية الملاحظة: مقاييس التتبع وإعادة التشغيل والتقييم والتكلفة والجودة.
1679. سطح المنتج: قم بالدردشة عند الحاجة، ولوحة القيادة عند الحاجة، والمراجعة عندما يكون الأمر مهمًا.
168 
169يغطي الإطار الوكيل بشكل أساسي النقاط 2 وجزءًا من النقطة 1. والباقي هو العمل الحقيقي.
170 
171## ما سأفعله عمليًا
172 
173إذا قال لي الفريق "نريد وكلاء في الإنتاج"، فلن أبدأ بعشرة وكلاء.
174 
175سأبدأ بسير عمل صغير ومتكرر ويمكن ملاحظته. على سبيل المثال: فتح تقارير العلاقات العامة الخاصة بالصيانة، وتحديث الوثائق من الإصدارات المغلقة، وإعداد مراجعة أسبوعية، وفرز الأخطاء المكررة، وإنشاء اختبارات للملفات المتأثرة.
176 
177ثم سأضع حدودًا واضحة جدًا:
178 
179- لا كتابة بدون فروع أو رمل؛
180- لا أسرار في الموجه؛
181- الأدوات في القائمة المسموح بها؛
182- موافقة الإنسان على الإجراءات الخارجية؛
183- سجل وتتبع إلزامي؛
184- الميزانية لكل تشغيل؛
185- الإخراج قابل للفحص دائمًا.
186 
187عندها فقط سأتوسع.
188 
189الوكلاء لا يفشلون لمجرد أن النماذج أخطأت في فهمهم. إنهم يفشلون لأننا نضعهم في بيئات غامضة، بأذونات مربكة وتوقعات مسرحية.
190 
191##قراءتي
192 
193البنية التحتية للوكالة مملة بأفضل طريقة.
194 
195إنه ليس الجزء الذي يجعلك تصفق في العرض التوضيحي. إنه الجزء الذي يتيح لك استخدام العرض التوضيحي صباح يوم الاثنين، مع أشخاص حقيقيين، وبيانات حقيقية، وعواقب حقيقية.
196 
197لن يتم تحديد مستقبل الوكلاء فقط من خلال من لديه أفضل قدوة. سيقرره من يبني أفضل مكان ليعمل فيه: منعزل عندما يقوم بالتجارب، متصل عند الحاجة، يمكن ملاحظته دائمًا، مخول بمعايير ومتواضع بما يكفي للتوقف عندما لا يعرف.
198 
199هذا هو المكان الذي يتوقف فيه العملاء عن كونهم لعبة ويصبحون بنية تحتية.
200 
201## مصادر
202 
203- [Vercel: كيفية إنشاء عملاء الذكاء الاصطناعي باستخدام Vercel وAI SDK](https://vercel.com/kb/guide/how-to-build-ai-agents-with-vercel-and-the-ai-sdk)
204- [مستندات Vercel: Sandbox](https://vercel.com/docs/sandbox)
205- [مستندات Vercel: العمل مع Sandbox](https://vercel.com/docs/sandbox/working-with-sandbox)
206- [مستندات فيرسيل: MCP](https://vercel.com/docs/mcp)
207- [بروتوكول سياق النموذج: المواصفات](https://modelcontextprotocol.io/specation)
208- [OpenAI: أدوات جديدة لوكلاء البناء](https://openai.com/index/new-tools-for-building-agents/)
209- [مدونة Cloudflare: الوكلاء على Cloudflare](https://blog.cloudflare.com/agents-on-cloudflare/)
210