SSE ile Akışlanan Yanıtlar

Bazı araçların çalışması zaman alır: uzun bir arama veya yavaş bir API çağrısı gibi. İstemciyi sessizlik içinde bekletmek yerine sunucu, güncellemeleri gerçekleştikçe akış olarak gönderebilir. ⏳

Streamable HTTP, Server-Sent Events veya SSE kullanarak akış sağlar. Bu, bir sunucunun açık tek bir bağlantı üzerinden bir dizi iletiyi göndermesi için web'e özgü, basit bir yöntemdir.

SSE tek yönde akar: sunucudan istemciye. Sunucu bağlantıyı açık tutar ve söyleyecek yeni bir şeyi olduğunda olayları bu bağlantı üzerinden gönderir.

Bir yanıtın akış olduğunu Content-Type değerinden anlarsınız. Sunucu bu değeri text/event-stream olarak ayarladığında istemci, tek bir son gövde yerine olayları okur.

Her SSE olayı yalnızca metindir. data: ile başlayan satırlar yükü taşır; boş bir satır ise sonraki olay başlamadan önce bir olayın sonunu belirtir.

Her olayın içinde tanıdık bir JSON-RPC iletisi bulunur. Akış yeni bir biçim icat etmez; aynı iletileri zaman içinde iletir.

Akış hâlindeki bir yanıt önce ilerleme bildirimleri, en son da nihai sonucu gönderebilir. Kullanıcı, dönen bir yükleyiciye bakmak yerine aracın çalıştığını görür.

Akış kullanmak isteğe bağlıdır. Hızlı çalışan bir araç için sunucu, olay akışına hiç ihtiyaç duymadan tek bir JSON yanıtı döndürüp bağlantıyı kapatabilir.

SSE, sunucunun olayları bir id ile etiketlemesine olanak tanır. Bu küçük ayrıntı ileride önem kazanır: istemcinin kopan bir bağlantıdan sonra akışı sürdürmesini sağlar.

Ham SSE'yi nadiren elle yazarsınız. MCP SDK'si olayları sizin için biçimlendirir; siz yalnızca ilerleme bildirimlerini ve sonuçları gönderirsiniz, o da bunları doğru şekilde akışa aktarır.

Akış, bir aracın döndürdüğü şeyi değil, yalnızca nasıl hissettirdiğini değiştirir. Nihai yanıt aynıdır; kullanıcı yalnızca daha akıcı ve daha hızlı tepki veren bir deneyim yaşar. ✨

Bir sunucu, yanıtın canlı bir akış olduğunu nasıl belirtir?

SSE, sunucunun JSON-RPC olaylarını açık tek bir bağlantı üzerinden göndermesini sağlar: önce ilerleme, en son sonuç. İsteğe bağlıdır, web'e özgüdür ve yavaş araçları hızlı hissettirir. 🎉