AI ajanları geliştiren her ekip aynı duvara toslar.
Tek bir prompt ve birkaç araçla başlarsın.
Çalışır.
Sonra gereksinimler büyür. Daha fazla uç durum. Daha fazla ekip. Daha fazla risk.
Bir anda "ajanın" 3.000 kelimelik bir sistem prompt'una dönüşür, aynı anda beş işi yapmaya çalışır.
Çözüm daha fazla prompt mühendisliği değil.
Doğru kalıbı seçmektir.
İşte her üretime hazır ajan sisteminin üzerine inşa edildiği 15 kalıp — ve her birini tam olarak ne zaman kullanacağın.
Bir kalıp seçmeden önce
Her görev bir ajana ihtiyaç duymaz.
Bir görev, aşağıdaki durumlarda bir ajana ihtiyaç duyar:
→ Tek bir model çağrısı güvenilir bir sonuç üretemiyorsa
→ Model çalışma zamanında araçlar veya veri kaynakları arasında seçim yapmak zorundaysa
→ Görev planlama, doğrulama veya yinelemeli iyileştirme gerektiriyorsa
→ İş akışında kodla sabitlenemeyecek gerçek bir belirsizlik varsa
Bir görev genellikle bir ajana ihtiyaç duymaz, girdiden çıktıya giden yol öngörülebilir olduğunda.
Özetleme. Sınıflandırma. Basit çıkarım. Şablonlu üretim.
Bunlar, doğrudan model çağrıları olarak daha hızlı, daha ucuz ve daha güvenilirdir.
Onları bir ajana sarmak, sıfır fayda için yalnızca gecikme ve hata noktaları ekler.
KALIP 1 — Tek Ajan
En basit ve en yaygın başlangıç noktası.
Bir model. Bir sistem prompt'u. Sınırlı bir araç seti.
Model hangi aracı çağıracağına karar verir, sonucu gözlemler ve yanıtlamak için yeterli bilgiye sahip olana kadar devam eder.
Gerçek örnek: Sipariş durumunu sorgulayan, kargoyu kontrol eden ve sorunu çözemezse bir talep oluşturan bir müşteri destek ajanı — tüm bunlar 2-3 araç ve tek bir net görevle.
Şu durumlarda kullan: Görev iyi tanımlanmışsa, araç seti küçükse ve tek bir ajan tüm bağlamı kafası karışmadan tutabiliyorsa.
Şu durumlarda bozulur: Sürekli araç eklediğinde ve sistem prompt'u bir sayfayı geçtiğinde. Bu, daha uzun bir prompt'a değil, farklı bir kalıba ihtiyacın olduğunun işaretidir.
KALIP 2 — Çoklu Ajan Sıralı
Uzmanlaşmış ajanlar sabit bir sırayla çalışır. Her birinin çıktısı, bir sonrakinin girdisini besler.
Gerçek örnek: Bir sözleşme inceleme hattı — bir ajan yükümlülükleri çıkarır, bir sonraki riskleri belirler, üçüncüsü satın alma için özeti hazırlar. Sıra asla değişmez.
Şu durumlarda kullan: İş akışının net, tekrarlanabilir aşamaları varsa ve her aşama, bir sonrakinin tam olarak ihtiyaç duyduğu şeyi üretiyorsa.
Şu durumlarda bozulur: Sıranın, süreç içinde bulunanlara göre değişmesi gerektiğinde. Sıralı iş hatları, yolun sabit olduğunu varsayar — öyle değilse, daha dinamik bir şeye ihtiyacın vardır.
KALIP 3 — Çoklu Ajan Paralel
Bağımsız alt görevler aynı anda çalışır, ardından tek bir görünümde birleştirilir.
Gerçek örnek: Sabah saat 2'de bir üretim olayı. Üç ajan aynı anda günlükleri, metrikleri ve son dağıtımları araştırır — art arda değil — çünkü bir kesinti sırasında her dakika önemlidir.
Şu durumlarda kullan: Alt görevler gerçekten bağımsızsa ve hız önemliyse.
Şu durumlarda bozulur: Görevler aslında birbirlerinin sonuçlarına bağlıysa. Bağımlı işi paralel yürütmeye zorlamak, yalnızca yarış koşulları ve eksik bağlam yaratır.
KALIP 4 — Döngü
Bir çıkış koşulu karşılanana kadar bir dizi adımı tekrarla.
Gerçek örnek: Dağınık CSV verilerini profillendiren, bir temizleme planı öneren, kalite standartlarını geçip geçmediğini kontrol eden ve geçmezse yeniden deneyen bir veri temizleme ajanı — maksimum tur sayısına kadar.
Şu durumlarda kullan: Görev birden çok deneme gerektiriyorsa ve net, kontrol edilebilir bir durma koşulu tanımlayabiliyorsan.
Şu durumlarda bozulur: Güvenilir bir çıkış koşulu yoksa. Olmadan, kontrolden çıkan maliyetler ve asla sonlanmayabilecek bir sistem elde edersin.
KALIP 5 — İnceleme ve Eleştiri
Bir yargıç ajan, başka bir ajanın çıktısını inceler, eleştirir ve spesifik, uygulanabilir geri bildirim verir.
Gerçek örnek: Oluşturulan bir rapor, bir insana ulaşmadan önce zayıf iddiaları, eksik kanıtları veya net olmayan bölümleri işaretleyen ayrı bir "eleştirmen" ajan tarafından incelenir.
Şu durumlarda kullan: Kalite hızdan daha önemliyse ve sisteme sonradan eklenmiş değil, içine yerleşik ikinci bir görüş istiyorsan.
Şu durumlarda bozulur: Eleştirmen ajan, üretici ile aynı kör noktaları kullanıyorsa. Benzer varsayımlarla eğitilmiş bir inceleyici, aynı hataları yakalamaz.
KALIP 6 — Yinelemeli İyileştirme
Bir kalite puanı eşiği olan bir geri bildirim döngüsü. Üretici, çıtayı geçene kadar iyileştirmeye devam eder.
Gerçek örnek: Kendi taslağını marka yönergelerine göre puanlayan ve minimum bir kalite puanına ulaşana kadar yeniden yazan bir pazarlama metni üreticisi — sadece bir geçer-kalır kontrolü değil, dereceli iyileştirme.
Şu durumlarda kullan: Çıktı kalitesi gerçekten değişkense ve "yeterince iyi"nin ölçülebilir bir eşiği varsa.
Şu durumlarda bozulur: Puanlama işlevi belirsiz veya oynanabilirse. Model, gerçek bir iyileştirme olmadan kendi puanını şişirebiliyorsa, döngü sadece token yakar.
KALIP 7 — Koordinatör
Merkezi bir yönlendirme ajanı, gerçekte ne sorulduğuna bağlı olarak istekleri uzmanlaşmış ajanlara yönlendirir.
Gerçek örnek: Destek talepleri, her şeyi bilmeye çalışan tek bir ajan yerine dar bağlamlı fatura, teknik, hesap, nakliye veya dolandırıcılık uzmanlarına yönlendirilir.
Şu durumlarda kullan: Farklı bağlam, araç veya karar mantığı gerektiren gerçekten farklı istek türlerin varsa.
Şu durumlarda bozulur: Yönlendirmenin kendisi belirsiz hale geldiğinde. İstekler tek bir kategoriye temiz bir şekilde girmiyorsa, koordinatör yeni bir darboğaz ve yanlış yönlendirme kaynağı haline gelir.
KALIP 8 — Hiyerarşik Görev Ayrıştırması
Bir kök ajan, karmaşık bir hedefi daha küçük alt hedeflere böler, bunları uzman işçilere devreder ve ardından her şeyi tek bir cevapta sentezler.
Gerçek örnek: "Gelecek yıl hangi 3 ülkeye genişlemeliyiz?" sorusu; rekabet analizi, düzenleyici araştırma, lojistik fizibilitesi ve pazar büyüklüğü belirlemeye bölünür — her biri farklı bir uzman tarafından ele alınır, ardından birleştirilir.
Şu durumlarda kullan: Sorun tek bir akıl yürütme geçişi için çok genişse ancak temiz bir şekilde bağımsız uzmanlık alanlarına ayrılıyorsa.
Şu durumlarda bozulur: Alt hedefler aslında bağımsız değilse. İş akışlarının gerçek zamanlı olarak birbirini bilgilendirmesi gerekiyorsa, bunları önceden ayrıştırmak bu etkileşimi kaybeder.
KALIP 9 — Sürü
Birden çok uzman ajan, paylaşılan bir tartışmaya katkıda bulunur, birbirlerinin varsayımlarına meydan okur ve bir kolaylaştırıcı nihai bir öneri sentezler.
Gerçek örnek: Şirket bir abonelik katmanı başlatmalı mı? Araştırma, mühendislik, finans ve destek ajanlarının her biri, bir kolaylaştırıcı ödünleşimleri tartmadan önce birden çok tur boyunca kendi perspektiflerini savunur.
Şu durumlarda kullan: Tek bir "doğru" cevap olmadığında — gerçekten rekabet eden bakış açıları tarafından şekillendirilen, iyi gerekçelendirilmiş bir karara ihtiyacın var.
Şu durumlarda bozulur: Hızlı, deterministik bir cevaba ihtiyacın olduğunda. Sürüler kasıtlı olarak yavaş ve keşfedicidir — hıza ihtiyacın varsa yanlış araçtır.
KALIP 10 — ReAct (Akıl Yürüt ve Harekete Geç)
Ajan, akıl yürütme ve eylem arasında geçiş yapar: neyi araştıracağına karar ver, bir aracı çağır, sonucu gözlemle, yeterli kanıt olup olmadığına karar ver.
Gerçek örnek: "Kuyruk işlemcisi takılı kalmış gibi görünüyor" — ajan belgeleri arar, hizmet durumunu kontrol eder, bulguları ilişkilendirir ve ancak o zaman bir düzeltme önerir. Araştırma yolu önceden tanımlanmamıştır; yol boyunca bulduklarına bağlıdır.
Şu durumlarda kullan: Cevaba giden yol gerçekten önceden planlanamıyorsa — her adımın ortaya çıkardığı şeye bağlıdır.
Şu durumlarda bozulur: Araştırmalar yakınsamadan uzun sürerse. Her zaman akıl yürütme-eylem döngülerinin sayısını sınırla, yoksa sonsuz keşif riskiyle karşı karşıya kalırsın.
KALIP 11 — İnsanın Döngüde Olduğu
Ajan araştırır ve önerir, ancak riskli veya belirsiz herhangi bir şeyde nihai kararı insan verir.
Gerçek örnek: İade onayları — düşük riskli, net vakalar otomatikleştirilir. Yüksek tutarlar, dolandırıcılık sinyalleri veya politika istisnaları, bir şey sonuçlandırılmadan önce insan incelemesi için bekletilir.
Şu durumlarda kullan: Karar gerçek finansal, yasal veya itibari risk taşıyorsa ve tam otomasyon henüz kabul edilebilir değilse.
Şu durumlarda bozulur: Bunu sadece bir UI özelliği olarak değil, mimari bir özellik olarak ele alırsan. Dayanıklı durum, inceleyici ataması, zaman aşımı işleme ve yükseltme yollarına ihtiyacın var — sadece bir "duraklat" düğmesine değil.
KALIP 12 — Planla ve Yürüt
Bir planlayıcı ajan, herhangi bir işlem yapılmadan önce tam, yapılandırılmış bir planı önceden oluşturur — incelenebilir ve değiştirilebilir. Ardından bir yürütücü adımları uygular.
Gerçek örnek: "İşçi filosunu 10 örnekten 20 örneğe yeniden boyutlandır, kuyruğun boşaldığını doğrula, runbook'u güncelle." Yürütme başlamadan önce planın tamamı görünürdür; ReAct'te yolun adım adım ortaya çıkmasının aksine.
Şu durumlarda kullan: Planın herhangi bir işlem gerçekleşmeden önce incelenebilir veya onaylanabilir olmasını istiyorsan — gerçek sonuçları olan operasyonlar için önemlidir.
Şu durumlarda bozulur: Ortam, planın yürütülebileceğinden daha hızlı değişirse. Körü körüne yürütülen bayat bir plan, hiç plan olmamasından daha kötüdür.
KALIP 13 — Yansıma
Ajan kendi başarısızlıklarını değerlendirir, neyin yanlış gittiği üzerinde düşünür ve bu hafızayı bir sonraki denemeye taşır.
Gerçek örnek: Bir kod üretme ajanı bir betik yazar, çalışma zamanında başarısız olur, ajan gerçek hatayı analiz eder, neyin düzeltileceğini kaydeder ve yeniden dener — aynı hatayı tekrarlamak yerine her denemede daha akıllı hale gelir.
Şu durumlarda kullan: Başarısızlıklar bilgilendiriciyse ve kendi kendini düzeltme, bir sonraki denemeyi gerçekten iyileştiriyorsa.
Şu durumlarda bozulur: Başarısızlık modları rastgele veya birbiriyle ilgisizse. Yansıma, yalnızca öğrenilecek gerçek bir kalıp olduğunda yardımcı olur.
KALIP 14 — Özel Mantık
Bir hibrit: deterministik kod, asla yanlış olmaması gereken kuralları ele alırken, model muhakeme, taslak hazırlama ve istisna işlemeyi halleder.
Gerçek örnek: Satın alma doğrulaması ve dolandırıcılık kontrollerinin model'e asla devredilmeyen katı deterministik kurallar olarak çalıştığı, müşteri yanıtının hazırlanması ve yönlendirme önerilerinin ajanlık olarak kaldığı bir iade iş akışı.
Şu durumlarda kullan: İş akışı, yasal veya finansal sonuçları olan gerçek dallanma mantığına sahipse ve neyin deterministik neyin esnek olduğu konusunda kesin olman gerekiyorsa.
Şu durumlarda bozulur: Ekipler çizgiyi bulanıklaştırır ve modelin, sabit kodlanmış kurallar olması gereken kararlar almasına izin verirse. Uygunluk, izinler ve para hareketi asla yalnızca modelin kararı olmamalıdır.
KALIP 15 — Olay Güdümlü Ajan
Ajan kendisine sorulmasını beklemez. Bir olay akışına abone olur ve bir koşul tetiklendiği anda harekete geçer.
Gerçek örnek: Şüpheli bir işlem olayı anında tetiklendiğinde reaksiyon gösteren bir dolandırıcılık tespit ajanı — bir destek talebinin nihayet konuyu gün ışığına çıkarmasını beklemek yerine, bu noktada hasar çoktan oluşmuştur.
Şu durumlarda kullan: Zamanlama her şeyden daha önemliyse ve bir insan isteğini beklemek, harekete geçme penceresini kaçırmak anlamına geliyorsa.
Şu durumlarda bozulur: Tetikleyici koşullar zayıf tanımlanmışsa. Belirsiz tetikleyicilere sahip gürültülü bir olay akışı, sürekli "kurt gibi uluyan" bir sisteme dönüşür — veya daha kötüsü, gerçek sinyali kaçırır.
Kalıp seçimi — belirsizliğe uydur, abartıya değil
Doğru kalıp, işindeki belirsizliğin şekline uyar:
→ Hangi aracı kullanacağından emin değil misin → Tek Ajan veya ReAct
→ Nereye yönlendireceğinden emin değil misin → Koordinatör
→ Kaliteden emin değil misin → İnceleme ve Eleştiri veya Yinelemeli İyileştirme
→ Yürütme yolundan emin değil misin → Planla ve Yürüt veya ReAct
→ Kendi kendini nasıl düzelteceğinden emin değil misin → Yansıma veya Döngü
→ İş riskinden emin değil misin → İnsanın Döngüde Olduğu veya Özel Mantık
→ Sorun yapısından emin değil misin → Hiyerarşik Ayrıştırma veya Sürü
→ Bir isteği bekleyemiyor musun → Olay Güdümlü Ajan
Bir sürü, görev yalnızca tek bir güvenilir araç çağrısı gerektiriyorsa, tek bir ajandan daha gelişmiş değildir.
Planla ve Yürüt, planın üçüncü adımda bayatlıyorsa, ReAct'ten bir yükseltme değildir.
En güvenilir üretim sistemleri en özerk olanlar değildir.
Özerkliği tam olarak değer yarattığı yere koyar — ve her yerde başka bir yerde kısıtlar.
Üretime hazır ajan sistemleri için 10 kural
- İşe yarayan en küçük kalıpla başla. Temiz araç sözleşmelerine sahip tek bir ajan, zayıf sözleşmelere sahip çoklu ajan sistemini yener.
- Araç tanımlarını sözleşme gibi yaz. Model, aracın ne yaptığını yalnızca tanımdan bilir — senin niyetinden değil.
- İstek başına yineleme, araç çağrısı ve harcamayı sınırla. Bütçe sınırı olmayan bir ajan, bir faturayla karşına çıkmayı bekleyen bir yükümlülüktür.
- Tam eylem izini günlüğe kaydet. Araç çağrıları, argümanlar, çıktılar, nihai karar. Bu olmadan, olay soruşturması tahmin yürütmektir.
- Geri alınamaz eylemleri deterministik kontrollerin veya insan onayının arkasında tut. Modelin, bir para hareketi veya üretim değişikliğinden önceki tek kapı olmasına asla izin verme.
- Gerçek başarısızlık durumlarıyla değerlendir, sadece mutlu yollarla değil. Mutlu yol doğruluğu bir prototiptir. Uç durum doğruluğu bir üründür.
- Sistem prompt'u okunamaz hale gelmeden prompt'ları sorumluluğa göre ayır. Prompt'una sızan "ama Y olduğunda X'i yapma" ifadesi, ajanın iki iş yaptığı anlamına gelir.
- Çoklu ajan sistemlerine dağıtık sistemler gibi davran. Kısmi hata, zaman aşımları, yeniden denemeler ve gözlemlenebilirlik isteğe bağlı değildir.
- Model incelemesi, deterministik doğrulamanın yerini tutmaz. Kaliteyi artırmak için yargıçlar kullan. Doğruluğu uygulamak için testler ve izin kontrolleri kullan.
- Daha basit kalıbı tercih et — basit her zaman daha iyi olduğu için değil, ancak biriktirdiğin karmaşıklık bütçesini daha iyi araçlar, daha iyi prompt'lar, daha iyi değerlendirme için harcayabilirsin.
İşte 15 kalıbın tamamı.
Çoğu ekip yanlış kalıbı seçtikleri için başarısız olmaz.
Hangi belirsizlik için gerçekten çözüm ürettiklerini hiç sormadıkları için başarısız olurlar.
Kalıbı seç. Sorunun şekline uydur. Yerini hak etmediği yere özerklik ekleme.
Bu faydalıysa:
→ Ekibinde ajan geliştiren her mühendisle paylaşmak için tekrar gönder
→ Bunun gibi daha fazla döküm için @sairahul1'i takip et
→ Bunu yer imlerine ekle — her yeni bir ajan projesine başladığında geri döneceksin
Yapay zeka, ürün geliştirme ve sensiz çalışan sistemler hakkında yazıyorum.
