Etkili Prompt Yazma Rehberi: Adım Adım Stratejiler ve Örnekler

Prompt yazma neden “komut yazmak”tan fazlası?

Günlük kullanımda “prompt” bir modele yazdığınız mesaj gibi görünür. Ancak iyi sonuçların büyük kısmı, mesajın yapısı ve test edilebilir olmasıyla ilgilidir. Resmî kılavuzlar prompt mühendisliğini; istenen çıktıyı elde etmek için talimatı, bağlamı, örnekleri ve çıktı formatını bilinçli şekilde tasarlama süreci olarak ele alır. Bu yaklaşım, özellikle farklı görevlerde (özetleme, sınıflandırma, içerik taslağı, kod yardımcılığı) tutarlılığı artırmayı hedefler. (Bkz. OpenAI Prompt Engineering Best Practices, Anthropic Prompt Engineering Overview)

Bu rehberde amaç, tek seferde “mükemmel” prompt bulmak değil; ölçülebilir bir iyileştirme döngüsü kurmaktır. Çünkü hangi tekniğin daha iyi çalıştığı; model ailesine, dilin nüanslarına (Türkçe/İngilizce), bağlam uzunluğuna ve görev türüne göre değişebilir. Bu yüzden evrensel yüzdeler vermek yerine, kendi kullanımınızda nasıl test edeceğinizi göstereceğiz.

Temel prensipler (çoğu görev için geçerli)

1) Talimatı en başa koyun, bağlamı net ayırın

Resmî pratiklerden biri: modeli ne yapacağı konusunda en baştan yönlendirmek ve bağlamı belirgin ayraçlarla (### veya üç tırnak) ayırmaktır. Bu, modelin “hangisi görev, hangisi içerik?” ayrımını daha doğru yapmasına yardımcı olur. (Kaynak: OpenAI Help Center)

• İyi: “Aşağıdaki metni 5 maddede özetle. Çıktı formatı: JSON.”
• Zayıf: “Şunu özetler misin?” (format yok, kapsam belirsiz)

2) Çıktı formatını “göstererek” tarif edin

Sadece “madde madde yaz” demek yerine, örnek çıktı şablonu vermek; tutarlı yapı ve sonradan işlenebilir (parse edilebilir) sonuç alma ihtimalini yükseltir. Bu yaklaşım hem resmî pratiklerde hem de teknik özetlerde özellikle vurgulanır. (Kaynak: OpenAI, ayrıca akademik özet: arXiv 2509.11295)

3) Önce zero-shot, gerekirse few-shot, sonra daha ileri yöntemler

Yaygın bir yol haritası: önce örneksiz (zero-shot) net talimatla başlayın; yetmezse birkaç örnek ekleyin (few-shot); en son aşamada daha kalıcı çözümleri (ürünleştirme, ince ayar gibi) değerlendirin. Bu sıralama çoğu senaryoda maliyet ve hız açısından mantıklıdır, ancak her işte aynı sonucu garanti etmez. (Kaynak: OpenAI, Anthropic)

4) Başarı kriteri tanımlayın ve ölçün

Prompt yazımı, bir “metin yazma” işi olmaktan çok bir deney tasarımı işidir: doğru/yanlış ölçütünüz yoksa ilerleme hissi yanıltıcı olabilir. Anthropic dokümantasyonu, otomatik değerlendirme ve deneysel karşılaştırmaları (A/B gibi) önerir. (Kaynak: Anthropic Docs)

Adım adım prompt yazma süreci (uygulanabilir şablon)

Adım 1: Hedefi tek cümlede netleştirin

Kendinize şunu sorun: “Bu çıktı ile ne yapacağım?” Örnek hedefler:

• Bir metni toplantı notuna dönüştürmek
• 100 ürün yorumunu etiketlemek (olumlu/olumsuz/konu)
• Bir blog yazısı için taslak ve başlık alternatifleri üretmek

Hedef cümlesi, promptun ilk satırı olur.

Adım 2: Bağlamı yapılandırın (girdi, kısıt, tanım)

Modelin bilmesini istediğiniz minimum bilgileri ekleyin:

• Hedef kitle: “ABD’de yaşayan genel okuyucu”
• Ton: “Tarafsız, pratik, kısa paragraflar”
• Kapsam: “Yalnızca verilen metne dayan; varsayım ekleme”
• Tanımlar: “CTA = eylem çağrısı” gibi

Adım 3: Çıktı formatını sabitleyin

Çıktı formatı, kalitenin yarısıdır. Mümkünse:

• Başlık hiyerarşisi (H2/H3)
• Tablo şeması
• JSON anahtarları
• Madde sayısı sınırı

Adım 4: Örnek ekleyin (gerekliyse)

Zero-shot yeterli değilse 1–3 mini örnek ekleyin. Örneklerde girdi ve beklenen çıktı biçimini net gösterin. Bu, modelin “neye benzetmesi gerektiğini” öğretir (few-shot yaklaşımı).

