Ajanınız Şeyleri Nerede Hatırlıyor? Sohbet Geçmişi Depolama için Pratik Rehber

Emiliano Montesdeoca — Sat, 25 Apr 2026 00:00:00 +0000

Bu gönderi otomatik olarak çevrilmiştir. Orijinal sürüm için buraya tıklayın.

Bir AI ajanı oluştururken enerjinizin büyük bölümünü modele, araçlara ve istemlere harcarsınız. Konuşma geçmişinin nerede tutulduğu sorusu bir uygulama ayrıntısı gibi görünür — ancak alacağınız en önemli mimari kararlardan biridir.

Kullanıcıların konuşmaları dallandırıp dallandıramayacağını, yanıtları geri alıp alamayacağını, yeniden başlatmadan sonra oturumları devam ettirip ettiremeyeceğini ve verilerinizin altyapınızı terk edip etmediğini belirler. Agent Framework ekibi derinlemesine bir analiz yayımladı.

İki temel desen

Servis tarafından yönetilen: AI servisi konuşma durumunu depolar. Uygulamanız bir referans tutar ve servis her istekte ilgili geçmişi otomatik olarak ekler.

İstemci tarafından yönetilen: Uygulamanız tam geçmişi tutar ve her istekte ilgili mesajları gönderir. Servis durumsuzdur. Her şeyi siz kontrol edersiniz.

Agent Framework bunu nasıl soyutlar

AgentSession session = await agent.CreateSessionAsync();
var first = await agent.RunAsync("Adım Alice.", session);
var second = await agent.RunAsync("Benim adım ne?", session);

session = agent.create_session()
first = await agent.run("Adım Alice.", session=session)
second = await agent.run("Benim adım ne?", session=session)

Sağlayıcı hızlı referans

Sağlayıcı	Depolama	Model	Sıkıştırma
OpenAI/Azure Chat Completions	İstemci	Yok	Siz
Foundry Agent Service	Servis	Doğrusal	Servis
Responses API (varsayılan)	Servis	Dallanma	Servis
Anthropic Claude, Ollama	İstemci	Yok	Siz

Nasıl seçilir

Dallanma veya “geri al” gerekiyor mu? → Servis tarafından yönetilen Responses API
Veri egemenliği gerekiyor mu? → DB destekli istemci tarafından yönetilen
Basit bir sohbet botu mu? → Servis tarafından yönetilen doğrusal yeterli

Tam karar ağacı için tam makaleyi okuyun.

C# 15 Union Türlerini Alıyor — ve Bunlar Tam İstediğimiz Şey

Emiliano Montesdeoca — Sun, 05 Apr 2026 00:00:00 +0000

Bu yazı otomatik olarak çevrilmiştir. Orijinal için buraya tıklayın.

Bunu bekliyordum. C# 15, union anahtar sözcüğünü tanıtıyor — derleyici tarafından zorunlu kılınan kapsamlı desen eşleştirmeli gerçek discriminated union’lar. F#‘ın discriminated union’larını ya da Rust’ın enum’larını hiç kıskandıysanız, bunun neden önemli olduğunu tam olarak biliyorsunuzdur.

Bill Wagner, .NET bloğunda konunun derinlemesine incelemesini yayımladı ve dürüst olmak gerekirse? Tasarım temiz, pratik ve son derece C# ruhuyla örtüşüyor. Gerçekte ne olduğunu ve neden ilk bakışta göründüğünden daha büyük bir mesele olduğunu size anlatayım.

Union türlerinin çözdüğü sorun

C# 15 öncesinde, bir metottan “birkaç olası türden biri” döndürmek her zaman bir uzlaşıydı:

object — kısıtlama yok, derleyici yardımı yok, her yerde savunmacı casting
İşaretçi arayüzler — daha iyi, ama herkes bunları uygulayabilir. Derleyici kümenin tamamlanmış olduğunu asla kabul edemez
Soyut taban sınıflar — aynı sorun, üstelik türlerin ortak bir atası olması gerekiyor

Bunların hiçbiri gerçekte istediğinizi vermiyor: derleyicinin her durumu ele aldığınızı garanti ettiği kapalı bir tür kümesi. Union türlerinin yaptığı tam olarak bu.

Sözdizimi güzelce basit

public record class Cat(string Name);
public record class Dog(string Name);
public record class Bird(string Name);

public union Pet(Cat, Dog, Bird);

Tek satır. Pet, bir Cat, bir Dog veya bir Bird tutabilir. Örtülü dönüşümler otomatik olarak oluşturulur:

Pet pet = new Dog("Rex");
Console.WriteLine(pet.Value); // Dog { Name = Rex }

Ve işte sihir — derleyici kapsamlı eşleştirmeyi zorunlu kılıyor:

