smaple.tr
prompt engineering

Prompt Engineering ve LLM Orkestrasyon Rehberi [2026]

Mehmet Kurtipek
20 Haziran 2026
11 dk okuma
prompt engineering
LLM
LangChain
LlamaIndex
prompt tasarımı
chain of thought
few-shot learning
AI orkestrasyon

Prompt Engineering ve LLM Orkestrasyon: Kapsamli Rehber

Buyuk dil modelleri (LLM) her gecen gun daha yetenekli hale gelirken, bu modellerden maksimum verim almak icin prompt engineering kritik bir disiplin olarak one cikiyor. Dogru yapilandirilmis bir prompt, modelin ciktisini dramatik sekilde iyilestirebilirken, kotu tasarlanmis bir prompt yaniltici veya yetersiz sonuclar uretir. Arastirmalar gosteriyor ki ayni model, farkli prompt stratejileri ile yuzde 30'dan fazla performans farki gostereibiliyor. Bu rehberde prompt tasarim ilkelerinden LLM orkestrasyon frameworklerine, uretim ortami desenlerinden maliyet optimizasyonuna kadar tum konulari kapsamli bir sekilde ele aliyoruz.

Prompt Tasarim Ilkeleri

Etkili bir prompt yazmanin temelinde uc ana ilke bulunur: netlik, baglam ve kisitlamalar. Bu uclu, modelin ne yapmasini istediginizi dogru anlamasini saglar ve tutarli sonuclar elde etmenin anahtaridir.

Netlik (Clarity)

Prompt ne kadar net yazilirsa model o kadar tutarli sonuc uretir. Belirsiz ifadeler yerine spesifik talimatlar kullanmak her zaman daha iyi sonuc verir. Ornegin "Bu metni ozetle" yerine "Bu metni 3 madde halinde, her madde en fazla 2 cumle olacak sekilde Turkce ozetle" demek cok daha etkilidir. Netlik ayni zamanda modelin gorevde kalmassini ve konu disi sapmalari en aza indirmesini saglar. Karmasik gorevlerde talimatlari numarali adimlar halinde vermek, netligin pratik bir uygulamasidir.

Baglam (Context)

Modele yeterli baglam saglamak, ciktinin kalitesini dogrudan etkiler. Rol tanimlama, hedef kitle belirtme ve beklenen format aciklamasi baglam saglamanin temel yollaridir. Sistem promptlari bu baglami kalici hale getirmek icin ideal bir mekanizma sunar. Baglam saglarken dikkat edilmesi gereken onemli bir nokta, fazla bilginin de modelin dikkatini dagitabilecegi ve onemli detaylarin gozden kacmasina yol acabilecegi gerceigidir. Bu nedenle baglam bilgisinin ilgili ve ozlu olmasi tercih edilmelidir.

Kisitlamalar (Constraints)

Modelin ciktisini sinirlandirmak, tutarli ve kullanilabilir sonuclar elde etmek icin onemlidir. Karakter siniri, format kisitlamasi, dil tercihi ve yasakli icerik tanimlari bu kategoriye girer. Kisitlamalar ne kadar net olursa modelin hata yapma olasiligi o kadar azalir. Ozellikle API entegrasyonlarinda JSON cikti format kisitlamasi, modelin yapilandirmali ve programatik olarak islenilebilir cikti uretmesini garantiler. Negatif kisitlamalar da ("su konulara deginme", "teknik jargon kullanma") oldukca etkili bir yontemdir.

Prompt Desenleri ve Teknikleri

Farkli gorevler icin farkli prompt desenleri kullanmak, LLM performansini onemli olcude arttirir. Ise en yaygin ve etkili desenler:

Zero-Shot Prompting

Herhangi bir ornek vermeden modelden dogrudan gorev yerine getirmesini istemektir. Basit gorevler icin etkili olmakla birlikte, karmasik veya alana ozgu gorevlerde yetersiz kalabilir. Modern modeller zero-shot yeteneklerinde buyuk ilerleme kaydettigi icin pek cok standart gorev icin hala gecerli bir yaklasimdir. Siniflandirma, ceviri ve basit ozetleme gorevleri genellikle zero-shot ile iyi sonuclar verir.

