Vercel Academy, “Build Your Own AI Coding Agent Harness” dersini ücretsiz yayınladı. Üç API çağırıp demo yapan sulardan değil; araç döngüsü, bağlam budama, alt-agent delegasyonu, yaşam döngüsü yönetimi gibi sert konuları gerçek mühendislik gözüyle anlatıyor.

Cursor ile kod yazan her yerde var. Ama “özel Agent framework’ü teslim edebilen” mühendis için piyasa farklı konuşuyor. Bu ders, o farkı yaratacak kişiler için bir dönüm noktası.

Önce Kafayı Netleştirelim: Agent Harness Ne Demek

Agent Harness, AI’ın kendi başına iş yapmasını, bağlamı yönetmesini, güvenli çalışmasını sağlayan iskelet. Yani AI’a bir proje yöneticisi + güvenlik görevlisi + not defteri vermek gibi. Harness olmadan AI sadece sohbet eden bir model; Harness ile AI, görev alıp iş bitiren stajyer gibi çalışır.

Derste üç parça net bir şekilde ayrılmış:

• AI SDK: AI’ın konuşmasını sağlar (model çağrısı, metin üretimi)
• Vercel Sandbox: AI’ın iş yapmasını sağlar (izole ortamda güvenli komut çalıştırma)
• just-bash: AI’ın söz dinlemesini sağlar (standartlaştırılmış araç arayüzü, shell davranışı kontrollü)

Üçü birleşince tam bir Agent fabrikası ortaya çıkıyor.

Acı Gerçek: Yazdığın Agent Neden Hep Demo Seviyesinde Kalıyor

Joel Hooks dersin açılışında sektörün ayıbını açıkça söylüyor: “Üç araçlı bir tool loop sadece bir demo. Asıl sorun, onu gerçek işe koşmaya çalıştığında patlar.” Agent’a 5000 satırlık dosya okutuyorsun, tüm içeriği bağlama tıkıyor, bir türlü geri tüküremiyor. Bash yetkisi veriyorsun, bir rm -rf ile prod ortamını siliyor. Yirmi adımlık görev veriyorsun, onuncu adımda ne yaptığını unutuyor.

Müşteri kabuğa değil, iş bitirene para veriyor. Piyasadaki “AI kodlama asistanı eğitimi” derslerinin yüzde 90’ı prompt paketlemeyi, GPT API bağlamayı, gösterişli ön yüz yapmayı öğretiyor. Oysa kurumların gerçekten para ödediği şey, Agent’ın tüm görev zincirini güvenle tamamlaması. Bu mimari seviyesinde bir sorun, parametre ayarıyla çözülmez.

Vercel’ın bu dersteki niyeti net: Agent Harness’ı ciddi bir mühendislik ürünü olarak görmek, oyuncak script olarak değil.

Fırsat: Agent Mühendisi Piyasada En Kıt Kaynak Haline Geliyor

Freelance piyasası artık ikiye bölünmüş durumda. Bir ucunda Cursor ile kod tamamlayan “AI kullanıcısı” var, düşük fiyattan iş kapıyor. Diğer ucunda “AI Agent özel çözümü” teslim edebilen mühendis var; proje başına fiyat belirgin şekilde yüksek, müşteri kuyrukta bekliyor.

Sebebi basit: Şirketler “kod tamamlama” değil, “otomasyon iş akışı” istiyor. Bir e-ticaret patronu Python scripti yazmanı değil; rakip fiyatlarını otomatik çeken, ürün açıklaması üreten, A/B testi koşan, rapor çıkaran bir Agent kurmanı istiyor. Bu işi sadece Agent Harness mimarisini bilen kişi yapabilir.

⚠️ Kaynak gönderiye göre Upwork’ta “AI agent customization” kategorisinde proje ortalamaları binlerce dolar seviyesinde; bağımsız doğrulama yapılmadı.

Yol 1: Dersin Çekirdek Modüllerini Sindir, Teknik Setini Kur

Ders müfredatındaki en değerli modüller, tek tek sindirilmeli. Her modülü “sorun → çözüm → benzetme” üçlüsüyle özetliyorum:

Araç Döngüsü (Tool Loop): Agent’ın kalbi.

• Sorun: Araç çağrısı başarısız olunca, zaman aşımına uğrayınca, çakışma çıkınca Agent çöküyor.
• Çözüm: AI SDK’da stopWhen koşuluyla döngü sonlandırma, maxSteps ile adım sınırı, otomatik yeniden deneme.
• Benzetme: Fabrika bandındaki ritim kontrolörü gibi; her hata oluşunda durur, hatalı ürün bir sonraki istasyona geçmez.

Araç Tasarımı (Tool Design): Aracın tanecikliği, Agent’ın tavanını belirler.

• Sorun: Çok kaba olursa ince iş yapamaz, çok ince olursa araç çağrılarında kaybolur.
• Çözüm: “Dosya sistemi”ni tek万能 bash yerine read, write, edit, glob, grep olarak beş atomik araca böl.
• Benzetme: Çalışana anahtar, tornavida, matkap ver; tüm garajı teslim etme.

