DeepSeek Harness Nedir? Her Şeyin Bir Eklenti Olduğu Ajan Çalışma Zamanı

DeepSeek Harness Nedir?

Kısaca dsh olarak anılan DeepSeek Harness, MIT lisansı altında DeepSeek AI tarafından sunulan açık kaynaklı bir ajan harness'tır. Bir dil modeli ile dış dünya arasında konumlanır; araçlar, oturumlar, kum havuzu ve görevi sürdüren döngüyü sağlar.

DeepSeek'in kendi çerçevesi şu şekilde: "Ajan = Model + Harness." Model akıl yürütme ve üretimden sorumludur. Harness ise bu akıl yürütmenin gerçek bir dosya sistemi üzerinde eyleme dökülmesini ve her adımda görevi yeniden anlatmanıza gerek kalmadan sürmesini sağlar.

Cordis üzerinde çalışır; bu, DeepSeek Harness'ten önce gelen bir eklenti çerçevesidir. Cordis, ayarların bu parçaları birbirinden bağımsız olarak değiştirmesine imkân tanır. Bu tercihin maliyetine daha sonra döneceğim.

Bu çerçeveyi belirledikten sonra, iki yaygın yanılgıdan bahsedelim.

DeepSeek Harness bir yapay zeka modeli değildir

Önceden belirtildiği gibi, model ve çalışma zamanı ayrı katmanlardır. Bu ayrım, araçları veya oturum kurulumunu değiştirmeden sağlayıcıyı değiştirmenize olanak tanır. Aynı çalışma zamanı DeepSeek, Anthropic, OpenAI veya OpenAI uyumlu bir uç noktayı kullanabilir.

DeepSeek Harness bir kodlama asistanından fazlasıdır

Standard kipi kodlama asistanı izlenimi verir, ancak bu yalnızca bir kurulumdur. Daha sonra ele alacağım üzere, Minimal ve Creator kipleri ajanın kullanabileceklerini değiştirir. Yeni bir kurulum inşa etmek yine mühendislik çalışması gerektirir; geliştiriciler parçalara erişim sahibidir.

Cordis, DeepSeek Harness Eklentilerini Nasıl Düzenler

Önceden belirtildiği gibi Cordis, DeepSeek Harness'in altındaki eklenti çerçevesidir. Her bir parçanın tek bir sağlayıcının koduna bağlanmadan bir hizmet talep etmesine izin verir.

Cordis, Koishi sohbet botu ekosisteminden türemiştir ve Shigma olarak bilinen bir geliştirici tarafından oluşturulmuştur; DeepSeek bunu tedarik eder ve genişletir. Yazarları tasarımı Spatio-temporal Birleşebilirlik için Bir Programlama Paradigması adlı makalelerinde açıklar.

Bu temeller, projenin ana sloganına ve iki Cordis terimine götürür. İsimler akademik gelse de davranış oldukça basittir.

"Her şey bir eklentidir"

DeepSeek'in mimari dokümantasyonu, dsh'i diğerlerinin yanına bir eklenti bağlayarak genişlettiğinizi söyler. Model bağdaştırıcıları, araçlar, oturumlar, kum havuzları, depolama, zamanlama, ajan döngüsü ve arayüzün tümü eklentilerdir.

Kelimesi kelimesine alındığında slogan aşırıya kaçar. Cordis yine de eklentilerin altında yer alır. Onları yükler ve kaldırır, ihtiyaçlarını kontrol eder ve birbirleriyle konuşmak için kullandıkları olayları çalıştırır. Cordis gereklidir; isteğe bağlı bir parça daha değildir.

Uzamsal birleşebilirlik, eklenti bağımlılıklarını yönetir

Bir eklenti, el yazımı bir önyükleme sırası gerekmeden ihtiyaç duyduğu hizmetleri bildirir. Bu hizmetler mevcut olduğunda etkinleşir ve gerekli bir hizmet kaybolursa devre dışı kalır. Çalışıp çalışamayacağına bağımlılıkları karar verir.

DeepSeek buna uzamsal birleşebilirlik der. Bağımlılıklar, Cordis'e bir bileşenin nereye oturduğunu söyler; böylece geliştiricilerin başlangıç sırasını elle düzenlemesi gerekmez.

Zamansal birleşebilirlik, eklenti etkilerini geri sarar