Few-Shot Learning

Modele birkac ornek vererek beklenen cikti formatini ve yaklasimi gostermektir. Genellikle 2-5 ornek yeterli olur. Orneklerin cesitlilik gostermesi ve edge case'leri kapsamasi onemlidir. Few-shot prompting ozellikle siniflandirma, format donusumu ve stil uyarlama gorevlerinde son derece etkilidir. Ornek siralamasinin sonucu etkileyebildigi unutulmamalidir; en ilgili ornekleri sona koymak genellikle daha iyi sonuc verir. Dinamik few-shot secimi ise girdi benzerligine gore orneklerin otomatik olarak secilmesini saglayan gelismis bir tekniktir.

Chain-of-Thought (CoT)

Modeli adim adim dusunmeye yonlendiren bu teknik, mantiksal cikarim gerektiren gorevlerde buyuk fark yaratir. "Adim adim dusun" gibi basit bir ekleme bile modelin ara adimlari gostermesini ve daha dogru sonuclara ulamasini saglar. CoT ozellikle matematik, mantik ve karmasik analiz gorevlerinde vazgecilmezdir. Zero-shot CoT (sadece "adim adim dusun" eklemek) ve few-shot CoT (dusunme adimlarini orneklerle gostermek) olmak uzere iki temel varyanti bulunur.

ReAct (Reasoning + Acting)

Modelin hem dusunme hem de eylem adimlarini birlikte yurutmesini saglayan ReAct deseni, arac kullanan ajanlar icin temel yaklasimdir. Model once durumu degerlendirir (Thought), sonra bir eylem secer (Action), eylemin sonucunu gozlemler (Observation) ve donguyu tekrarlar. Bu desen ozellikle arama, hesaplama ve dis sistemlerle etkilesim gerektiren gorevlerde kullanilir. Ajanttik yapay zeka uygulamalarinin temelini olusturur.

Tree-of-Thought (ToT)

Chain-of-Thought'un daha gelismis bir versiyonu olan Tree-of-Thought, modelin birden fazla cozum yolunu paralel olarak kesfetmesini saglar. Her dusunce dalini degerlendirir, umut verici olanlari derinlestirir ve cikmaz sokaklari terk eder. Karmasik problem cozme, strateji gelistirme ve yaratici gorevlerde son derece etkilidir. ToT yaklasimi ozellikle tek bir dogru cevabinolmadigi, birden fazla olasi cozumun degerlendirilmesi gereken senaryolarda parlar.

Sistem Promptlari ve Guvenlik Kaliplari

Sistem promptlari, modelin davranisini tum konusma boyunca yonlendiren kalici talimatlardir. Etkili bir sistem promptu su bilesenlerden olusur:

Rol Tanimlama

Modele belirli bir rol atamak, ciktinin tonu, derinligi ve yaklasimini belirler. "Sen deneyimli bir yazilim mimarisin" gibi bir rol tanimlama, modelin teknik derinlik ve profesyonel ton kullanmasini saglar. Rol tanimlama ne kadar detayli olursa, modelin o rol icinde kalmasi o kadar kolaylasir. Deneyim yili, uzmanlik alani ve iletisim tarzini belirtmek etkili yontemlerdir.

Davranis Kurallari

Modelin neleri yapmasi ve neleri yapmamasi gerektigini acikca belirtmek onemlidir. Ornegin "Emin olmadigin konularda tahmin yurutme, bilmedigini belirt" veya "Kod orneklerini her zaman aciklama ile birlikte ver" gibi kurallar tutarli davranis saglar. Kurallari oncelik sirasina gore listelemek, modelin cakisma durumlarinda dogru karar vermesine yardimci olur.

Guardrails (Koruma Mekanizmalari)

Prompt injection saldirilarina karsi koruma, uygunsuz icerik filtreleme ve konu disi talepleri reddetme gibi guvenlik onlemleri sistem promptuna entegre edilmelidir. Ozellikle kullaniciya donuk uygulamalarda bu katman kritik oneme sahiptir. Cift katmanli koruma yaklasimi (hem girdi hem cikti kontrolu) en saglikli yontemdir.

