AJAN MİMARİSİ NASIL TASARLANIR
Altı katman. Sağlayıcı yalnızca biri.
1:1 canlı çalıştaylarla, kendi kod tabanın üzerinden: sağlayıcı ve model seçeneklerini seçip gerisini %100 içeride kurduğun agentic sistemler. Bu sayfa o iddianın planı: katman katman ne kurulur, her katmanın sahibi kim ve hangi karar nerede durur.
Teknik şartname · YÖNTEM
- Katman
- 06
- İçeride kurulan
- %83
- Sağlayıcı
- 5 seçenek
- Araç
- 7 kategori
- Otonomi
- 0–3 kademe
01KATMAN HARİTASI
Sahibi belli altı katman
01
KiralıkModel katmanı
Soyutlama katmanı olmadan her çağrı bu sağlayıcının sözdizimini taşır.
02
İçerideAraç dağıtıcısı
Şema, yetki, hata sözlüğü — hiçbir sağlayıcı bunu sizin adınıza tasarlamıyor.
03
İçerideBağlam ve hafıza
Ne kadarını geri yüklüyorsunuz, ne kadarını yeniden üretiyorsunuz.
04
İçerideKontrol kapıları
Yan etkisi olan her araç burada durur; modele bırakılmaz.
05
İçerideGözetme ve iz
Her karar bir satır: girdi, çıktı, araç, token, maliyet.
06
İçerideDeğerlendirme
Altın set ve kapı sizin; model değiştirdiğinizde kıyas sizde kalır.
02SEÇİM YÜZEYİ
Sağlayıcı: değişebilir katman
OpenAI
bulutEn kalabalık araç arayüzü; ama hata tiplerini kendi sözleşmenize indirgemeden çıkmayın.
KilitlenmeAraç çağrı biçimi ve akış olayları kendi sözdizimine yaslanır.
Anthropic
bulutUzun araç zincirlerinde ve talimat sadakatinde güçlü. Kontrol kapılarını prompt'ta değil kodda tutma alışkanlığına çok uygun.
KilitlenmeAraç kullanımı ve sistem talimatı katı; taşırken bu iki sözleşme değişir.
Google
bulutGeniş pencere, çok modlu girdi. Uzun doküman işlerinde RAG yerine ham sayfayı koymak cazip gelir — maliyeti ölçerek yapın.
KilitlenmeÇok modlu girdi ve devasa pencere kolay alıştırır; pencere bedava değildir.
Yerel / açık ağırlık
yerelVeri dışarı çıkmıyor, maliyet tahmin edilebilir. Bedeli: kalite boşluğunu ve donanımı siz yönetirsiniz.
KilitlenmeKilitlenmezsiniz; ama operasyon yükü sizin olur.
Karma (görev başına seçim)
karmaİş başına farklı model: ucuz eleme, pahalı karar. Bu sitenin vaadi tam olarak bu — seçimi tek dosyadan yönetmek.
KilitlenmeKilitlenme en düşük; soyutlama katmanı olmadan bakım yükü en yüksek.
03ARAÇLAR
Araçlar ve risk yüzeyi
A1
Risk 8Veriye erişim (SQL / RAG)
Ajanıza tablo değil, sorgu sözleşmesi verin. Serbest SQL yerine parametreli okuma araçları; RAG'i tek başına hafıza sanmayın.
A2
Risk 14Kod çalıştırma (sandbox)
Çalıştırma yetkisi ajanın en büyük sıçrama tahtası ve en büyük deliği. Ağsız, dosyasız, süreli bir kum havuzu olmadan açmayın.
A3
Risk 6Web araması
Arama çıktısı güvenilmez veridir: kaynak, tarih ve alıntı olmadan modele yedirme. Aksi halde ajanınız başkasının enjeksiyonunu tekrar eder.
A4
Risk 16Tarayıcı otomasyonu
Kırılgan ve pahalı. Son çare olarak kullanın: önce API var mı diye sorun, yoksa ekran görüntüsü + erişilebilirlik ağacıyla sınırlayın.
A5
Risk 12İç API çağrıları
İç araçlar, dış araçlardan daha tehlikelidir: yetkiler sizin adınıza. Kullanıcı kimliğini ajana devretmeyin, kapsamı daraltılmış servis anahtarı verin.
A6
Risk 22Yazma işlemleri (commit, e-posta, fatura)
Yazma yetkisi olan her ajan bir onay kapısı ister. Kapı prompt'ta değil, araç dağıtıcısında olur; “lütfen onay iste” bir kontrol değildir.
A7
Risk 10İş akışı tetikleme (kuyruk / cron)
Ajanı bir turda bitmeye zorlamak yerine kuyruğa iş bırakın: uzun işler böyle dayanır. Yalnız yeniden tetikleme tavanı koyun, yoksa sonsuz döngü sizin olur.
04OTONOMİ
Otonomi ikili değil, kademeli
L0
kademe
Öneri modu
Ajan planı yazar, insan uygular. Araç çağrısı yok ya da salt okunur.
- Her adım insan onaylı
L1
kademe
Yarı-otonom
Okuma ve hesaplama araçları serbest; yazma ve gönderme kapıda.
- Yazma araçları onay kapısında
L2
kademe
Otonom döngü + gözlemci
Kendi turunu kurar; eşikte (tur, maliyet, güven) insana devreder.
- Tur ve maliyet tavanı
- Eşik aşımında insan devri
L3
kademe
Çok ajanlı (yönetici + uzmanlar)
Bir yönetici işi böler, uzmanlar çalışır. Güçlüdür ama hata yüzeyi katlanarak artar.
- Ajanlar arası sözleşme
- Yönetici bütçe tavanı
05ÖLÇME
Ölçme disiplini
Şimdilik ölçmeyeceğim
Risk +18Bu bir tercih değil, erteleme. Prompt değiştirdiğinizde neyi bozduğunuzu bilemezsiniz — ki çoğu iş orada batar.
- Bari 10 elle yazılmış girdi/beklenen çiftini dosyaya koyun
Altın örnek seti (25)
Risk 025 gerçek örnek + elle yazılmış beklenen sonuç. Değişiklik öncesi koşun; puan düşüşü yayına giriş demektir.
- Örnekleri kenar durumlarla doldur (boş, çok uzun, çelişkili)
- Puanlayıcıyı koda yaz, modele değerlendirme yaptırma (başlangıçta)
CI kapısı + gözetleme
Risk −6Eval seti her birleştirmede koşar; üretimde her karar satırı toplanır ve haftalık örnekleme geri beslenir.
- Kapı kırmızıysa birleştirme yok — istisna akışı yaz
- Üretimden kaç örnek geri besliyorsunuz, sayıyı sabitleyin
06KONTROL LİSTESİ
Kendi içinde kurma kontrol listesi
- 01
Karar tek dosyada
Sağlayıcı, model, sıcaklık, araç seti ve tavanlar bir ayar dosyasında. Kod değişmeden ortam değişir.
- 02
Soyutlama sızdırmaz
İki sağlayıcının hata tipleri tek bir sözleşmeye iner. Değiştirdiğinizde çağrı yerleri değil, bir adaptör değişir.
- 03
Her adım kayıtlı
Girdi, çıktı, araç çağrısı, token, maliyet, süre. Yeniden oynatılamayan bir ajan hata ayıklanamaz.
- 04
Yan etki kapısız değil
Okuma araçları serbest, yazma araçları onaylı. Kapı kodda, prompt'ta değil.
- 05
Değişiklik ölçer
Prompt veya model değiştiğinde 25 altın örnek koşar. Yeşil değilse yayına girmez.
- 06
Çıkış planı var
Yerel bir model ya da ikinci sağlayıcı, kabiliyet düşüşü ölçülmüş şekilde rafta durur.
Sonraki adım
Mimariyi okumak yetmez. Kurmak gerekir.
Bu katmanların her biri bir eğitim modülüne karşılık gelir: 1:1 çalıştayda kendi kod tabanınız üzerinden, kodu siz yazarak kurulur.