C# İle Yapay Zeka Tabanlı Metin Özetleme Uygulaması Nasıl Yapılır?

Gereksinimler ve Ön Hazırlık

Projeye başlamadan önce geliştirme ortamınızın güncel olduğundan emin olmalısınız. 2026 standartlarında, performanslı bir yapay zeka uygulaması için aşağıdaki araçlara ihtiyacınız vardır:

• .NET 9 SDK veya üzeri: En güncel performans iyileştirmelerini içerir.
• Visual Studio 2022 (v17.12+) veya VS Code: C# geliştirme deneyimi için optimize edilmiştir.
• Semantic Kernel Kütüphanesi: Yapay zeka modelleriyle C# kodunu bağlayan temel kütüphane.
• OpenAI veya Azure OpenAI API Anahtarı: Metin işleme yeteneği için gerekli olan model erişimi.

Projenizi oluşturmak için terminal ekranınızda şu komutu çalıştırarak başlayın:

dotnet new console -n MetinOzetlemeUygulamasi
cd MetinOzetlemeUzetlemeUygulamasi
dotnet add package Microsoft.SemanticKernel

Bu komutlar, C# projenizi başlatır ve yapay zeka ile konuşmanızı sağlayacak olan Semantic Kernel kütüphanesini projenize dahil eder.

Yapay Zeka Servis Konfigürasyonu

Yapay zeka modellerine bağlanırken en kritik nokta, API anahtarlarını kod içerisine doğrudan yazmamaktır. Bu güvenlik riski oluşturur. Bunun yerine, appsettings.json dosyasını kullanmalı veya ortam değişkenlerinden yararlanmalısınız.

Aşağıdaki kod bloğu, Semantic Kernel'ı başlatmak ve modelle bağlantı kurmak için gerekli olan temel yapılandırmayı gösterir:

using Microsoft.SemanticKernel;

var builder = Kernel.CreateBuilder();
builder.AddOpenAIChatCompletion(
    modelId: "gpt-4o",
    apiKey: "YOUR_API_KEY_HERE"
);

var kernel = builder.Build();

Bu yapılandırma, uygulamanızın hangi yapay zeka modelini kullanacağını ve kimlik doğrulamasını nasıl yapacağını belirler. modelId kısmında güncel ve maliyet etkin modelleri seçmeye özen gösterin.

Kritik Güvenlik Uyarısı: API anahtarlarınızı asla GitHub gibi herkese açık platformlarda paylaşmayın. Üretim ortamlarında (production) Azure Key Vault veya User Secrets yönetimini kullanın.

Metin Özetleme Fonksiyonunu Yazma

Metin özetleme işlemi, bir "Prompt" (istemi) göndererek gerçekleştirilir. Semantic Kernel, bu süreci yönetmek için oldukça esnek bir yapı sunar. Aşağıdaki kod, uzun bir metni alıp onu özetleyen temel fonksiyonu gösterir:

public static async Task Ozetle(Kernel kernel, string metin)
{
    var prompt = $"Lütfen şu metni 3 cümleyle özetle: {metin}";
    var result = await kernel.InvokePromptAsync(prompt);
    return result.ToString();
}

Bu fonksiyon, metni alır ve yapay zekaya belirli bir kısıtlama (3 cümle) ile özetleme komutu gönderir. InvokePromptAsync metodu, asenkron olarak çalışarak uygulamanızın donmasını engeller.

Performans ve Yöntem Karşılaştırması

Metin özetleme için farklı yaklaşımlar mevcuttur. İhtiyacınıza göre en uygun yöntemi seçmek için aşağıdaki tabloyu inceleyebilirsiniz:

Hata Yönetimi ve Debug İpuçları

Yapay zeka ile çalışırken en sık karşılaşılan hatalar API limitleri ve ağ kesintileridir. Uygulamanızın kararlı çalışması için mutlaka try-catch blokları kullanmalısınız. Ayrıca, token limitlerini aşmamak için gönderilen metin uzunluğunu kontrol etmek önemlidir.

try 
{
    string sonuc = await Ozetle(kernel, uzunMetin);
    Console.WriteLine(sonuc);
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"Bağlantı hatası: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Beklenmedik hata: {ex.Message}");
}

Bu yapı, uygulamanızın API tarafındaki bir kesintide çökmesini engeller ve kullanıcıya anlamlı bir hata mesajı dönmenizi sağlar.

Uygulamanın Test Edilmesi

Uygulamanızı test etmek için uzun bir makale veya haber metni kullanabilirsiniz. Test aşamasında, yapay zekanın özetleme stilini değiştirmek için prompt'unuzu güncelleyebilirsiniz. Örneğin, "Profesyonel bir dille özetle" veya "Çocukların anlayacağı şekilde özetle" gibi talimatlar ekleyerek sonuçların nasıl değiştiğini gözlemleyin.

string testMetni = "C# modern, nesne yönelimli bir dildir...";
var ozet = await Ozetle(kernel, testMetni);
Console.WriteLine("Özet: " + ozet);

Testlerinizi yaparken, her istekte harcanan token miktarını izlemek maliyet yönetimi açısından kritik bir alışkanlıktır.