Prompt Sablonlama ve Versiyonlama

Uretim ortaminda promptlari yonetmek, yazilim kodunu yonetmekten farkli degildir. Prompt sablonlama ve versiyonlama bu yonetimin temelidir.

Sablon Yapisi

Degisken yerleri belirli bir sozdizimi ile isaretlenen prompt sablonlari, farkli girdilerle tekrar tekrar kullanilabilir. Jinja2, Mustache veya ozel sablon motorlari bu amacla kullanilir. Sablonlar, promptun sabit kismini degisken kisminden ayirarak tutarlilik saglar. Iyi tasarlanmis bir sablon sistemi, gelistiricilerin prompt mantigi ile uygulama mantigi arasindaki siniri net bir sekilde cizmesine olanak tanir.

Versiyon Kontrolu

Promptlari Git gibi bir versiyon kontrol sisteminde yonetmek, degisiklikleri izlemeyi, A/B testi yapmayi ve gerektiginde geri donmeyi mumkun kilar. Her prompt degisikliginin bir commit mesaji ile belgelenmesi, ekip icinde seffaflik saglar. Prompt kalite metriklerini versiyon gecmisiyle iliskilendirmek, hangi degisikliklerin iyilestirme getirdigini somut olarak gormek icin degerli bir uygulamadir.

Prompt Registry

Merkezi bir prompt kayit defteri, tum sablonlari, versiyonlarini ve performans metriklerini tek bir noktada toplar. Bu yaklasim ozellikle birden fazla uygulama ve ekibin ayni promptlari kullandigi buyuk organizasyonlarda kritik oneme sahiptir.

LLM Orkestrasyon Frameworkleri

Tek bir LLM cagrisindan daha karmasik is akislari icin orkestrasyon frameworkleri devreye girer. Bu frameworkler zincirleme, yonlendirme, bellek yonetimi ve arac entegrasyonu gibi yetenekler sunar.

LangChain

En yaygin kullanilan orkestrasyon frameworku olan LangChain, modeller arasi zincirleme, bellek yonetimi, arac entegrasyonu ve retrieval gibi kapsamli ozellikler sunar. LangChain Expression Language (LCEL) ile deklaratif zincir tanimlama mumkundur. Genis ekosistemi ve topluluk destegi ile hizla gelisen bir platformdur. LangSmith ile entegre izleme ve degerlendirme yetenekleri de sunulmaktadir.

LlamaIndex

Veri indeksleme ve sorgulama odakli bir framework olan LlamaIndex, ozellikle RAG (Retrieval-Augmented Generation) uygulamalarinda one cikar. Yapilandirmali ve yapilandirmasiz veri kaynaklarini indeksleyerek LLM'lerin bu verilere erisimini kolaylastirir. Ozel indeks yapilari ve sorgu motorlari ile karmasik veri sorgulama senaryolarini destekler. Detayli bilgi icin RAG ve kurumsal bilgi yonetimi yazimiza goz atabilirsiniz.

Semantic Kernel

Microsoft'un gelistirdigi Semantic Kernel, ozellikle kurumsal .NET ve Java uygulamalari icin tasarlanmistir. Plugin mimarisi, planlama yetenekleri ve Azure OpenAI entegrasyonu ile kurumsal ortamlarda guclu bir tercih olabilir. Mevcut kurumsal uygulamalara AI yetenekleri eklemek icin dogal bir entegrasyon noktasi sunar.

Zincirleme ve Yonlendirme

Karmasik gorevleri kucuk adimlara bolmek ve dogru modele ya da isleme yonlendirmek, LLM uygulamalarinin temel mimari desenidir.

Sequential Chains (Sirali Zincirler)

Bir adimin ciktisinin bir sonraki adimin girdisi oldugu sirali zincirler, en temel orkestrasyon desenidir. Ornegin: metin ozetleme, sonra ceviri, sonra format donusumu. Her adim bir oncekinin sonucunu kullanir ve sonuc iteratif olarak zenginlesir.