Sandbox Soyutlama (Sandbox Abstraction): Güvenliğin anahtarı.

• Sorun: Agent bash yetkisi alınca rm -rf ile prod veritabanını silebilir.
• Çözüm: Vercel Sandbox izole çalışma ortamı sunar; Agent orada ne yaparsa yapsın ana makineye dokunamaz.
• Benzetme: Kimya laboratuvarındaki çeker ocak — patlayan ocak, bina değil.

Bağlam Budama (Context Pruning): 5000 satırlık dosyayı olduğu gibi prompt’a tıkamazsın.

• Sorun: AI 5000 satırı belleğine doldurur, eski konuşma yeni kararı kirletir.
• Çözüm: prepareStep kancasıyla her adımdan önce bağlamı budar; son N adımı tutar, eski içeriği özetler.
• Benzetme: Odayı toplamak gibi; kullanmadıklarını depoya kaldırır, masada sadece bugün lazım olanı bırakırsın.

Alt-Agent Delegasyonu (Subagent Delegation): Karmaşık görev parçalanmalı.

• Sorun: Tek Agent çok modüllü iş aldığında bağlam şişer, sorumluluklar birbirine girer.
• Çözüm: Ana agent planlar, alt-agent’lar modülleri yürütür, sonuçlar ana agent’a döner.
• Benzetme: Proje yöneticisi işi frontend, backend, test’e böler; kendisi sadece ilerleme ve risk takip eder.

Yaşam Döngüsü Yönetimi (Lifecycle Management): Agent başlatma, çalışma, duraklatma, kurtarma, sonlandırma — her durum ayrı yönetilmeli.

• Sorun: Uzun görev yarıda kesilince, kullanıcı iptal edince, model zaman aşımına uğrayınca Agent durumu tamamen kayboluyor.
• Çözüm: Her durumu serileştirip sakla; kaldığı yerden devam etme ve insan müdahalesi desteği.
• Benzetme: Oyun kayıt dosyası — ölünce son kayıttan okursun, baştan oynamazsın.

Yol 2: Dersin Teknik Setiyle Müşteri Kap, Örnek Vaka Üret

Dersi bitirmek bitiş değil, başlangıç. Vercel AI SDK + Vercel Sandbox + just-bash üçlüsüyle hemen ilk gerçek projeye atıl.

En hızlı para yolu: Fiverr, Upwork veya Türkiye’deki freelance platformlarında “Vercel yığınıyla özel AI Agent kuruyorum” hizmeti aç. İlk üç müşteriyi yarı fiyata veya ücretsiz yap; karşılığında referans yorumu ve vaka hakkı al.

⚠️ Kaynak gönderiye göre ilk üç müşteriyi ücretsiz yapmanın süresi Agent karmaşıklığına bağlı olarak birkaç günden birkaç haftaya değişebilir; bağımsız doğrulama yapılmadı. Değip değmeyeceği, vakaları sonraki ücretli müşterilere dönüştürebilmenle ölçülür.

Örnek vaka seçimi kritik. “Bana sohbet botu yap” gibi ezberlenmiş taleplerden kaçın; “operasyonel iş akışımı otomatikleştir” gibi yüksek değerli işlere yönel. Örneğin:

• Pazaryeri satıcısı için Agent: yorumları izler, olumsuz anahtar kelimeleri çıkarır, iyileştirme önerisi üretir, Slack’e iter.
• İçerik üreticisi için Agent: rakip hesapları tarar, viral içerik paternlerini analiz eder, konu listesi çıkarır.
• Bağımsız geliştirici için Agent: GitHub Issues’ları izler, önceliklendirir, PR taslağı oluşturur.

⚠️ Kaynak gönderiye göre bu tür projelerin fiyat aralığı on binlerce lira seviyesinde; bağımsız doğrulama yapılmadı.

Soğuk Başlangıç: Müşteri Ağın Yoksa Ne Yaparsın

Kurumsal müşteri ağı olmamak çoğu kişinin gerçek başlangıç noktası. Üç somut kanal:

1. Topluluklarda vaka paylaşımı: Vibe Coding topluluklarında, LinkedIn’de, X’te vaka paylaş. Başlık şablonu: “Vercel AI SDK ile XX sektörü için Agent kurdum, ayda XX saat iş tasarrufu sağladı”. 30 saniyelik demo videosu ekle. Trafik gelince müşteri kendisi yazar.
2. Ücretsiz deneme karşılığı referans: Tanıdığın küçük müşteriye ilk projeyi 5.000 TL’ye yap, karşılığında yazılı referans + vakayı yayınlama izni iste.
3. Kademeli fiyat stratejisi: 5.000 TL küçük iş (tek modül Agent) → 30.000 TL orta iş (çok modüllü iş akışı) → 300.000 TL büyük iş (tam özel çözüm + 6 ay bakım). Her kademe, bir önceki kademenin vakasıyla desteklenir.

Yol 3: Ders İçeriğini Yeniden Paketle, İçerik Üreticisi Ol

Vercel dersi İngilizce ve eşik yüksek. Bu tam senin bilgi asimetrisi avantajın.

