بث الاستجابات باستخدام SSE

تستغرق بعض الأدوات وقتًا، مثل البحث الطويل أو استدعاء واجهة API البطيء. وبدلًا من جعل العميل ينتظر في صمت، يمكن للخادم بثّ التحديثات فور حدوثها. ⏳

يستخدم Streamable HTTP تقنية Server-Sent Events، أو SSE، لبث البيانات. وهي طريقة بسيطة وأصلية للويب تتيح للخادم دفع سلسلة من الرسائل عبر اتصال مفتوح واحد.

يتدفق SSE في اتجاه واحد: من الخادم إلى العميل. ويُبقي الخادم الاتصال مفتوحًا ويدفع الأحداث عبره كلما توفرت لديه معلومات جديدة.

يمكنكم معرفة أن الرد عبارة عن تدفق من خلال Content-Type. فعندما يعيّنه الخادم إلى text/event-stream، يقرأ العميل الأحداث بدلًا من قراءة جسم نهائي واحد.

كل حدث SSE ليس سوى نص. تحمل الأسطر التي تبدأ بـ data: الحمولة، بينما يشير السطر الفارغ إلى نهاية حدث، قبل بدء الحدث التالي.

تحتوي كل فعالية على رسالة JSON-RPC مألوفة. لا يبتكر التدفق تنسيقًا جديدًا، بل يسلّم الرسائل نفسها بمرور الوقت.

يمكن للرد المتدفق إرسال إشعارات التقدم أولًا، ثم إرسال النتيجة النهائية أخيرًا. وهكذا يرى المستخدم أن الأداة تعمل بدلًا من التحديق في مؤشر تحميل.

التدفق اختياري. فبالنسبة إلى أداة سريعة، يمكن للخادم ببساطة إرجاع استجابة JSON واحدة ثم الإغلاق، من دون الحاجة إلى تدفق أحداث على الإطلاق.

يتيح SSE للخادم وسم الأحداث باستخدام id. وتصبح هذه التفاصيل الصغيرة مهمة لاحقًا، إذ تتيح للعميل استئناف التدفق بعد انقطاع الاتصال.

نادرًا ما تكتبون SSE الخام يدويًا. إذ يتولى SDK الخاص بـ MCP تنسيق الأحداث نيابةً عنكم؛ وما عليكم سوى إرسال التقدم والنتائج، وسيبثها بالطريقة الصحيحة.

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

يتيح SSE للخادم دفع أحداث JSON-RPC عبر اتصال مفتوح واحد: التقدم أولًا، والنتيجة أخيرًا. وهو اختياري وأصلي للويب، ويجعل الأدوات البطيئة تبدو سريعة. 🎉