LangGraph, araç kullanımı ve değerlendirmeyle üretim seviyesinde ajanik sistemler
Araç kullanımı, retrieval, değerlendirme ve gözlemlenebilirlik içeren sınırlı LangGraph iş akışları — otonom demolar değil.
İlgili: ajanik yetenekler
Özet
Bu sayfa LMXAI'nin üretim için ajanik sistemleri nasıl tasarlayıp geliştirdiğini anlatır: LangGraph'ta açık kontrol akışı, tipli şemaların arkasında araç kullanımı, erişim kontrollü retrieval, yayından önce değerlendirme ve işletimde izleme (tracing). Yaklaşımı, mevcut modellerin uzun vadeli ve çok turlu görevlerde hâlâ başarısız olduğunu gösteren ajan güvenilirliği araştırmalarına yerleştirir; bir ajanın ne zaman doğru tasarım olduğunu ve bir çalışmanın ne teslim ettiğini açıklar.
Anahtar kelimeler ajanik sistemler · LangGraph · araç kullanımı · değerlendirme · gözlemlenebilirlik · MCP
İçindekiler
- Giriş
- Arka plan ve ilgili çalışmalar
- Bir ajanik sistemi üretime hazır yapan nedir?
- Kontrolsüz özerklik olmadan LangGraph
- Bir mühendislik arayüzü olarak araç kullanımı
- Ajanlar için retrieval
- Üretimden önce değerlendirme
- Gözlemlenebilirlik ve denetlenebilirlik
- Örnek mimari
- LMXAI'nin ilgili deneyimi
- Ne zaman bir ajan kullanmalısınız?
- Tipik bir çalışmanın teslim ettikleri
- İlgili okumalar
- Sistemi yalnızca prototiplemeyecek, kuracak bir AB ekibine mi ihtiyacınız var?
Giriş
LMXAI, LangGraph, kontrollü araç kullanımı, retrieval, değerlendirme ve gözlemlenebilirlikle üretim seviyesinde ajanik sistemler tasarlayan ve geliştiren, AB merkezli bir AI mühendislik stüdyosudur. Odak otonom demolarda değil; gerçek iş ortamlarında test edilebilen, izlenebilen ve güvenle işletilebilen sınırlı iş akışlarındadır.
Leiden, Hollanda merkezli LMXAI; mimari, backend mühendisliği, model entegrasyonu, RAG, çıkarım ve ürün teslimatı alanlarında çalışır. Böylece ajan katmanı, gerçekten kullanması gereken sistemlerle birlikte tasarlanır.
Arka plan ve ilgili çalışmalar
Modern ajan döngüsü, bir dil modelinin akıl yürütmeyi dış kaynaklara yönelik eylemlerle dönüşümlü yürüttüğünde çok adımlı görevlerde daha iyi sonuç verdiğini gösteren çalışmalardan gelir; model böylece plan yapabilir, istisnaları yönetebilir ve eksik bilgiyi toplayabilir[1]. Sistematik bir derleme, bu fikir üzerine kurulan sistemleri ortak bir yapı çerçevesi etrafında düzenler ve nasıl değerlendirildiklerini inceler[2].
Değerlendirme sonuçları, LMXAI'nin özerkliği neden sınırladığını açıklar. AgentBench, sekiz ortamda, zayıf uzun vadeli akıl yürütmeyi, karar vermeyi ve talimat takibini kullanılabilir ajanların önündeki temel engeller olarak belirler[3]. τ-bench'te en gelişmiş function-calling ajanları görevlerin yarısından azını tamamlamış ve tekrarlanan denemelerde tutarsız kalmıştır[4]. Çağrıları yapısal olarak kontrol eden Berkeley Function Calling Leaderboard, modellerin tek turlu çağrıları iyi yönettiğini, ancak bellek, dinamik kararlar ve uzun vadeli görevlerde hâlâ zorlandığını bulur[5].
Araç erişimi saldırı yüzeyini de genişletir: getirilen içeriğe gizlenmiş talimatlar, saldırgan sisteme hiç doğrudan seslenmeden bir modeli yönlendirebilir ve araç çağrılarını tetikleyebilir[6]. Açık grafikler, şemaya göre denetlenen araç çağrıları, onay kapıları ve yayından önce değerlendirme bu bulgular yüzündendir.
Bir ajanik sistemi üretime hazır yapan nedir?
Bir üretim ajanı, araçlara bağlanmış bir LLM'den fazlasına ihtiyaç duyar. Modelin neye karar verebileceği, neye erişebileceği, hataların nasıl ele alınacağı ve kalitenin nasıl ölçüleceği üzerinde açık kontrol gerekir.
LMXAI bir ajanik sistemi genellikle birbirine bağlı altı katman olarak ele alır:
- Orkestrasyon — durum, yönlendirme, yeniden denemeler, dallanma ve deterministik adımlar.
- Model katmanı — görev kalitesi, gecikme, gizlilik ve maliyete göre seçilen bir veya daha fazla model.
- Araçlar — iç API'ler, arama, veritabanları, doküman servisleri, MCP sunucuları ve iş eylemleri.
- Retrieval — kaynak gösterimi ve erişim kontrolleriyle ilgili iç veya dış bilgi.
- Değerlendirme — araç seçimi, görev tamamlama, dayanaklılık ve hata durumları için tekrarlanabilir testler.
- Gözlemlenebilirlik ve yönetişim — izler, kayıtlar, izinler, onaylar ve operasyonel metrikler.
LangGraph işe yarar, çünkü tüm iş akışını uzun bir prompt'un içine saklamak yerine durumu ve kontrol akışını açık hale getirmemizi sağlar.
Kontrolsüz özerklik olmadan LangGraph
LMXAI, LangGraph'ı bir iş akışının model kararlarından fayda sağladığı ama yine de mühendislik kontrolü gerektirdiği yerlerde kullanır.
Örnekler:
- bir isteği doğru araca veya bilgi kaynağına yönlendirmek;
- karmaşık bir görevi sınırlı adımlara bölmek;
- ilk sonuç zayıfsa ek kanıt getirmek;
- sonuç doğuran bir eylemden önce onay istemek;
- araç çıktısını bir sonraki düğüme ulaşmadan doğrulamak;
- güven veya politika koşulları sağlanmadığında bir insana yükseltmek.
Amaç azami özerklik değildir. Amaç, görevi güvenilir biçimde çözmek için gereken asgari özerkliktir.
Bir mühendislik arayüzü olarak araç kullanımı
Araç çağırma, bir ajanın gerçek sistemlerle etkileşime başladığı yerdir; bu yüzden araç tasarımı prompt tasarımı kadar önemlidir.
LMXAI araçları şunlarla tasarlar:
- dar, açık şemalar;
- doğrulanmış girdi ve çıktılar;
- kapsamı belirlenmiş izinler;
- eylemlerin tekrarlanabileceği yerlerde idempotentlik;
- öngörülebilir hata sözleşmeleri;
- araç çağrılarının denetlenebilirliği;
- zaman aşımları ve geri dönüş davranışı;
- yüksek etkili eylemler için onay kapıları.
Araçlar doğrudan API'ler, iç servis sarmalayıcıları veya birlikte çalışabilirlik faydalıysa MCP üzerinden sunulabilir. Model hiçbir zaman görevin gerektirdiğinden geniş bir erişim almamalıdır.
Ajanlar için retrieval
Ajanik sistemler çoğu zaman tek bir sabit vektör indeksini sorgulamak yerine birden fazla veri kaynağı arasında seçim yapmak zorundadır. LMXAI şunları birleştirebilir:
- dense ve sparse retrieval;
- hibrit arama;
- Elasticsearch veya diğer kurumsal arama altyapıları;
- meta veriye ve izinlere duyarlı retrieval;
- sorgu yeniden yazma ve ayrıştırma;
- çoklu indeks yönlendirmesi;
- yanıt üretilmeden önce kaynak doğrulaması.
Bu, retrieval'ı genel bir "arama aracı" olmaktan çıkarıp kontrollü bir ilgililik katmanına dönüştürür.
Üretimden önce değerlendirme
Bir ajan, elle test edilen birkaç konuşma iyi gitti diye hazır olmaz. LMXAI değerlendirmeyi sistemin gerçekten vermesi gereken kararlar etrafında kurar.
Kullanım senaryosuna göre değerlendirme şunları içerebilir:
- görev tamamlama oranı;
- doğru araç seçimi;
- araç argümanlarının doğruluğu;
- retrieval recall ve dayanaklılık;
- atıf doğruluğu;
- reddetme ve yükseltme davranışı;
- döngü ve yeniden deneme oranları;
- gecikme ve token maliyeti;
- model veya prompt değişikliklerinde regresyon testleri.
Araç kullanan sistemler için LMXAI ayrıca BFCL'den türetilmiş function-calling testleri gibi benchmark tarzı değerlendirme kalıplarıyla, müşterinin gerçek iş akışlarını yansıtan alana özgü test setlerini birleştirerek çalışır.
Gözlemlenebilirlik ve denetlenebilirlik
Üretim ajanlarının bir iş akışında ne olduğunu açıklayan izlere ihtiyacı vardır. LMXAI ajan çalıştırmalarını OpenTelemetry ve Phoenix gibi teknolojilerle donatabilir; böylece ekipler model çağrılarını, araç çağrılarını, retrieval adımlarını, gecikmeyi, hataları ve token kullanımını inceleyebilir.
Bu, ajanlar düzenlemeye tabi veya riskin yüksek olduğu alanlarda çalıştığında özellikle önemlidir. Bir ekip, bir model hatasını retrieval hatasından, araç hatasından, izin sorunundan veya orkestrasyon hatasından ayırabilmelidir.
Örnek mimari
Tipik bir sistem şöyle görünebilir:
Kullanıcı veya uygulama → API → LangGraph iş akışı → model/yönlendirici → retrieval + araçlar → doğrulama/onay → yanıt veya iş eylemi
İş akışının tamamında kimlik, izinler, izler, değerlendirme ve politika kontrolleri bulunur.
Son mimari öncü API'lerle, kendi barındırılan açık modellerle veya hibrit bir kurulumla çalışabilir. LMXAI modelden bağımsızdır; veri yerleşimi veya altyapı kontrolü gerektirdiğinde vLLM ve Kubernetes ile egemen çıkarım yığınları da kurar.
LMXAI'nin ilgili deneyimi
LMXAI kurumsal, eğitim ve sağlık alanlarında üretim sistemleri kurmuştur:
- egemen çıkarımlı kurumsal AI çalışma alanları;
- LangGraph tabanlı ajanik iş akışları;
- MCP ve özel araç entegrasyonları;
- kurumsal retrieval'lı RAG sistemleri;
- çok modlu araç kullanımı ince ayarı;
- akış (streaming), izolasyon ve gözlemlenebilirlik sunan AI gateway'leri.
Mühendislik yığını LangGraph, LangChain, MCP, FastAPI, Elasticsearch, vLLM, Kubernetes, OpenTelemetry ve Phoenix'i içerir.
Ne zaman bir ajan kullanmalısınız?
Ajanik mimari, bir görev araçlar, kaynaklar veya iş akışı yolları arasında dinamik kararlar gerektirdiğinde işe yarar. Deterministik bir servis, sabit bir hat (pipeline) veya normal bir arama uç noktası sorunu daha güvenilir çözebiliyorsa çoğu zaman gereksizdir.
Bu yüzden LMXAI işe iş akışından başlar ve model akıl yürütmesinin gerçekte nerede değer kattığını sorar. Otonom karmaşıklık yalnızca operasyonel maliyetini hak ettiğinde eklenir.
Tipik bir çalışmanın teslim ettikleri
Bir üretim çalışması şunları kapsayabilir:
- iş akışı ve mimari tasarımı;
- LangGraph uygulaması;
- araç ve MCP entegrasyonu;
- retrieval mimarisi;
- model seçimi ve yönlendirme;
- değerlendirme veri setleri ve yayın kapıları;
- gözlemlenebilirlik ve izleme;
- izinler ve insan onayı akışları;
- dağıtım, yük testi ve üretime sağlamlaştırma;
- dokümantasyon ve devir.
İlgili okumalar
Sistemi yalnızca prototiplemeyecek, kuracak bir AB ekibine mi ihtiyacınız var?
LMXAI, ajanik bir ürünü iş akışı tasarımından üretim mimarisine, uygulamaya, değerlendirmeye ve dağıtıma kadar tek bir mühendislik sahibi altında taşıyabilir.
Kaynakça
- Yao, S., Zhao, J., Yu, D., Du, N., Shafran, I., Narasimhan, K., & Cao, Y. (2023). ReAct: Synergizing reasoning and acting in language models. International Conference on Learning Representations (ICLR 2023). arxiv.org/abs/2210.03629
- Wang, L., Ma, C., Feng, X., Zhang, Z., Yang, H., et al. (2024). A survey on large language model based autonomous agents. Frontiers of Computer Science, 18(6). doi:10.1007/s11704-024-40231-1 arxiv.org/abs/2308.11432
- Liu, X., Yu, H., Zhang, H., Xu, Y., Lei, X., et al. (2024). AgentBench: Evaluating LLMs as agents. International Conference on Learning Representations (ICLR 2024). arxiv.org/abs/2308.03688
- Yao, S., Shinn, N., Razavi, P., & Narasimhan, K. (2024). τ-bench: A benchmark for tool-agent-user interaction in real-world domains. arXiv preprint arXiv:2406.12045. arxiv.org/abs/2406.12045
- Patil, S. G., Mao, H., Yan, F., Ji, C. C.-J., Suresh, V., Stoica, I., & Gonzalez, J. E. (2025). The Berkeley Function Calling Leaderboard (BFCL): From tool use to agentic evaluation of large language models. Proceedings of the 42nd International Conference on Machine Learning (ICML 2025), PMLR 267. proceedings.mlr.press/v267/patil25a.html
- Greshake, K., Abdelnabi, S., Mishra, S., Endres, C., Holz, T., & Fritz, M. (2023). Not what you've signed up for: Compromising real-world LLM-integrated applications with indirect prompt injection. Proceedings of the 16th ACM Workshop on Artificial Intelligence and Security (AISec '23). doi:10.1145/3605764.3623985 arxiv.org/abs/2302.12173
Her kaynak yayıncı, arXiv veya resmî kayıt üzerinden doğrulanmıştır.