İçeriğe geç
Pazar, 15 Kasım 2026Yapay zekâ · sade Türkçe · denenmiş@yapaytu
YAPAYTU

AI agent harness nedir, nasıl çalışır?

AI agent harness nedir, nasıl çalışır? Model ve MCP ile farkını öğren; hazır görev şablonuyla ajanın izinlerini, kaldığı yeri ve bitirme ölçütünü netleştir.

Yapay TU Editör · 6 dk okuma
AI agent harness nedir?
Kısa cevap

AI agent harness, yapay zekâ modelinin araç kullanarak görev yürütmesini sağlayan çevre yazılımıdır. Araç çağrılarını çalıştırır, sonuçları modele geri verir ve uygulamasına göre izinleri, çalışma sınırlarını ve oturumlar arasındaki ilerleme bilgisini yönetir. Bir ajan seçerken model adıyla birlikte bu özellikleri de kontrol etmelisin.

AI agent harness (ajan çalışma altyapısı), bir ajanın dosyalara erişmesini ve araçlarla iş yapmasını sağlayan yazılımdır. Ajana yarım kalan işini yeniden anlatmak zorunda kalıyorsan, kullandığın uygulamanın ilerleme bilgisini nasıl sakladığına bakmalısın. Bir kodlama aracı seçerken bu altyapıyı tanımak, dosya izinleriyle oturum yönetimini ayrı ayrı değerlendirmene yardım eder.

AI agent harness ne işe yarar?

AI agent harness, modelin araç kullanarak çalışmasını sağlayan ve görev boyunca yapılan işlemleri yöneten yazılım katmanıdır. Model bir dosyanın okunmasını isteyebilir; dosyayı açıp içeriğini geri döndüren kod, modelin çevresindeki bu yapıdadır. Kullanılan uygulamaya göre izin denetimi ve ilerleme kayıtları da burada yönetilir.

Örneğin ajana, bir web sitesindeki iletişim formunun hatasını düzeltmesini söylediğini düşün. Bunun için dosyaları okuması, değişiklik yapması ve formu denemesi gerekir. Harness, araç çağrılarının çalışmasını ve sonuçlarının modele ulaşmasını sağlar. Senin açısından bakılacak ayrıntılar, hangi dosyalara erişildiği ve değişikliğin nasıl doğrulandığıdır.

Anthropic'in uzun süren ajan görevleri üzerine açıklaması, oturumlar arasında ilerleme kaydının neden gerektiğini somutlaştırıyor: sonraki oturumun, yapılan işi ve kalan adımları yeniden bulması gerekebiliyor. Harness tasarımında bu bilgilerin saklanması ve geri yüklenmesi ele alınıyor. Genel kavramı ilk kez duyuyorsan yapay zekâ ajanı nedir rehberi başlangıç için yardımcı olur.

Model, harness ve MCP arasındaki fark nedir?

Model yanıt veya araç çağrısı üretir; harness çağrının işlenmesini ve çalışma akışını yönetir, MCP (model bağlam protokolü) ise dış araçlarla bağlantı kurmak için kullanılır. Bir uygulamada bu parçalar birlikte bulunabilir. Aynı model adını görmek, iki uygulamanın aynı dosyalara eriştiği veya aynı onay kurallarını kullandığı anlamına gelmez.

Parça İletişim formu örneğindeki görevi Sen neyi kontrol etmelisin?
Model Hata mesajını değerlendirip bir sonraki işlemi önerir Verdiğin görev tanımı yeterince açık mı?
Harness Dosya okuma ve düzenleme çağrılarını yürütür, sonuçları geri iletir Çalışma klasörü, izinler ve durma koşulları nasıl ayarlanıyor?
Araç Bir dosyayı okur veya tarayıcıda işlem yapar Görev için gereken işlemi destekliyor mu?
MCP bağlantısı Uygulamanın bir araç sunucusuyla iletişim kurmasını sağlar Hangi sunucuya, hangi yetkilerle bağlanılıyor?

Tarayıcı aracı eklemek, ajanın formu test edebilmesine imkân verir. Testin hangi aşamada yapılacağını ve başarısız olunca ne olacağını ayrıca tanımlamalısın. MCP bağlantı rehberinde bağlantının kurulmasıyla ilgili ayrıntıları bulabilirsin.

Agent harness nasıl çalışır?

Harness, modelin araç çağrısını alır, izin verilen işlemi çalıştırır ve sonucu modele geri göndererek döngüyü sürdürür. Model de dönen bilgiyle sonraki adımı seçer. Anthropic'in ajan tasarımı açıklaması, bu döngüde araç sonuçlarından gelen geri bildirimi ve durma koşullarını özellikle ele alıyor.

