A2UI: كيف يصف الوكيل واجهة المستخدم دون كتابة كود

يتيح بروتوكول A2UI لنموذج لغوي أن يبني واجهة مستخدم في وقت التشغيل دون إصدار سطر واحد من الكود القابل للتنفيذ. فبدلًا من طلب JSX أو HTML، يُطلب من النموذج كائن JSON صغير يحدد المكوّن الموجود أصلًا لدى العميل والقيم التي يجب عرضها فيه. تتبع مراجعة منشورة على dev.to طلبًا واحدًا من قرار الوكيل إلى البكسلات على الشاشة.

لماذا لا يكفي إرسال الكود

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

ثلاثة أدوار وخمس رسائل

الوكيل هو كود الخادم ويقرر ما يُعرض: أي مكوّنات وبأي قيم. البروتوكول هو صيغة الإرسال التي تنتقل فيها هذه القرارات، ولا يسمح إلا بخمسة أنواع من الرسائل. أربع تنتقل من الوكيل إلى العميل: createSurface يسجّل سطحًا لدى كتالوج، و updateComponents يضيف سجلات المكوّنات أو يستبدلها، و updateDataModel يكتب القيم في شجرة JSON الخاصة بالسطح، و deleteSurface يزيل السطح. والخامسة، action، هي الرسالة الوحيدة من العميل إلى الوكيل، أما النقل فمتروك خارج المواصفة.

حدّ الثقة

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

لوحة تحكم والطريق إلى v1.0

تشير المراجعة إلى a2ui-mutual-fund-dashboard، تطبيق Next.js مفتوح المصدر ينتج فيه سؤال باللغة الطبيعية عن صندوق استثمار هندي لوحة تحكم: بطاقة إحصاء، ومخطط تاريخ NAV، وملخص بلغة بسيطة. الكتالوج ثابت عند خمسة مكوّنات، ولا يُسأل النموذج عن أرقام أبدًا، بل عن المكوّنات ومواضع ظهورها فقط. كل هذا مثبَّت على الإصدار v0.9.1 الذي يذكره a2ui.org كالإصدار الإنتاجي الحالي، بينما v1.0 مرشح للإصدار. الإضافة الجوهرية فيه رسالة سادسة، actionResponse، تتيح للوكيل أن يجيب على إجراء محدد بشكل متزامن.