Dersi 10-15 bölümlük seriye böl; YouTube, Instagram, TikTok veya blogunda yayınla. Başlık örnekleri: “Vercel’ın iç eğitimi sızdı: AI Agent framework nasıl yazılır”, “Üç araçlı döngü sadece oyuncak, gerçek Agent için bu beş modül şart”, “Bağlam budama: Agent’ın unutmaması için çekirdek teknik”.

Her bölüm 5-8 dakika, tek bir teknik noktayı kod demosuyla anlat. Somut öneriler:

• İlk bölüm araç döngüsü: AI SDK’nın generateText + tools yapılandırması, stopWhen kullanımı, prepareStep ile bağlam budama — 3 kod demosu, 7 dakika.
• Başlık A/B testi: “Vercel iç eğitimi sızdı” ile “AI Agent framework el kitabı” başlıklarını küçük bütçeyle dene, yüksek CTR çıkan şablonu seri boyunca uygula.

Gelir üç katmanlı: birinci katman yazılım eğitimi reklamları; ikinci katman kendi kursunu sat (“AI Agent Mühendisi Uygulamalı Kurs”); üçüncü katman kurumsal danışmanlık. ⚠️ Kaynak gönderiye göre on bin takipçili hesaplarda tek yazılım reklamı binlerce lira seviyesinde; bağımsız doğrulama yapılmadı.

Yol Haritası: Hangi Yol Sana Uyuyor

• Tam zamanlı yazılımcı, yan gelir istiyor: Yol 2 + Yol 3’ün hafif versiyonu. Hafta sonu 1-2 küçük iş al, süreci kısa video olarak paylaş. Hedef ayda 50.000-100.000 TL ek gelir.
• Freelance, ayda 500.000 TL hedefi: Yol 2’ye tam odaklan. İlk 3 ay müşteri seçme, sadece vaka biriktir. Dördüncü ay yüksek değerli müşteriye geç, proje başına 300.000 TL üstü hedefle.
• Öğrenci / kariyer değiştiren: Önce Yol 1 ile dersi sindir, 5 demo projesini GitHub’a koy, portföy oluştur. 6 ay sonra müşteri almaya başla.

Vaka: Joel Hooks’un Kendisi Zaten Yaşayan Bir Örnek

Joel Hooks, Vercel Academy’nin bu dersinin yazarı ve anlatıcısı. Aynı zamanda “Agent mühendisi olarak para kazanma”nın canlı örneği: yüksek kaliteli teknik içerik üretip geliştirici topluluğunda güçlü kişisel marka kurdu, ders içerikleri defalarca yeniden paylaşıldı.

Onun taktiği birebir uygulanabilir: Teknik set olarak Vercel AI SDK’yı merkeze al, teslimat olarak “kod parçası” değil “çalışan Agent sistemi” sun. Bu, Agent freelance piyasasında en kıt arz.

⚠️ Diğer bağımsız geliştiricilere ait spesifik gelir verileri (aylık 50.000 dolar, altı ayda 120.000 takipçi vb.) kaynak paketinde doğrulanabilir referansla yer almıyor; bu yazıda rakam kullanılmadı.

Sıfırdan Başlayanlar İçin Yol Haritası

Node.js / TypeScript hiç görmediysen şu sırayla ilerle:

1. Birinci ay: Node.js temelleri + TypeScript sözdizimi + LLM temelleri (token, prompt, function calling). Türkçe kaynak olarak TypeScript resmi belgeleri, “AI Engineer Handbook” önerilir.
2. İkinci ay: Dersten sadece “araç döngüsü” modülünü sindir, AI SDK resmi quickstart’ı ile demo kur.
3. Üçüncü ay: “Sandbox soyutlama” modülünü ekle; dosyaları otomatik düzenleyen bir Agent yap.
4. Dördüncü aydan itibaren: Yol 2 veya Yol 3 ile para kazanma denemelerine başla.

Gerçekçi beklenti: İlk ay sadece araç döngüsü modülünü sindir, hepsini birden bitirmeye çalışma. Günde 2 saat ayırırsan 30 günde çalışan minimal Agent zincirini kurarsın.

Harekete Geç: Bu Akşam Vercel Academy’yi Aç

Vercel Academy dersi ücretsiz, kayıt veya ödeme gerekmiyor. vercel.com/academy adresine git, “Build Your Own AI Coding Agent Harness” dersini bul, ilk modülden başla.

Hepsini birden bitirmeye çalışma. Günde 2 saat ayır; önce araç döngüsü ve sandbox soyutlama modüllerini sindir, sonra hemen en küçük çalışan ürünü yap — dosyaları otomatik düzenleyen bir Agent bile yeterli.

30 dakika içinde “dosya oku → içeriği analiz et → rapor üret → yeni dosyaya yaz” zincirini kurabildiğinde, “AI kodlama eğitimi öğrencileri”nin yüzde 90’ını geçmiş olursun. O noktadan sonra müşteri almak, video çekmek, blog yazmak için gerçek içeriğin olur.

Bu akşam Vercel Academy’yi aç, araç döngüsü modülünden başla — 30 gün sonra şimdiki haline teşekkür edersin.