المصدر متاحمصفوفة اختبار ADK-Rust v2 تم التحقق منها

عمليات الوكلاء متعددة القنوات

تشغيل وكلائك حيث يعمل مستخدموك بالفعل.

بوابة ADK تربط قنوات المراسلة، تطبيقات الويب، ووكلاء آخرين بفريق من وكلاء ADK-Rust. توجه كل طلب، تستعيد السياق الصحيح، تطبق سياسة التشغيل، وتوفر للمطورين مكانًا واحدًا لرؤية النظام والتحكم به.

بوابة ADK تشغيل

الأشخاص والأنظمة

تيليجرام
Slack
واتساب
Discord
مصفوفة

الهوية · الموجه · المشغل

الجلساتالسياسةالأحداثالتسليم

فريق الوكلاء

وكيل النظام
وكيل الدعم
وكيل البحث
وكيل الترميز
الأدواتالذاكرةالبروتوكولاتالتحكم

لماذا بوابة؟

الوكيل مفيد. نظام الوكلاء المُدار هو منتج.

يمكن لوكيل ADK-Rust التفكير، استدعاء الأدوات، وبث الأحداث. يجب على النشر الحقيقي أيضًا الإجابة عن أسئلة عملية: أين تصل الطلبات؟ أي وكيل يجب أن يستلمها؟ أي جلسة يجب استعادتها؟ ماذا يُسمح لذلك الوكيل أن يفعل؟

توفر بوابة ADK طبقة التشغيل المشتركة هذه. تدخل Telegram، Slack، WhatsApp، Discord، Matrix، webhooks، وطلبات الويب الموجهة للوكيل عبر المحولات. تحول البوابة هذه إلى شكل رسالة واحد، تطبق قواعد الوصول، توجهها إلى نظام أو وكيل متخصص، وتسلم التقدم عبر القناة الأصلية.

البوابة لا تدمج كل وكيل في مساعد واحد. يمكن للمطورين الاحتفاظ بوكلاء البحث، الدعم، العمليات، والبرمجة منفصلين — مع نماذج، أدوات، مساحات عمل، أذونات، وربط قنوات مختلفة — مع تشغيلهم عبر واجهة تحكم واحدة.

بدون بوابة

  • كل قناة تحتاج إلى تكامل وكيل خاص بها
  • تتغير الجلسات والهويات بين نقاط الدخول
  • يتم تكوين الأدوات والأذونات في عدة أماكن
  • المشغلون لا يمكنهم رؤية نظام الوكيل بالكامل

مع ADK Gateway

  • مهايئات القناة تشترك في عقد وارد واحد
  • التوجيه يختار الوكيل والجلسة عن قصد
  • تبقى القدرات والسياسة مرتبطة بأدوار الوكلاء
  • لوحة تحكم واحدة تعرض الوكلاء والقنوات والعمل والصحة

البنية

بوابة واحدة حول فريق من الوكلاء الذين يتم التحكم بهم بشكل مستقل.

اقرأ الهندسة المعمارية من اليسار إلى اليمين. تدخل الطلبات عبر قنوات البشر أو الوكلاء. تحدد الهوية والتوجيه مكان انتمائها. يقوم ADK-Rust بتشغيل الوكيل المختار بحالته وقدراته الخاصة. تراقب لوحة التحكم كل طبقة دون أن تصبح جزءًا من المحادثة.

نقاط الدخول

  • تيليجرام · سلاك
  • واتساب · ديسكورد
  • مصفوفة · webhooks
  • طلبات AWP

حافة الثقة

  • الإقران + الهوية
  • قوائم السماح + الأدوار
  • حدود المعدل
  • JWT / SSO

وقت تشغيل البوابة

  • موجه الرسائل
  • ADK-Rust Runner
  • الجلسات + الأحداث
  • التسليم

فريق الوكلاء

  • وكيل النظام
  • وكلاء متخصصون
  • رسم تدفقات العمل البيانية
  • وكلاء ترميز ACP

الإمكانات

  • النماذج + بديل
  • أدوات Rust + MCP
  • الذاكرة + RAG
  • الوثائق + التخزين

لوحة تحكم المشغل

تكوين، الموافقة، المراقبة، الاسترداد، وتدقيق مسار الطلب الكامل.

