İnsanların Sürekli Karıştırdığı 3 Katman İçin Pratik Bir Kılavuz
Çoğu kişi yapay zeka ajanlarından tek bir şeymiş gibi bahsediyor.
Oysa öyle değil.
Bir ajan, oyuncak bir demo seviyesini aşıp dosyalara, API'lere, belgelere, müşterilere veya üretim koduna dokunmaya başladığında, artık sadece "bir modeli yönlendirmiyorsunuz."
Bir sistem tasarlıyorsunuz.
Ve bu sistemde, sürekli birbirine karıştırılan üç kavram var:
- Ajan koşum mühendisliği (Agent harness engineering)
- Döngü mühendisliği (Loop engineering)
- Grafik mühendisliği (Graph engineering)
Hepsi aynı modelin etrafında konumlanır.
Hepsi güvenilirliği etkiler.
Ve evet, hepsi döngüler içerebilir.
Ama farklı sorunları çözerler.
Bunları karıştırırsanız, yanlış katmanda hata ayıklamaya başlarsınız.
30 Saniyelik Cevap
İşte net versiyonu:
- Koşum mühendisliği, modelin etrafındaki ortamı inşa eder
- Döngü mühendisliği, tekrarlanan çalışma ve geri bildirim döngüsünü tasarlar
- Grafik mühendisliği, iş akışı topolojisini açık hale getirir
İyi bir zihinsel model şudur:
Ortam → Geri Bildirim → Akış
- Koşum, modele araçlar, hafıza, kontrol ve bir çalışma alanı sağlar
- Döngü, işin nasıl tekrar deneneceğine, kontrol edileceğine ve iyileştirileceğine karar verir
- Grafik, hangi adımın bir sonraki adım olarak gerçekleşmesine izin verildiğini tanımlar
İşte fark budur.
Bu Terimler Neden Şimdi Önemli?
Ham bir model, kendi başına gerçek bir iş yapamaz.
Şunları yapamaz:
- oturumlar arasında proje durumunu korumak
- araçları güvenle çağırmak
- bir tarayıcıyı incelemek
- izinleri zorlamak
- başarısız olan işi yeniden denemek
- çıktı kalitesini doğrulamak
- görevleri uzmanlar arasında yönlendirmek
- doğru anda durmak
Tüm bunlar, etrafındaki sistemden gelir.
Ajan yazılımı olgunlaştıkça, pratik bir yapı ortaya çıkıyor:
- Koşum, modele çalışma koşullarını sağlar
- Döngüler, işi tekrarlanabilir ve doğrulanabilir kılar
- Grafik, karmaşık iş akışlarını açık ve kontrol edilebilir hale getirir
Bunları ayrı katmanlar olarak gördüğünüzde, yapay zeka mimarisiyle ilgili kafa karışıklığının çoğu ortadan kalkar.
Ciddi Bir Koşum Genellikle Neler İçerir?
- Bağlam Enjeksiyonu
Modelin harekete geçmeden önce gördükleri:
- talimatlar
- alınan bilgi
- konuşma durumu
- hafıza
- politikalar
- göreve özel kurallar
- Eylem Yüzeyleri
Modelin yapabilecekleri:
- API çağrıları
- tarayıcı eylemleri
- kabuk komutları
- kod yürütme
- MCP araçları
- veritabanları
- özel işlevler
- Kalıcılık
Zaman içinde varlığını sürdürenler:
- dosyalar
- kontrol noktaları
- oturum durumu
- ilerleme günlükleri
- git geçmişi
- uzun süreli hafıza
- Yürütme Kontrolü
Çalıştırmanın nasıl yönetildiği:
- yeniden denemeler
- zaman aşımları
- bütçeler
- model seçimi
- alt ajan oluşturma
- onay kapıları
- Güvenlik ve Yönetişim
Sistemi güvende tutan şeyler:
- en az ayrıcalıklı izinler
- izolasyon
- izin verilenler listesi
- gizli bilgi yönetimi
- insan onayı
- Gözlemlenebilirlik
Hata ayıklamanızı sağlayan şeyler:
- izlemeler
- araç girdileri ve çıktıları
- durum geçişleri
- gecikme süresi
- maliyet
- değerlendirme sonuçları
Koşum Mühendisliği Neden Önemlidir?
İki ekip aynı modeli kullanır ve tamamen farklı sonuçlar alabilir.
Neden?
Çünkü bir ekip modele şunları sağlar:
- temiz araçlar
- kararlı durum
- yapılandırılmış hafıza
- net izinler
- gözlemlenebilir yürütme
Diğer ekip ise şunları sağlar:
- belirsiz bir yönlendirme
- dağınık araçlar
- gürültülü bağlam
- hafıza yok
- doğrulama yok
Model aynı olabilir.
Çalışma koşulları aynı değildir.
Koşum mühendisliği şu durumlarda önemlidir: ajan
- doğru yeteneğe erişemiyorsa
- oturumlar arasında bağlam kaybediyorsa
- ortamlar arasında tutarsız davranıyorsa
- denetlenemiyorsa
- çok fazla izne sahipse
- kesintiden sonra temiz bir şekilde toparlanamıyorsa
Model güvenilir bir şekilde çalışamıyorsa, bakılacak ilk yer koşumdur.
2. Döngü Mühendisliği
Nedir?
Araç kullanan her ajanın zaten küçük, yerleşik bir döngüsü vardır:
- modeli çağır
- sonucu gözlemle
- araçları çalıştır
- gözlemleri geri besle
- iş bitene kadar tekrarla
Döngü mühendisliği, bu davranışın etrafında bilinçli olarak ek döngüler tasarladığınızda başlar.
Sadece "tekrar sor" değil.
Sadece "yeniden dene" değil.
Gerçek bir çalışma ve geri bildirim sistemi.
İyi Bir Döngünün Anatomisi
Tetikleyici
Yeni bir döngüyü ne başlatır?
- kullanıcı isteği
- başarısız test
- yeni belge
- planlanmış çalıştırma
- web kancası
- değerlendirici geri bildirimi
Hedef
Ulaşmaya çalıştığımız belirli koşul nedir?
"İyileştirmeye devam et" değil.
Gerçek bir hedef.
Durum
Bir sonraki döngünün neyi bilmesi gerekiyor?
- mevcut taslak
- önceki deneme
- araç sonuçları
- hatalar
- ilerleme durumu
Eylem Politikası
Ajanın yapmasına izin verilen nedir?
- düzenle
- devret
- araçları çağır
- token harca
- dosya yaz
- PR aç
Kanıt
İşe yarayıp yaramadığını nasıl anlarız?
- testler
- şema doğrulaması
- alıntılar
- farklar (diff)
- metrikler
- inceleyici onayı
Geri Bildirim
Tam olarak ne başarısız oldu?
Geri bildirim, kısa ve uygulanabilir olmalıdır.
Durdurma Kuralı
Ne zaman biter?
- başarı
- zaman aşımı
- bütçe tükenmesi
- maksimum yeniden deneme sayısına ulaşılması
- onarılamaz hata
- bir insana yükseltme
Döngü Mühendisliğindeki En Önemli İlke
Güvene değil, kanıta dayalı döngü yapın.
"Ajan işin bittiğini söylüyor" bir durdurma koşulu değildir.
Gerçek bir durdurma koşulu daha çok şuna benzer:
- testler geçiyor
- şema doğrulanıyor
- alıntılar çözümleniyor
- inceleyici onaylıyor
- politika kontrolü temiz
İşte döngü mühendisliği budur.
Döngü Mühendisliği Neden Sadece Yönlendirme Mühendisliği Değildir?
Bir yönlendirme, modele bir çağrı sırasında ne yapması gerektiğini söyler.
Bir döngü, sistemin çağrıdan sonra ne yapacağını tanımlar.
Bu şunları içerir:
- sonuçları nasıl kontrol ettiği
- başarısızlığa nasıl tepki verdiği
- ilerlemeyi nasıl sürdürdüğü
- devam etmeye nasıl karar verdiği
- nasıl sonlandırdığı
Yönlendirme, bir yanıtı iyileştirir.
Bir döngü, bir süreci iyileştirir.
Bu çok farklı bir mühendislik problemidir.
3. Grafik Mühendisliği
Nedir?
Grafik mühendisliği, iş akışı yapısını açık hale getirir.
Farklı bir soruyu yanıtlar:
Sadece "Ajan ne yapmalı?" değil. Ama "Bir sonraki adımda ne olmasına izin veriliyor?"
Grafik mühendisliğinde:
- adımlar düğümlerdir
- geçişler kenarlardır
- dallanma açıktır
- paralel çalışma açıktır
- birleşmeler açıktır
- yeniden denemeler açıktır
- insan müdahaleleri açıktır
Grafik, sistem için kontrol haritası haline gelir.
Grafik Mühendisleri Aslında Neyi Tasarlar?
Düğüm Sınırları
Neyin içinde olduğu:
- deterministik bir işlev
- bir LLM çağrısı
- bir uzman ajan
- bir insan inceleme adımı
Durum Şeması
Her düğümün okuyup yazabileceği şeyler.
Yönlendirme Koşulları
Hangi kanıtın işi taşıdığı:
- ileri
- geri
- yana
- yükseltmeye
Eş Zamanlılık
Neyin paralel çalışabileceği ve neyin beklemesi gerektiği.
Döngüler ve Çıkışlar
Yeniden denemelere nerede izin verildiği, kaç tanesine izin verildiği ve nasıl durduruldukları.
Dayanıklılık
Kontrol noktalarının nerede olduğu ve iş akışının kesintiden sonra nasıl devam ettiği.
Grafikler Ne Zaman Değerlidir?
Grafikler, süreç aşağıdakileri içerdiğinde değerlidir:
- anlamlı dallanma
- onaylar
- uzman aktarımları
- paralel çalışma
- kurtarma yolları
- açık kontrol noktaları olan çok adımlı iş akışları
İş basitçe şu olduğunda daha az kullanışlıdırlar:
"Bir ajana birkaç araç verin ve çalışmasına izin verin."
Bu durumda, sağlam bir koşum artı birkaç döngü yeterli olabilir.
Bir grafik netlik katar, ancak aynı zamanda yapı da ekler.
Çok erken çok fazla yapı, sistemi kırılgan hale getirebilir.
3 Katman Nasıl Birlikte Çalışır?
Diyelim ki bir araştırma ve yayınlama ajanı oluşturuyorsunuz.
Şunları yapması gerekiyor:
- bir konuyu kapsamlandırmak
- kaynakları toplamak
- alıntıları elemek
- bir rapor taslağı hazırlamak
- yasal incelemeden geçmek
- sadece onaydan sonra yayınlamak
İşte katmanların haritası:
Koşum
Şunları sağlar:
- tarayıcı erişimi
- arama araçları
- dosya çalışma alanı
- hafıza
- alıntılar
- onaylar
- izlemeler
- model yönlendirme
Döngü
Şunları halleder:
- kanıt zayıf olduğunda kaynak alımını yeniden denemek
- alıntı hatalarını düzeltmek
- not veren kontrollerini çalıştırmak
- pazar değiştiğinde işi yenilemek
Grafik
Yolu kontrol eder:
- kapsamlandırma
- araştırma
- eleme
- sentez
- taslak hazırlama
- inceleme
- yayınlama
Yayın öncesinde bir insan kapısı ile.
İşte bu yüzden 3 katman birbirinin yerine geçemez.
Birlikte çalışırlar, ancak aynı şey değildirler.
Düzeltmeyi Seçmeden Önce Hatayı Teşhis Edin
İşte pratik kural:
Ajan çalışamıyorsa, koşumu düzeltin
Örnekler:
- eksik araç erişimi
- güncel olmayan durum
- zayıf hafıza
- kötü izinler
- gözlemlenebilirlik yok
Ajan neredeyse çalışıyor ancak güvenilmezse, döngüyü düzeltin
Örnekler:
- ilk taslak yakın ancak zayıf
- başarı tutarsız
- yeniden denemeler kontrolsüz
- tamamlanma kanıtı yok
Sürecin kendisi karmaşıksa, grafiği düzeltin
Örnekler:
- birçok uzman
- onaylar
- dallanma mantığı
- paralel yollar
- yapılandırılmış aktarımlar
Sık Yapılan Hatalar
1. Grafiği Çok Erken İnşa Etmek
Ekipler genellikle işin gerçekte nasıl davrandığını görmeden önce büyük bir iş akışı çizer.
Daha iyi yaklaşım:
- daha basit bir koşumla başlayın
- izlemeler toplayın
- kararlı kalıpları bulun
- sadece kontrolü hak eden şeyi resmileştirin
2. Aynı Modelin Güvenlik Önlemi Olmadan Yazmasına ve Not Vermesine İzin Vermek
Kendi kendini inceleme yardımcı olabilir, ancak aynı kör noktaları paylaşır.
Şunları tercih edin:
- mümkün olduğunda deterministik kontroller
- ayrı inceleyici bağlamı
- harici değerlendiriciler
- yüksek etkili eylemler için insan onayı
3. "Denemeye Devam Et"i Bir Döngü Olarak Kullanmak
Bu bir döngü tasarımı değildir.
Bu kontrolsüz bir maliyet sızıntısıdır.
Her döngünün ihtiyacı vardır:
- ölçülebilir bir hedef
- gerçek kanıt
- yeniden deneme sınırları
- yükseltme kuralları
4. Koşumu Bir Karışık Kutu Olarak Görmek
Daha fazla araç, otomatik olarak daha iyi ajanlar anlamına gelmez.
Çok fazla araç şunları yaratır:
- seçim hataları
- gürültülü bağlam
- zayıf güvenilirlik
- daha geniş risk yüzeyi
İyi bir koşum kalabalık değildir.
Hassastır.
5. Orkestrasyon Başarısızlıkları İçin Modeli Suçlamak
Bir model şunları telafi edemez:
- bozuk API'ler
- güncel olmayan durum
- eksik çıkış koşulları
- belirsiz araç şemaları
- görünmez hata modları
Hataya sahip olan katmanı düzeltin.
Basit Bir Üretim Kontrol Listesi
Koşum
- Araçlar dar ve belgelenmiş mi?
- Durum kalıcı mı?
- İzinler en az ayrıcalıklı mı?
- Operatörler duraklatabilir, inceleyebilir ve devam ettirebilir mi?
- İzlemeler görünür mü?
Döngü
- Hangi kanıt başarıyı kanıtlıyor?
- Başarısızlık durumunda hangi geri bildirim döndürülüyor?
- Kaç yeniden denemeye izin veriliyor?
- Durdurma kuralı nedir?
- Bütçe bittiğinde ne olur?
Grafik
- Hangi yollar deterministik olmalıdır?
- Neler paralel çalışabilir?
- İnsan kapıları nerede?
- Hangi durum paylaşılıyor?
- Kurtarma yolları nerede başlıyor?
Değerlendirme
- Gerçek izlemeleri tekrar oynatabiliyor musunuz?
- Sürümleri karşılaştırabiliyor musunuz?
- İyileştirmeyi gerçek bir değişikliğe atfedebiliyor musunuz?
Operasyonlar
- Maliyeti takip ediyor musunuz?
- gecikme süresini?
- başarısızlık oranını?
- müdahale oranını?
- üretimde görev başarısını?
Farkı Hatırlamanın En Basit Yolu
Sadece bir şey hatırlayacaksanız, şunu hatırlayın:
- Koşum mühendisliği modeli çalışır hale getirir
- Döngü mühendisliği işi yinelemeli ve doğrulanabilir kılar
- Grafik mühendisliği yürütme yolunu açık ve kontrol edilebilir kılar
Hiçbiri diğerlerinin yerini almaz.
Mükemmel bir grafik, zayıf bir koşumu kurtaramaz.
Güçlü bir koşum, iyi döngüler olmadan yine de para israf eder.
Ve temiz döngüler, dallanma ve onaylar geçici kodlarda gizli kaldığında yönetilmesi zorlaşır.
Güvenilir ajan sistemleri, 3 katmanın da bilinçli olarak tasarlandığında ortaya çıkar.
Gerçek mimari yapı budur.
Son Çıkarım
İnsanlar sürekli olarak yapay zeka ajanlarından, asıl atılımın model olduğunu söyleyerek bahsediyor.
Üretimde, bu nadiren gerçek farklılaştırıcıdır.
Farklılaştırıcı, modelin etrafındaki sistemdir:
- çalışmasını sağlayan koşum
- iyileştirmesini sağlayan döngüler
- kontrol altında çalışmasını sağlayan grafik
Oyuncak ajanların gerçek sistemlere dönüşmesi böyle olur.
Buraya kadar okuduysanız:
- BUNU YER İMİNE EKLEYİN.
- [@LunarResearcher](https://x.com/@LunarResearcher)'i takip edin
- [Substack](https://substack.com/@lunarresearcher)'imi takip edin
- [Özel Telegram Kanalımı](https://t.me/+O4FFj3BmnJRiODhi) takip edin