Adım 5: Parametreleri amaca göre ayarlayın (varsa)

Kullandığınız araca göre değişmekle birlikte, resmî kılavuzlar bazı ayarların çıktıyı güçlü biçimde etkilediğini belirtir: model seçimi, temperature (yaratıcılık/dalgalanma), max tokens (uzunluk sınırı) ve stop dizileri gibi. (Kaynak: OpenAI Help Center)

Pratik kural: “Tekrarlanabilirlik” istiyorsanız daha deterministik ayarları tercih edin; “fikir üretimi” istiyorsanız çeşitliliği artıran ayarlar işinize yarayabilir. Net değer önermek yerine, her görevde küçük aralıklarla test etmek daha güvenlidir.

Adım 6: Test edin, ölçün, iterasyon yapın

En az iki prompt varyantı hazırlayın:

• V1: Sade, net talimat + format
• V2: V1 + örnek(ler) + ek kısıtlar

Sonra 10–30 temsilî örnek üzerinde (metin, soru, veri satırı) aynı test setiyle deneyin. Başarı kriterlerinizi önceden belirleyin: doğruluk, format uyumu, gereksiz uzatma, kaynaklılık vb. Anthropic dokümanları bu tür değerlendirme yaklaşımını teşvik eder. (Kaynak: Anthropic Docs)

Kopyalanabilir prompt şablonları (Türkçe örneklerle)

Aşağıdaki şablonlar, farklı modellere uyarlanabilecek şekilde “rol + görev + bağlam + format” yapısına göre düzenlenmiştir. İsterseniz aynı şablonu İngilizceye çevirerek de kullanabilirsiniz.

Şablon 1: İçerik özetleme (format garantili)

Ne zaman kullanılır? Uzun metni hızlıca toplantı notu/özet hâline getirmek istediğinizde.

Görev: Aşağıdaki metni özetle ve aksiyon maddeleri çıkar.
Kısıtlar: Yalnızca metindeki bilgilere dayan. Varsayım ekleme.
Çıktı formatı:
- Özet: 5 madde
- Aksiyonlar: 3 madde
- Riskler/Bilinmeyenler: 3 madde
Metin:
"""
[Buraya metni yapıştırın]
"""

Neden işe yarar? Talimat başta, bağlam ayraçla ayrılmış, çıktı biçimi sabit. Bu, resmî pratiklerin önerdiği temel düzenle uyumludur. (Kaynak: OpenAI)

Şablon 2: Etiketleme/sınıflandırma (tutarlılık için)

Ne zaman kullanılır? Yorumları, destek taleplerini veya e-postaları kategorilere ayırmak istediğinizde.

Görev: Aşağıdaki metni etiketle.
Etiketler: [Fiyat], [Kalite], [Teslimat], [İade], [Diğer]
Kurallar: En fazla 2 etiket seç. Emin değilsen [Diğer] kullan.
Çıktı formatı (JSON):
{"text": "...", "labels": ["...", "..."], "confidence": "low|medium|high"}
Metin: """[Buraya metin]"""

Neden işe yarar? Etiket seti sınırlı, karar kuralları açık, JSON şeması örneklenmiş. “Formatı gösterme” yaklaşımı, birçok görevde çıktıyı daha stabil hâle getirir. (Kaynak: OpenAI; akademik özet: arXiv)

Şablon 3: Blog taslağı (hedef kitle + ton + kapsam)

Ne zaman kullanılır? Bir yazının iskeletini hızlı üretmek istediğinizde.

Rol: Deneyimli bir teknoloji içerik editörü gibi yaz.
Hedef kitle: Genel okuyucu (ABD).
Görev: "[Konu]" hakkında 1200–1800 kelimelik bir yazı taslağı oluştur.
Gereksinimler:
1) H2/H3 başlık yapısı kullan.
2) Her H2 altında 2–4 kısa paragraf yaz.
3) 1 kontrol listesi ve 1 tablo öner.
4) Belirsiz noktaları "Sınırlamalar" bölümünde belirt.
Çıktı: Önce başlık önerileri (5 adet), sonra taslak.

Neden işe yarar? Hedef kitle, uzunluk, yapı ve “sınırlamalar” beklentisi açıkça belirtilir. Bu tür kısıtlar, modelin “ne üretmemesi gerektiğini” de çerçeveler.

Şablon 4: Kalite kontrol (self-critique yaklaşımı)

Ne zaman kullanılır? Üretilen metni yayımlamadan önce tutarlılık ve kapsama kontrolü için.

Görev: Aşağıdaki taslağı değerlendir ve iyileştir.
Kontrol listesi:
- Talimatlara uyum var mı?
- Çelişki / belirsizlik var mı? (Varsa belirt)
- Gereksiz tekrar var mı?
- Eksik adımlar var mı?
Çıktı formatı:
1) Bulgular (madde madde)
2) Düzeltilmiş metin (revize edilmiş sürüm)
Metin: """[Taslak]"""