لوحة التحكمأحداث WebSocketالقياساتالسجلاتالصحة
الواجهات والتسليمالهوية وسياسة التشغيلالتوجيه والتنفيذالحالة والقدرات

متابعة طلب واحد

من رسالة Telegram إلى الوكيل المختص المناسب.

ينطبق نفس التدفق على كل قناة مدعومة. يتغير فقط المحول وصيغة التسليم؛ التوجيه، الجلسات، تنفيذ الوكيل، السياسة، والأدلة تبقى مشتركة.

  1. 01Channel adapter

    استقبال شكل رسالة واحد

    تيليجرام، سلاك، واتساب، ديسكورد، ماتريكس، وwebhooks تصل بصيغ مختلفة. يحول كل محول هذه الرسائل إلى نفس عقدة الرسالة الواردة.

  2. 02Access boundary

    تحديد من يمكنه المتابعة

    قواعد الإقران، قوائم السماح، سياسة ذكر المجموعة، هوية متعددة المستخدمين، حدود المعدل، وفحوصات JWT الاختيارية تُنفذ قبل وصول الطلب إلى الوكيل.

  3. 03موجه الرسائل

    اختر الوكيل المناسب

    يتحقق التوجيه من القناة، والحساب، والشخص أو المجموعة. يفوز التطابق الأكثر تحديداً؛ وكيل النظام هو الخيار النهائي.

  4. 04ADK-Rust Runner

    استعادة المحادثة

    يقوم المشغل بإرفاق الجلسة الصحيحة، وسياق المستخدم، والذاكرة، وحالة الإلغاء، وسلسلة التراجع عن النموذج قبل بدء تنفيذ الوكيل.

  5. 05Specialist agent

    استخدم القدرات المعينة فقط

    يمكن للوكيل المختار استخدام أدوات Rust الخاصة به، خوادم MCP، المعرفة، سير العمل، أو وكيل ترميز ACP معتمد. تحدد سياسة الدور ما يمكنه استدعاؤه.

  6. 06Delivery + evidence

    إرجاع التقدم والاحتفاظ بسجل

    تصبح الأحداث المكتوبة مؤشرات كتابة، ورسائل تقدم، وصور، أو استجابة نهائية. تشرح المقاييس، والسجلات، وتاريخ المهام، وأحداث التدقيق ما حدث.

التوجيه في Rust

التوجيه صريح وقابل للاختبار.

يمكن للمطور ربط وكيل بقناة كاملة، حساب واحد على تلك القناة، أو شخص أو مجموعة محددة. يتحقق الموجه من القاعدة الأكثر تحديدًا أولاً ويتراجع بشكل متوقع.

المثال يلخص التنفيذ المصدر للقراءة. يختبر المستودع السلوك الدقيق على مستوى الحساب، القناة، القديم، والافتراضي للتوجيه.

router.rs · simplified resolution order
/// Most-specific binding wins.
pub fn resolve_agent(&self, message: &InboundMessage) -> &str {
    // 1. channel + account + person or group
    if let Some(agent) = self.exact_binding(message) {
        return agent;
    }

    // 2. channel + account, then channel-only
    if let Some(agent) = self.account_binding(message)
        .or_else(|| self.channel_binding(message))
    {
        return agent;
    }

    // 3. configured legacy rules, then the system agent
    self.legacy_binding(message)
        .unwrap_or(&self.default_agent_id)
}
gateway.json · agent, channel, and role
{
  "agent": {
    "model": {
      "primary": "openai/gpt-5.4-mini",
      "fallbacks": ["openai/gpt-5.4-nano"]
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing"
    }
  },
  "user_agents": [{
    "id": "support",
    "name": "Customer support",
    "tools": ["order_lookup", "refund_request"],
    "channel_bindings": [{ "channel_type": "telegram" }],
    "role": {
      "allow": ["order_lookup", "refund_request"],
      "deny": ["refund_issue"]
    },
    "auto_start": true
  }]
}

لوحة تحكم مدمجة

رؤية النظام. تغييره عن قصد.

لوحة تحكم React مدمجة في ملف Rust الثنائي وتُقدم على /ui. It is the operator interface for configuration, agent lifecycle, approvals, sessions, memory, scheduled work, logs, and health.

الإعداد

اختر مزودي النماذج، خزّن بيانات الاعتماد، اربط حسابات القناة، وتحقق من البوابة قبل فتحها للمستخدمين.

