TEMSİLÎ VAKA · LOJİSTİK
Fiyat sorgusu ajanında çok ajanlı iş bölümü
Spot taşıma fiyatı sorguları serbest metin olarak geliyordu: e-posta, portal formu, telefon notu. Bir teklifi kurmak için yük tarifinin normalize edilmesi, mod ve rota seçimi, hat tarifesi, ek kalemler, gümrükleme hizmeti, sigorta ve müşterinin ticari durumu ayrı ayrı ele alınmak zorundaydı. İlk kurulan tek ajanlı akış bu uzunlukta kayboluyordu: aynı aracı tekrar tekrar çağırıyor, önceki adımın sonucunu unutuyor ve sonunda kalemleri eksik bir teklif metni üretiyordu. Eksik kalemin hangi adımda düştüğü de akış kaydından çıkarılamıyordu.
Beklenen etki
- İzlenebilirlik
- Her teklif kaleminin hangi ajan tarafından hangi turda yazıldığı iş emri kaydından okunabiliyor
- Ölçüm
- İnsana devir bir hata değil ayrı bir sonuç sınıfı olarak izleniyor; devir sebepleri ayrıştırılmış durumda
- Karar sınırı
- İskonto ve kredi limiti kararı yetki matrisinde kaldı; ajanlar bu alanlara yazamıyor
- Kapsam
- Karayolu ve intermodal parsiyel taleplerde çalışıyor; tehlikeli madde ve proje yükü doğrudan insana gidiyor
Temsilî senaryo: buradaki satırlar ölçüm sonucu değil, bu kurulumda hangi büyüklüğün izlenmesi gerektiğini gösterir.
Bu kayıt gerçek bir müşteri işi değildir. Sinaptik Lab'in bu problemde izlediği yaklaşımı, mimari kararları ve ölçüm düzenini göstermek için yazılmış temsilî bir senaryodur: kurum adı taşımaz, içindeki hiçbir değer gerçek ölçüm değildir ve referans olarak gösterilemez. Gerçek projelerden vakalar müşteri onayı alındıkça bu kütüphaneye eklenir.
Problem
Spot taşıma fiyatı sorguları serbest metin olarak geliyordu: e-posta, portal formu, telefon notu. Bir teklifi kurmak için yük tarifinin normalize edilmesi, mod ve rota seçimi, hat tarifesi, ek kalemler, gümrükleme hizmeti, sigorta ve müşterinin ticari durumu ayrı ayrı ele alınmak zorundaydı. İlk kurulan tek ajanlı akış bu uzunlukta kayboluyordu: aynı aracı tekrar tekrar çağırıyor, önceki adımın sonucunu unutuyor ve sonunda kalemleri eksik bir teklif metni üretiyordu. Eksik kalemin hangi adımda düştüğü de akış kaydından çıkarılamıyordu.
Yaklaşım
Akış, tek bir uzun düşünme zinciri yerine sorumluluğu bölünmüş ajanlara dağıtıldı: talep normalizasyonu, tarife, ek kalemler, mevzuat ve izin uygunluğu, ticari değerlendirme. Ajanlar birbirine serbest metinle değil tipli bir iş emri belgesiyle devrediyor; her ajanın yazabileceği alanlar tanımlı, başka alana yazamıyor. Durma kararı modelde değil kodda duruyor: adım bütçesi, aynı araç ve argüman imzasının yinelenmesi tespiti ve 'her devirde iş emrinde en az bir alan dolacak' ilerleme ölçütü koordinatörde deterministik olarak işliyor. Bu koşullardan biri tetiklendiğinde akış hata vermiyor, tasarlanmış çıkışa gidiyor ve talep fiyatlandırma uzmanına devrediliyor. Teklifin gönderilmesi her durumda insan onayına bağlı kaldı, çünkü fiyat gönderildiği anda ticari bir taahhüt doğuyor.
Kullanılan teknolojiler
- Görev başına dar ajan
- Tipli devir sözleşmesi
- Alan sahipliği olan paylaşımlı iş emri
- Adım bütçesi ve döngü tespiti
- Tasarlanmış insana devir
- Eksiksizlik kapısı
Bağlam, kurulum ve ölçüm
Problem ve yaklaşım özetin üstünde; burada kararların gerekçesi ve mimarinin ayrıntısı var.
Bağlam ve kısıtlar#
Parsiyel ve komple taşıma fiyatı, hat tarifesi ile ek kalemlerin toplamı olarak kuruluyor: terminal ve liman masrafı, yakıt endeksi, tehlikeli madde ilavesi, bekleme, gümrükleme hizmeti, sigorta. Bunların bir kısmı müşteriye özel anlaşmada, bir kısmı güncel tarifede, kalanı operasyon uzmanının deneyiminde duruyordu. Otomasyonun duracağı yer baştan belli: fiyat gönderildiği anda ticari bir taahhüt doğuyor, iskonto ve kredi limiti yetkisi de kişiye bağlı. Dolayısıyla hedef otomatik teklif değil, insanın önüne eksiksiz ve izlenebilir bir teklif taslağı koymaktı.
Veri ve erişim#
Fiyatı kuran veri dört yerde duruyordu: hat ve tarife verisi tarife yönetiminde, müşteriye özel anlaşmalar sözleşme kaydında, kredi limiti ve risk durumu finans tarafında, sefer ve kapasite durumu operasyon sisteminde. Bu dağınıklığın asıl sonucu teknik değil yetkiseldi: müşteriye özel tarife ticari sır ve herkes göremiyor. Bu yüzden ajanlar kendi servis kimliğiyle değil, talebi açan kullanıcının yetki kapsamıyla çalışıyor; bir satış temsilcisinin doğrudan göremediği bir tarife ajan üzerinden de görünmüyor. Yetki dışı kalan alan boş bırakılıp iş emrinde soru olarak açılıyor.
- Hat ve tarife verisi: geçerlilik tarihli kayıtlar; süresi geçmiş tarife ajana hiç verilmiyor
- Müşteriye özel anlaşma ve iskonto: sözleşme kaydında, ticari sır kapsamında, yetkiye bağlı
- Kredi limiti ve risk durumu: finans tarafında; ajana yalnızca 'uygun / kontrol gerekiyor' biçiminde okunuyor, tutar açılmıyor
- Sefer ve kapasite durumu: operasyon sisteminde, tarih aralığı bazında sorgulanıyor
- Gelen talep metni ve ekleri: içeriği veri olarak işlenir, talimat olarak değil
Mimari kararlar#
Çok ajanlı yapının amacı zekâyı artırmak değil, sorumluluğu bölmekti: dar bir araç kümesiyle çalışan bir ajan yanlış araç seçmiyor ve hangi kalemi kimin yazdığı sonradan okunabiliyor. Bölmenin bedeli koordinasyon; bu bedel iki yerde ödendi: devir belgesinin tiplenmesi ve durma koşullarının koda alınması. Aşağıdaki kararların her biri, tek ajanlı sürümde gözlenmiş belirli bir başarısızlık kipine karşılık geliyor.
| Karar | Seçilen yol | Neden |
|---|---|---|
| Tek ajan mı, bölünmüş ajanlar mı | Görev başına dar ajan ve bir koordinatör | Akış uzayıp araç kümesi büyüdükçe yanlış araç seçimi ve tekrar çağrı artıyor |
| Devir biçimi | Tipli iş emri belgesi; serbest metin devri yasak | Serbest devirde bilgi sessizce düşüyor ve kaybın yeri bulunamıyor |
| Paylaşımlı durum | Tek iş emri, alan bazında sahiplik | İki ajanın aynı alana yazması son yazanın kazandığı bir yarış üretti |
| Durma koşulu | Kodda: adım bütçesi, imza yinelemesi, ilerleme ölçütü | Model kendi döngüsünü güvenilir biçimde fark etmiyor |
| Eksik bilgi | Uydurulmaz; iş emrinde soru olarak açılır | Yanlış fiyat, eksik fiyattan daha pahalı |
| Yetki | Ajan, talebi açan kullanıcının yetki kapsamıyla çalışır | Servis kimliğiyle çalışan ajan, kullanıcının göremediği tarifeyi dolaylı olarak sızdırıyor |
Güvenlik ve yetki#
Burada korunan şey ağırlıkla kişisel veri değil ticari sır: müşteriye özel tarife, iskonto aralığı ve risk durumu. Yetki kapsamının ajana taşınması bu yüzden mimarinin merkezinde; ek olarak ajanların hangi tarifeye hangi talep için baktığı denetim izine yazılıyor. İkinci risk sınıfı gelen metinden geliyor: müşteri e-postası ve ekleri talimat gibi okunabilecek cümleler içerebiliyor. Akışta gelen içerik ayrı bir güven seviyesinde işaretli, araç çağırma yetkisi yalnızca sistem tarafında tanımlı ve ekten çıkan metin de aynı sınıfa giriyor. Kişisel veri tarafında ise talep metnindeki iletişim bilgileri fiyatlandırma adımlarına hiç geçmiyor.
Ölçüm düzeni#
- Sonuç dağılımı: eksiksiz taslak, soru üretildi, insana devredildi — üçü ayrı sonuç sınıfı
- Durma sebepleri: adım bütçesi, imza yinelemesi, ilerleme yok, yetki dışı alan
- Eksiksizlik denetimi: insan onay ekranında hangi kalemin eklendiği veya düzeltildiği
- Araç çağrısı hata sınıfları: şema dışı argüman, zaman aşımı, süresi geçmiş tarife talebi
- Devir kaybı denetimi: iş emri alanlarının turlar arasında boşalıp boşalmadığı otomatik kontrol ediliyor
Devreye alma ve işletme#
- 1Tek ajanlı taban
Mevcut akış ölçüm altına alındı; düşen kalemler ve kayıp yerleri sınıflandırıldı
- 2Bölme
Normalizasyon ve tarife ajanları ayrıldı, aralarındaki devir şeması yazıldı
- 3Durma mekanizmaları
Adım bütçesi, imza yinelemesi ve ilerleme ölçütü koordinatöre kod olarak eklendi
- 4Dar kapsamla canlı
Tek hat ailesinde parsiyel taleplerle açıldı; tehlikeli madde ve proje yükü kapsam dışı bırakıldı
- 5Onay ekranı geri beslemesi
Uzmanın düzelttiği kalemler haftalık gözden geçirmeye girdi ve devir şemasını güncelledi
Nerede yanıldık#
İlk tasarımda ajanlar birbirine serbest metin özetiyle devrediyordu ve koordinatörün kendisi de bir dil modeliydi. İki sonuç birlikte geldi: bilgi devirlerde sessizce düştü, döngüler de kimse durdurmadığı için uzun uzun devam etti. Devir belgesini tiplemek kaybı hata hâline getirdi, durma koşullarını koda taşımak da döngüyü bir sonuç sınıfına çevirdi; ikisi de model değiştirerek çözülemeyecek problemlerdi.
Sonra 'daha çok ajan daha iyi' varsayımına kapıldık. Her yeni ajan gecikme ve maliyet ekledi, üstelik bazılarının işi hiç model gerektirmiyordu; hacim ağırlığı ve mesafe hesabı deterministik servise indirildi. Üçüncüsü değerlendirme kümesiydi: kümeyi kolay taleplerden kurmuşuz, çoklu modlu ve karışık gümrük durumu olan talepler hiç yoktu. Zor talepleri kümeye koyduğumuzda başarısızlık kiplerinin çoğunun tarife tarafında değil normalizasyon adımında oluştuğu görüldü.
Bir sonraki projede ne değişir?
Bir vakanın en değerli bölümü sonuç değil, tekrar edilebilir dersidir.
- 01
Ajanları serbest metinle konuşturmak en pahalı hata oldu. 'Tehlikeli madde yok' bilgisi iki devir sonra kayboluyor ve kimse kaybı fark etmiyor; devir belgesi tipli hâle geldiğinde aynı kayıp şema hatası olarak görünür oldu.
- 02
Döngü kararını koordinatör modele bırakmak işe yaramıyor. Model kendi döngüsünü fark etmekte kötü; adım bütçesi ve araç çağrısı imza yinelemesi kontrolü kodda olmalı.
- 03
Ajan sayısını artırmak doğruluk getirdi ama gecikme ve maliyet de getirdi. Bazı ajanların işi zaten deterministikti — hacim ağırlığı hesabı ya da mesafe sorgusu için model gerekmiyordu, bunlar servise indirildi.
- 04
İnsana devri başarısızlık sayan bir ölçüm düzeni ekibi yanlış yöne itiyor. Devir tasarlanmış bir sonuç olarak sayılmaya başlandığında eksik kalemli teklif üretme baskısı düştü.
- 05
Aynı alana iki ajanın yazabilmesi, son yazanın kazandığı sessiz bir yarış üretti. Alan sahipliği tanımlanmadan paylaşımlı durum güvenilir değil.
Vaka kütüphanesinden
- EğitimDers materyali üretiminde telif ve kaynak zinciriBir eğitim içeriği ekibinin slayt, çalışma kâğıdı ve ders notu arşivi yıllar içinde karışık kaynaklardan büyümüştü: internetten alınmış görseller, yabancı kitaplardan çevrilmiş paragraflar, farklı lisanslarla dolaşan açık ders materyalleri. Bir hak sahibi itiraz ettiğinde hangi paragrafın nereden geldiğini kimse söyleyemiyor; arama dosya adına ve ekip hafızasına kalıyordu. Model destekli üretim devreye girdikten sonra bu belirsizlik büyüdü, çünkü üretilen metnin dayandığı kaynak hiçbir yerde yazılı olmuyordu. Ekipte yaygın olan eğitim amaçlı kullanım serbesttir varsayımı da hiç denetlenmemiş bir varsayımdı.
- EğitimÖdeve biçimlendirici geri bildirim üretimiBir özel okul grubunda dil ve sosyal bilimler öğretmenleri her hafta çok sayıda yazılı ödev okuyordu; not zamanında giriliyordu ama öğrenciye dönen şey bir puan ile kısa bir genel yorumdu. Hangi öğrencinin hangi rubrik ölçütünde tekrar tekrar zorlandığı hiçbir yerde toplu olarak durmuyordu; öğretmen bunu kendi defterindeki izlenimden hatırlıyordu. Geri bildirim yazma işi mesai dışına taştığı için dönem başındaki ödevlerde ayrıntılı, dönem sonuna doğru tek cümleye inen bir kalite farkı oluşuyordu. Velinin gördüğü tabloda puan vardı, gerekçe yoktu.
- EğitimÖğrenci risk modelinde etik sınırlarBir yükseköğretim kurumunda akademik danışmanlar, dersi bırakma ya da kayıt yenilememe riski taşıyan öğrencilere ulaşmayı sezgiyle yapıyordu: yokluğu fark edilen öğrenciye yazılıyor, fark edilmeyen kimseye görünmüyordu. Devam bilgisi, ödev teslimleri ve öğrenme yönetim sistemi hareketleri ayrı sistemlerde durduğu için kimse bunları tek bir öğrenci için yan yana koymuyordu. Danışmanın haftada yapabileceği görüşme sayısı sınırlıydı ama bu sınırın kime harcandığı hiçbir kayıtta yoktu. Risk modeli gündeme geldiğinde ilk itiraz teknik değildi: skor öğrenciye yapışan bir etikete dönerse ne olacağı soruldu.
BUILD
Aynı yaklaşımı kurumunuzda kurmak ister misiniz?
Discovery oturumunda mevcut durumunuzu, veri erişiminizi ve başarı tanımınızı birlikte yazıyoruz.
