<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[BeyondGuard Field Notes - Medium]]></title>
        <description><![CDATA[Research reports, threat intelligence, deployment playbooks, and the occasional blunt opinion on where the AI security category is going from the team behind BeyondGuard. - Medium]]></description>
        <link>https://medium.com/beyondguard-field-notes?source=rss----91207a0d761c---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>BeyondGuard Field Notes - Medium</title>
            <link>https://medium.com/beyondguard-field-notes?source=rss----91207a0d761c---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 02:17:47 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/beyondguard-field-notes" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Vercel AI SDK — AI Streaming’de Manuel SSE Yönetiminden Vercel AI SDK’e Geçiş]]></title>
            <link>https://medium.com/beyondguard-field-notes/vercel-ai-sdk-ai-streamingde-manuel-sse-y%C3%B6netiminden-vercel-ai-sdk-e-ge%C3%A7i%C5%9F-927de5b230e1?source=rss----91207a0d761c---4</link>
            <guid isPermaLink="false">https://medium.com/p/927de5b230e1</guid>
            <category><![CDATA[vercel-ai-sdk]]></category>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[sse]]></category>
            <category><![CDATA[ai-streaming]]></category>
            <category><![CDATA[agentic-ai]]></category>
            <dc:creator><![CDATA[Cemre Acar]]></dc:creator>
            <pubDate>Mon, 29 Jun 2026 13:45:33 GMT</pubDate>
            <atom:updated>2026-06-29T13:45:32.522Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*piVbU5WG1r94hFps.png" /></figure><p>Eğer son bir yıldır projelerinize yapay zeka modellerini entegre etmeye çalıştıysanız, muhtemelen Server-Sent Events (SSE) dünyasının engebeli yollarından geçmişsinizdir.</p><p>Yapay zekanın o akıcı, kelime kelime yazma (streaming) efektini kullanıcıya sunabilmek için backend tarafında custom event stream’ler ayarlamak, front-end’de EventSource mimarisi kurmak, bağlantı koptuğunda state’i korumak veya gelen metni parse etmek için saatler harcamış olabilirsiniz. (Ben harcadım en azından 😂)</p><p>Ben de projelerimde SSE tabanlı çözümlerle boğuşan bir front-end developer olarak, Vercel AI SDK ile tanıştığımda bir oh çektim. Bu yazıda, salt SSE yaklaşımının neden artık geride kaldığını, Vercel AI SDK’in bize neler sunduğunu inceleyecek ve uçtan uca çalışan örnek bir chatbot uygulamasını birlikte ayağa kaldıracağız.</p><h3>Geleneksel Yöntem: SSE Neden Yoruyor?</h3><p>Server-Sent Events (SSE), sunucudan istemciye tek yönlü veri akışı sağlamak için harika bir web standardıdır. Ancak doğrudan ham yapay zeka entegrasyonlarında kullanıldığında karşımıza şu zorluklar çıkar:</p><ol><li><strong>Manuel State Yönetimi:</strong> Kullanıcının mesaj geçmişini (array formatında), yüklenme durumunu ve input alanındaki metni yönetmek için bir sürü useState ve useReducer yazmanız gerekir.</li><li><strong>Bağlantı Kopmaları ve Hata Yönetimi:</strong> İnternet dalgalandığında stream’in nerede kaldığını anlamak ve client tarafında bunu yakalamak tam bir baş ağrısıdır.</li><li><strong>Model Değiştirme Zorluğu:</strong> Bugün OpenAI kullanırken yarın Anthropic (Claude) veya yerel bir LLM’e geçmek istediğinizde, backend’deki akış yapısını ve payload formatını tamamen baştan yazmanız gerekir. (Bu duruma göre değişebilir tabii ki.)</li><li><strong>Structured Data (JSON) Sıkıntısı:</strong> Yapay zekadan sadece düz metin değil de bir grafik çizdirmek için JSON objesi akışı (stream) istediğinizde, yarım kalmış JSON string’lerini front-end’de parse etmeye çalışırken uygulamanız patlayabilir.</li></ol><h3>Vercel AI SDK Nedir ve Neler Sunar?</h3><p>Vercel AI SDK; OpenAI, Anthropic, Google Gemini veya Supabase gibi servislerle çalışırken akış (streaming) yönetimini, UI state güncellemelerini ve chat geçmişini yönetmeyi inanılmaz derecede kolaylaştıran bir kütüphanedir.</p><p>Arka planda veri akışını sağlamak için yine SSE veya benzeri stream protokollerini kullanır. Model bağımsız ve açık kaynak bir kütüphanedir. Temelde iş akışınızı ikiye ayırır: <strong>Core (Server)</strong> ve <strong>UI (Client)</strong>.</p><h3>SSE’ye Göre En Büyük Avantajları:</h3><ul><li><strong>Saniyeler İçinde Streaming:</strong> Sunucu tarafında streamText fonksiyonunu çağırıp, front-end&#39;de tek bir useChat hook&#39;u kullanarak tüm kelime akışını otomatik yönetirsiniz.</li><li><strong>Provider Esnekliği (Model Agnostic):</strong> Tek bir satır kodu değiştirerek GPT-4o’dan Claude 3.5 Sonnet’e veya Gemini 1.5 Pro’ya geçiş yapabilirsiniz. API payload’ları ile SDK sizin yerinize ilgilenir.<br>Buradaki model bağımsızlığı (model agnostic) vizyonu sadece OpenAI veya Anthropic gibi devlerin tekelinde değil. Örneğin, son dönemin en gözde açık kaynaklı modellerinden biri olan Alibaba’nın <strong>Qwen 3.5 27b</strong> modelini projenizde kullanmak istiyorsunuz diyelim. Süreç sizin için yine milimetrik olarak aynı kalıyor. İster yerelde Ollama ile ister bulutta Together AI veya Groq gibi bir sağlayıcı üzerinden Qwen çalıştırın; Vercel AI SDK’in OpenAI uyumlu (createOpenAI) yapısı sayesinde tek yapmanız gereken backend&#39;deki endpoint ve model adını değiştirmektir. Front-end tarafındaki useChat hook&#39;unuz arkada GPT-4o mu yoksa Qwen mi çalıştığını ruhu bile duymadan kelime akışını (streaming) ve state yönetimini aynı kusursuzlukla yönetmeye devam eder. Bu da size kapalı kaynak kodlu ticari modellere bağımlı kalmadan, açık kaynak dünyasının özgürlüğünü projenize yansıtma şansı tanır.</li><li><strong>Hazır State Yönetimi:</strong> useChat hook&#39;u size messages (tüm sohbet geçmişi), gönderim için append veya handleSubmit ve akışın durumunu bildiren status gibi araçları paket halinde sunar. Sıfır state boilerplate kodu!</li><li><strong>Gelişmiş Özellikler (Tool Calling &amp; Generative UI):</strong> Yapay zekaya front-end fonksiyonlarınızı tetikletebilir (Tool Calling) veya yapay zekanın çıktısına göre ekranda dinamik React bileşenleri render edebilirsiniz.</li></ul><h3>Vercel AI SDK ile Neler Yapılabilir?</h3><p>Vercel AI SDK, yapay zekayı bir chatbot kutusuna hapsetmenin çok ötesine geçmenizi sağlar. Bir front-end developer olarak bu SDK ile şunları inşa edebilirsiniz:</p><ul><li><strong>Gelişmiş Chatbotlar ve Asistanlar:</strong> Dosya/resim yüklenebilen (multimodal), konuşma geçmişini hafızada tutan ve kelime kelime akan (streaming) akıllı asistanlar.</li><li><strong>Structured Data (Yapılandırılmış Veri) Akışı:</strong> Yapay zekadan düz metin yerine anlık olarak parse edilen JSON çıktısı alabilirsiniz. Örneğin; yapay zeka bir analiz yaparken ön yüzde eş zamanlı olarak dolan grafikler, tablolar veya formlar üretebilirsiniz.</li><li><strong>Tool Calling (Ajan Yapıları):</strong> Yapay zekaya front-end fonksiyonlarını tetikletebilirsiniz. Kullanıcı “Bana İzmir’deki hava durumunu göster” dediğinde, LLM sizin yazdığınız getWeather() fonksiyonunu parametreleriyle birlikte tetikler ve gelen veriyi arayüzde şık bir kart olarak render edebilirsiniz.</li><li><strong>Generative UI (Üretken Arayüz):</strong> Yapay zekanın çıktısına göre ön yüzde dinamik React bileşenleri render edebilirsiniz. AI sadece metin yazmaz; komponentin kendisini üretip ekrana basar.</li><li><strong>AI Tabanlı Metin Editörleri (Notion AI benzeri):</strong> Seçilen metni genişleten, tonunu değiştiren veya otomatik tamamlayan (autocomplete) zengin içerik editörleri.</li></ul><h3>Uygulama Zamanı: Next.js &amp; Vercel AI SDK ile Akıllı Chatbot</h3><p>Şimdi lafı uzatmayalım ve birlikte temiz bir Next.js App Router projesinde Vercel AI SDK ve Gemini provider’ını kullanarak uçtan uca çalışan bir chatbot yapalım.</p><h3>1. Kurulum</h3><p>Öncelikle projemize gerekli paketleri dahil ediyoruz:</p><pre>npm install ai @ai-sdk/google @ai-sdk/react zod</pre><blockquote><strong><em>Not:</em></strong><em> AI SDK v5/v6 ile React hook’ları (</em><em>useChat) ayrı bir pakete taşındı: </em><em>@ai-sdk/react. Ayrıca proje köküne </em><em>.env.local ekleyip </em><em>GOOGLE_GENERATIVE_AI_API_KEY=... anahtarınızı tanımlamayı unutmayın; SDK bu değişkeni otomatik okur.</em></blockquote><h3>2. Backend / Server Kısmı (API Route)</h3><p>Next.js projemizde app/api/chat/route.ts dosyasını oluşturuyoruz. Burası yapay zeka modeliyle güvenli köprümüz olacak:</p><pre>import { google } from &#39;@ai-sdk/google&#39;;<br>import { streamText, convertToModelMessages, type UIMessage } from &#39;ai&#39;;<br><br>// İsteklerin hızlı şekilde stream edilmesi için Edge Runtime kullanıyoruz<br>export const runtime = &#39;edge&#39;;<br>export async function POST(req: Request) {<br>  // Front-end&#39;den gelen UIMessage geçmişini alıyoruz<br>  const { messages }: { messages: UIMessage[] } = await req.json();<br>  // Modelimizi ve mesaj geçmişimizi SDK&#39;e veriyoruz.<br>  // Dikkat: streamText &quot;await&quot; edilmez; ama UI mesajlarını modelin<br>  // beklediği formata çeviren convertToModelMessages artık &quot;await&quot; ister.<br>  const result = streamText({<br>    model: google(&#39;gemini-2.5-flash&#39;), // İstediğiniz modeli seçebilirsiniz<br>    messages: await convertToModelMessages(messages),<br>  });<br>  // Sonucu front-end&#39;in doğrudan tüketeceği UI mesaj akışına dönüştürüyoruz<br>  return result.toUIMessageStreamResponse();<br>}</pre><h3>3. Frontend / Client Kısmı (UI Bileşeni)</h3><p>Şimdi app/page.tsx dosyamıza geliyoruz ve arayüzümüzü inşa ediyoruz. SSE ile sayfalarca sürecek mantıksal yapıyı useChat ile nasıl sadeleştirdiğimize dikkat edin. (v5/v6 ile girdi alanını istersek useChat&#39;in kendi input state&#39;i ile yönetebilir, istersek de aşağıdaki gibi esnek bir şekilde append fonksiyonundan yararlanabiliriz.)</p><pre>&#39;use client&#39;;<br>import { useChat } from &#39;@ai-sdk/react&#39;;<br>import { useState } from &#39;react&#39;;<br><br>export default function ChatComponent() {<br>  // useChat otomatik olarak /api/chat endpoint&#39;ine POST isteği atar<br>  const { messages, append, status } = useChat();<br>  const [input, setInput] = useState(&#39;&#39;);<br>  // &#39;submitted&#39; = istek gitti, &#39;streaming&#39; = cevap akıyor<br>  const isLoading = status === &#39;submitted&#39; || status === &#39;streaming&#39;;<br>  const handleSubmit = (e: React.FormEvent) =&gt; {<br>    e.preventDefault();<br>    if (!input.trim()) return;<br>    <br>    // Yeni mesajı akışa ekliyoruz<br>    append({ role: &#39;user&#39;, content: input });<br>    setInput(&#39;&#39;);<br>  };<br>  return (<br>    &lt;div className=&quot;flex flex-col w-full max-w-2xl mx-auto h-screen p-6 justify-between bg-slate-50&quot;&gt;<br>      {/* Mesaj Akış Alanı */}<br>      &lt;div className=&quot;flex-1 overflow-y-auto space-y-4 mb-4 p-4 bg-white rounded-xl shadow-sm border border-slate-100&quot;&gt;<br>        {messages.length === 0 &amp;&amp; (<br>          &lt;p className=&quot;text-center text-slate-400 mt-10&quot;&gt;Vercel AI SDK dünyasına hoş geldin! Sohbet etmeye başla.&lt;/p&gt;<br>        )}<br>        {messages.map(m =&gt; (<br>          &lt;div<br>            key={m.id}<br>            className={`flex flex-col p-3 rounded-lg max-w-[80%] ${<br>              m.role === &#39;user&#39;<br>                ? &#39;bg-blue-600 text-white ml-auto&#39;<br>                : &#39;bg-slate-100 text-slate-800 mr-auto&#39;<br>            }`}<br>          &gt;<br>            &lt;span className=&quot;text-xs font-semibold mb-1 opacity-75&quot;&gt;<br>              {m.role === &#39;user&#39; ? &#39;Sen&#39; : &#39;Asistan&#39;}<br>            &lt;/span&gt;<br>            {/* v5/v6&#39;da içerik m.content yerine m.parts dizisinden okunur */}<br>            {m.parts.map((part, i) =&gt;<br>              part.type === &#39;text&#39; ? (<br>                &lt;p key={i} className=&quot;whitespace-pre-wrap text-sm&quot;&gt;{part.text}&lt;/p&gt;<br>              ) : null,<br>            )}<br>          &lt;/div&gt;<br>        ))}<br>        {isLoading &amp;&amp; (<br>          &lt;div className=&quot;text-left text-xs text-slate-400 animate-pulse&quot;&gt;<br>            Asistan yazıyor…<br>          &lt;/div&gt;<br>        )}<br>      &lt;/div&gt;<br>      {/* Giriş Formu */}<br>      &lt;form onSubmit={handleSubmit} className=&quot;flex gap-2&quot;&gt;<br>        &lt;input<br>          className=&quot;flex-1 p-3 border border-slate-300 rounded-xl text-sm focus:outline-none focus:ring-2 focus:ring-blue-500 bg-white text-slate-900&quot;<br>          value={input}<br>          placeholder=&quot;Yapay zekaya bir şeyler sor…&quot;<br>          onChange={(e) =&gt; setInput(e.target.value)}<br>          disabled={isLoading}<br>        /&gt;<br>        &lt;button<br>          type=&quot;submit&quot;<br>          className=&quot;bg-blue-600 text-white px-6 py-3 rounded-xl text-sm font-medium hover:bg-blue-700 disabled:opacity-50 transition-all&quot;<br>          disabled={isLoading || !input.trim()}<br>        &gt;<br>          Gönder<br>        &lt;/button&gt;<br>      &lt;/form&gt;<br>    &lt;/div&gt;<br>  );<br>}</pre><p>Uygulamanın çalışan tüm kodlarına, üzerine eklediğim yeni denemelere ve projenin reposuna <a href="https://github.com/cmracar/vercel-ai-sdk-example"><strong>GitHub</strong></a> üzerinden erişebilirsiniz.</p><h3>Özet Karşılaştırma: Hangisi, Ne Zaman Mantıklı?</h3><p>Kısa ve öz olması açısından şu hızlı eşleştirmeyi de cebimize koyalım:</p><h3>Şu Durumlarda Vercel AI SDK Kullanmak Daha Mantıklı:</h3><ul><li><strong>Bir AI Chatbot veya Metin Üretim Aracı Yapıyorsanız:</strong> Eğer projeniz OpenAI, Gemini gibi bir modelden yanıtı kelime kelime ekrana yazdırmaksa kesinlikle Vercel AI SDK kullanmalısınız.</li><li><strong>React, Next.js, Vue veya Svelte Kullanıyorsanız:</strong> UI component’leri ile tam entegre çalışır. Yükleme durumları (isLoading), durdurma butonu (stop), yeniden deneme (reload) gibi özellikleri tek satırda sunar.</li><li><strong>Tool Calling İhtiyacınız Varsa:</strong> AI modelinin bir fonksiyon çalıştırıp sonucunu tekrar stream’e dahil etmesi gerekiyorsa, bunu saf SSE ile yönetmek tam bir baş ağrısıdır. AI SDK bunu çocuk oyuncağına indirger.</li></ul><h3>Şu Durumlarda Saf/Geleneksel SSE Kullanmak Daha Mantıklı:</h3><ul><li><strong>AI Dışı Canlı Veri Akışları:</strong> Canlı borsa grafiği, maç skoru, sunucu logları veya push bildirimler gibi yapay zeka ile ilgisi olmayan bir sistem kuruyorsanız AI SDK’ya ihtiyacınız yoktur.</li><li><strong>Frontend Framework Kullanmıyorsanız:</strong> Tamamen vanilla JavaScript veya çok hafif bir yapı kullanıyorsanız ekstradan kütüphane yüklemek istemeyebilirsiniz.</li><li><strong>Tam Kontrol ve Sıfır Bağımlılık:</strong> Arka planda dönen protokol detaylarına, veri formatına (örneğin binary stream) tamamen hakim olmak ve projenin dış bir kütüphaneye bağımlı olmamasını istiyorsanız tercih edebilirsiniz.</li></ul><h3>AG-UI ve Vercel AI SDK Farkı Nedir?</h3><p>Bir önceki yazımda <strong>AG-UI</strong> protokolünden bahsetmiş ve SSE ile akış yapısını anlatmıştım. Konu yapay zeka ve front-end mimarisi olunca bu ikisinin farkına da değinmek gerekiyor.</p><p>AG-UI, adından da anlaşılacağı üzere işin tamamen UI katmanına odaklanan ve hazır bileşenler sunan bir protokoldür. SSE tabanlı akışları kendi içinde soyutlayarak, geliştiriciye saniyeler içinde çalışan bir chat kutusu sunmayı amaçlar. Yani odağı, ekranda hızlıca görsel bir sonuç üretmektir.</p><p>Ancak projeniz büyüdüğünde, şirkete özel esnek bir tasarım uygulamak istediğinizde ya da işin içine gelişmiş yapay zeka mantıkları girdiğinde AG-UI’ın çizdiği sınırların dışına çıkamazsınız.</p><p>İşte Vercel AI SDK tam bu tıkanma noktasında devreye giriyor. Vercel AI SDK hazır bir buton veya chat arayüzü sunmaz, <strong>Headless </strong>bir mimariyle çalışır. Yani arayüzün, CSS’in ve tasarımın iplerini %100 front-end geliştiriciye bırakırken; arka plandaki model yönetimini, state senkronizasyonunu ve veri akışını üstlenir.</p><p>Özetle; AG-UI hızlı bir prototip için harika bir görsellik sunarken, Vercel AI SDK yapay zeka uygulamaları oluşturmanızı sağlayan uçtan uca bir altyapı sağlayıcısıdır.</p><h3>Bitirirken..</h3><p>Yapay zeka çağında bir front-end geliştirici olarak vizyonumuzu sadece kod yazmaktan, <strong>”akıllı ürün mimarları”</strong> olmaya taşımamız gerekiyor. Vercel AI SDK bize tam olarak bu gücü veriyor; altyapı dertlerini soyutlayarak tamamen kullanıcı deneyimine odaklanmamızı sağlıyor.</p><p>Eğer hala projelerinizde eski usul veri akışlarıyla boğuşuyorsanız, bu hafta sonu kendinize bir iyilik yapın ve Vercel AI SDK’e şans verin.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*TT-wUkZMNIqypf46" /><figcaption>Photo by <a href="https://unsplash.com/@bearsnap?utm_source=medium&amp;utm_medium=referral">Junseong Lee</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=927de5b230e1" width="1" height="1" alt=""><hr><p><a href="https://medium.com/beyondguard-field-notes/vercel-ai-sdk-ai-streamingde-manuel-sse-y%C3%B6netiminden-vercel-ai-sdk-e-ge%C3%A7i%C5%9F-927de5b230e1">Vercel AI SDK — AI Streaming’de Manuel SSE Yönetiminden Vercel AI SDK’e Geçiş</a> was originally published in <a href="https://medium.com/beyondguard-field-notes">BeyondGuard Field Notes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>