AG-UI: البروتوكول الذي يربط وكلاء الذكاء الاصطناعي بتطبيقات الواجهة الأمامية
لقاء وكلاء الذكاء الاصطناعي بالواجهة الأمامية
مع التطور المتسارع لتقنيات وكلاء الذكاء الاصطناعي، باتت عملية دمجها مع واجهات مستخدم سهلة الاستخدام تحدياً هندسياً محورياً. صُمِّم AG-UI تحديداً لمعالجة هذه المشكلة؛ إذ يُقنّن طريقة اتصال وكلاء الذكاء الاصطناعي بتطبيقات الواجهة الأمامية، مما يجعل الأنظمة الوكيلة في متناول المستخدمين النهائيين.
ما هو AG-UI؟
AG-UI أو بروتوكول تفاعل الوكيل مع المستخدم (Agent-User Interaction Protocol) هو بروتوكول خفيف الوزن قائم على الأحداث يُقنّن أسلوب اتصال وكلاء الذكاء الاصطناعي بتطبيقات الواجهة الأمامية. صُمِّم انطلاقاً من مبدأَي البساطة والمرونة، مما يُتيح التكامل السلس بين الوكلاء وواجهات المستخدم.
الخصائص الجوهرية
- بنية قائمة على الأحداث: تُطلق خلفيات الوكلاء أحداثاً متوافقة مع نحو 16 نوعاً من أنواع الأحداث القياسية في AG-UI.
- طبقة وسيطة مرنة: تدعم آليات نقل أحداث متعددة من بينها SSE وWebSockets والـ webhooks.
- مطابقة مرنة لتنسيق الأحداث: تضمن قابلية التشغيل البيني بين طيف واسع من الوكلاء والتطبيقات.
- تطبيق HTTP مرجعي: يوفر موصّلاً جاهزاً يُمكّن الفرق من البدء بسرعة.
موقع AG-UI في مكدس بروتوكولات الوكلاء
يؤدي AG-UI دوراً تكاملياً إلى جانب بروتوكولات الوكلاء الرئيسية الأخرى:
- MCP (بروتوكول سياق النموذج): يوفر الأدوات للوكلاء.
- A2A (وكيل إلى وكيل): يُتيح التواصل بين الوكلاء.
- AG-UI: يدمج الوكلاء في التطبيقات الموجهة للمستخدمين.
تعمل هذه البروتوكولات الثلاثة معاً لتشكّل منظومة متكاملة للأنظمة الوكيلة.
الميزات الرئيسية
محادثة وكيلة في الوقت الفعلي
- دعم البث للمحادثات الحية دورة بدورة.
- تفاعل طبيعي بين المستخدمين والوكلاء.
مزامنة الحالة ثنائية الاتجاه
- مزامنة الحالة في الوقت الفعلي بين الوكيل والواجهة الأمامية.
- تجربة مستخدم متسقة طوال الجلسة.
الواجهة التوليدية والرسائل المنظمة
- مكونات واجهة مستخدم تُولَّد ديناميكياً استجابةً لمخرجات الوكيل.
- عرض مخصص يتكيف مع كل رد من ردود الوكيل.
إثراء السياق في الوقت الفعلي
- تحديثات سياقية تُرسَل أثناء المحادثة في الوقت الفعلي.
- ردود وكيلة أكثر دقة وصلة بالموضوع.
تكامل أدوات الواجهة الأمامية
- تكامل سلس مع الأدوات الموجودة في تطبيقات الويب.
- قدرة الوكلاء على استدعاء وظائف الواجهة الأمامية مباشرةً.
التعاون بمشاركة الإنسان
- مسارات عمل تتيح تدخل الإنسان عند الحاجة.
- دعم تعاوني لاتخاذ القرارات في المهام المعقدة.
دعم أطر العمل
يتكامل AG-UI مع مجموعة من أطر عمل الوكلاء الشائعة.
متاح الآن
قيد التطوير
مساهمات مرحّب بها
دعم SDK حسب اللغة
| اللغة | الحالة | ملاحظات |
|---|---|---|
| Python | متاح | SDK الرئيسي |
| TypeScript | متاح | SDK الرئيسي |
| .NET | قيد التطوير | طلب سحب جارٍ |
| Nim | قيد التطوير | طلب سحب جارٍ |
| Rust | قيد التطوير | مخطط له |
البدء السريع
إنشاء تطبيق AG-UI جديد
أنشئ تطبيق AG-UI جديداً في ثوانٍ:
npx create-ag-ui-app my-agent-app
مثال Hello World
جرّب العرض التجريبي Hello World لترى AG-UI أثناء العمل. يشرح هذا المثال البسيط المفاهيم الأساسية وآلية عمل البروتوكول.
AG-UI Dojo: عارض الوحدات البنائية
AG-UI Dojo عرض للوحدات البنائية التي يدعمها AG-UI. تتراوح كل وحدة بين 50 و200 سطر من الكود الموجز، مما يجعلها مرجعاً مفيداً عند التنفيذ الفعلي.
دليل المطورين
دمج إطار عمل جديد
لدمج AG-UI مع إطار عمل وكيل جديد:
- الرجوع إلى دليل البدء السريع.
- حجز استشارة تكامل AG-UI.
- الانضمام إلى مجتمع Discord.
تفاصيل التطبيق التقني
يقوم جوهر بروتوكول AG-UI على التواصل القائم على الأحداث:
# مثال: إطلاق حدث من الوكيل
agent.emit_event({
"type": "message",
"content": "Hello from agent!",
"timestamp": datetime.now().isoformat()
})
// مثال: استقبال حدث في الواجهة الأمامية
agui.onEvent('message', (event) => {
console.log('Received:', event.content);
updateUI(event);
});
حالات استخدام فعلية
1. روبوت محادثة لدعم العملاء
- محادثة في الوقت الفعلي مع مزامنة الحالة.
- تصعيد المحادثة إلى وكيل بشري عند الاستفسارات المعقدة.
- عرض ديناميكي للمستندات والصور عبر واجهة مخصصة.
2. مساعد مراجعة الكود
- عرض نتائج تحليل الكود حياً في الواجهة.
- اقتراحات تحسين تفاعلية.
- تحرير تعاوني للكود بين المطور والوكيل.
3. لوحة تحليل البيانات
- استكشاف البيانات عبر استفسارات بالغة الطبيعية.
- توليد رسوم بيانية ومخططات في الوقت الفعلي.
- تصور تفاعلي لنتائج التحليل.
المجتمع والمساهمة
AG-UI مشروع مفتوح المصدر موزَّع بموجب رخصة MIT. تشكّل حوله مجتمع مطورين نشط، ويمكن المشاركة فيه بعدة طرق:
- الإبلاغ عن المشكلات وتقديم طلبات السحب عبر مستودع GitHub.
- الانضمام إلى مجتمع Discord (ورشة عمل مجدولة في 20 يونيو).
- المساهمة في دمج أطر عمل جديدة.
خلاصة
يعالج AG-UI الفجوة بين وكلاء الذكاء الاصطناعي وواجهات المستخدم. تتيح بنيته القائمة على الأحداث والخالية من التعقيد الزائد للمطورين بناء تطبيقات وكيلة دون الحاجة إلى كود قالبي مُفرط.
يمنح البروتوكول التفاعل الفوري والواجهة التوليدية ومسارات العمل بمشاركة الإنسان فائدة عملية في طيف واسع من أنواع تطبيقات الذكاء الاصطناعي. مع توسع دعم أطر العمل ونشاط المجتمع المستمر، يستحق AG-UI المتابعة بينما تواصل منظومة الوكلاء تطورها.
روابط مرجعية: