AI agent geliştirmek için bugün onlarca çerçeve (framework) var ve her birinin kendine göre haklı bir tasarım felsefesi bulunuyor. “Hangisi en iyisi” sorusu, “hangi veritabanı en iyisi” sorusu kadar bağlama bağlıdır. Bu yazıda LangGraph, CrewAI, AutoGen, OpenAI Agents SDK, Anthropic’in Claude Agent SDK’sı ve Semantic Kernel’ı aynı kriterlerle karşılaştırıyoruz. Ancak asıl mesajımız tablodan önce geliyor: kurumsal bir ajan projesinin başarısını çerçeve değil, mimari belirler. Çerçeve yanlış seçilirse değiştirilebilir; mimari yanlış kurulursa proje baştan yapılır.

 

Bir ajan çerçevesi ne yapar?

Çerçeveler, yapay zeka ajanının tekrar eden altyapı işlerini hazır sunar: modele araç tanımlarını iletmek, tool calling çıktısını yakalayıp aracı çalıştırmak, sonucu modele geri vermek, döngüyü yönetmek, durumu saklamak, birden fazla ajan arasında görev devretmek. Bunların hepsi çerçeve olmadan da yazılabilir; çerçeve, zaman kazandırır ve belirli bir düşünme biçimi dayatır. Bu dayatma, seçimin asıl konusudur: her çerçeve, “ajan nedir ve nasıl organize edilir” sorusuna farklı bir cevap verir.

 

Karşılaştırma tablosu

Aşağıdaki tablo, her çerçevenin temel tasarım yaklaşımını ve kamuya açık dokümantasyonunda öne çıkan özellikleri özetler. Çerçeveler hızla değişiyor; nihai karar öncesinde güncel dokümantasyona bakılmalıdır.

Çerçeve Geliştirici Temel yaklaşım Dil desteği Model bağımsızlık Güçlü yanı Dikkat edilecek nokta
LangGraph LangChain ekibi Graf / durum makinesi: düğümler ve kenarlarla açıkça tanımlanan akış Python, JavaScript Yüksek; çok sayıda model sağlayıcı Deterministik akış kontrolü, durum yönetimi, insan onayı için kesme noktaları Öğrenme eğrisi; LangChain ekosistemine aşinalık gerektirir
CrewAI CrewAI Rol tabanlı ekip metaforu: ajanlara rol, hedef ve görev atanır Python Yüksek Hızlı başlangıç, çoklu ajan senaryolarını sezgisel kurma Akış üzerinde ince kontrol için ek yapı gerekebilir
AutoGen Microsoft Konuşma tabanlı çoklu ajan: ajanlar mesajlaşarak iş birliği yapar Python (.NET desteği de duyurulmuştur) Yüksek Ajanlar arası etkileşim ve araştırma amaçlı deneyler Konuşma akışının öngörülebilirliği üretimde yönetilmelidir
OpenAI Agents SDK OpenAI Hafif ilkel yapılar: ajan, araç, devir (handoff), guardrail Python, TypeScript Öncelikle OpenAI modelleri; başka sağlayıcılar için uyumluluk katmanı Sade API, hızlı prototipleme, yerleşik izleme Ekosistem OpenAI merkezli
Claude Agent SDK Anthropic Ajan döngüsü, araç kullanımı ve MCP bağlantısı hazır gelir Python, TypeScript Claude modelleri odaklı MCP ile yerleşik entegrasyon, dosya ve komut araçları, uzun görevler Model tarafında Anthropic’e bağlılık
Semantic Kernel Microsoft Kurumsal uygulamalara yapay zeka eklemek için SDK; eklenti ve planlayıcı yapısı C#/.NET, Python, Java Yüksek .NET ve Azure ortamlarıyla uyum, kurumsal yazılım ekipleri için doğal Ajan özellikleri daha sonradan eklendi; sürüm takibi gerekir

 

Çerçevelerin dört ayrışma ekseni

1. Akış kontrolü: açık mı, modele bırakılmış mı?

LangGraph gibi graf tabanlı çerçevelerde akışı geliştirici çizer; model yalnızca düğümlerin içinde karar verir. CrewAI ve AutoGen gibi çerçevelerde akışın önemli kısmı ajanların etkileşimine bırakılır. Kurumsal süreçlerde (ERP’ye yazan, müşteriye e-posta gönderen) açık akış kontrolü öngörülebilirlik ve denetim açısından avantajlıdır. Araştırma ve içerik üretimi gibi çıktının insan tarafından okunacağı işlerde esnek akış kabul edilebilir.

2. Çoklu ajan modeli

CrewAI rol tabanlı ekip, AutoGen konuşma, OpenAI Agents SDK devir (bir ajanın görevi diğerine aktarması), LangGraph ise graf düğümleri olarak ajanlar sunar. Hangisinin uygun olduğu, mimarinizin hiyerarşik mi eşler arası mı olduğuna bağlıdır; bunu multi-agent sistem tanımı ve mimari yazımızda ele aldık. Çoğu kurumsal proje tek ajanla başlamalıdır; bu durumda çoklu ajan yeteneği seçim kriteri bile değildir.

3. Model bağımsızlık

LangGraph, CrewAI, AutoGen ve Semantic Kernel çok sayıda model sağlayıcıyla çalışacak şekilde tasarlanmıştır. OpenAI ve Anthropic SDK’ları doğal olarak kendi modelleri etrafında kurulmuştur. KVKK gereği ileride on-premise LLM‘e geçme olasılığınız varsa, model katmanının değiştirilebilirliği seçim kriterlerinin başında olmalıdır. Bu, sağlayıcı SDK’larını dışlamaz; model çağrısının mimaride soyutlanmış olmasını gerektirir.

4. Entegrasyon standardı

MCP desteği, çerçeveler arasında yaygınlaşıyor; Claude Agent SDK’da yerleşik, diğerlerinde adaptör ya da eklenti düzeyinde bulunuyor. Araçlarınızı MCP ile tanımlarsanız, çerçeve değiştirdiğinizde entegrasyonlarınızı yeniden yazmazsınız. Bu, çerçeve bağımlılığını azaltmanın en somut yoludur.

 

Neden çerçeve değil, mimari önemli?

Üretimde çalışan ajan projelerini inceleyince başarı ile başarısızlığı ayıran unsurların hiçbirinin çerçeveye özgü olmadığını görüyoruz:

  • Kapsam tanımı: Ajan tam olarak hangi işi yapıyor, hangi adımda duruyor? Hiçbir çerçeve belirsiz kapsamı kurtarmaz.
  • Araç tanımlarının kalitesi: Modelin doğru aracı doğru parametreyle seçmesi, açıklamaların netliğine bağlıdır. Bu, çerçeveden bağımsız bir yazım işidir.
  • Yetki ve onay tasarımı: Guardrail ve insan onayı kapıları, çerçevenin sağladığı kesme noktalarıyla uygulanır ama nereye konacağına süreç analizi karar verir.
  • Deterministik ile olasılıksal ayrımı: Akışın sabit kısmı kodda, yargı gerektiren kısmı modelde. Bu ayrımı yanlış yapan proje, hangi çerçeveyle yazılırsa yazılsın pahalı ve öngörülemez olur.
  • Gözlemlenebilirlik: Her kararın loglanması, ölçülmesi ve iyileştirilmesi. Çerçeveler izleme araçları sunar; ne ölçüleceğine siz karar verirsiniz.
  • Değiştirilebilirlik: Model, çerçeve ve araç katmanlarının birbirinden ayrılması. İyi mimaride çerçeve değişikliği, ajanın mantığını etkilemez.

Bizim yaklaşımımız

Projelerde çerçeveyi ekibin mevcut teknoloji yığınına, akış kontrolü ihtiyacına ve model stratejisine göre seçiyoruz; tek bir çerçeveye bağlı değiliz. Değişmeyen tarafımız mimari ilkelerdir: model katmanı soyutlanır, araçlar MCP ile tanımlanır, akışın sabit kısmı deterministik kodda tutulur, her karar loglanır ve geri alınamaz adımlar onay kapısından geçer. Kendi ürünlerimiz olan SellBox ve Teklif Robotu da bu ilkelerle çalışır; çerçeve, bu ilkelerin uygulama aracıdır.

 

Seçim için pratik sorular

  • Ekibiniz hangi dilde çalışıyor? .NET ağırlıklı bir kurumsal ekip için Semantic Kernel doğal; Python ekibi için seçenek daha geniş.
  • Akışı önceden çizebiliyor musunuz? Evet ise graf tabanlı yaklaşım; hayır ise akışın niye belirsiz olduğunu önce süreç analiziyle çözün.
  • Model stratejiniz ne? Tek sağlayıcıya bağlı kalmayı kabul ediyorsanız sağlayıcı SDK’ları hızlıdır; on-premise ihtimali varsa model bağımsız çerçeve ya da soyutlama katmanı şart.
  • Kaç ajan gerekiyor? Tek ajan için çoklu ajan yetenekleri gereksizdir; sade bir çerçeve ya da doğrudan SDK yeterli olabilir.
  • Entegrasyonlar nasıl tanımlanacak? MCP ile tanımlarsanız çerçeve kararı geri alınabilir hâle gelir.

Bu soruları süreç keşfi aşamasında birlikte cevaplıyoruz; kurumsal yapay zeka danışmanlığı hizmetimiz çerçeve seçimini de kapsar. Geliştirme yaklaşımımız için yapay zeka ajanları sayfamıza bakabilirsiniz.

 

Çerçeve seçiminde üretim kriterleri

Prototip aşamasında her çerçeve iyi görünür; fark üretimde ortaya çıkar. Nihai karar öncesinde şu başlıkları çerçevenin güncel dokümantasyonunda ve mümkünse küçük bir deneme projesinde kontrol edin:

  • Durum kalıcılığı: Uzun süren bir görev yarıda kesildiğinde (sunucu yeniden başladı, onay bekleniyor) kaldığı yerden devam edebiliyor mu? İnsan onayı kapıları için bu zorunludur.
  • Kesme noktaları: Akışın belirli bir adımında durup dış girdi beklemek ve sonra devam etmek çerçevede doğal bir yapı mı, yoksa geçici çözüm mü?
  • İzlenebilirlik: Her model çağrısı, araç çağrısı ve ara durum, dışarıdaki bir izleme sistemine aktarılabiliyor mu? Denetim izi buradan beslenir.
  • Sürüm kararlılığı: Çerçevenin API’si ne sıklıkla kırıcı değişiklik yapıyor? Hızla gelişen çerçevelerde bu, bakım maliyetine doğrudan yansır.
  • Test edilebilirlik: Model çağrılarını sahte yanıtlarla değiştirip akışı deterministik biçimde test edebiliyor musunuz?

Bu kriterlerin hiçbiri “hangi çerçeve daha popüler” sorusuyla ilgili değildir. Üretimde yaşayacak bir ajan için popülerlik, topluluk desteği anlamına geldiği ölçüde değerlidir; onun dışında bir seçim kriteri değildir.

 

Sık sorulan sorular

Çerçeve kullanmadan ajan yazılabilir mi?

Evet. Model sağlayıcılarının API’leri tool calling’i doğrudan destekler; döngü, durum yönetimi ve loglama birkaç yüz satır kodla yazılabilir. Dar kapsamlı tek ajanlar için bu yaklaşım, çerçeve bağımlılığı taşımadığı için tercih edilebilir. Çerçeve, karmaşıklık arttıkça değer kazanır.

Çerçeveyi sonradan değiştirmek zor mu?

Mimariye bağlıdır. Araçlar MCP ile tanımlanmış, model çağrısı soyutlanmış ve iş mantığı çerçeveden ayrı tutulmuşsa değişim yönetilebilir bir eforla yapılır. İş mantığı çerçevenin yapılarına gömülmüşse değişim yeniden yazma demektir.

Açık kaynak çerçeve mi, sağlayıcı SDK’sı mı?

Açık kaynak çerçeveler model bağımsızlık ve topluluk desteği sağlar; sağlayıcı SDK’ları kendi modelleriyle en sorunsuz deneyimi ve yerleşik izleme araçlarını sunar. KVKK nedeniyle on-premise ihtimali olan kurumlarda model bağımsızlık ağır basar.

Türkçe için çerçeve farkı var mı?

Türkçe kalitesi çerçeveye değil modele bağlıdır. Çerçeve yalnızca modelle sistem arasındaki altyapıdır. Türkçe performansı model seçimi aşamasında, gerçek verinizle pilotta ölçülmelidir.

 

Önce mimari, sonra çerçeve

Otuz dakikalık bir görüşmede sürecinizi, teknoloji yığınınızı ve model stratejinizi birlikte değerlendirip hangi mimarinin ve hangi çerçevenin uygun olduğunu netleştirelim. Taahhüt gerektirmez.

Ücretsiz keşif görüşmesi planlayın → Kuruma özel geliştirme için özel yapay zeka çözümleri sayfamıza göz atabilirsiniz.