بعد أن تنجح في تشغيل وكيل ذكاء اصطناعي بكفاءة على الخادم، تبدأ المشكلة الحقيقية بمجرد محاولة ربطه بتطبيق ويب أو جوال أو واجهة طرفية: النص يتدفق بصيغة مخصصة، واستدعاءات الأدوات وسط الإجابة تسير عبر مخطط JSON مختلف، ومزامنة حالة الشاشة تنكسر مع أول تحديث متزامن، بينما تبقى خطوات موافقة المستخدم معلّقة فوق اتصالات هشة.
AG-UI (Agent-User Interaction Protocol) هو بروتوكول مفتوح المصدر وخفيف الوزن قائم على الأحداث، يُدار تحت ag-ui-protocol/ag-ui برخصة MIT، ويحدد لغة قياسية لربط وكلاء الذكاء الاصطناعي بواجهات الويب والجوال والطرفية. يجمع البروتوكول تدفق الردود جزءاً بجزء، واستدعاء الأدوات في منتصف الإجابة، ومزامنة حالة التطبيق المشتركة، والتوقف المؤقت لطلب موافقة المستخدم داخل هيكل موحّد.
هام
- تدفق أحداث موحّد ومُنمَّط: تفصل عائلات الأحداث القياسية مثل
RUN_STARTEDوTEXT_MESSAGE_CONTENTوTOOL_CALL_STARTوSTATE_DELTAواجهة المستخدم تماماً عن إطار عمل الوكيل في الخلفية. - توقف نظيف للموافقة البشرية (Human-in-the-Loop): بدلاً من تعليق اتصال شبكي مفتوح لدقائق، يُنهي الوكيل الجولة بحدث
RUN_FINISHEDذي نتيجةinterruptثم يستأنف العمل لاحقاً عبر حمولةresumeمنظمة. - تكامل واضح مع MCP وA2A: بينما يربط MCP الوكيل بالأدوات والبيانات ويربط A2A الوكلاء ببعضهم، يوحّد AG-UI طبقة التواصل المباشر بين الوكيل وواجهة المستخدم.
بالنسبة للمؤسسات التي تبني حلول الذكاء الاصطناعي المؤسسية وتقود مشاريع تطوير البرمجيات المخصصة عبر منصات متعددة، يمثّل ارتباط الواجهة الأمامية بإطار خلفي واحد (مثل LangChain أو CrewAI أو Google ADK أو Microsoft Agent Framework) ديناً تقنياً مكلفاً؛ إذ يؤدي أي تغيير في محرك الخلفية إلى كسر محللات التدفق في React وiOS وAndroid والطرفية. يعالج AG-UI هذا الترابط الصارم ليبرز كمرشح معياري للتواصل بين الوكيل والواجهة.
لماذا تعجز واجهات REST التقليدية عن خدمة تطبيقات الوكلاء؟
صُممت واجهات REST الكلاسيكية لدورة طلب واحد يقابله رد واحد مكتمل، لكن وكيل الذكاء الاصطناعي الحديث يكسر هذا الافتراض في أربع نقاط جوهرية:
- تداخل النص مع استدعاء الأدوات: يبدأ الوكيل ببث الشرح النصي، ثم يتوقف وسط الجواب لاستدعاء أداة خلفية أو أمامية، وبعد استلام النتيجة يكمل صياغة الرد.
- تحديثات الحالة المشتركة: تتغير قوائم المهام والنماذج وحالة الوكلاء الفرعيين لحظياً وتحتاج لمزامنة جزئية سلسة دون إعادة تحميل كامل بيانات الشاشة.
- حوكمة التدخل البشري: العمليات الحساسة كحذف سجلات الإنتاج أو اعتماد التحويلات المالية تتطلب إيقاف التنفيذ بأمان وانتظار موافقة بشرية موثقة.
- التفاعل متعدد الوسائط: تحتاج الواجهات إلى تمرير ملفات وصور وسياق شاشة منمّط في الاتجاهين إلى جانب النص.
وضمن اتجاهات منظومة وكلاء الذكاء الاصطناعي المفتوحة في نوفمبر 2026، أدت اختلافات صيغ البث بين الأطر البرمجية إلى تكرار كتابة المحوّلات في كل مشروع. ويأتي AG-UI، بدعم قوي وتبنٍّ مبكر مع CopilotKit تحت حوكمة مفتوحة، لتوحيد هذا العقد البرمجي.
موقع AG-UI مقارنةً ببروتوكولي MCP وA2A
تعتمد بنية الوكلاء الحديثة على ثلاثة معايير مفتوحة متكاملة يعمل كل منها في طبقة مختلفة:
| البروتوكول / النهج | الطبقة التي يوحّدها | السؤال الهندسي الأساسي | وسيلة النقل ونموذج البيانات | الدور الأساسي |
|---|---|---|---|---|
| AG-UI | الوكيل <-> واجهة المستخدم | «كيف يتواصل الوكيل مع واجهة الويب أو الجوال أو الطرفية؟» | SSE أو WebSocket مستقل عن النقل + أحداث منمّطة + RFC 6902 JSON Patch | بث الردود، عرض الأدوات الحية، الحالة المشتركة، وموافقات البشر |
| MCP | الوكيل <-> الأدوات والبيانات | «كيف يكتشف الوكيل الأدوات وقواعد البيانات وينفّذها بأمان؟» | JSON-RPC عبر stdio أو Streamable HTTP | قواعد البيانات والملفات والأدوات المتخصصة مثل REA MCP |
| A2A | وكيل <-> وكيل | «كيف تنسّق الوكلاء الموزعة وتفوّض المهام بينها؟» | عقود مهام HTTP / JSON-RPC (Google / Linux Foundation) | تنسيق الأنظمة متعددة الوكلاء عبر حدود الخدمات |
| REST / SSE مخصص | خادم واحد <-> واجهة واحدة | «كيف أربط هذا النموذج الأولي سريعاً؟» | حزم JSON خاصة غير موحدة | النماذج الصغيرة؛ عبء صيانة مرتفع عند تعدد المنصات |
في المعمارية الإنتاجية المتكاملة، يستخدم الوكيل MCP للوصول إلى الأدوات والذاكرة (مثل الاستعلام من طبقة الذاكرة الدائمة claude-mem)، ويفوّض المهام للوكلاء الآخرين عبر A2A، ويقدّم كامل التجربة التفاعلية للمستخدم عبر AG-UI.
عائلات الأحداث والاستقلالية عن طبقة النقل
صُمم AG-UI ليكون مستقلاً عن طبقة النقل؛ فيعمل عبر Server-Sent Events (SSE) للتدفق الخفيف أحادي الاتجاه من الخادم إلى الواجهة، أو عبر WebSockets عند الحاجة لتواصل ثنائي الاتجاه في الزمن الحقيقي لإرسال الإلغاءات الفورية أو نتائج أدوات العميل.
وتنقسم دورة حياة التفاعل إلى أربع عائلات رئيسية من الأحداث:
1. دورة حياة التشغيل والخطوات (Runs & Steps)
RUN_STARTED: يعلن بدء جولة تشغيل جديدة مع معرّفيthreadIdوrunId.STEP_STARTEDوSTEP_FINISHED: يتيحان عرض مراحل التنفيذ الداخلية بوضوح في واجهة المستخدم.RUN_FINISHEDوRUN_ERROR: يبلّغان باكتمال التشغيل، أو التوقف المنظّم للموافقة البشرية (interrupt)، أو حدوث خطأ.
2. بث الرسائل النصية (Text Messages)
TEXT_MESSAGE_STARTوTEXT_MESSAGE_CONTENTوTEXT_MESSAGE_ENDوTEXT_MESSAGE_CHUNK: تنقل الأجزاء النصية المتتالية مربوطة بمعرّف رسالة محدد، ما يمنع تداخل التدفقات المتزامنة في الواجهة.
3. استدعاء الأدوات أثناء الإجابة (Tool Calls)
TOOL_CALL_STARTوTOOL_CALL_ARGSوTOOL_CALL_ENDوTOOL_CALL_RESULTوTOOL_CALL_CHUNK: تبث قرار استدعاء الأداة ومعاملات JSON أثناء توليدها، بحيث تعرض الواجهة بطاقة تنفيذ فورية أو مكوّناً تفاعلياً (Generative UI) داخل الرد نفسه.
4. مزامنة الحالة المشتركة (State Management)
STATE_SNAPSHOT: يرسل لقطة كاملة للحالة عند بدء الاتصال أو بعد استعادة الشبكة.STATE_DELTA: يرسل الفروقات الجزئية فقط بصيغة RFC 6902 JSON Patch، مما يخفض استهلاك الشبكة ويمنع إعادة رسم الجداول والنماذج المعقدة بالكامل.
نصيحة
توفر أبرز أطر الوكلاء — ومنها LangChain وCrewAI وMicrosoft Agent Framework وGoogle ADK وLlamaIndex وPydantic AI — محوّلات AG-UI مدمجة أو رسمية، ما يمنح فرق الهندسة حرية تبديل محرك الخلفية دون إعادة كتابة الواجهات.
آلية التوقف والاستئناف النظيف للموافقة البشرية
إبقاء اتصال HTTP مفتوحاً بانتظار نقرة مستخدم يؤدي غالباً إلى انتهاء مهلة الوكيل العكسي أو انقطاع تطبيق الجوال في الخلفية. يعالج AG-UI نمط الإنسان في الحلقة (HITL) بجعل التوقف حداً نهائياً نظيفاً عبر RUN_FINISHED متضمناً كائن interrupt ومعرّف interruptId.
بعد قرار المستخدم في الواجهة، يطلق العميل جولة جديدة عبر HttpAgent من حزمة @ag-ui/client مع مصفوفة resume:
import { HttpAgent } from "@ag-ui/client";
const agent = new HttpAgent({
url: "https://api.example.com/agent",
headers: {
Authorization: `Bearer ${process.env.AGUI_TOKEN}`,
},
threadId: "thread-ops-4821",
});
agent.messages.push({
id: "msg-user-1",
role: "user",
content: "حذف مسودات الفواتير المؤقتة المؤرشفة منذ أكثر من 90 يوماً.",
});
async function executeWithApproval() {
// 1. تنتهي الجولة الأولى بنظافة بحالة interrupt بانتظار موافقة المراجع
await agent.runAgent();
// المعرّف المستخرج من حدث RUN_FINISHED وقرار المستخدم في الواجهة:
const pendingInterruptId = "intr-clean-drafts-01";
const approvedByReviewer = true;
// 2. استئناف التنفيذ على threadId نفسه عبر حمولة resume
const resumed = await agent.runAgent({
resume: [
{
interruptId: pendingInterruptId,
status: approvedByReviewer ? "resolved" : "cancelled",
payload: {
approved: approvedByReviewer,
comment: approvedByReviewer
? "تمت الموافقة من لوحة العمليات."
: "مرفوض وفق سياسة الاحتفاظ بالبيانات.",
},
},
],
});
return resumed;
}
سواء اتخذ المراجع قراره خلال ثلاث ثوانٍ أو ثلاث ساعات، لا يظل أي اتصال شبكي معلّقاً على الخادم؛ بل يُستأنف التنفيذ بدقة من نقطة الحفظ المرتبطة بـ threadId.
منظومة حزم التطوير (SDKs) للويب والجوال والطرفية
لأن AG-UI يفصل دلالة الأحداث عن محرك الرسم، يمكن لنقطة نهاية واحدة خدمة جميع المنصات معاً:
- تطبيقات الويب (دعم رسمي): حزم TypeScript (
@ag-ui/coreو@ag-ui/client) مع CopilotKit لأطر React وAngular وVue مع معالجة مدمجة لفروقات الحالة واستعادة اللقطات. - تطبيقات الجوال متعددة المنصات: حزمة Kotlin Multiplatform لأنظمة Android وiOS وJVM، وتطبيقات Swift الأصلية لنظام iOS (
async/awaitوCodable)، إضافةً إلى دعم React Native وحزم مجتمعية لمنصة Flutter تدعم بث SSE ونماذج الموافقة البشرية. - الطرفية وسطر الأوامر (CLI): يمكن بناء عملاء طرفيين تفاعليين ولوحات مراقبة للوكلاء بلغة Node.js/TypeScript أو Python أو .NET مباشرة فوق تدفق الأحداث ذاته.
- لغات المواصفة الأساسية 1.0: تغطي التعريفات الرسمية TypeScript وPython و.NET إلى جانب حزم مجتمعية نشطة بلغات Go وRust وJava وDart/Flutter وRuby وC++.
تحذير
ضوابط الأمان والصلاحيات: يوحّد AG-UI نقل الأحداث ولا يحل محل طبقة التفويض الأمني. لا تعتمد أبداً على قيمة approved: true الواردة من العميل في resume دون إعادة التحقق على الخادم من جلسة المستخدم المصادق عليها، وصلاحيات الأدوار (RBAC)، ومطابقة interruptId مع threadId. ولضبط تكلفة التوكنز في الوكلاء كثيفة البث، يمكنك مراجعة دليل ضغط التوكنز عبر Caveman.
متى ينبغي اعتماد AG-UI في معمارية منتجك؟
إذا كان تطبيقك يولّد فقرة نصية ثابتة مرة واحدة لكل طلب، فإن HTTP العادي يكفي. أما اعتماد AG-UI فيحقق عائداً هندسياً واضحاً عندما يتوافر شرطان أو أكثر مما يلي:
- الحاجة إلى تشغيل الوكيل ذاته عبر الويب والجوال والطرفية دون تكرار محللات التدفق.
- عرض استدعاءات الأدوات أثناء الرد، ومزامنة الحالة المشتركة، وإدارة بوابات الموافقة البشرية بأمان.
- الاحتفاظ بحرية تغيير إطار الوكيل الخلفي مستقبلاً دون إعادة كتابة الواجهات الأمامية.
لتقدير نطاق وتكلفة بناء واجهات وكلاء متعددة المنصات يمكنك تجربة حاسبة التكلفة، أو التواصل مباشرة مع فريق الهندسة عبر صفحة التواصل مع Kling Digital لتصميم معماريات AG-UI وMCP جاهزة للإنتاج.




