ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصداركود / SDK · جاهز للعملGitHub Trending AI→ المصدر

AG-UI 1.0 يمنح وكلاء الذكاء الاصطناعي لغة موحدة للتواصل مع التطبيق: 31 نوعًا من الأحداث

يُبلغ كل إطار عمل للوكلاء التطبيقَ بطريقته الخاصة بأن الوكيل يكتب أو استدعى أداة أو ينتظر تأكيدًا من الإنسان. ويستبدل بروتوكول AG-UI 1.0 هذه الوصلات محلية الصنع بتدفق أحداث مشترك، مثل «بدأ الكتابة» أو «استدعى أداة». عدد هذه الأنواع 31، وهي مجمّعة في ثماني عائلات. لذلك يعمل وكيل واحد على الويب أو في تطبيق الجوّال أو في Slack دون إعادة كتابة الواجهة.

معالج بواسطة الذكاء الاصطناعي من GitHub Trending AI؛ بتحرير Hamidun News
AG-UI 1.0 يمنح وكلاء الذكاء الاصطناعي لغة موحدة للتواصل مع التطبيق: 31 نوعًا من الأحداث
المصدر: GitHub Trending AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليGitHub Trending AI ↗
رئيس التحرير
النسخة 1.0 مجمّدةوكلاء 0.x يعملون مع عملاء 1.0 والعكس صحيح
حقيقة رئيسية #2حزم SDK للغات TypeScript وPython و.NET تُولَّد من JSON Schema
حقيقة رئيسية #3من بين الداعمين المعلَن عنهم Google وMicrosoft وAmazon وOracle

تخيّل أنك تدمج وكيل ذكاء اصطناعي في نافذة دردشة داخل منتجك. يكتب الوكيل إجابته كلمة بكلمة، ويستدعي في منتصفها أداة، كالبحث في قاعدة بيانات، ثم ينتظر أن يضغط المستخدم «تأكيد». يُبلغ كل إطار عمل للوكلاء التطبيقَ بذلك كله بصيغته الخاصة، فيضطر مطوّر الواجهة الأمامية إلى كتابة وصلة مستقلة لكل واجهة خلفية. يلغي بروتوكول AG-UI (اختصار Agent-User Interaction Protocol، أي «بروتوكول التفاعل بين الوكيل والمستخدم») هذه الوصلات. ففي النسخة 1.0 يصف 31 نوعًا من الأحداث: «بدأ الوكيل الكتابة»، و«استدعى أداة»، و«حدّث الحالة» وغيرها. وتستطيع أي واجهة مستخدم (UI) عرض هذه الأحداث.

كيف يعمل

يمرّ بين الوكيل والتطبيق تدفق أحداث واحد ثنائي الاتجاه. يطلق التطبيق «تشغيلًا» (run) ويرسل إلى الوكيل رسالة واحدة تتضمن سجل المحادثة وقائمة الأدوات التي تستطيع الواجهة الأمامية تنفيذها والحالة المشتركة والسياق. وفي المقابل يرسل الوكيل تدفقًا من الأحداث المصنّفة. لا يهم العميل اللغة التي كُتب بها الوكيل، ويكفيه أن يفهم الأحداث.

والتشبيه المألوف هنا هو ترجمة الأفلام النصية. قد يكون الفيلم صُوّر بأي كاميرا، لكن إذا كانت صيغة الترجمة موحدة فسيعرضها أي مشغّل. وهنا يؤدي دور المشغّل تطبيق الويب أو عميل الجوّال أو الطرفية أو Slack.

هذه الأنواع الـ31 من الأحداث موزعة على ثماني عائلات: دورة حياة التشغيل، والرسائل النصية، واستدعاءات الأدوات، والحالة، والاستدلال، والنشاط، والوكلاء الفرعيون، والأحداث المخصصة. العائلة الأولى وحدها إلزامية. فالوكيل الأدنى يرسل بضعة أحداث فقط، وتُضاف البقية مع نمو المنتج.

وتمرّ عبر هذه الأحداث أمور يُضطر المطوّر عادةً إلى تنفيذها يدويًا:

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

ماذا يعني «1.0» للمطوّر

يعني الرقم 1.0 الاستقرار. فالمواصفة مجمّدة ومعرَّفة عبر JSON Schema، وحزم SDK للغات TypeScript وPython و.NET تُولَّد منها مباشرة. وهذا يقلل خطر تباعد العميل والخادم في التفاصيل. كما أُعلن عن توافق عكسي في الاتجاهين: وكلاء النسخة 0.x يعملون مع عملاء 1.0 والعكس صحيح. ولن يضطر من بدأ التكامل بالفعل إلى إعادة كتابة أي شيء.

ولا يرتبط البروتوكول بوسيلة نقل بعينها: تصف المواصفة ربطًا عبر HTTP، ويستطيع الوسيط (middleware) أن يضيف أحداثًا من أي مصدر آخر. وأي وكيل AG-UI هو نقطة نهاية HTTP تستقبل الطلب وتبثّ الأحداث عائدةً. ويتضمن المستودع مثالًا لخادم وعميل في نحو 30 سطرًا. ولا يحتاج المثال إلى مفاتيح API: يُثبَّت الخادم عبر pip install ag-ui-protocol fastapi uvicorn، والعميل عبر npm install @ag-ui/client tsx (يلزم Node.js 20+). وإذا استبدلتَ الخادم بآخر فلا حاجة إلى تغيير العميل.