Neden işe yarar? Akademik özetlerde pratikte kullanılan teknikler arasında “self-critique” benzeri yaklaşımlar anılır; ancak sonuçlar göreve göre değişebilir. Bu yüzden bir “kalite kapısı” olarak kullanmak, tek başına doğruluk garantisi gibi düşünmemek daha sağlıklıdır. (Kaynak: arXiv 2509.11295)

Yaygın sorunlar ve hızlı teşhis

Model konu dışına çıkıyor

• Çözüm: Kapsamı bir cümleyle sınırla: “Yalnızca aşağıdaki metne dayan.”
• Çözüm: Bağlamı üç tırnakla ayır; talimatı üstte tut. (Kaynak: OpenAI)

Format bozuluyor (JSON kırılıyor, tablo eksik geliyor)

• Çözüm: Formatı örnekle “göster” ve tek bir şema kullan.
• Çözüm: “Sadece aşağıdaki formatta çıktı ver” gibi net kısıt ekle.
• Çözüm: Gerekirse stop dizileri gibi araç düzeyi kontrolleri değerlendir (kullandığınız platform destekliyorsa). (Kaynak: OpenAI)

Çıktı fazla uzun veya fazla kısa

• Çözüm: “En fazla X madde” veya “Her madde 1–2 cümle” gibi sınırlar koy.
• Çözüm: Aracınız izin veriyorsa uzunlukla ilgili token sınırlarını gözden geçir. (Kaynak: OpenAI)

Aynı prompt farklı zamanlarda tutarsız sonuç veriyor

• Çözüm: Daha deterministik ayarlar ve daha net format kullan.
• Çözüm: Few-shot örnek ekleyerek “hedef çıktıyı” daha iyi sabitle.
• Çözüm: Değerlendirmeyi aynı test setiyle yap; tek örnek üzerinden karar verme. (Kaynak: Anthropic)

Ölçümleme: Basit bir A/B test planı

Aşağıdaki plan, kişisel kullanım için bile uygulanabilir:

1. Test seti seçin: 10–30 temsilî örnek (aynı tür e-posta, aynı tür ürün yorumu vb.).
2. Rubrik yazın (0–2 puan):
   • Format uyumu
   • Kapsam (istenen her şeyi kapsıyor mu?)
   • Doğruluk (girdiyle tutarlı mı?)
   • Gereksiz uzatma/tekrar
3. Varyantları çalıştırın: V1 vs V2.
4. Sonuçları tabloya dökün ve en zayıf metriği hedefleyerek promptu revize edin.

Bu yaklaşım, “hissiyat” yerine ölçütlere dayalı ilerlemeyi kolaylaştırır; resmî dokümantasyonlar da benzer iteratif yaklaşımı vurgular. (Kaynak: Anthropic Docs)

Örnek değerlendirme tablosu

Türkçe yazanlar için yerelleştirme ipuçları

1) Dil hedefini baştan söyleyin

“Çıktı dili: Türkçe” ve gerekirse “Terimler: İngilizce teknik terimleri parantez içinde ver” gibi yönergeler; karışık dil kullanımını azaltabilir.

2) Biçimsel ton ve hitap

Türkçede “siz dili” / “sen dili” seçimi önemlidir. Promptta “resmî ve mesafeli” ya da “samimi ama profesyonel” gibi ton tanımı yazın.

3) Özel isimler ve ölçü birimleri

ABD pazarı için yazarken (ör. kitle ABD ama dil Türkçe), ölçü birimi, tarih formatı ve örneklerin yerelliği karışabilir. Promptta “Örnekler ABD bağlamına uygun olsun; ancak metin Türkçe kalsın” gibi açık bir cümle ekleyin.

Sınırlar ve dikkat notları

Bu rehber, resmî dokümantasyonlar ve bir akademik özet üzerinden “genel geçer” pratikleri derler. Yine de:

• Model farkları ve görev türü, aynı tekniğin etkisini değiştirebilir; genellenmiş performans iddiaları yanıltıcı olabilir. (Kaynak: Anthropic, arXiv)
• Resmî sayfalar “sürekli güncellenen” belgeler olabilir; bu nedenle kritik kararlar için erişim tarihini not etmek faydalıdır. (Erişim: 2026-03-07; kaynak bağlantıları yukarıda)
• Hukuk, sağlık veya finans gibi yüksek riskli alanlarda, çıktıları uzman kontrolünden geçirmeden kullanmayın; bu yazı profesyonel danışmanlık yerine geçmez.

Hızlı kontrol listesi (1 dakikada prompt iyileştirme)

• Görev tek cümlede net mi?
• Bağlam ayraçla ayrıldı mı (### veya """ ... """)?
• Çıktı formatı örnekle gösterildi mi?
• Kısıtlar yazıldı mı (kapsam, ton, uzunluk, dil)?
• Test planı var mı (en az 10 örnekle kıyas)?