Cordis ayrıca olay dinleyicileri, istem bölümleri ve araç şemaları gibi kayıtları izler. Bir eklentiyi kaldırmak, sahipsiz dinleyiciler bırakmak yerine bu etkileri de kaldırır. Bu, bir kabuk komutu gibi harici bir eylemi geri almaz; tersine çevrilebilirlik yalnızca Cordis'in izlediği etkilere uygulanır.

DeepSeek Harness Mimarisi: Çalışma Zamanı Nasıl Bir Araya Geliyor

Çalışan bir örnek, belirli bir sırayla yüklenen ayarlardan inşa edilen bir eklenti ağacıdır. Bu ayarlar hangi parçaların etkin olduğunu belirler.

Cordis, değiştirilebilir tüm çalışma zamanı eklentilerini birbirine bağlar. Görsel: Yazar.

Cordis hizmetleri, eklentilerin birbirini bulmasını sağlar

Cordis ortak bir hizmet dizini sağlar. Eklentiler, bir sağlayıcının kodunu içe aktarmak yerine ctx.tools, ctx.llm ve ctx.sessions gibi kararlı anahtarlar kullanır. ctx.llm çağıran bir araç, arkasında hangi model bağdaştırıcısının bulunduğunu bilmek zorunda değildir.

Ajan hazır ayarları ve çalışma zamanı profilleri farklı katmanları kontrol eder

Her şey değiştirilebilir ise, belirli bir çalıştırmada nelerin bağlanacağına yine bir şeyin karar vermesi gerekir ve DeepSeek Harness bu yanıtı kolayca karıştırılabilecek iki katmanda verir.

Kısa versiyon: bir profil programın nasıl başladığını, bir hazır ayar ise ajanın neler yapabileceğini kontrol eder. Yalnızca web uygulamasını kullanıyorsanız, sonraki iki alt bölümü atlayabilirsiniz.

Çalışma zamanı profilleri

web, headless, sdk, sdk-minimal ve acp şablon olarak sunulan bir çalışma zamanı profili, uygulamanın nasıl başlatılacağını ve önyüklemede hangi Cordis eklenti paketlerinin yığılacağını belirler. Çoğu okuyucu bu katmana yalnızca dsh web veya benzeri bir komutu çalıştırarak dokunacaktır.

Ajan hazır ayarları

Bir ajan hazır ayarı (Standard, PTC, Minimal veya Creator), etkin bir oturumun neleri kullanabileceğine karar verir. Bir yama dosyası, Harness kaynağına dokunmadan hazır ayarı değiştirebilir.

Ajan döngüsü, turları, adımları ve araç çağrılarını koordine eder

DeepSeek, bir adımı bir turdan ayırır. Bir adım, bir model isteği artı onun araç çağrılarıdır. Bir tur ise sıfır veya daha fazla adımdır: ilk girdi sahiplenilmeden önce açılır ve hiçbir borç kalmadığında kapanır. Çoğu tur, ajanın yanıt vermesinden önce birkaç adım çalıştırır; ancak reddedilen bir girdi, hiç adım harcamayan bir turu kapatır.

Bir tur birkaç adım içerebilir. Görsel: Yazar.

Oturumlar yalnızca eklemeli bir olay günlüğü kullanır

Bence en önemli kısım bu. Bir oturum, bir sohbet mesajları dizisi değil, türlendirilmiş olaylardan oluşan yalnızca eklemeli bir gündür. Harness, modelin geçmişini bu kayıttan oluşturur ve oturum dokümantasyonu, modele gönderilen her şeyin buradan yeniden elde edilebilir olmasını şart koşar.

Devam etme, çatallama, arama, yeniden oynatma ve Trajectory görünümü bu olay akışı üzerine inşa edilir.

Geçmişi yeniden türetmek, belirlenimci bir yeniden çalıştırma değildir. Model çıktısı ve harici durum farklı olabilir; yine de günlük, ne olduğuna dair incelenebilir bir kayıt sağlar.

Oturum geçmişi yalnızca eklemeli bir gündür. Görsel: Yazar.

DeepSeek Harness araçları ve kum havuzlarını nasıl kontrol eder

Bir model bir aracı adıyla isteyebilir, ancak onu doğrudan çalıştırma yetkisine sahip değildir. İstek ile dosya sistemi değişikliği arasında iki ayrı kontrol bulunur.