Router Chains (Yonlendirici Zincirler)

Girdinin icerigine gore farkli zincirlere yonlendirme yapan router chains, cok amacli uygulamalarda kullanilir. Bir musteri talebi siniflandirilir ve ilgili uzman zincirine yonlendirilir. Bu yaklasim hem performansi hem de maliyet verimliligi arttirir. Semantik yonlendirme, anahtar kelime tabanlii yonlendirmeden daha esnek ve dogru sonuc verir.

Parallel Chains (Paralel Zincirler)

Birbirinden bagimsiz gorevleri paralel olarak calistirmak, toplam isleme suresini onemli olcude azaltir. Ornegin bir belgeyi hem ozetlerken hem de anahtar kelimeleri cikarirken hem de duygu analizi yapmak paralel zincirlerle mumkundur. Sonuclar birlestirildiginde kapsamli ve hizli bir analiz elde edilir.

Cikti Ayristirma ve Dogrulama

LLM ciktisinin yapilandirmali ve guvenilir olmasi, uretim uygulamalarinda kritik bir gerekliliktir.

Yapilandirmali Cikti

JSON, XML veya ozel formatlar gibi yapilandirmali cikti talep etmek ve bunu programatik olarak ayristirmak temel yaklasimdir. Pydantic modelleri veya JSON Schema ile beklenen cikti formatini tanimlamak, hem modele rehberlik eder hem de dogrulama saglar. Instructor gibi kutuphaneler bu sureci buyuk olcude otomatiklestirir.

Dogrulama Katmanlari

Ciktinin beklenen formata uygunlugunu kontrol eden dogrulama katmanlari, hatalari erken yakalamaya yardimci olur. Tip kontrolu, deger araliklarinin dogrulanmasi ve zorunlu alanlarin varligi gibi kontroller bu katmanda yer alir. Dogrulama basarisiz olursa yeniden deneme veya hata yonetimi devreye girer.

Retry Mekanizmalari

Model ciktisi dogrulamadan gecemediginde, hatanin geri bildirim olarak modele verilmesi ve yeniden denenmesi etkili bir stratejidir. Genellikle 2-3 deneme yeterli olur. Her denemede hata mesajini prompt'a eklemek, modelin hatasini duzeltme olasiligini arttirir. Ustel geri cekilme (exponential backoff) stratejisi ile yeniden deneme araliklari kademeli olarak arttiriilmalidir.

Token Optimizasyonu ve Maliyet Yonetimi

LLM API maliyetleri dogrudan token tuketimine baglidir. Maliyet optimizasyonu, prompt muhendisliginin onemli bir parcasidir.

Prompt Sikistirma

Gereksiz tekrarlari kaldirmak, kisaltmalar kullanmak ve sadece gerekli baglami eklemek token tuketimini azaltir. Ancak netlik ile kisilik arasindaki dengeyi korumak onemlidir. Asiri sikistirma model performansini olumsuz etkileyebilir. Otomatik prompt sikistirma araclari, bu dengeyi koruyarak token sayisini azaltmada yardimci olabilir.

Model Secimi Stratejisi

Her gorev icin en uygun modeli secmek maliyet optimizasyonunun temelidir. Basit siniflandirma gorevleri icin kucuk ve hizli modeller, karmasik cikarim icin buyuk modeller kullanmak hem maliyet hem de performans acisindan idealdir. Smart Maple olarak projelerimizde bu katmanli yaklasimi basariyla uyguluyoruz. Gorev karmasikligina dayali otomatik model yonlendirmesi, bu stratejiyi olceklendirmenin etkili bir yoludur.

Onbellekleme

Ayni veya benzer promptlar icin ciktilari onbelleklemek, hem maliyeti hem de yanit suresini onemli olcude azaltir. Semantik onbellekleme, tam eslesme yerine anlam benzerligi uzerinden calisarak daha genis bir kapsam saglar. Onbellek gecerlilik suresi ve bosaltma politikalari dikkatle yapilandirilmalidir.

Degerlendirme ve Test

Prompt performansini sistematik olarak olcmek ve iyilestirmek, surekli bir surectir.

