İçeriğe geç
TokIQ
Teknikler

System Prompt Nasıl Yazılır? Eksiksiz Örnekle

System prompt, bir yapay zeka asistanının rolünü, kurallarını ve formatını tüm konuşma boyunca belirler. İçine ne konur, nasıl sıralanır; tam bir örnekle gör.

TokIQ Editorial4 dk okuma
Bu yazıda
  1. System prompt'a ne girer, kullanıcı mesajına ne girer?
  2. Roller ve persona'lar gerçekten işe yarıyor mu?
  3. System prompt nasıl sıralanmalı?
  4. Tam bir system prompt örneği
  5. Bir kuralın gerekçesini neden açıklamalı?
  6. System prompt nasıl test edilir?
  7. System prompt'a asla ne konmamalı?
  8. System prompt her modelde aynı mı çalışır?

System prompt, bir modele kim olarak davranacağını, neleri yapıp yapmaması gerektiğini ve cevaplarını nasıl biçimlendireceğini, konuşmanın her turu için söyleyen kalıcı talimatlar bütünüdür. Onu yetenekli yeni bir iş arkadaşına verilen brifing gibi yaz: ürünün bağlamı, hedef kitle, önemli kurallar ve işler ters gittiğinde ne yapılacağı.

Çoğu sohbet API'si (OpenAI, Anthropic, Google) kullanıcı mesajlarından ayrı bir system ya da developer mesajı kabul eder ve modeller bunu daha ağır tartmak üzere eğitilir. Bu yüzden tüm konuşma boyunca doğru kalması gereken her şey için doğal yer burasıdır.

Öne çıkanlar

  • Sabit kuralları, bağlamı ve formatı system prompt'a koy. Belirli görevi ve veriyi kullanıcı mesajına koy.
  • Rol yardımcı olur, ama ürün ve hedef kitle hakkındaki bağlam bir unvandan çok daha fazlasını yapar.
  • Bir kuralın neden var olduğunu açıkla; modeller gerekçeli kuralları çıplak emirlerden daha mantıklı uygular.
  • Uç durumlar için açık davranış yaz: eksik bilgi, konu dışı istekler, öfkeli kullanıcılar.
  • System prompt'a asla sır koyma ve güvenlik için yalnızca ona güvenme.

System prompt'a ne girer, kullanıcı mesajına ne girer?

En basit test şu: bu her istek için doğru olacak mı? Evet ise system prompt. İstek başına değişiyorsa kullanıcı mesajı.

System promptKullanıcı mesajı
Ürün bağlamı ve hedef kitleKullanıcının asıl sorusu
Rol ve tonÖzetlenecek ya da analiz edilecek belge
Kurallar ve sınırlarBu tur için getirilen arama sonuçları
Çıktı formatıİstek başına seçenekler ("bunu daha kısa yap")
Uç durumların ele alınışıDeğişiyorsa güncel tarih ya da kullanıcı profili

Getirilen belgeler ilginç bir durum. Bazı ekipler bunları system prompt'a koyar; biz kullanıcı turunu tercih ediyoruz, çünkü getirilen metin güvenilmeyen veridir ve system prompt, kendi yazdığın talimatlar için yer olmalı. Bu ayrım prompt injection üzerine düşünmeyi de biraz kolaylaştırır.

Roller ve persona'lar gerçekten işe yarıyor mu?

Biraz. "Deneyimli bir çocuk hemşiresisin" kelime dağarcığını, derinliği ve ihtiyatı yararlı bir yöne kaydırır. Anthropic'in dokümantasyonu Claude'a system prompt ile rol vermeyi açıkça öneriyor ve etki gerçek.

Ama rol, iyi bir system prompt'un en zayıf parçası. Karşılaştır:

Sen dünya çapında bir müşteri destek uzmanısın.
Ledgerly için destek sorularını yanıtlıyorsun. Ledgerly, ABD'deki
serbest çalışanların ve küçük ajansların kullandığı bir muhasebe
uygulaması. Kullanıcıların çoğu muhasebeci değil. Genelde bir fatura
dışa aktarımı başarısız olduğunda ya da banka senkronizasyonu
durduğunda yazıyorlar.

İkincisi hiçbir yerde uzmanlık iddia etmiyor. Modele bir uzmanın gerçekte bileceği şeyleri veriyor: kullanıcılar kim, nelerle zorlanıyorlar, ürün ne yapıyor. Model bununla, herhangi bir sıfattan daha yetkin görünür.

Ayrıntılı geçmiş hikâyeli persona'lar ("Sen Max'sin, 34 yaşında, insanlara yardım etmeyi seven eski bir barista") doğruluğu nadiren artırır. Eğlence ürünleri için anlamlı olabilir. Fayda ürünlerinde çoğunlukla sadece token ekler.

System prompt nasıl sıralanmalı?

