API'ye Bağlanmadan AI İçerik Asistanı Tasarlamak: DummyProvider ile Güvenli Akış

Hiçbir dış API'ye bağlanmadan çalışan bir AI içerik asistanı: DummyProvider, sağlayıcı soyutlaması, üret→önizle→kullan akışı, editör onayı ve sonradan gerçek bir sağlayıcıya geçiş.

Giriş

Bir "AI içerik asistanı" deyince akla hemen bir dış API çağrısı gelir: anahtar al, isteği gönder, yanıtı bekle. Ama ilk günden gerçek bir API'ye bağlanmak zorunda değilsin. Bu projede içerik asistanı, hiçbir dış servise bağlanmadan çalışan bir DummyProvider üzerine kurulu; tüm editöryel akış anahtarsız, ağsız ve maliyetsiz çalışıyor. Üstelik yapı öyle tasarlandı ki, ileride gerçek bir sağlayıcıya geçmek için CMS'e dokunmak gerekmiyor.

Problem

Gerçek bir AI API'sine erken bağlanmak; anahtar yönetimi, maliyet, hız sınırı, ağ hataları ve öngörülemeyen çıktı demektir — hem de daha editöryel akışın doğru çalıştığını görmeden. Daha güvenli yol: önce akışı kur, sahte ama gerçekçi bir sağlayıcıyla. Akış oturunca gerçek sağlayıcı tak-çıkar bir parçaya döner.

Sağlayıcı (provider) soyutlaması

Kalbinde tek bir sözleşme var: bir üretici arayüzü, onu uygulayan soyut bir AIProvider (prompt ve bağlamı kuran şablon method) ve bunu somutlaştıran sağlayıcılar. DummyProvider bu arayüzü uygular ve yapılandırmadaki şablonlara göre belirlenimci (deterministic) örnek metin döndürür. İleride gerçek bir sağlayıcı da aynı arayüzü uygular — yalnız send() içi değişir, akışın gerisi aynı kalır.

Bağlam: konu, tür, ton, dil

Üretim tek bir bağlam nesnesiyle şekillenir: konu, içerik türü (blog, rehber, öğretici…), ton (profesyonel, samimi, teknik, başlangıç) ve dil. Prompt bu bağlamdan kurulur; sahte sağlayıcı da gerçek sağlayıcı da aynı bağlamı alır. Böylece "aynı girdi, aynı akış" garanti olur.

Üret → Önizle → Kullan → Onayla

1. Üret: Editör konuyu, türü ve tonu seçer; asistan alanları (başlık, özet, gövde, SEO) doldurur.
2. Önizle: Çıktı forma yansır; editör görür.
3. Kullan / düzenle: Editör metni benimser, düzeltir, kendi sesini katar.
4. Onayla: Kaydeder — içerik taslak olarak oluşur; hiçbir şey otomatik yayınlanmaz.

Yani asistan yazıyı "yayınlamaz", yalnız taslak hazırlar; son söz her zaman editördedir.

Güvenlik ağı

• Tamamen kapatılabilir: Bir bayrakla AI kapalıysa hiçbir dış istek gitmez.
• Hata formu bozmaz: Bir sorun olursa editöre bildirim çıkar, form olduğu gibi kalır.
• Kayıt: Her üretim (sağlayıcı, görev, süre) loglanır; panelde görünür.

Sonraki adım

Hazır olduğunda, aynı arayüzü uygulayan gerçek bir sağlayıcı eklersin; editöryel akış, arayüz ve güvenlik ağı aynı kalır. Modelin nasıl "düşündüğünü" merak ediyorsan LLM Nedir? Büyük Dil Modellerine Giriş dersine, kavram için Sözlük'teki LLM tanımına bakabilirsin.