💡 3 Maddede Bu Yazının Özeti
Bir yapay zekâ ajanının gücünü yalnız kullandığı model belirlemez. Modelin dosyalara, araçlara, oturum geçmişine, çalışma alanına ve güvenlik sınırlarına nasıl bağlandığı da sonucu doğrudan etkiler. DeepSeek’in geliştirici ön izlemesi olarak sunduğu DeepSeek Harness, bu katmanı başlı başına bir ürün ve…
Bir yapay zekâ ajanının gücünü yalnız kullandığı model belirlemez. Modelin dosyalara, araçlara, oturum geçmişine, çalışma alanına ve güvenlik sınırlarına nasıl bağlandığı da sonucu doğrudan etkiler. DeepSeek’in geliştirici ön izlemesi olarak sunduğu DeepSeek Harness, bu katmanı başlı başına bir ürün ve açık kaynak geliştirme yüzeyi olarak ele alıyor. Projenin ana tezi kısa: model ajanın “zekâsıysa”, harness onun gerçek ortamda iş yapmasını sağlayan çalışma düzenidir.
DeepSeek Harness nedir?
DeepSeek Harness, kodlama ve ajan geliştirme senaryoları için tasarlanmış açık kaynaklı bir ajan çalışma ortamıdır. Proje, model çağrısını tek başına yeterli görmez; araçlar, beceriler, oturumlar, kum havuzları, depolama, döngüler, zamanlama ve kullanıcı arayüzü gibi katmanları birlikte yönetir. DeepSeek, sistemi dünya genelindeki harness geliştiricileri için developer preview olarak açtı; bu nedenle API’lerin ve davranışların değişebileceği baştan kabul edilmelidir.
“Her şey eklenti” yaklaşımı ne getiriyor?
Harness’ın merkezinde Cordis eklenti sistemi bulunuyor. Model sağlayıcısı, terminal aracı, web aracı, oturum deposu veya arayüz gibi işlevler tek bir sabit uygulamaya gömülmek yerine eklenti olarak bağlanabiliyor. Bu, örneğin bir projede model adaptörünü değiştirirken dosya sistemi ve oturum politikasını korumayı; başka bir projede ise yalnız araç izinlerini veya planlama döngüsünü değiştirmeyi mümkün kılıyor. Ancak esneklik, uyumluluk testini de geliştiricinin sorumluluğu hâline getiriyor.
Cordis çekirdeği ve servis bileşimi
Cordis çekirdeği, eklentilerin yüklenmesi, kaldırılması ve bağımlılıklarının yönetilmesiyle ilgileniyor. Ajanın asıl yetenekleri eklentilerde yaşıyor ve servis/olay mekanizmasıyla birbirine bağlanıyor. Bu mimari, tek bir “ajan çerçevesi” yerine yeniden birleştirilebilir bileşenlerden oluşan bir sistem kurmak isteyen ekipler için önemli. Bir çalışma alanında araç kaydı, başka birinde oturum geçmişi veya zamanlama politikası farklılaşabiliyor; kaynak kodun tamamını çatallamak zorunlu olmuyor.
Oturum günlüğü ve izlenebilirlik
DeepSeek Harness’ın öne çıkan iddiası, bir çalıştırmada modelin gördüğü bağlamın ve gerçekleşen olayların eklenebilir bir oturum günlüğünde tutulması. Sistem istemleri, araç çağrıları ve sonuçları, alt ajan planlaması ile bağlam eklemeleri bu akışta yer alabiliyor. Bu sayede bir oturumu devam ettirme, çatallama, arama veya yeniden oynatma aynı olay dizisi üzerinden yürütülebiliyor. Pratikte bu yaklaşım, “ajan neden bu sonucu verdi?” sorusunu incelemeyi kolaylaştırır; buna karşılık günlüklerin gizli veri, dosya yolu veya araç çıktısı içerebilme ihtimali nedeniyle saklama politikasının tasarlanması gerekir.
Çalışma kipleri: standarttan minimal ajana
Proje, farklı iş akışları için birden çok çalışma kipi tanımlıyor. Standard mode; dosya düzenleme, kabuk, arama, beceriler, planlama, hedefler, alt ajanlar ve iş akışlarıyla tam kodlama ajanı deneyimini hedefliyor. Code mode, modelin birden çok işlemi tek bir TypeScript programında birleştirmesine odaklanıyor. Minimal mode ise kalıcı bash ile metin değiştirme aracına indirgenmiş daha dar bir yapı sunuyor. Creator mode’da buna ek olarak çalışma zamanı inceleme ve eklenti/preset oluşturma araçları bulunuyor. Bu ayrım, her görevde en geniş yetki setini açmak yerine iş için gerekli en küçük yüzeyi seçmeye yardım edebilir.
Kurulum başlangıcı ve Web UI
Resmî başlangıç yolu Node.js kurulu bir sistemde npx @deepseek-ai/dsh web komutunu çalıştırmak. Bu komut, varsayılan olarak yerel makinede bir Web UI başlatıyor. Kaynaktan çalışmak isteyenler depoyu klonlayıp bağımlılıkları kurarak derleme yapabiliyor. Arayüzün yerel çalışması veriyi otomatik olarak uzak sunucuya göndermediği anlamına gelmez: seçilen model sağlayıcısı, web araçları, MCP hizmetleri ve eklentilerin her biri kendi veri işleme sınırlarına sahiptir.
Model ve araç seçimi neden ayrı bir tasarım kararı?
Harness, DeepSeek’in resmî model sağlayıcısıyla kullanılabildiği gibi uyumlu uç noktalarla da yapılandırılabiliyor. Bu, model değişimini kolaylaştırır; fakat bir modelin araç çağrısı biçimi, bağlam sınırı, fiyatlandırması ve güvenlik davranışı aynı değildir. Sağlayıcı değiştirirken yalnız “yanıt veriyor mu?” testi yapmak yeterli olmaz. Dosya işlemleri, komut çalıştırma, uzun oturum devamlılığı, hata sonrası yeniden deneme ve günlük kaydı gibi temel akışlar da ayrı ayrı denenmelidir.
Güvenlik: ön izleme yazılımında varsayım yapmamak
DeepSeek’in kendi güvenlik notu, Harness’ın henüz güvenlik denetiminden geçmemiş deneysel bir geliştirici ön izlemesi olduğunu açıkça belirtiyor. Model tarafından üretilen komutları çalıştırabilmesi, üçüncü taraf eklenti yükleyebilmesi ve kendisine verilen ağ, süreç, dosya ya da kimlik bilgilerine erişebilmesi riski büyütür. Sandbox, onay istemleri ve izin kontrolleri riski azaltabilir; fakat bir araca zaten verilmiş kaynağı korumaz. Bu nedenle ilk denemeler için ayrılmış bir çalışma alanı, en az yetki, yedek ve eklenti incelemesi temel pratiklerdir.
Hangi ekipler için anlamlı?
DeepSeek Harness, hazır bir sohbet penceresinden çok kendi ajan altyapısını birleştirmek isteyen geliştiricilere hitap ediyor. Tekrarlanabilir araç akışları kuran ekipler; model, oturum, sandbox ve kullanıcı arayüzünü değiştirilebilir parçalara ayırmak isteyebilir. Buna karşılık yalnız tek seferlik kod yardımı arayan kullanıcılar için eklenti mimarisi, yapılandırma ve güvenlik değerlendirmesi gereksiz karmaşıklık getirebilir. Projeyi üretim altyapısı olarak seçmeden önce uyumluluk kırılmalarını, günlüklerin veri kapsamını ve sandbox sınırlarını gerçek iş yüküyle test etmek gerekir.
Sonuç
DeepSeek Harness, ajanları yalnız model seçimi olarak değil, çalışma ortamı ve bileşim problemi olarak ele alıyor. Eklenti tabanlı yapısı ile izlenebilir oturum akışı güçlü bir geliştirme yönü sunuyor. Yine de mevcut sürüm geliştirici ön izlemesi: açık kaynak olması üretime hazır veya güvenli olduğu anlamına gelmiyor. En sağlıklı başlangıç, dar yetkili ve yalıtılmış bir ortamda küçük bir araç setiyle kurulum yapmak; sonra günlük, eklenti ve izin politikasını kanıtlanmış ihtiyaçlara göre büyütmektir.
