بدون بوابة
- كل قناة تحتاج إلى تكامل وكيل خاص بها
- تتغير الجلسات والهويات بين نقاط الدخول
- يتم تكوين الأدوات والأذونات في عدة أماكن
- المشغلون لا يمكنهم رؤية نظام الوكيل بالكامل
عمليات الوكلاء متعددة القنوات
بوابة ADK تربط قنوات المراسلة، تطبيقات الويب، ووكلاء آخرين بفريق من وكلاء ADK-Rust. توجه كل طلب، تستعيد السياق الصحيح، تطبق سياسة التشغيل، وتوفر للمطورين مكانًا واحدًا لرؤية النظام والتحكم به.
الأشخاص والأنظمة
الهوية · الموجه · المشغل
فريق الوكلاء
لماذا بوابة؟
يمكن لوكيل ADK-Rust التفكير، استدعاء الأدوات، وبث الأحداث. يجب على النشر الحقيقي أيضًا الإجابة عن أسئلة عملية: أين تصل الطلبات؟ أي وكيل يجب أن يستلمها؟ أي جلسة يجب استعادتها؟ ماذا يُسمح لذلك الوكيل أن يفعل؟
توفر بوابة ADK طبقة التشغيل المشتركة هذه. تدخل Telegram، Slack، WhatsApp، Discord، Matrix، webhooks، وطلبات الويب الموجهة للوكيل عبر المحولات. تحول البوابة هذه إلى شكل رسالة واحد، تطبق قواعد الوصول، توجهها إلى نظام أو وكيل متخصص، وتسلم التقدم عبر القناة الأصلية.
البوابة لا تدمج كل وكيل في مساعد واحد. يمكن للمطورين الاحتفاظ بوكلاء البحث، الدعم، العمليات، والبرمجة منفصلين — مع نماذج، أدوات، مساحات عمل، أذونات، وربط قنوات مختلفة — مع تشغيلهم عبر واجهة تحكم واحدة.
البنية
اقرأ الهندسة المعمارية من اليسار إلى اليمين. تدخل الطلبات عبر قنوات البشر أو الوكلاء. تحدد الهوية والتوجيه مكان انتمائها. يقوم ADK-Rust بتشغيل الوكيل المختار بحالته وقدراته الخاصة. تراقب لوحة التحكم كل طبقة دون أن تصبح جزءًا من المحادثة.
نقاط الدخول
حافة الثقة
وقت تشغيل البوابة
فريق الوكلاء
الإمكانات
لوحة تحكم المشغل
تكوين، الموافقة، المراقبة، الاسترداد، وتدقيق مسار الطلب الكامل.
متابعة طلب واحد
ينطبق نفس التدفق على كل قناة مدعومة. يتغير فقط المحول وصيغة التسليم؛ التوجيه، الجلسات، تنفيذ الوكيل، السياسة، والأدلة تبقى مشتركة.
تيليجرام، سلاك، واتساب، ديسكورد، ماتريكس، وwebhooks تصل بصيغ مختلفة. يحول كل محول هذه الرسائل إلى نفس عقدة الرسالة الواردة.
قواعد الإقران، قوائم السماح، سياسة ذكر المجموعة، هوية متعددة المستخدمين، حدود المعدل، وفحوصات JWT الاختيارية تُنفذ قبل وصول الطلب إلى الوكيل.
يتحقق التوجيه من القناة، والحساب، والشخص أو المجموعة. يفوز التطابق الأكثر تحديداً؛ وكيل النظام هو الخيار النهائي.
يقوم المشغل بإرفاق الجلسة الصحيحة، وسياق المستخدم، والذاكرة، وحالة الإلغاء، وسلسلة التراجع عن النموذج قبل بدء تنفيذ الوكيل.
يمكن للوكيل المختار استخدام أدوات Rust الخاصة به، خوادم MCP، المعرفة، سير العمل، أو وكيل ترميز ACP معتمد. تحدد سياسة الدور ما يمكنه استدعاؤه.
تصبح الأحداث المكتوبة مؤشرات كتابة، ورسائل تقدم، وصور، أو استجابة نهائية. تشرح المقاييس، والسجلات، وتاريخ المهام، وأحداث التدقيق ما حدث.
التوجيه في Rust
يمكن للمطور ربط وكيل بقناة كاملة، حساب واحد على تلك القناة، أو شخص أو مجموعة محددة. يتحقق الموجه من القاعدة الأكثر تحديدًا أولاً ويتراجع بشكل متوقع.
المثال يلخص التنفيذ المصدر للقراءة. يختبر المستودع السلوك الدقيق على مستوى الحساب، القناة، القديم، والافتراضي للتوجيه.
/// 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)
}{
"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.
اختر مزودي النماذج، خزّن بيانات الاعتماد، اربط حسابات القناة، وتحقق من البوابة قبل فتحها للمستخدمين.
إنشاء متخصصين، تعيين الأدوات والقنوات، بدء أو إيقاف عملياتهم، وتحديد الوكلاء الذين يمكنهم تفويض العمل.
مراجعة مكالمات الأدوات الحساسة، إقران المستخدمين، إنهاء الجلسات، فحص الموافقة، والتدخل عندما لا يجب متابعة مهمة.
راقب القنوات والوكلاء في الوقت الحقيقي، وافحص الأخطاء، وابحث في الذاكرة، وتابع صحة البوابة العاملة.
فتح حدود البروتوكول
القنوات تربط البوابة بالأشخاص. البروتوكولات تربطها بالقدرات وبرمجيات أخرى. لكل حد وظيفة مميزة، لذا يمكن للمطورين إضافة واحدة دون إعادة تصميم وقت التشغيل بالكامل.
MCP
الاتصال بخوادم القدرات للمتصفحات، الحواسيب، الوسائط، البيانات، وأنظمة الأعمال. يمكن للبوابة إضافة، سرد، وإزالة خوادم MCP المكونة دون دمج كل تكامل في ملفها التنفيذي.
ACP
تشغيل عمليات وكيل الترميز المدعومة خلف حدود مراقبة. تبقى سياسة مساحة العمل، وطلبات الأذونات، والتقدم، والتكلفة، وحالة الطابور، وتاريخ المهام مرئية للبوابة.
AWP
نشر الاكتشاف، القدرات، الصحة، الموافقة، الاشتراكات، ونقطة نهاية رسالة الوكيل حتى تتمكن البرامج الأخرى من فهم كيفية العمل مع البوابة.
HTTP + WebSocket
تجلب الويب هوكس الواردة العمل من تطبيقات أخرى. APIs HTTP وأحداث WebSocket الحية تشغل لوحة التحكم المدمجة وأدوات العمليات الخارجية.
الحدود الحالية: المصدر يكشف عن مسار agent-message الخاص به تحت واجهة AWP. الصفحة لا تدعي وجود واجهة خادم A2A مكتملة ومحققة بشكل منفصل أو تنفيذ إنتاجي لتجارة AWP.
الحوكمة
يجب أن تكون استقلالية الوكيل قرار تشغيل مهيأ. تضع بوابة ADK الهوية، السلطة، الحدود، والأدلة حول نفس مسار التنفيذ الذي يحمل الطلب.
الإقران، قوائم السماح، جلسات متعددة المستخدمين، JWT/JWKS، وتعيين الأدوار تحدد من يقوم بالطلب.
قواعد السماح والرفض لكل وكيل بالإضافة إلى الموافقة على الأدوات تحدد القدرات التي يمكن للشخص أو الوكيل استخدامها.
تحديد معدلات الطلب، مهلات الطلب، الإلغاء، حلقات الأدوات المحدودة، وسياسة الصحة تحد من مدة استمرار العمل.
توفر أحداث التدقيق، السجلات، المقاييس، تاريخ المهام، نتائج الأدوات، وتاريخ الصحة سجلًا تشغيليًا.
النشر
يمكن لمحطة عمل المطور، خادم داخلي، أو حاوية تشغيل نفس شكل البوابة. يمكن تخزين الجلسة في الذاكرة لتجربة محلية أو الانتقال إلى SQLite، PostgreSQL، Redis، أو Firestore لنظام منشور.
خدمة Rust تضم لوحة تحكم React المجمعة. قم بتثبيت أو نسخ ملف تنفيذي واحد واحتفظ بالتكوين بجانبه.
يتضمن المستودع ملف Dockerfile وعقود حجم ومنفذ موثقة لنشر الحاويات.
وحدة systemd تدعم بدء التشغيل عند الإقلاع، سياسة إعادة التشغيل، الجاهزية، السجلات، وملفات البيئة التي يملكها المشغل.
تعريف launchd يشغل بوابة محلية دائمة لوكلاء المطور ومحطة العمل.
الترحيل والتحقق
قدرات المنتج في هذه الصفحة تأتي من مصدر البوابة المحلية، التكوين، الوثائق، ومجموعات الاختبار. تمر الآن ترحيل ADK-Rust v2 بالتحقق من المكتبة، الخاصية، التكامل، الوكيل المولد، ولوحة التحكم.
محولات القنوات، توجيه الرسائل، سجل الوكلاء، دورة حياة العمليات، الجلسات، الذاكرة، RAG، المهام المجدولة، الموافقة على الأدوات، التحكم في الوصول، مسارات لوحة التحكم، AWP، تكامل MCP وACP، أصول النشر، والاختبارات موجودة في المستودع المراجع.
كل تبعية في ADK تحل إلى مساحة العمل المحلية 2.0. Rust 2024 وRust 1.95 تُجمّع عبر جميع الأهداف والميزات. جميع اختبارات المكتبة البالغ عددها 845، و276 اختبار خاص بالخصائص والتكامل المستقل، و81 اختبار لوحة تحكم تمر بنجاح.
الحالة 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 الموثق. يحتوي المستودع على البوابة، ولوحة التحكم المدمجة، ومرجع التكوين، وأدلة القنوات، وأصول النشر، ومجموعات الاختبار اللازمة لفهم وتشغيل النظام الكامل.