Kod Güvenliği Sorumluluk Reddi: Bu makalede paylaşılan kod örnekleri eğitim amaçlıdır. Uygulamanızı yayına almadan önce, girdi verilerini temizleyin (input validation) ve API anahtarlarınızı şifreli bir şekilde saklayın.

Sıkça Sorulan Sorular

C# ile özetleme yaparken neden Semantic Kernel kullanmalıyım?

Semantic Kernel, farklı yapay zeka modelleri arasında kolayca geçiş yapmanızı sağlar ve C# kodunuz ile yapay zeka mantığını birbirinden ayırarak temiz bir mimari sunar.

Token limiti nedir ve neden önemlidir?

Token, yapay zekanın metni işlerken kullandığı birimdir. API maliyetleri token başına hesaplanır; bu nedenle metinleri parçalara bölerek işlemek daha ekonomiktir.

Uygulama çevrimdışı çalışabilir mi?

Eğer yerel (local) bir LLM (örneğin Llama 3) kullanırsanız çevrimdışı çalışabilir, ancak bu durum yüksek donanım kaynağı gerektirir.

Özetleme kalitesini nasıl artırabilirim?

Prompt mühendisliği yaparak, yapay zekaya "rol" atayabilir (örneğin: "Sen bir editörsün") ve çıktının formatını (JSON, liste, paragraf) kesin bir şekilde belirtebilirsiniz.

Hangi C# kütüphaneleri daha iyi sonuç verir?

Semantic Kernel şu an endüstri standardıdır; ancak basit projeler için doğrudan OpenAI.NET kütüphanesi de tercih edilebilir.

İleri Seviye İpuçları: Prompt Mühendisliği ve Çıktı Kontrolü

Metin özetleme süreçlerinde elde ettiğiniz verimin kalitesini artırmak için sadece kütüphane kullanımı yeterli değildir. C# içerisinde Semantic Kernel kullanarak "Prompt Template" yapısını optimize etmek, modelin daha tutarlı sonuçlar üretmesini sağlar. Özellikle uzun metinlerde modelin bağlamı kaybetmemesi için "Few-Shot Prompting" tekniğini kullanmalısınız.

Aşağıdaki örnekte, özetleme işlemini belirli bir formatta (JSON) almak için nasıl bir yapı kurabileceğinizi görebilirsiniz:

// Semantic Kernel ile yapılandırılmış prompt örneği
string prompt = @"
    Aşağıdaki metni özetle ve sonucu JSON formatında döndür.
    Format: { 'ozet': '...', 'anahtar_kelimeler': [] }
    Metin: {{$input}}
";

var summaryFunction = kernel.CreateFunctionFromPrompt(prompt);
var result = await kernel.InvokeAsync(summaryFunction, new() { ["input"] = metinIcerigi });

Uygulamanın Ölçeklendirilmesi ve Deployment Stratejileri

Geliştirdiğiniz özetleme uygulamasını bir ASP.NET Core Web API projesine dönüştürdüğünüzde, yüksek trafik altında performans sorunları yaşamamak için bazı mimari kararlar almanız gerekir. Özellikle Async/Await yapısını uçtan uca kullanmak ve API isteklerini kuyruklamak (Queue) önemlidir.

Performans İçin İpuçları:

• Caching (Önbellekleme): Aynı metinler için tekrar tekrar API çağrısı yapmamak adına IMemoryCache veya Redis kullanarak özetleri saklayın.
• Streaming: Eğer kullanıcıya özetin parça parça gelmesini istiyorsanız, Semantic Kernel'ın Streaming özelliklerini kullanarak yanıt süresini (latency) minimize edin.
• Rate Limiting: OpenAI veya diğer LLM servislerine yapılan istekleri sınırlandırarak maliyet kontrolü sağlayın.

Uygulamanızı Azure App Service veya Docker konteynerleri üzerinde yayına alırken, API anahtarlarınızı asla kod içerisinde tutmayın. Bunun yerine Azure Key Vault veya Environment Variables kullanmayı bir standart haline getirin.

// Örnek: ASP.NET Core içerisinde güvenli yapılandırma kullanımı
public void ConfigureServices(IServiceCollection services)
{
    var apiKey = Configuration["OpenAI:ApiKey"];
    services.AddKernelBuilder()
            .AddOpenAIChatCompletion("gpt-4", apiKey)
            .Build();
}

Not: Büyük ölçekli metinleri özetlerken, metni parçalara (chunking) bölmek ve her parçayı ayrı ayrı özetleyip ardından birleştirmek, "Context Window" limitlerine takılmanızı engeller.

Sonuç

C# ile yapay zeka tabanlı metin özetleme uygulaması yapmak, modern yazılım geliştirme süreçlerinde oldukça değerli bir yetkinliktir. Bu rehberde, Semantic Kernel kullanarak basit ama etkili bir özetleme motoru kurmayı, güvenlik önlemlerini ve hata yönetimini öğrendiniz. Bir sonraki adım olarak, bu uygulamayı bir Web API (ASP.NET Core) içerisine entegre ederek, kullanıcıların kendi metinlerini gönderip özet alabilecekleri bir platform haline getirebilirsiniz.