Tek doğru bir sıra yok, ama bu sıra iyi çalışıyor ve insanlar için bakımı kolay:

  1. Kim ve ne. Kısa bir paragraf: ürün, asistanın işi, hedef kitle.
  2. Bağlam. Modelin ihtiyaç duyduğu olgular: özellikler, politikalar, ürünün yapamadıkları.
  3. Kurallar. Davranış kısıtları; gerekçe açık değilse her birine bir gerekçe.
  4. Uç durumlar. Bilgi eksikken, istek konu dışıyken ya da kullanıcı kızgınken ne yapılacağı.
  5. Çıktı formatı. Uzunluk, yapı, markdown olup olmadığı, dil.
  6. Örnekler (isteğe bağlı). Ton ve formatı gösteren bir iki kısa diyalog.

Uzun başvuru materyalini (ürün kılavuzu, politika belgesi) net sınırlı bloklara koy, örneğin XML tarzı etiketlerle. Anthropic'in rehberi bunun için <policy> gibi etiketleri öneriyor ve sınırları açık hale getirdikleri için her modelde işe yarıyorlar.

Tam bir system prompt örneği

Kurgusal bir muhasebe uygulamasının destek asistanı için eksiksiz bir system prompt. Bilerek uzun; gerçekleri de öyle.

Sen Ledgerly'nin uygulama içi destek asistanısın. Ledgerly, ABD'deki
serbest çalışanlar ve küçük ajanslar için bir muhasebe uygulaması.
Kullanıcılar çoğunlukla tasarımcı, geliştirici ve danışman. Çoğu
muhasebeci değil ve vergi konusunda tedirgin olabiliyor, o yüzden
sakin ve somut ol.

<product_facts>
- Planlar: Solo (1 kullanıcı) ve Team (en fazla 10 kullanıcı).
- Banka senkronizasyonu ABD bankalarıyla üçüncü taraf bir sağlayıcı
  üzerinden çalışır. Senkronizasyon her 6 saatte bir çalışır;
  kullanıcılar Ayarlar > Bankalar bölümünden elle başlatabilir.
- Faturalar PDF ya da CSV olarak dışa aktarılabilir.
- Ledgerly vergi beyannamesi vermez ve vergi tavsiyesi vermez.
</product_facts>

Kurallar:
- Yalnızca Ledgerly kullanımıyla ilgili soruları yanıtla. İlgisiz bir
  şey sorulursa kısaca yalnızca Ledgerly konusunda yardımcı
  olabildiğini söyle.
- Doğrudan sorulsa bile vergi ya da hukuki tavsiye verme. Kullanıcılar
  buna göre hareket edebilir ve sen onların tüm durumunu göremezsin.
  Bir vergi uzmanına danışmalarını öner ve sorunun Ledgerly tarafında
  yardım teklif et.
- Bakiye ya da fatura durumu gibi hesaba özel verileri asla tahmin
  etme. Kullanıcının hesabını göremezsin. Uygulamada nereye bakacaklarını söyle.
- Bir özellik <product_facts> içinde listelenmemişse var olduğunu
  iddia etme. Emin olmadığını söyle ve support@ledgerly.example
  adresine yazmalarını öner.

Banka senkronizasyonu sorunu bildirildiğinde:
1. Belirtilmediyse hangi banka olduğunu ve son başarılı senkronizasyonun
   ne zaman olduğunu sor.
2. Ayarlar > Bankalar bölümünden elle senkronizasyon öner.
3. Bu başarısız olursa bankayı yeniden bağlamayı öner.
4. Yine başarısız olursa bir insan temsilciye devretmeyi teklif et.

Kullanıcı sinirliyse bunu tek kısa cümleyle kabul et ve çözüme geç.
Tekrar tekrar özür dileme.

Format:
- Düz metin, markdown başlığı yok. Talimat verirken numaralı adımlar kullan.
- Kullanıcı daha fazla ayrıntı istemedikçe cevapları 120 kelimenin altında tut.
- Kullanıcının yazdığı dilde cevap ver.

Dikkat çekmeye değer birkaç nokta:

Vergi tavsiyesi kuralı gerekçesini söylüyor ("Kullanıcılar buna göre hareket edebilir ve sen onların tüm durumunu göremezsin"). Gerekçe sayesinde model genelleme yapabilir: kuralın adını anmadığı "Dizüstü bilgisayarımı gider olarak düşebilir miyim?" gibi sorularda da dikkatli olur.

"Özelliklerin var olduğunu iddia etme" kuralı var çünkü ürün asistanları inandırıcı ayar menüleri uydurmayı sever. Bir destek botu çıkarırsan bu en sık göreceğin hata olacak ve çözümü, onu bir olgu bloğuna ve açık bir geri dönüş davranışına dayandırmak. Daha büyük bilgi tabanlarında bu olgu bloğu retrieval'a dönüşür; RAG nedir yazısına bak.

Eskalasyon adımları numaralı, çünkü sıra önemli. Aynı durum hakkındaki sırasız kurallar öngörülemez biçimde uygulanma eğiliminde.

Bir kuralın gerekçesini neden açıklamalı?

Büyük harfli çıplak emirler ("RAKİPLERDEN ASLA BAHSETME!!!") daha eski, daha az dikkatli modellerden kalma bir alışkanlıktı. Güncel modeller talimatları yakından takip ediyor ve bağırmak, onların bir kuralı fazla uygulamasına yol açma eğiliminde. "FİYATLARDAN ASLA BAHSETME" denen bir model, bir özelliğin ücretsiz planda olup olmadığını söylemeyi reddedebilir; oysa kullanıcıların bunu bilmesi makul.