Araç yürütme hattı

Çağrı bir ilke denetimi, yürütme ve sonuç işlemeden geçer. Aracı model seçer; nasıl ve çalışıp çalışmayacağına çalışma zamanı karar verir.

Araçların nasıl çalışacağına çalışma zamanı karar verir. Görsel: Yazar.

Kum havuzu ile onaylar arasındaki fark

• Onay, bir eylemin kullanıcı tarafından doğrulanması gerekip gerekmediğini sorar. 
• Kum havuzu, nerede ve nasıl yürütüleceğini sınırlar. 

DeepSeek bunları ayrı tutar; ancak izin hazır ayarları, tıpkı bir konteyner çalışma zamanının süreç izinlerini yürütme sınırlarından ayırması gibi, her iki kontrolü de paketler.

Şimdiden belirtmeye değer, çünkü sınırlamalar bölümünde geri döneceğim: bir modeli sistem isteminde "yalnızca dosyaları oku" diye uyarmak, modelin uyabileceği bir öneridir; bir işletim sistemi düzeyi kum havuzu kısıtlaması gibi zorlayıcı bir sınır değildir.

DeepSeek Harness Kipleri: Standard, PTC, Minimal ve Creator

DeepSeek Harness dört farklı kip sunar. Bu dördünden hiçbiri diğerlerinin üzerinde değildir. Hepsi "bu oturuma çalışma zamanının ne kadarı açığa çıkarılmalı" sorusuna verilen yanıtlardır ve doğru seçenek eldeki göreve bağlıdır. Mimari bölümün gösterdiği gibi, her kip ajana sunulan araç kümesini değiştirir.

Dört kip tek bir çalışma zamanı temelini paylaşır. Görsel: Yazar.

Standard kipi

Genel amaçlı temel: 

• Dosya düzenleme
• Kabuk erişimi
• Dosya ve web araması
• Yetenekler
• Planlama
• Amaçlar
• Alt ajanlar
• İş akışları

Sıradan depo işleri için başlayacağım yer burası olurdu.

PTC kipi

PTC kipi, Standard'ın araç setinin neredeyse tamamını korur ancak modele erişim şeklini değiştirir. (Sürüm 0.1.2'den beri, Web PTC kipi artık varsayılan olarak genel amaçlı workflow aracını sunmaz.) 

Model, birkaç model adımı boyunca tek tek araçları istemek yerine, üretilen bir SDK'ya karşı bir program yazar. Bu program, run_code aracılığıyla birden çok aracı çağırabilir. Her çağrı yine aynı ilke denetimlerinden geçer; dolayısıyla PTC, modelin planı nasıl ifade ettiğini değiştirir, yapabileceklerini değil.

Ürün sayfası hâlâ "Code mode" etiketini kullanıyor; ancak daha yeni resmi bir sürüm, eski konuşma kayıtlarını okunabilir tutarken bunu PTC kipine yeniden adlandırdı. Metin boyunca PTC kipini kullanacağım; SSS, bu kısaltmanın ne anlama gelebileceğine geri döner.

Minimal kipi

Minimal kipi ortamı iki araca indirger: kalıcı bir kabuk ve dize-değiştirme tabanlı bir dosya düzenleyici. DeepSeek, model kıyaslamaları için bunu kullanır; çünkü test sonuçları yalnızca modelin ağırlıklarına değil, kısmen modelin harness'ına da bağlıdır.

Creator kipi

Creator kipi geliştiricilerin çalışma zamanını incelemesine ve Cordis eklentilerini bellekte test etmesine olanak tanır. Hazır ayarları inşa etmek içindir ve bunu daha derin bir anlamda kendini geliştiren olarak adlandırmazdım.

DeepSeek Harness'i Diğer Ajan Çerçevelerinden Farklı Kılan Nedir?

DeepSeek Harness, çalışma zamanının alt bölümlerini değiştirilebilir kılarak birçok ajan çerçevesinden ayrılır. Bunu mimari bölümüne katmayı düşündüm; ancak ayrım gözden kaçması kolaydır. Cordis bu değişiklikleri tek bir eklenti sistemi üzerinden yönetir.