İletişim formunda akış şöyle tasarlanabilir: ajan önce ilgili dosyayı okur, hatayı araştırır ve bir değişiklik önerir. Düzenleme izni varsa dosyayı değiştirir. Ardından test aracı çalışır; sonuç hata gösteriyorsa ajan düzeltmeye devam edebilir. Onay gereken bir işlemde ise uygulama çalışmayı bekletir.

Başlamadan önce "bitti" koşulunu yaz. Örneğin boş e-posta alanında uyarı görünmesi ve geçerli örnek veriyle test gönderiminin çalışması ayrı kontroller olabilir. Ajanın son mesajına ek olarak bu kontrollerin sonuçlarını da iste. Denemeler uzarsa ne zaman durulacağını uygulamada belirle; örneğin aynı hatada belirlediğin sayıda denemeden sonra sana dönmesini sağla.

Kendi görevinde harness nasıl kullanılır?

Hazır bir ajan uygulamasında harness özelliklerini çalışma alanı, araç izinleri ve oturum yönetimi üzerinden kullanırsın; kendi uygulamanı geliştiriyorsan bunları kodla veya bir SDK (yazılım geliştirme kiti) ile kurarsın. Önce küçük bir görev seçip hangi yeteneklere ihtiyaç duyduğunu yazabilirsin.

İletişim formu örneği için aşağıdaki görev şablonunu kullan. Bunu, dosya ve test araçları olan bir ajana vereceğin prompt olarak düşün. Klasör adını kendi test kopyana göre değiştir.

text
Görev: Test kopyasındaki iletişim formunun boş e-posta
alanıyla gönderilmesi sorununu düzelt.

Çalışma alanı: [test projesinin klasörü]
Önce mevcut hata kaydını ve ilgili form dosyalarını oku.
Bu görevde yalnızca form doğrulamasını değiştir.
Yeni özellik ekleme.

Tamamlanma ölçütleri:
- Boş e-posta alanı için kullanıcıya uyarı gösteriliyor.
- Geçerli örnek veri test ortamında kabul ediliyor.
- Yapılan kontrollerin sonucu raporlanıyor.

Canlı siteye yayınlama ve gerçek kişilere mesaj gönderme.
Bu işlemler gerekiyorsa dur ve benden onay iste.

Oturum sonunda bir ilerleme notu bırak:
Değişen dosyalar, kontrol sonuçları, kalan sorun ve
bir sonraki oturumun başlaması gereken adım.

Bu metin uygulamanın izinlerini kendiliğinden değiştirmez. Klasör sınırını ve dışarıya işlem yapma yetkisini ayrıca uygulamanın ayarlarında uygula. İlerleme notunun kaydedildiğini de kontrol et; yeni oturum açtığında ajanın bu notu okumasını iste. Anthropic'in örneğindeki ilerleme dosyası ve özellik listesi, böyle bir devir için kullanılabilecek yöntemlerdir. Her araçta aynı dosya adı veya otomatik yükleme davranışı bulunmasını bekleme.

İzinler ve durma kuralları nasıl belirlenir?

İzinleri, ajanın görev için erişmesi gereken kaynaklara göre sınırlandırmalı; durma kurallarını da görev başlamadan uygulamada tanımlamalısın. Prompttaki talimat ile aracın gerçekten sahip olduğu yetkiyi ayrı ayrı kontrol et. Örneğin "canlı siteye dokunma" yazdıysan test ortamının bağlantılarını kullan ve canlı yayın yetkisini kapat.

Yazı tarihinde Claude Agent SDK izin belgeleri, araç kullanımını izin kuralları ve çalışma modlarıyla yönetmeyi açıklıyor. Çalışma sırasında karar vermek için ayrıca bir onay işlevi var. Daha önceki bir kuralın otomatik onayladığı çağrı, bu onay işlevine uğramayabiliyor. Kendi uygulamanı yazıyorsan izinlerin değerlendirme sırasını okumadan yalnızca tek bir onay kontrolüne güvenme.

Form örneğinde, test dosyalarını okumaya izin verebilir ve değişiklikleri ayrı bir kopyada yaptırabilirsin. Gerçek e-posta gönderen bağlantıyı denemeye ekleme. Başarı ölçütüne ulaşamayan ajan için bir deneme sınırı koy; sınır dolduğunda hata çıktısını ve kalan işi kaydetmesini iste. Böylece yeniden başladığında nerede takıldığını inceleyebilirsin.

Bir harness'i nasıl değerlendirmelisin?

Harness'i, aynı küçük görevde ne yaptığını ve kesintiden sonra hangi bilgilerle devam ettiğini izleyerek değerlendirmelisin. Başarılı bir son mesajın yanında dosya değişiklikleri ve test sonuçları da inceleyebileceğin kanıtlardır.

