Mengalirkan Balasan dengan SSE

Beberapa peralatan memerlukan waktu, seperti pencarian panjang atau panggilan API yang lambat. Daripada membuat klien menunggu dalam diam, server dapat mengalirkan pembaruan saat pembaruan itu terjadi. ⏳

HTTP yang dapat dialirkan menggunakan Server-Sent Events, atau SSE. Ini adalah cara sederhana dan alami bagi web agar server dapat mendorong rangkaian pesan melalui satu koneksi yang tetap terbuka.

SSE mengalir dalam satu arah: dari server ke klien. Server mempertahankan koneksi tetap terbuka dan mendorong peristiwa melalui koneksi tersebut setiap kali ada hal baru yang perlu disampaikan.

Anda dapat mengetahui bahwa suatu tanggapan merupakan aliran dari Content-Type-nya. Saat server mengaturnya ke text/event-stream, klien membaca peristiwa, bukan satu isi akhir.

Setiap peristiwa SSE hanyalah teks. Baris yang diawali data: membawa muatan, sedangkan baris kosong menandai akhir satu peristiwa sebelum peristiwa berikutnya dimulai.

Di dalam setiap peristiwa terdapat pesan JSON-RPC yang sudah dikenal. Pengaliran tidak menciptakan format baru; pengaliran hanya mengirimkan pesan yang sama dari waktu ke waktu.

Tanggapan yang dialirkan dapat terlebih dahulu mengirim notifikasi kemajuan, lalu hasil akhir pada bagian terakhir. Pengguna dapat melihat bahwa peralatan sedang bekerja, bukan hanya menatap pemutar tunggu.

Pengaliran bersifat opsional. Untuk peralatan yang cepat, server cukup mengembalikan satu tanggapan JSON lalu menutup koneksi, tanpa memerlukan aliran peristiwa sama sekali.

SSE memungkinkan server memberi peristiwa sebuah id. Detail kecil ini menjadi penting nanti: inilah cara klien melanjutkan aliran setelah koneksi terputus.

Anda hampir tidak pernah perlu menulis SSE mentah secara manual. SDK MCP memformat peristiwa untuk Anda; Anda cukup mengirim kemajuan dan hasil, lalu SDK mengalirkannya dengan benar.

Pengaliran tidak mengubah hasil yang dikembalikan peralatan, hanya mengubah pengalamannya. Jawaban akhirnya identik; pengguna hanya mendapatkan pengalaman yang lebih lancar dan lebih responsif. ✨

SSE memungkinkan server mendorong peristiwa JSON-RPC melalui satu koneksi yang tetap terbuka: kemajuan terlebih dahulu, hasil terakhir. Fitur ini opsional, alami bagi web, dan membuat peralatan yang lambat terasa cepat. 🎉