Otomatik Degerlendirme

BLEU, ROUGE gibi geleneksel metriklerin yani sira LLM-as-a-judge yaklasimi, bir modelin baska bir modelin ciktisini degerlendirmesini saglar. Bu yaklasim ozellikle yaratici ve acik uclu gorevlerde etkilidir. Degerlendirme kriterleri acikca tanimlanmali ve tutarlilik icin birden fazla degerlendirme turu yapilmalidir. Rubrik tabanli degerlendirme, oznel degerlendirmeleri daha tutarli hale getirir.

A/B Testi

Farkli prompt versiyonlarini gercek kullanicilarla test etmek, hangisinin daha iyi performans gosterdigini objektif olarak olcmeye yardimci olur. Istatistiksel anlamlilik icin yeterli orneklem buyuklugu saglamak onemlidir. Test sonuclarini segment bazinda analiz etmek, hangi prompt versiyonunun hangi kullanici grubu icin daha etkili oldugunu ortaya cikarir.

Regresyon Testi

Prompt degisikliklerinin mevcut performansi bozmamasi icin regresyon test setleri olusturmak kritik oneme sahiptir. Altin standart veri setleri ile her degisikligin etkisi olculmelidir. CI/CD boru hattiina entegre edilmis otomatik regresyon testleri, her prompt degisikliginin kalite kontrolunden gecmesini garantiler.

Uretim Ortami Desenleri

LLM uygulamalarini uretim ortamina tasimak, gelistirme ortamindan farkli zorluklar icerir.

Fallback Stratejileri

Birincil modelin yanit vermemesi veya hata uretmesi durumunda yedek modellere veya kurallara dayali sistemlere gecis yapan fallback mekanizmalari, yuksek erisilebilirlik saglar. Model saglayicilari arasinda gecis yapabilmek de bu stratejinin bir parcasidir. Birden fazla saglayici ile calismak, tek noktadan bagimliligi ortadan kaldirir.

Rate Limiting ve Kuyruk Yonetimi

API hiz sinirlamalarini yonetmek, istekleri kuyruga almak ve oncelik siralama yapmak uretim ortaminin temel gereksinimlerindendir. Token bucket veya sliding window algoritmalari bu amacla kullanilir. Oncelik kuyrugu ile kritik isteklerin dusuk oncelikli isteklerden once islenmesi saglanabilir.

Izleme ve Gozlemlenebilirlik

Her LLM cagrisinin gecikme suresi, token tuketimi, hata orani ve maliyet gibi metriklerle izlenmesi, uretim ortaminda sorunlari erken tespit etmeyi saglar. LangSmith, Weights & Biases ve ozel izleme cozumleri bu amacla kullanilabilir. Anormallik tespiti ile beklenmedik maliyet artislari veya performans dususleri otomatik olarak bildirilmelidir.

Guvenlik ve Icerik Filtreleme

LLM uygulamalarinda guvenlik, tasarim asamasindan itibaren dusunulmesi gereken bir konudur.

Prompt Injection Korunmasi

Kullanici girdilerinin sistem promptunu manipule etmesini engellemek icin girdi dogrulama, ayristirma ve izleme katmanlari uygulanmalidir. Kullanici girdisi ile sistem talimatlari arasinda net bir ayirim yapilmasi temel savunma hattini olusturur. Girdi sanitizasyonu, uzunluk sinirlama ve sezgisel tabanli tespit bu katmanin bilesenlerindendir.

Icerik Filtreleme

Hem girdide hem de ciktida uygunsuz, zararli veya hassas icerik filtreleme mekanizmalari bulunmalidir. Siniflandirma modelleri, kural tabanli filtreler ve moderasyon API'leri bu amacla kullanilir. Katmanli filtreleme yaklasimi (hizli kural tabanli on filtre, ardindan model tabanli derin analiz) hem performans hem de dogruluk acisindan etkilidir.

Veri Gizliligi

Kisisel verilerin LLM'lere gonderilmemesi veya maskelenerek gonderilmesi, KVKK ve GDPR uyumlulugunun saglanmasi kritik oneme sahiptir. Ozellikle fine-tuning ve ozel model egitimi sureclerinde veri gizliligi daha da onemli hale gelir. PII tespit ve maskeleme araclari bu sureci otomatiklestirmeye yardimci olur.