İlk denemende yalnızca form hatasına odaklan. Çalışmanın sonunda ilgili dosyayı incele ve belirtilen kontrolleri kendin de uygula. Sonra yeni bir oturum açıp ilerleme notunu okut. Ajanın tamamlanan adımı tekrar yapıp yapmadığını ve kalan sorunu doğru bulup bulmadığını kontrol et.

Bir başka denemede gereken dosyayı erişime kapatarak ajanın ne yaptığını gözle. İşlem engellendiğinde senden bilgi mi istiyor, hata mı bildiriyor, yoksa görevi tamamladığını mı söylüyor? Beklenen davranışı önceden yaz ki sonucu karşılaştırabilesin. Araçları değiştirirken başlangıç dosyalarını ve görev tanımını aynı tut; aksi hâlde hangi değişikliğin sonucu etkilediğini ayırmak zorlaşır. Belirli bir denemedeki başarıyı diğer bütün görevlerine genelleme.

Bizim yorumumuz

Bizce harness kavramı, özellikle bir ajana art arda iş yaptıran küçük ekipler için kullanışlı. Tek bir paragrafı düzelttireceksen kapsamlı bir ajan düzeni kurmak gereksiz olabilir. Buna karşılık bir web projesindeki eksikleri farklı günlerde tamamlatıyorsan, son yapılan değişikliğin ve kalan işin kaydı doğrudan ihtiyacına karşılık gelir. İlk tercihimiz, bu kayıtları senin de okuyabildiğin bir çalışma düzeni olurdu.

Türkiye'de bir müşterinin sitesini hazırlayan bağımsız geliştirici için önerimiz, denemeyi sitenin ayrı bir kopyasında yapmak. Form örneğinde olduğu gibi, kabul koşullarını müşteriye gösterebileceğin açıklıkta yaz. Hangi girişin kabul edildiğini ve hangisinde uyarı çıktığını kaydet. Böyle bir kayıt, teslim sırasında neyi kontrol ettiğini anlatmanı da kolaylaştırır.

Bizce ilk kurulumda her servisi bağlamaya çalışmak gereksiz iş çıkarır. Dosya erişimi ve bir test aracıyla başlayıp eksik kalan ihtiyaca göre ilerleyebilirsin. Ajanın durduğu yerde hata kaydı yoksa önce kayıt düzenini iyileştir. Sonraki oturum yapılan işi tekrar ediyorsa ilerleme notunun gerçekten yüklendiğini kontrol et. Model değişikliğini değerlendirmeden önce bu sorunların hangi katmanda olduğunu araştırmak daha anlamlı gelir.

Bir araç için karar verirken başarısız denemenin kaydını da incelemeni öneriyoruz. Hata mesajını görebiliyor musun, kaldığın yerden devam etmek için neyi elle yapman gerekiyor? Sonraki denemende bu soruların cevaplarını not al; kendi işinde tekrar eden eksiklere göre hangi özelliğe ihtiyaç duyduğunu belirleyebilirsin.

Bilgiler 14 Kasım 2026 tarihinde Anthropic'in ajan tasarımı açıklamaları ve Claude Agent SDK izin belgeleri üzerinden kontrol edildi. Kullandığın sürümde izinlerin değerlendirme sırasını resmi belgeden yeniden kontrol et.

Bu yazı sponsorlu değildir.

Sık sorulanlar

AI agent harness ne demek?

Modelin araç çağrılarını çalıştıran ve görev boyunca çalışma akışını yöneten çevre yazılımı demek. İzinler, ilerleme kayıtları ve durma koşulları bu yapının parçası olabilir.

Agent harness ile yapay zekâ modeli arasındaki fark nedir?

Model, verilen bağlama göre yanıt veya araç çağrısı üretir. Harness bu çağrıyı işler, izin verilen işlemi yürütür ve sonucu bir sonraki adım için modele iletir.

MCP bir agent harness mi?

MCP, uygulamaların dış araçlara ve verilere bağlanmasını sağlayan bir protokoldür. Harness bu bağlantılardan yararlanabilir; görevin nasıl sürdürüleceği ve ne zaman duracağı ayrıca tasarlanır.

Bir prompt yazarak agent harness kurulabilir mi?

Prompt ile görev ve davranış beklentilerini tarif edebilirsin. Araçları çalıştırmak, izinleri uygulamak ve ilerlemeyi kaydetmek için bu işleri yapan bir uygulama veya kod gerekir.

#yapay-zeka-ajanlari#agent-harness#yazilim#rehber
E-bülten

Haftada bir e-posta. Sadece işe yarayanlar.

Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.

Adresine bir onay e-postası gelir. Aydınlatma metni
Sıradaki yazı Cursor nedir? Yapay zekâlı kod editörü kimin işine yarar

Videolarda bu konuTümü

Bunları da okuyun