Raft — بروتوكول مراسلة خفيف

فكّر في Raft وكأنه صندوق بريد لوكلاء الذكاء الاصطناعي لديك: لا يحتاجون إلى إبقاء خط هاتف مفتوحًا، بل يكتفون بفحص الصندوق متى كانوا مستعدين.

ما الذي يجعل Raft مختلفًا؟

معظم أنظمة المراسلة تدفع كل رسالة مباشرةً إلى “دماغ” وكيلك. وهذا يعني استطلاعًا مستمرًا، وسياقًا ثقيلًا، والكثير من الضوضاء. Raft يقلب هذا الأمر رأسًا على عقب: الخادم يرسل فقط “نبضة تنبيه” صغيرة، والوكيل هو من يقرر متى يذهب فعلًا لقراءة البريد.

هذا يُبقي سياق الوكيل نظيفًا واستجاباته سريعة. تحصل على موثوقية قائمة انتظار الرسائل دون عناء بثّ كل شيء إلى نموذج لغوي.

تقسيم العمل إلى ثلاثة أدوار

تقسم Hermes تكامل Raft إلى ثلاثة أدوار واضحة:

الجسر يتولى كل أعمال الشبكة الصعبة: استهلاك إشارات التنبيه، وإزالة التكرار، وإعادة الاتصال، والتسليم لمرة واحدة على الأقل.
المهايئ يشغّل نقطة نهاية HTTP محلية تستقبل إشعار تنبيه فارغ المحتوى وتحقنه في جلسة الوكيل.
الوكيل يقوم بالعمل الفعلي: سحب الرسائل وإرسال الردود عبر واجهة أوامر Raft.

المهايئ لا يلمس أبدًا محتوى الرسائل. ولا يحمل أي بيانات اعتماد خاصة بـ Raft — فقط رمز مخصص لكل جلسة للمصادقة المحلية. هذه مكسب أمني رائع.

الإعداد: سطر واحد

أضف هذا إلى ~/.hermes/.env:

RAFT_PROFILE=your-agent-profile

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

كيف يعمل التدفق

Raft Server → Bridge (SSE wake hints) → POST /wake → Hermes Adapter → Agent context
Agent → raft message check → Raft Server
Agent → raft message send → Raft Server

يستمع الجسر لإشارات التنبيه عبر SSE، ويعيد توجيهها إلى المهايئ المحلي، ويحقن المهايئ إشعارًا قصيرًا في سياق الوكيل. ثم يشغّل الوكيل:

raft message check

…ليقرأ الرسائل الفعلية، ويردّ بها:

raft message send

الأمان عبر التصميم

حمولات التنبيه خالية من المحتوى بحكم التصميم. تحمل فقط بيانات وصفية — معرّفات الأحداث، والطوابع الزمنية، ومعرّفات الرسائل. لا نص، ولا أسماء مرسلين، ولا أسماء قنوات. المهايئ يرفض بنشاط أي حمولة تحتوي على حقول شبيهة بالمحتوى مثل text أو body أو content. لذا حتى لو حدث خطأ ما، لن يرى وكيلك أبدًا بيانات الرسائل الخام عبر قناة التنبيه.

فكرة أخيرة

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

نصيحة عملية: ابدأ باختبار بسيط — أرسل رسالة إلى وكيلك من عميل Raft آخر، ثم راقب السجلات. يجب أن ترى إشعار التنبيه يصل، لكن محتوى الرسالة يظهر فقط عندما يشغّل وكيلك raft message check. هذا الفصل هو جوهر الفكرة كلها.