Yalnızca çağrılabilecek araçları değil, ajanın nasıl çalıştığını da değiştirebilirsiniz. Olay günlüğü ayrıca geliştiricilerin inceleyebileceği bir çalışma sağlar; yalnızca sohbet dökümü okumakla kalmazlar. Minimal ve Creator kipleri de çalışma zamanını zıt yönlerden test etmelerine imkân verir.

DeepSeek Harness vs. Claude Code, Codex ve OpenCode

Bir özellik kontrol listesi meseleyi ıskalar. Her rakip uzantıları destekler; asıl faydalı soru, geliştiricilerin hangi parçaları değiştirebileceğidir. Ayrım küçük gibi duyulsa da öyle değildir. Harness ve Claude Code'un karşılaştırıldığı rehberimiz, her ikisinde de aynı modeli kullanır ve kurulum, günlükler ile maliyeti ele alır.

DeepSeek Harness vs. Claude Code

Claude Code, proje talimatları, yetenekler, kancalar, MCP, alt ajanlar ve bir Ajan SDK'sını destekler ve yerleşik döngüsünü sabit tutar. DeepSeek Harness ise geliştiricilerin ayarlar aracılığıyla döngüyü, model bağdaştırıcısını ve depolama katmanını değiştirmesine izin verir.

DeepSeek Harness vs. Codex

Codex, CLI ve Uygulama Sunucusu da açık kaynak olduğundan daha dikkatli bir karşılaştırma gerektirir. Geliştiricilerin belgelenmiş giriş noktaları üzerinden genişlettiği bir ajan harness'ı sunar. DeepSeek Harness, bizzat çalışma zamanını değiştirme etrafında inşa edilmiştir. Farklı düzeylerde kontrol sunarlar.

DeepSeek Harness vs. OpenCode

OpenCode zaten açık kaynaklıdır, birkaç model sağlayıcıyla çalışır ve istemci-sunucu mimarisi kullanır. Araçlarını, izinlerini, oturumlarını ve sağlayıcılarını yapılandırabilirsiniz. Eklentileri sabit bir sunucu çekirdeğini genişletirken, DeepSeek ayrıca döngüyü ve oturum deposunu da değiştirilebilir kılar.

DeepSeek Harness Ne Zaman Kullanılmalı

Çalışma zamanı parçalarını değiştirmek, tek başına faydalı değildir. Ek kontrol, ancak zaten sahip olduğunuz bir sorunu çözdüğünde önem kazanır.

• Çalışma zamanının kendisi projenin parçası olduğunda. Yalnızca bir ajanın üzerine inşa etmekten ziyade model bağdaştırıcılarını, ajan döngüsünü, depolamayı veya oturum davranışını değiştiriyorsanız, bu daha doğrudan bir uyumdur.
• Modelleri kontrollü bir ortamda karşılaştırırken. Aynı çalışma zamanını kullanmak, modeli değiştirirken testin daha fazlasını sabit tutar; yine de modeller araç kullanımı ve akıl yürütme tarzında farklılaşabilir.
• Karmaşık bir çalışmayı hata ayıklamak önemli olduğunda. Oturum olay günlüğü ve Trajectory görünümü, bir modelin ne gördüğünü ve hangi araçların çalıştığını yeniden kurmayı kolaylaştırır.
• Ajan iç yapılarını test ederken. Creator kipi ve Cordis, uygulama koduna ihtiyacı olanlardan ziyade ajanların nasıl bir araya getirildiğini inceleyen geliştiriciler içindir.

Basit model çağrıları veya iç yapısına dokunma ihtiyacı olmadan hazır bir kodlama ajanı isteyen ekipler için gereksiz olabilir. Daha fazla parçayı değiştirmek, ancak bu kontrol gerçek bir sorunu çözdüğünde ek işe değer.

DeepSeek Harness Sınırlamaları: Geliştirici Ön İzlemesi ve Güvenlik Riskleri

Yukarıdaki mimarinin hiçbiri, bunun bugün nerede yetersiz kaldığına dair net bir tablo olmadan çok şey ifade etmez.

Hâlâ geliştirici ön izlemesinde

DeepSeek deposu, kırıcı değişiklikler olacağını açıkça belirtir. Bu zaten yaşandı: Code'dan PTC'ye yeniden adlandırma, oturum API'lerinde değişiklikler ve isteğe bağlı bir SQLite depolama seçeneğinin kaldırılmasıyla geldi. Sürümlerinizi sabitleyin. Bu adımı atlamak ve kurulumun kararlı kalmasını ummak bir plan değildir.