Sonuc ve Oneriler

Prompt engineering ve LLM orkestrasyon, yapay zeka uygulamalarinin temel yapi taslarini olusturuyor. Basarili bir uygulama icin su adimlar onerilir:

Oncelikle prompt tasarim ilkelerini (netlik, baglam, kisitlamalar) her prompt icin uygulama aliskanligini edinin. Ardindan gorev karmasikligina uygun prompt desenlerini (zero-shot, few-shot, CoT, ReAct) secin. Orkestrasyon ihtiyaclari icin LangChain, LlamaIndex veya Semantic Kernel gibi frameworkleri degerlendirin ve kullanim alaniniza en uygun olani tercih edin.

Uretim ortaminda cikti dogrulama, maliyet optimizasyonu, guvenlik ve izleme katmanlarini ihmal etmeyin. Prompt versiyonlama ve sistematik degerlendirme ile surekli iyilestirme dongusu kurun. Token optimizasyonu ve model katmanlama ile maliyet kontrolunu saglayin.

Bu alan hizla gelisiyor ve yeni teknikler surekli ortaya cikiyor. Temelleri saglam oturtmak, yeni gelismelere hizla adapte olmanizi kolaylastiracaktir.

İlgili Makaleler

10 Ağustos 2026

MLOps Rehberi: Makine Öğrenmesi Modellerini Production'a Taşıma

Giriş: MLOps Nedir ve Neden Önemlidir? Makine öğrenmesi modelleri geliştirmek günümüzde nispeten kolaydır. Açık kaynak kütüphaneleri kullanarak son derece başarılı modeller oluşturabiliriz. Ancak bu modelleri production ortamına taşıyarak, ölçeklendirebilir, güvenilir ve sürdürülebilir şekilde çalıştırmak tamamen farklı bir hikayedir. Araştırmalara göre, veri bilimcileri tarafından geliştirilen makine öğrenmesi modellerinin %87'si hiçbir zaman production ortamına ulaşmaz. Bu başarısızlı

Devamını Oku: MLOps Rehberi: Makine Öğrenmesi Modellerini Production'a Taşıma
9 Ağustos 2026

LLM Fine-Tuning ve Özel Model Eğitimi Rehberi [2026]

LLM Fine-Tuning: Kurumsal Yapay Zeka Stratejisinin Temel Taşı Büyük dil modelleri (LLM), genel amaçlı metin üretimi ve anlama konusunda etkileyici performans sergiliyor. Ancak kurumsal ortamlarda belirli bir alan, terminoloji veya iş sürecine uyum sağlamaları gerektiğinde, genel bilgileri çoğu zaman yetersiz kalıyor. Bu noktada fine-tuning, yani ince ayar süreci devreye giriyor. Fine-tuning sayesinde mevcut bir temel modeli, kendi verileriniz ve ihtiyaçlarınız doğrultusunda özelleştirmek

Devamını Oku: LLM Fine-Tuning ve Özel Model Eğitimi Rehberi [2026]
8 Ağustos 2026

Bilgisayarlı Görü Uygulamaları: Nesne Tespiti, OCR ve Endüstriyel AI

Bilgisayarlı Görü Uygulamaları: Endüstriyel ve Medikal AI'nin Temel Teknolojisi Bilgisayarlı görü, makine öğrenmesinin en etkili alanlarından biridir. Türkiye'de yaşanan dijital dönüşüm sürecinde, özellikle üretim, sağlık ve lojistik sektörlerinde görü tabanlı otomasyon kritik hale gelmiştir. Smart Maple olarak Ankara'da geliştirdiğimiz çözümler, son beş yılda 150+ kuruluşunun üretim verimliliğini ortalama %35 oranında artırmıştır. Bu rehberde, bilgisayarlı görü teknolojisinin iş değeri

Devamını Oku: Bilgisayarlı Görü Uygulamaları: Nesne Tespiti, OCR ve Endüstriyel AI