معالج التشغيل الأولالنماذج البديلةاختبارات اتصال القناةتكوين JSON تم التحقق منه

توجيه الوكلاء

إنشاء متخصصين، تعيين الأدوات والقنوات، بدء أو إيقاف عملياتهم، وتحديد الوكلاء الذين يمكنهم تفويض العمل.

دورة حياة الوكيلربط القنواتأذونات التفويضالمهام المجدولة

ابقَ مسيطراً

مراجعة مكالمات الأدوات الحساسة، إقران المستخدمين، إنهاء الجلسات، فحص الموافقة، والتدخل عندما لا يجب متابعة مهمة.

موافقات الأدواتالإقران والأدوارإنهاء الجلسةموافقة AWP

تشغيل

راقب القنوات والوكلاء في الوقت الحقيقي، وافحص الأخطاء، وابحث في الذاكرة، وتابع صحة البوابة العاملة.

لوحة تحكم WebSocket الحيةالسجلات والقياساتمستعرض الذاكرةصحة المكون

فتح حدود البروتوكول

الاتصال بالأدوات، وكلاء الترميز، المواقع الإلكترونية، والتطبيقات.

القنوات تربط البوابة بالأشخاص. البروتوكولات تربطها بالقدرات وبرمجيات أخرى. لكل حد وظيفة مميزة، لذا يمكن للمطورين إضافة واحدة دون إعادة تصميم وقت التشغيل بالكامل.

MCP

تزويد الوكلاء بأدوات خارجية

الاتصال بخوادم القدرات للمتصفحات، الحواسيب، الوسائط، البيانات، وأنظمة الأعمال. يمكن للبوابة إضافة، سرد، وإزالة خوادم MCP المكونة دون دمج كل تكامل في ملفها التنفيذي.

ACP

تفويض عمل الترميز

تشغيل عمليات وكيل الترميز المدعومة خلف حدود مراقبة. تبقى سياسة مساحة العمل، وطلبات الأذونات، والتقدم، والتكلفة، وحالة الطابور، وتاريخ المهام مرئية للبوابة.

AWP

كشف واجهة ويب موجهة للوكيل

نشر الاكتشاف، القدرات، الصحة، الموافقة، الاشتراكات، ونقطة نهاية رسالة الوكيل حتى تتمكن البرامج الأخرى من فهم كيفية العمل مع البوابة.

HTTP + WebSocket

الدمج والتشغيل

تجلب الويب هوكس الواردة العمل من تطبيقات أخرى. APIs HTTP وأحداث WebSocket الحية تشغل لوحة التحكم المدمجة وأدوات العمليات الخارجية.

الحدود الحالية: المصدر يكشف عن مسار agent-message الخاص به تحت واجهة AWP. الصفحة لا تدعي وجود واجهة خادم A2A مكتملة ومحققة بشكل منفصل أو تنفيذ إنتاجي لتجارة AWP.

الحوكمة

توفير مساحة عمل للوكلاء ضمن حدود مرئية.

يجب أن تكون استقلالية الوكيل قرار تشغيل مهيأ. تضع بوابة ADK الهوية، السلطة، الحدود، والأدلة حول نفس مسار التنفيذ الذي يحمل الطلب.

01

الهوية

الإقران، قوائم السماح، جلسات متعددة المستخدمين، JWT/JWKS، وتعيين الأدوار تحدد من يقوم بالطلب.

02

السلطة

قواعد السماح والرفض لكل وكيل بالإضافة إلى الموافقة على الأدوات تحدد القدرات التي يمكن للشخص أو الوكيل استخدامها.

03

القيود

تحديد معدلات الطلب، مهلات الطلب، الإلغاء، حلقات الأدوات المحدودة، وسياسة الصحة تحد من مدة استمرار العمل.

04

الأدلة

توفر أحداث التدقيق، السجلات، المقاييس، تاريخ المهام، نتائج الأدوات، وتاريخ الصحة سجلًا تشغيليًا.

النشر

اختر مكان تشغيل البوابة.

يمكن لمحطة عمل المطور، خادم داخلي، أو حاوية تشغيل نفس شكل البوابة. يمكن تخزين الجلسة في الذاكرة لتجربة محلية أو الانتقال إلى SQLite، PostgreSQL، Redis، أو Firestore لنظام منشور.

01

ثنائي وحيد