Daha fazla kontrol, daha fazla karmaşıklık demektir

Çalışma zamanının daha fazlasını değiştirilebilir kılmak, geliştiricilere öğrenmesi gereken daha çok şey de verir: eklenti bağımlılıkları, ayarlar, sağlayıcı farkları ve sürüm uyumluluğu. Bu, kolaylık ve kontrol arasındaki alışıldık dengedir.

DeepSeek Harness yerel mi?

DeepSeek Harness, varsayılan olarak oturum içeriğini, araç kayıtlarını ve ayarları yerel olarak saklar; bu, veri işleme bildirimine göredir. Ayarlar ve proje listeleri hakkında isimsiz raporlarını kapatabilirsiniz. 

Ancak harici bir model sağlayıcısı, web aracı, MCP sunucusu veya eklenti; kendi politikası uyarınca yine de verileri makinenizin dışına gönderebilir. "Önce-yerel" bağlandığınız her hizmeti kapsamaz.

Ajan çalıştırmak güvenlik riskleri getirir

Dosyaları düzenleyebilen, komut çalıştırabilen ve üçüncü taraf eklentileri yükleyebilen bir çalışma zamanı gerçek hasara yol açabilir. DeepSeek'in güvenlik bildirimi, projenin güvenlik denetiminden geçmediğini söyler. Kum havuzları, onaylar ve izin kontrolleri riski azaltır; ancak yalıtımı garanti etmez.

Yazılımı kendi makinenizde çalıştırmak bu riski ortadan kaldırmaz. Güvenilmeyen işler için sınırlı izinler ve atılabilir bir ortam kullanın ve gizli talimatlar içerebilecek içerik konusunda dikkatli olun.

Neden Ajan Davranışı Yalnızca Modele Bağlı Değildir

Ajan davranışı, modele olduğu kadar çalışma zamanına da bağlıdır. Bu, "Ajan = Model + Harness" önermesine döner ve aynı ayrım DeepSeek ötesindeki LLM ajanları için de geçerlidir.

Bir modelin üretebilecekleri ağırlıklarına bağlıdır. Bir ajanın yaptıkları ise, modele hangi bağlamın ulaştığına, hangi eylemlere izin verildiğine ve yürütmenin ne kadar sıkı sınırlandığına da bağlıdır. Bunların hiçbiri ağırlıkların içinde değildir.

DeepSeek Harness, çevre katmanı; geliştiricilerin değiştirebileceği adlandırılmış parçalara ayırarak görünür kılar. Minimal kipi ise bunun DeepSeek ötesinde neden önemli olduğunu gösterir: bir kıyaslama puanı, yalnızca modeli değil, kısmen testte kullanılan harness'ı da yansıtır. Harness, bir modeli daha akıllı yapmaz. Modelin çalıştığı ortamı değiştirir.

Sonuç

Başlangıçtaki cümle korunması gereken cümledir: akıl yürüten modeldir, ancak çalışma zamanı bu akıl yürütmenin nelere ulaşabileceğine ve neler yapabileceğine karar verir. DeepSeek Harness, model bağdaştırıcısından ve araçlardan oturum deposuna ve ajan döngüsüne kadar bu çalışma zamanını düzenlenebilir kılar.

Bu kontrol, maliyeti de beraberinde getirir. Çalışma zamanının daha fazlasını değiştirmek, kurulumunun, sürüm değişikliklerinin ve güvenlik sınırlarının daha fazlasına sahiplenmek demektir. Kabuk erişimi olan bir geliştirici ön izlemesi, kurulup unutulacak bir şey değildir.

Görüşüm basit: çalışma zamanının kendisi işin parçası olduğunda DeepSeek Harness kullanın. Yalnızca depo düzenlemelerine ihtiyaç duyuyorsanız, hazır bir kodlama ajanı sizden daha az şey ister.

Şu DeepSeek Harness eğitimimiz kurulumu kapsar. Claude Code alternatifleri rehberi daha fazla kodlama ajanını karşılaştırırken, Yapay Zeka Ajanlarına Giriş bu makalenin varsaydığı temelleri ele alır.