وللبدء السريع توجد أداة سطر أوامر: يولّد الأمر npx create-ag-ui-app@latest واجهة أمامية على Next.js أو عميلًا طرفيًا لإطار عمل الوكلاء الذي تختاره. وتتصل القوالب بـ OpenAI، لذا يلزم مفتاح قبل التشغيل.

موقعه بين البروتوكولات الأخرى وتحفظات

يُقدَّم AG-UI بوصفه العنصر الثالث في مجموعة بروتوكولات الوكلاء المفتوحة. يمنح MCP الوكيلَ الأدوات والسياق، ويتيح A2A للوكلاء التخاطب فيما بينهم، ويربط AG-UI الوكيل بالمستخدم. وبإمكان وكيل واحد استخدام الثلاثة معًا، ويمكن أن يقف AG-UI أمام وكلاء يتحدثون MCP أو A2A. وتقف على حدة صيغ مثل MCP Apps وOpen-JSON-UI: فهي تصف أي واجهة يريد الوكيل عرضها. أما AG-UI فهو في هذه الصورة القناة التي تصل عبرها هذه الأوصاف وكل ما عداها إلى التطبيق.

يعلن المؤلفون أن Google وMicrosoft وAmazon وOracle تبنّت البروتوكول، وأنه مدمج في معظم أطر عمل الوكلاء. ومن بين التكاملات المذكورة OpenAI Agents وwatsonx وSpring AI وعملاء لـ React وAngular وVue وReact Native. وهذه المعلومات مأخوذة من وصف المشروع نفسه، ولا يتضمن المقال تحققًا مستقلًا من حجم الاعتماد الفعلي. وينبغي النظر إلى العروض التجريبية المحددة في Dojo والتحقق من مدى دعم إطار العمل الذي تحتاجه دون حلول ترقيعية محلية.

الخلاصة العملية: إذا كنت تبني منتجًا بعدة واجهات، أو تريد تغيير إطار عمل الوكلاء دون إعادة كتابة الواجهة الأمامية، فجرّب AG-UI على نموذج أولي صغير. فهو يغنيك عن بروتوكول محلي الصنع بين الوكيل والواجهة، يضطر المطوّرون عادةً إلى صيانته بأنفسهم.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول كيف يعمل؟

يمرّ بين الوكيل والتطبيق تدفق أحداث واحد ثنائي الاتجاه. يطلق التطبيق «تشغيلًا» (run) ويرسل إلى الوكيل رسالة واحدة تتضمن سجل المحادثة وقائمة الأدوات التي تستطيع الواجهة الأمامية تنفيذها والحالة المشتركة والسياق. وفي المقابل يرسل الوكيل تدفقًا من الأحداث المصنّفة. لا يهم العميل اللغة التي كُتب بها الوكيل، ويكفيه أن يفهم الأحداث. والتشبيه المألوف هنا هو ترجمة الأفلام النصية. قد يكون الفيلم صُوّر بأي كاميرا، لكن إذا كانت صيغة الترجمة موحدة فسيعرضها أي مشغّل.

ما أبرز التفاصيل حول ماذا يعني «1.0» للمطوّر؟

يعني الرقم 1.0 الاستقرار. فالمواصفة مجمّدة ومعرَّفة عبر JSON Schema، وحزم SDK للغات TypeScript وPython و.NET تُولَّد منها مباشرة. وهذا يقلل خطر تباعد العميل والخادم في التفاصيل. كما أُعلن عن توافق عكسي في الاتجاهين: وكلاء النسخة 0.x يعملون مع عملاء 1.0 والعكس صحيح. ولن يضطر من بدأ التكامل بالفعل إلى إعادة كتابة أي شيء. ولا يرتبط البروتوكول بوسيلة نقل بعينها: تصف المواصفة ربطًا عبر HTTP، ويستطيع الوسيط (middleware) أن يضيف أحداثًا من أي مصدر آخر. وأي وكيل AG-UI هو نقطة نهاية HTTP تستقبل الطلب وتبثّ الأحداث عائدةً.

ما أبرز التفاصيل حول موقعه بين البروتوكولات الأخرى وتحفظات؟

يُقدَّم AG-UI بوصفه العنصر الثالث في مجموعة بروتوكولات الوكلاء المفتوحة. يمنح MCP الوكيلَ الأدوات والسياق، ويتيح A2A للوكلاء التخاطب فيما بينهم، ويربط AG-UI الوكيل بالمستخدم. وبإمكان وكيل واحد استخدام الثلاثة معًا، ويمكن أن يقف AG-UI أمام وكلاء يتحدثون MCP أو A2A. وتقف على حدة صيغ مثل MCP Apps وOpen-JSON-UI: فهي تصف أي واجهة يريد الوكيل عرضها. أما AG-UI فهو في هذه الصورة القناة التي تصل عبرها هذه الأوصاف وكل ما عداها إلى التطبيق.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…