string name = pet switch
{
 Dog d => d.Name,
 Cat c => c.Name,
 Bird b => b.Name,
};

_ atma ifadesi gerekmiyor. Derleyici bu switch’in olası her durumu kapsadığını biliyor. Daha sonra union’a dördüncü bir tür eklerseniz, bunu ele almayan her switch ifadesi bir uyarı üretiyor. Eksik durumlar çalışma zamanında değil, derleme zamanında yakalanıyor.

Bu pratikte ne anlama geliyor

Pet örneği şirin, ama işte union’ların gerçek kodda asıl parladığı yer burası.

Farklı şekiller döndüren API yanıtları

public union ApiResult<T>(T, ApiError, ValidationFailure);

Artık her tüketici başarı, hata ve doğrulama başarısızlığını ele almak zorunda. “Hata durumunu kontrol etmeyi unuttum” hataları artık yok.

Tek değer veya koleksiyon

OneOrMore<T> deseni, union’ların yardımcı metotlarla nasıl bir gövdeye sahip olabileceğini gösteriyor:

public union OneOrMore<T>(T, IEnumerable<T>)
{
 public IEnumerable<T> AsEnumerable() => Value switch
 {
 T single => [single],
 IEnumerable<T> multiple => multiple,
 null => []
 };
}

Çağıranlar hangi form uygunsa onu kullanıyor:

OneOrMore<string> tags = "dotnet";
OneOrMore<string> moreTags = new[] { "csharp", "unions", "preview" };

foreach (var tag in tags.AsEnumerable())
 Console.Write($"[{tag}] ");
// [dotnet]

İlgisiz türleri birleştirme

Bu, geleneksel hiyerarşiler üzerindeki öldürücü özelliktir. Ortak atası olmayan türleri — string ve Exception, int ve IEnumerable<T> — union’layabilirsiniz.

Mevcut kütüphaneler için özel union’lar

İşte akıllı bir tasarım seçimi: [Union] özniteliğine sahip herhangi bir sınıf veya struct, temel deseni izlediği sürece (durum türleri için public constructor’lar ve bir Value özelliği) bir union türü olarak tanınır. OneOf gibi union benzeri türler zaten sağlayan kütüphaneler, iç yapılarını yeniden yazmadan derleyici desteğini benimseyebilir.

Değer türleriyle performans açısından kritik senaryolar için kütüphaneler, HasValue ve TryGetValue metotlarıyla boxing yapmayan erişim deseni uygulayabilir.

Büyük resim

Union türleri, C#‘a gelen daha kapsamlı bir bütünlük hikayesinin parçası:

Union türleri — kapalı bir tür kümesi üzerinde kapsamlı eşleştirme (şu an önizlemede mevcut)
Kapalı hiyerarşiler — closed değiştiricisi, tanımlayan derleme dışında türetilmiş sınıfları engelliyor (önerildi)
Kapalı enum’lar — bildirilmiş üyeler dışında değer oluşturulmasını engelliyor (önerildi)

Bu üç özellik birlikte, C#‘a herhangi bir ana akım dilde en kapsamlı tür güvenli desen eşleştirme sistemlerinden birini kazandıracak.

Bugün deneyin

Union türleri .NET 11 Preview 2’de mevcut:

.NET 11 Preview SDK‘yi yükleyin
Projenizde net11.0 hedefleyin
<LangVersion>preview</LangVersion> ayarlayın

Bir uyarı: Preview 2’de, henüz çalışma zamanında bulunmadıkları için UnionAttribute ve IUnion‘ı projenizde bildirmeniz gerekecek. Docs reposundan RuntimePolyfill.cs dosyasını alın veya şunu ekleyin:

namespace System.Runtime.CompilerServices
{
 [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct,
 AllowMultiple = false)]
 public sealed class UnionAttribute : Attribute;

 public interface IUnion
 {
 object? Value { get; }
 }
}

Sonuç

Union türleri, nasıl bu olmadan idare ettiğimizi merak ettiren özelliklerden biri. Derleyici tarafından zorunlu kılınan kapsamlı eşleştirme, temiz sözdizimi, generic desteği ve mevcut desen eşleştirmeyle entegrasyon — C# yolunda yapılmış, istediğimiz her şey bu.

.NET 11 Preview 2’de deneyin, şeyleri kırın ve GitHub’da geri bildiriminizi paylaşın. Bu önizleme aşamasında ve C# ekibi aktif olarak dinliyor. Uç durumlarınız ve tasarım geri bildiriminiz nihai sürümü şekillendirecek.

Tam dil referansı için union türleri belgelerine ve özellik spesifikasyonuna bakın.

Csharp | The .NET Blog