AWS تمنح وكلاء البرمجة معاينة حية للموقع مباشرة من جلسة معزولة

أضافت Amazon Web Services ميزة Session endpoints إلى AgentCore runtime. يشغّل AgentCore runtime كل جلسة لوكيل الذكاء الاصطناعي داخل آلة افتراضية صغيرة (microVM) معزولة خاصة بها. وكان كل ما يشغّله الوكيل داخلها، كالموقع مثلًا، غير مرئي من الخارج. أما الآن فللجلسة عنوان URL محمي: تفتحه في المتصفح وتتابع وكيل البرمجة وهو يبني تطبيق الويب. وتظهر كل تعديلة على الصفحة خلال ثوانٍ، قبل أن يتمكن أحد من نشر أي شيء على استضافة.

لماذا نراقب الموقع أثناء كتابة الوكيل للشيفرة

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

تلغي Session endpoints هذه الخطوة. وهي ليست بديلًا عن استضافة الإنتاج: فـ AWS تنصح صراحةً بتقديم التطبيق للمستخدمين عبر خدمة مثل AWS Amplify Hosting. والغرض من الـ endpoint هو بناء ما أنجزه الوكيل واختباره وقبوله.

كيف صُمّم النموذج التجريبي

يتكون النموذج المتاح في مستودع agentcore-samples من أربعة أجزاء:

• يعمل وكيل البرمجة داخل الجلسة على المنفذ 8080، ويعدّل ملفات الموقع بأربع أدوات: list وread وwrite وedit.
• يستمع خادم التطوير Vite إلى المنفذ 8090، ويقدّم الموقع، ويبلّغ المتصفح عبر WebSocket بكل ملف يُحفظ.
• على جهازك، يعرض التطبيق PreviewApp الصفحة: الدردشة على اليسار والموقع الحي على اليمين. ويرسل طلباتك إلى InvokeAgentRuntime ويفتح نقطة دخول محلية للموقع.
• لاتخاذ القرارات، يستدعي الوكيل نموذج Claude Haiku 5.5 في Amazon Bedrock.

يطلق أول استدعاء لـ InvokeAgentRuntime الجلسة، ويصل عنوان Session endpoint في ترويسة الاستجابة. ثم تسير الأمور ببساطة. تطلب تحويل الموقع إلى سمة قهوة داكنة. يقرأ الوكيل src/main.js وsrc/style.css وindex.html، ويحفظ الأنماط، فيتغير الموقع دون تحديث الصفحة. وتُبثّ خطوات الوكيل إلى الدردشة بوصفها server-sent events. ويجري الطلب التالي، وهو جعل زر «Order ahead» أخضر، بالطريقة نفسها: يغيّر الوكيل style.css فقط.

ست تفاصيل ينبغي معرفتها عند الإعداد

• أنت من يختار المنافذ. في المعامل allowedPorts عند إنشاء بيئة التشغيل (runtime) تُحدَّد من 1 إلى 5 منافذ أو نطاقات ضمن 8000–12000، دون المنافذ التي تحجزها المنصة. والمنفذ المسموح به لا يشغّل الخادم من تلقاء نفسه: يجب أن يستمع التطبيق إليه على 0.0.0.0.
• يصل العنوان مع الجلسة، في الترويسة X-Amzn-Bedrock-AgentCore-Runtime-Session-Endpoint-Url.
• تُصادَق كل طلب. تتطلب بيئة التشغيل المعتمدة على IAM توقيع SigV4 وصلاحية bedrock-agentcore:InvokeAgentRuntimeProxy، وتتطلب بيئة التشغيل ذات مفوّض JWT رمز bearer. ومعرفة العنوان وحدها لا تكفي.
• يُحدَّد المنفذ ببادئة في اسم المضيف، مثل 8090--<id>.runtime.bedrock-agentcore.<region>.on.aws. ويتصل العميل دائمًا بالمنفذ 443.
• يمرّ عبره HTTP/1.1 وHTTP/2 وserver-sent events وgRPC وWebSocket.
• الـ endpoint مرتبط بجلسة واحدة، وينتهي بانتهائها.

لا يستطيع المتصفح بنفسه توقيع طلبات الصفحة بـ SigV4. لذلك يفتح SDK الخاص بـ bedrock-agentcore على جهازك نقطة محلية على localhost:8088، وهي تضيف بيانات الاعتماد إلى كل طلب وإلى مصافحة WebSocket. وهي تستمع إلى 127.0.0.1 فقط، وترفض اتصالات WebSocket القادمة من صفحات مصادر غريبة.

وعلى حدة، يوجد في الجلسة المنفذ 8081: يقدّم الوكيل عليه المسار /status مع قائمة بالطلبات والملفات المعدَّلة. وعبر الـ endpoint نفسه لا يتغير سوى رقم المنفذ. والمنفذ 8080 غير مدرج في القائمة عمدًا: فـ InvokeAgentRuntime يصل إلى الوكيل حتى دون Session endpoint.

ما الذي يرفضه الـ endpoint وما ينبغي تذكّره

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

• منفذ خارج allowedPorts: 403 AccessDenied؛
• طلب دون بيانات اعتماد صالحة: 403 AccessDenied أو 401 AuthenticationRequired؛
• منفذ مسموح به لكن لا أحد يستمع إليه: 502 PortNotReachable؛
• عنوان جلسة أُغلقت بالفعل: 404 SessionNotFound.

تُسجَّل جميع الطلبات في AWS CloudTrail بوصفها أحداث InvokeAgentRuntimeProxy. وتحذف بيئة التشغيل ترويسات المصادقة الخاصة بها قبل إعادة التوجيه، فلا يرى الموقع التوقيع.

وهناك قيود أيضًا. تعمل الميزة مع بيئات تشغيل microVM فقط، ولا تعمل مع نوع الحوسبة Instances. والعنوان متاح عبر HTTPS العام، بينما لا يدعم AWS PrivateLink للاتصالات الواردة. وإذا استبدلت بيئة التشغيل عقدة الحوسبة الخاصة بالجلسة، فستُغلق الاتصالات، وقد تضيع تعديلات الوكيل في غياب تخزين دائم. ويعيش الموقع والوكيل في جلسة واحدة دون فصل بينهما في الصلاحيات، لذا ينبغي منح دور التنفيذ الأذونات الضرورية فقط. وأدوات الملفات لدى الوكيل لا تتجاوز مجلد الموقع. وإذا كان بإمكان أطراف خارجية إرسال الأوامر النصية (prompts)، فإن AWS تنصح باستخدام Amazon Bedrock Guardrails ومراجعة التغييرات يدويًا قبل النشر.

يُنشر النموذج دون Docker: يُرفع الوكيل بصيغة ملف zip إلى Amazon S3 عبر direct code deployment لـ Node.js 22. ويتطلب Python 3.10+ وbedrock-agentcore 1.25.2+ وboto3 1.43.122+. وبعد التجارب شغّل cleanup.py، فهو يحذف بيئة التشغيل والشيفرة ودور IAM.

بالنسبة إلى الفرق التي تبني وكلاء للمطوّرين، هذه طريقة عملية لاختصار دورة «اطلب، وشاهد، وصحّح». لكن لا تُبقِ المعاينة (preview) مفعّلة أكثر من اللازم: فالنقطة المحلية تعمل ببيانات اعتمادك.