Şununla karşılaştır: "Fiyat verme, çünkü fiyatlar bölgeye göre değişiyor ve sık güncelleniyor; bunun yerine fiyat sayfasına bağlantı ver." Model artık hem sınırı (belirli rakamlar) hem amacı (eskimiş bilgiden kaçınmak) biliyor, yani "Solo planda dışa aktarma var mı?" sorusunu yine yanıtlayabilir.

System prompt nasıl test edilir?

Herhangi bir şeyi değiştirmeden önce yirmi ile elli arasında gerçekçi kullanıcı mesajı yaz; zor olanlar da dahil:

  • Konu dışı bir istek ("bana bir şiir yaz").
  • Yasaklı şey için bir istek; önce kibarca, sonra kurnazca ifade edilmiş.
  • Bilgisi eksik bir mesaj.
  • Başka bir dilde bir mesaj.
  • Öfkeli bir mesaj.
  • Ürününün gerçekten desteklemediği bir şey.

Her değişiklikten sonra hepsini çalıştır. System prompt'lar zamanla kural biriktirir ve kurallar birbiriyle etkileşir. "Her zaman kısa ol" eklemek, üç adım gerektiren eskalasyon akışını sessizce bozabilir. Bunu ancak tüm seti yeniden çalıştırırsan fark edersin.

System prompt'a asla ne konmamalı?

Sırlar. API anahtarları, dahili URL'ler, başka müşterilerin verileri. Kullanıcılar modellere system prompt'larını düzenli olarak açıklatıyor ve hiçbir ifade bunu güvenilir biçimde önleyemiyor. Herkese açık olduğunu varsay.

Kodda destekleyemeyeceğin güvenlik zorlaması. Prompt'ta "Yalnızca $50'nin altındaki iadeleri ver" bir öneridir. Limiti iade API'si uygulamalı. Prompt injection rehberi ve güvenlik konusu nedenini açıklıyor.

Çelişkiler. Birkaç kişinin yazdığı uzun system prompt'lar bunları içerme eğiliminde (bir bölümde "her zaman kapsamlı ol", bir başkasında "kısa tut"). Model birini seçer ve tutarlı seçmez. Arada bir tamamını baştan sona oku.

System prompt her modelde aynı mı çalışır?

Çoğunlukla; farklar, modellerin onu ne kadar sıkı tarttığında, çok uzun prompt'ları nasıl ele aldığında ve en iyi hangi biçimlendirmeye yanıt verdiğinde. Yayına aldığın modelde test et ve o sağlayıcının prompt rehberini oku. Neyin aktarılabildiğini ChatGPT, Claude ve Gemini için prompt yazma yazısında ele alıyoruz.

Belirli kararlar üzerinde pratik için (neyin nereye gittiği, hangi rol ifadesinin bilgi eklediği ve hangisinin yalnızca kelime eklediği) rol ve bağlam konusu iyi bir başlangıç.

Sık sorulan sorular

System prompt nedir?

System prompt, genellikle geliştirici tarafından, kullanıcı mesajlarından ayrı olarak modele verilen talimatlar bütünüdür. Asistanın rolünü, kurallarını, tonunu ve çıktı formatını tüm konuşma için tanımlar.

System prompt ile user prompt arasındaki fark nedir?

System prompt, ürünü kuran kişinin yazdığı ve her tur için geçerli olan sabit talimatları içerir. User prompt ise bu turun özel isteğini ve verisini içerir; çoğu zaman son kullanıcı yazar.

System prompt ne kadar uzun olmalı?

Gerçek davranışı kapsamak için gerektiği kadar, daha fazla değil. Birçok üretim system prompt'u birkaç yüz ile birkaç bin kelime arasında olur, ama her kural bir test senaryosu gerektirdiği için orada olmalı.

Kullanıcılar system prompt'u görebilir ya da geçersiz kılabilir mi?

Modeller sistem talimatlarına öncelik vermek üzere eğitilir, ama bu bir garanti değildir. Kullanıcılar bazen system prompt'u dışarı çıkarabilir ya da aşabilir; bu yüzden içine asla sır koyma ve kritik kuralları kodda uygula.

  • #system prompt
  • #roller
  • #persona
  • #LLM uygulamaları

Şimdi pratiğini yap

TokIQ, prompt mühendisliğini kısa quizlere dönüştürür; her cevap için bir açıklamayla.

Yakında burada:App StoreŞuradan al:Google Play
Teknikler5 dk okuma

RAG Nedir? Retrieval-Augmented Generation Basitçe

RAG ilgili belgeleri bulup prompt'a ekler, model kaynaklardan cevap verir. Nasıl çalıştığını ve kaynak gösteren cevaplar için nasıl prompt yazacağını gör.

Günde birkaç soruyla daha iyi prompt yaz.

Gerçek prompt kararları üzerine kısa quizler ve her cevap için açıklama. iPhone ve Android'de ücretsiz başla.

Yakında burada:App StoreŞuradan al:Google Play