Somut Ayrıntılar Ekleme
Yapay zeka çıktısını temellendiren sayılar, adlar, biçimler ve örnekler.
Somut Ayrıntılar Ekleme, CoddyKit'te ücretsiz bir AI Prompt Engineering dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, AI Prompt Engineering öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. AI Prompt Engineering kursu toplamda 4 dersten oluşur.
Somut Ayrıntılar Dayanak Sağlar
Somut ayrıntılar belirli, ölçülebilir ve doğrulanabilir bilgi parçalarıdır. Bunlar modelin çıktısına genel bir yorum yerine gerçek durumunuzu dayanak yapar.
Dayanaklar olmadan model, hayalî ortalama kullanıcı için içerik üretir. Dayanaklarla ise sizin için üretir.
Somut Bir Kısıt Olarak Sözcük Sayısı
Sözcük sayısı ekleyebileceğiniz en basit ve etkili somut ayrıntılardan biridir. Karşılaştırın:
- Belirsiz: 'Kısa bir açıklama yazın'
- Somut: '75 sözcüklük bir açıklama yazın'
Model metin birimlerini sayar ve hedefinize ulaşmayı amaçlar. Hedefi biraz aşarsa tam olarak yeniden saymasını isteyebilirsiniz. Sözcük sayısı, yeniden yazma gerektiren sorun kategorilerinin tamamını ortadan kaldırır.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a product description for a noise-cancelling travel pillow in exactly 60 words. '
'After the description, output the word count in parentheses on a new line.'
)
}]
)
print(response.content[0].text)Somut Bir Ayrıntı Olarak Hedef Kitle
Belirli ve somut bir hedef kitle belirtmek, çıktının sözcük dağarcığını, örneklerini ve derinliğini büyük ölçüde değiştirir.
- Belirsiz: 'Nöral ağları açıklayın'
- Somut: 'Nöral ağları, kodlama geçmişi olmayan ancak Excel özet tablolarını anlayan bir Fortune 500 şirketindeki pazarlama yöneticisine açıklayın'
İkinci istem, modele gerçek bir okuyucunun zihinsel görüntüsünü verir ve karmaşıklığı kusursuz biçimde ayarlamasını sağlar.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
concrete_audience_prompt = (
'Explain what a REST API is.\n\n'
'Audience: a non-technical product manager who uses Salesforce daily '
'and understands the concept of a form submission on a website. '
'They will use this explanation to brief their engineering team tomorrow. '
'Use one real-world analogy. Max 100 words.'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': concrete_audience_prompt}]
)
print(response.choices[0].message.content)Genellemeler Yerine Adlandırılmış Varlıklar
Adlandırılmış varlıkları — gerçek ürün adlarını, şirket adlarını, kişileri, teknolojileri ve tarihleri — kullanmak modeli genel alandan çıkarır.
- Belirsiz: 'Bir rekabet analizi yazın'
- Somut: 'Her gün yazan, 10 kişilik uzaktan çalışan bir ekibi yöneten ve çevrimdışı erişime ihtiyaç duyan ileri düzey bir kullanıcı için Notion ile Obsidian ve Roam Research'in rekabet analizini yazın'
Adlandırılmış varlıklar, modeli eğitim sürecinden öğrendiği gerçek dünya bilgisine dayandırır.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Compare FastAPI vs Flask vs Django REST Framework '
'for building a production API that will serve a React frontend. '
'Context: 2-person startup team, Python 3.11, needs async support, '
'expects < 50 ms response time, and will deploy on AWS Lambda. '
'Format: 3-column markdown table with rows: setup complexity, '
'async support, performance, learning curve, community size.'
)
}]
)
print(response.content[0].text)Nicel Kısıtlar
Sayılar belirsizliğe yer bırakmaz. Ne zaman sayısal bir gereksiniminiz olsa bunu isteme ekleyin:
- Tam olarak N öğe listeleyin ('birkaç' veya 'birçok' demeyin)
- En fazla / en az sözcük veya karakter sayısı
- Belirli yüzdeler veya oranlar ('%70 pratik, %30 teorik')
- Zaman kısıtları ('Bu metni okumak için 3 dakikam varmış gibi açıklayın')
- Başarım hedefleri ('O(n) zaman karmaşıklığına ulaşan yaklaşımlar önerin')
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Generate exactly 8 onboarding email subject lines for a B2B SaaS product. '
'Requirements:\n'
'- Exactly 8 lines, no more, no fewer\n'
'- Each subject line between 40 and 60 characters\n'
'- 4 must emphasize value, 4 must create urgency\n'
'- Label each line: [VALUE] or [URGENCY]\n'
'- No emojis\n'
'- No duplicate words across all 8 lines'
)
}]
)
print(response.choices[0].message.content)Son Tarih ve Zamana Dayalı Çerçeveleme
Zamana dayalı bir bağlam sağlamak, çıktıların derinliğini ve odağını değiştirir. Modele bu içeriğin ne zaman kullanılacağını ve bunun doğurduğu kısıtları söyleyin:
- 'Bu e-posta 2 saat içinde gönderilecek — kısa tutun'
- 'Bu, Pazartesi günkü yönetim kurulu sunumu için — yönetici düzeyinde bir dil kullanın'
- 'Bu açıklama 5 dakikalık bir ekip toplantısında işe yaramalı'
- 'Bunu, müşteri görüşmesinden önce gözden geçirmek için 10 dakikası olan bir ekip için yazın'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=256,
messages=[{
'role': 'user',
'content': (
'Write a project status update for our AI chatbot project. '
'This will be read aloud at a 5-minute Monday morning stand-up. '
'The audience has zero technical background. '
'Talking time: max 2 minutes (approximately 300 words). '
'Cover: what we shipped last week, one current blocker, one upcoming milestone. '
'Tone: confident and factual. No jargon.'
)
}]
)
print(response.content[0].text)İstemde Somut Örnekler
İstediğiniz veya istemediğiniz şeylere ilişkin somut örnekler vermek, en yüksek etki sağlayan tekniklerden biridir. Örnekler biçimi, anlatım tarzını ve üslubu aynı anda öğretir.
Şunları ekleyebilirsiniz:
- İdeal çıktıya ilişkin bir örnek (tek seferlik)
- Etiketlerle birlikte birden fazla örnek (az örnekli)
- Daha önce neyin yanlış gittiğine ilişkin bir örnek (olumsuz örnek)
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prompt = '''
Write 3 feature announcement tweets for a new developer tool.
Here is an example of the style I want:
"We just shipped inline type errors in the editor. No more tab-switching to find
what broke. Your flow stays unbroken. Try it now: [link]"
Characteristics of this style:
- Opens with what shipped, not with excitement words
- Describes the user benefit in the second sentence
- Ends with a CTA
- No hashtags. No emojis. Under 200 characters.
New feature: autocomplete that learns from your codebase.
'''
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prompt}]
)
print(response.choices[0].message.content)Alana Özgü Terminoloji
Alana özgü terimlere yer vermek, çıktı için beklenen uzmanlık düzeyini modele gösterir.
- 'Önbelleğe almayı açıkla' → generic yanıt
- 'Memcached'den Redis 7.x'e geçiş yapan bir arka uç mühendisi için Redis LRU tahliye politikasını açıkla' → uzman düzeyinde, alanla bağlantılı yanıt
İstemde alanınızın terminolojisini kullanırsanız model de çıktıda aynı terminolojiyi yansıtır.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Generic prompt vs domain-vocabulary prompt
generic = 'Explain caching strategies.'
domain_anchored = (
'Compare write-through, write-behind, and cache-aside patterns '
'for a microservices architecture using Redis 7.x as the cache layer and '
'PostgreSQL 15 as the source of truth. '
'Focus on consistency guarantees, latency tradeoffs, and failure modes. '
'Audience: senior backend engineers familiar with CAP theorem.'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{'role': 'user', 'content': domain_anchored}]
)
print(response.content[0].text)Hariç Tutulacaklara İlişkin Kısıtlar
Somut olumsuz kısıtlar (hariç tutmalar), modelin öngörülebilir ve generic yönlere gitmesini engeller:
- 'Ücretli bir API anahtarı gerektiren çözümler önermeyin'
- 'Rakiplerden adlarıyla söz etmeyin'
- 'Kaldıraç veya sinerji sözcüklerini kullanmayın'
- 'Kuramsal içeriğe yer vermeyin — yalnızca pratik bilgiler sunun'
- 'Uygulanması 5 dakikadan uzun süren yaklaşımları hariç tutun'
Her hariç tutma kuralı, generic içerik için bir seçeneği daha ortadan kaldırarak çıktıyı daha kesin hâle getirir.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Suggest 5 ways to speed up a slow Python script. '
'EXCLUDE:\n'
'- Suggestions requiring third-party libraries (stdlib only)\n'
'- Suggestions about hardware upgrades\n'
'- Rewrites of the entire script\n'
'- Suggestions that take more than 30 minutes to implement\n'
'Each suggestion: one sentence describing what to do, one sentence on expected speedup.'
)
}]
)
print(response.choices[0].message.content)Hepsini Bir Araya Getirmek
Adım adım tamamen somut bir istem oluşturalım. Şununla başlayalım: 'Bir iş tanımı yazın.'
- Rolü ekleyin: 'Kıdemli makine öğrenimi mühendisi için'
- Özel adlandırılmış varlığı ekleyin: 'Londra'da Seri B aşamasındaki bir yapay zekâ girişiminde'
- Kelime sayısını ekleyin: '350-400 kelime'
- Hedef kitleyi ekleyin: '5 yıldan fazla deneyime sahip adaylar için'
- Yapıyı ekleyin: 'Biçim: giriş, sorumluluklar (8 madde), gereksinimler (5 madde), tercih edilen nitelikler (3 madde)'
- Hariç tutmayı ekleyin: 'Hızlı tempolu veya tutkulu gibi klişeler kullanılmasın'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
concrete_prompt = (
'Write a job description for a Senior ML Engineer position '
'at a Series B AI startup in London. '
'Target candidate: 5+ years ML experience, strong Python, familiar with LLMs. '
'Length: 350-400 words. '
'Structure:\n'
'1. 3-sentence company intro (no fluff — focus on product and mission)\n'
'2. Responsibilities: exactly 8 bullet points\n'
'3. Requirements: exactly 5 bullet points\n'
'4. Nice-to-haves: exactly 3 bullet points\n'
'EXCLUDE: phrases like "fast-paced", "passionate", "ninja", "rockstar", "self-starter".'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=600,
messages=[{'role': 'user', 'content': concrete_prompt}]
)
print(response.content[0].text)İstemi Zenginleştirme Alışkanlığı
Göndermeden önce her istemi zenginleştirme alışkanlığı geliştirin. Şu hızlı zihinsel zenginleştirme turunu uygulayın:
- Belirsiz bir sözcüğü bir sayıyla değiştirebilir miyim?
- Belirli bir araç, teknoloji veya kişinin adını verebilir miyim?
- Hedef kitleyi daha kesin biçimde tanımlayabilir miyim?
- İstediğim şeye ilişkin bir örnek ekleyebilir miyim?
- En az bir 'şunu eklemeyin' kısıtı ekleyebilir miyim?
- Çıktı biçimini daha kesin biçimde belirtebilir miyim?
Yalnızca iki veya üç zenginleştirme bile çıktı kalitesini büyük ölçüde artırır.
# Prompt enrichment in code form: before/after comparison
before = 'Give me ideas for my presentation.'
after = (
'Generate 6 opening hook ideas for a 15-minute conference talk '
'titled "Why Your AI Prompts Are Failing You" at PyCon 2025. '
'Audience: Python developers, mostly backend, some ML experience. '
'Each hook: 2 sentences max. '
'Mix: 2 provocative statistics, 2 counterintuitive questions, 2 short stories. '
'EXCLUDE: "Did you know..." openers and rhetorical questions about the future of AI.'
)
print('BEFORE:', before)
print()
print('AFTER:', after)Bilgi Kontrolü
Bir girişim kurucusu şu istemi gönderiyor: 'Pazarlama metni yazmama yardım edin.' Aşağıdaki yeniden yazılmış istemlerden hangisi en etkili somut ayrıntıları kullanır?
Somut Ayrıntılar Ekleme — Özet
Somut ayrıntılar, belirsiz istemleri kesin talimatlara dönüştürür. Şu sabitleme tekniklerini kullanın:
- Kelime sayısı: 'kısa/uzun' ifadelerini kesin sayılarla değiştirin
- Özel adlandırılmış varlıklar: belirli ürünler, araçlar, şirketler ve kişiler
- Hedef kitle: rol, deneyim düzeyi ve zaten bildikleri
- Nicel kısıtlar: tam olarak N öğe, her türden %N
- Alan terminolojisi: beklenen derinlik düzeyini göstermek için alanın kendi terimlerini kullanın
- Örnekler: iyi bir çıktının nasıl göründüğünü gösterin
- Hariç tutmalar: modelin nelerden kaçınması gerektiğini belirtin
Sıkça Sorulan Sorular
“Somut Ayrıntılar Ekleme” dersi ücretsiz mi?
Evet — “Somut Ayrıntılar Ekleme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve AI Prompt Engineering kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. AI Prompt Engineering kursu toplamda 4 dersten oluşur.
“Somut Ayrıntılar Ekleme” dersinde ne öğreneceğim?
Yapay zeka çıktısını temellendiren sayılar, adlar, biçimler ve örnekler. AI Prompt Engineering ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
AI Prompt Engineering öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te AI Prompt Engineering, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.
“Somut Ayrıntılar Ekleme” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu AI Prompt Engineering dersinde kod yazıp çalıştırabilir miyim?
Evet. Her AI Prompt Engineering dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- Özgüllük Neden Önemlidir
- İstemlerdeki Belirsizliği Giderme
- Somut Ayrıntılar Ekleme
- Belirsiz ve Özgül İstemlerin Karşılaştırılması