خدمة Rust تضم لوحة تحكم React المجمعة. قم بتثبيت أو نسخ ملف تنفيذي واحد واحتفظ بالتكوين بجانبه.

02

حاوية

يتضمن المستودع ملف Dockerfile وعقود حجم ومنفذ موثقة لنشر الحاويات.

03

خدمة لينكس

وحدة systemd تدعم بدء التشغيل عند الإقلاع، سياسة إعادة التشغيل، الجاهزية، السجلات، وملفات البيئة التي يملكها المشغل.

04

خدمة macOS

تعريف launchd يشغل بوابة محلية دائمة لوكلاء المطور ومحطة العمل.

الترحيل والتحقق

ما الذي تم التحقق منه اليوم؟

قدرات المنتج في هذه الصفحة تأتي من مصدر البوابة المحلية، التكوين، الوثائق، ومجموعات الاختبار. تمر الآن ترحيل ADK-Rust v2 بالتحقق من المكتبة، الخاصية، التكامل، الوكيل المولد، ولوحة التحكم.

المصدر الذي تم التحقق منه

هيكلية منتج البوابة

محولات القنوات، توجيه الرسائل، سجل الوكلاء، دورة حياة العمليات، الجلسات، الذاكرة، RAG، المهام المجدولة، الموافقة على الأدوات، التحكم في الوصول، مسارات لوحة التحكم، AWP، تكامل MCP وACP، أصول النشر، والاختبارات موجودة في المستودع المراجع.

الاختبارات تم التحقق منها

ترحيل ADK-Rust v2 محلي

كل تبعية في ADK تحل إلى مساحة العمل المحلية 2.0. Rust 2024 وRust 1.95 تُجمّع عبر جميع الأهداف والميزات. جميع اختبارات المكتبة البالغ عددها 845، و276 اختبار خاص بالخصائص والتكامل المستقل، و81 اختبار لوحة تحكم تمر بنجاح.

الإصدار المنشور

crates.io لا يزال على الإصدار 1

الحالة v2 التي تم التحقق منها هي حالياً ترحيل مصدر محلي، وليست حزمة adk-gateway v2 منشورة. يجب أن تستمر إرشادات التثبيت في التمييز بين فحص المصدر وإصدار crates.io v1.

التحقق من المشغل

سلوك معتمد ومنشور

كل مزود رسائل، مزود نموذج، خادم MCP خارجي، خلفية دائمة، مزود هوية، ونشر الإنتاج لا تزال بحاجة إلى مراجعة بيانات الاعتماد والبنية التحتية والأمان من مشغله.

تقييد صريح

أسطح تجريبية

توليد الشيفرة متعدد الوكلاء لا يزال يوثق نقاط نهاية A2A النائبة، ويتم إعلان تجارة AWP لكنها غير منفذة كنظام معاملات كامل. ولا يتم تقديم أي منهما هنا كجاهز للإنتاج.

مراجعة المصدر: تحل جميع تبعيات ADK إلى مساحة العمل المحلية v2.0.0، يستهدف المشروع Rust 2024 مع MSRV 1.94، ويمر التجميع لجميع الأهداف/الميزات بنجاح. تجتاز عملية التحقق 845 اختبار مكتبة، 276 اختبار خاصية وتكامل مستقل، و81 اختبار لوحة تحكم؛ يستمر crates.io في نشر إصدار v1.

يُقدَّم ADK Gateway كبرنامج مدعوم بالمصدر، وليس كخدمة مستضافة على موقع ويب. تم التحقق من ترحيل الإصدار المحلي v2، بينما يظل crates.io على الإصدار v1. تعتمد قنوات المراسلة، مزودو النماذج، أدوات MCP الخارجية، الخلفيات الدائمة، وأمان الإنتاج على بيانات اعتماد المشغل وتكوين النشر؛ يظل توليد الكود التجريبي والتجارة عبر AWP محدودين صراحة في وثائق المصدر.

ابنِ طبقة التشغيل

الاتصال بقناة واحدة. توجيه طلب واحد. إبقاء كل قرار مرئياً.

ابدأ من المصدر v2 الموثق. يحتوي المستودع على البوابة، ولوحة التحكم المدمجة، ومرجع التكوين، وأدلة القنوات، وأصول النشر، ومجموعات الاختبار اللازمة لفهم وتشغيل النظام الكامل.