AI Prompt Engineering · Ders

Başlık-Gövde-Alt Bilgi İstem Kalıbı

Karmaşık ve çok görevli istemlere ölçeklenebilen tutarlı bir istem yapısı oluşturun.

Başlık-Gövde-Alt Bilgi İstem Kalıbı, 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.

Belgeler Olarak Prompt'lar

Raporlar, makaleler ve e-postalar gibi uzun biçimli belgeler, bilişsel olarak gezinmesi kolay olduğu için Başlık/Gövde/Alt Bilgi yapısını kullanır. Okuyucular her bölgede ne bekleyeceklerini bilir.

Aynı ilke Prompt'lar için de geçerlidir. Prompt'lar birkaç cümleyi aştığında Başlık/Gövde/Alt Bilgi yapısı onları taranabilir, sürdürülebilir ve tutarlı hâle getirir.

Bu kalıp farklı modellerde çalışır ve basit Prompt'lardan son derece karmaşık Prompt'lara kadar ölçeklenebilir.

Başlık Bölümü

Başlık iki soruyu yanıtlar: Kimsiniz? ve Görev nedir?

Modelin kimliğini (persona veya rol) belirler ve Prompt'un temel amacını belirtir. Diğer her şey bu temel üzerine kurulur.

Güçlü bir başlık kısadır — genellikle 2-4 cümle. Örnekleri, kısıtlamaları veya çıktı kurallarını içermez.

header = '''
<header>
You are an expert technical writer specializing in API documentation.
Your task is to write clear, developer-friendly documentation
for the API endpoint described in the body of this prompt.
</header>
'''

print(header)

Gövde Bölümü

Gövde, modelin görevi gerçekleştirmek için ihtiyaç duyduğu içeriği veya bağlamı içerir. Burası ana veri bölgesidir:

İşlenecek kaynak belgeler
Konuşma geçmişi
Yapılandırılmış veriler (JSON, CSV parçacıkları)
Başvuru malzemesi
Kullanıcının gerçek girdisi

Gövde en büyük bölümdür ve çoğunlukla çalışma zamanında dinamik olarak eklenir.

def build_body(endpoint_spec):
    return f'''
<body>
<endpoint_specification>
{endpoint_spec}
</endpoint_specification>
</body>
'''

spec = 'POST /api/v2/users\nRequest body: {email: string, role: admin|user}\nReturns: {id: string, created_at: ISO8601}'
print(build_body(spec))

Alt Bilgi Bölümü

Alt Bilgi, biçim talimatlarını ve çıktı şemasını içerir. Sonda yer almasının nedenleri şunlardır:

Model yukarıdan aşağıya okur ve biçimlendirme kurallarını az önce işlediği içeriğe uygular
Sona yakın biçim talimatlarının göz ardı edilme olasılığı daha düşüktür
Alt bilgi, aynı çıktı türünü kullanan Prompt'lar arasında çoğunlukla yeniden kullanılabilir

Alt bilgi açık olmalıdır: Bu alanlara sahip bir JSON nesnesi döndürün; güzel biçimlendirin gibi belirsiz bir ifade kullanılmamalıdır.

footer = '''
<footer>
Format your response as a JSON object with these fields:
{
  "endpoint": "string",
  "summary": "string (one sentence)",
  "parameters": [{"name": "string", "type": "string", "required": true|false, "description": "string"}],
  "response_example": "string (JSON)",
  "error_codes": [{"code": "number", "meaning": "string"}]
}
Do not include any text outside the JSON object.
</footer>
'''

print(footer)

Tam Kalıbı Birleştirme

Başlık, Gövde ve Alt Bilgiyi eksiksiz, yeniden kullanılabilir bir Prompt işlevinde birleştirme:

def build_api_doc_prompt(endpoint_spec):
    header = '<header>\nYou are an expert technical writer. Document the API endpoint in the body.\n</header>'
    body = f'<body>\n<endpoint>\n{endpoint_spec}\n</endpoint>\n</body>'
    footer = '<footer>\nReturn JSON: {"summary": str, "parameters": [...], "response_example": str}\nNo text outside JSON.\n</footer>'
    return '\n\n'.join([header, body, footer])

spec = 'GET /api/products/:id\nReturns product details by ID'
print(build_api_doc_prompt(spec))

Bu Sıralama Neden İşe Yarar

Başlık/Gövde/Alt Bilgi sıralaması, modellerin bağlamı işleme biçimini yansıtır:

Önce Başlık — kimliği ve amacı belirler, modeli sırada gelecekler için hazırlar
İkinci olarak Gövde — model artık içeriği, belirlenen rol ve görev merceğinden işler
Son olarak Alt Bilgi — biçim talimatları, model yanıtını üretmeden hemen önce gelir ve çıktı yapısı üzerindeki etkisini en üst düzeye çıkarır

Biçim talimatlarını başlığa (en başa) koymak, model yanıtını yazana kadar bunların kısmen unutulmasına neden olur.

Karmaşık İstemlere Ölçekleme

Üstbilgi/Gövde/Altbilgi kalıbı, istemler karmaşıklaştığında doğal olarak ölçeklenir:

def build_complex_prompt(persona, task, context_docs, constraints, output_schema):
    header = f'<header>\n{persona}\nTask: {task}\n</header>'

    docs = '\n'.join(f'<document id="{i+1}">\n{d}\n</document>' for i, d in enumerate(context_docs))
    body = f'<body>\n{docs}\n</body>'

    constraint_list = '\n'.join(f'- {c}' for c in constraints)
    footer = f'<footer>\n<constraints>\n{constraint_list}\n</constraints>\n<output_schema>\n{output_schema}\n</output_schema>\n</footer>'

    return '\n\n'.join([header, body, footer])

Altbilgi Şablonlarını Yeniden Kullanma

Altbilgi, çıktı yapısını tanımladığı için en çok yeniden kullanılabilen bölümdür. Yaygın altbilgi şablonları:

FOOTER_JSON = '<footer>\nReturn a valid JSON object. No text outside JSON. No markdown code fences.\n</footer>'

FOOTER_MARKDOWN = '<footer>\nFormat your response as markdown.\nUse ## for section headers.\nUse bullet points for lists.\nMaximum 500 words.\n</footer>'

FOOTER_STRUCTURED = '<footer>\nRespond using this exact structure:\n1. Summary (1 sentence)\n2. Key Findings (bullet list)\n3. Recommendation (1 paragraph)\n</footer>'

print('Footer templates ready for reuse.')

Gövdeye Dinamik İçerik Ekleme

Gövde, çoğunlukla çalışma zamanında dinamik olarak oluşturulan bölümdür. Dinamik gövde ekleme için en iyi uygulamalar:

Eklenecek içeriği her zaman adlandırılmış XML etiketleriyle sarın
İstem ekleme saldırılarını önlemek için kullanıcı girdisini eklemeden önce temizleyin
Çok uzun belgeleri kısaltın ve kısaltmayı gövdede belirtin
Eklenen her parçayı açıkça etiketleyin (belge_1, kullanıcı_sorgusu, sohbet_geçmişi)

def safe_inject(user_content, max_chars=3000):
    safe = user_content.replace('<', '&lt;').replace('>', '&gt;')
    if len(safe) > max_chars:
        safe = safe[:max_chars] + '... [TRUNCATED]'
    return f'<user_input>\n{safe}\n</user_input>'

raw = 'User provided text here. Could be very long.'
print(safe_inject(raw))

Kod Tabanında Tutarlı Yapı

Üstbilgi/Gövde/Altbilgi kalıbının asıl gücü, uygulamanızın tamamı aynı kalıbı tutarlı biçimde kullandığında ortaya çıkar. Faydaları:

Yeni ekip üyeleri herhangi bir istemi anında anlar
Kod incelemesinde istemi incelemek daha kolaydır — inceleyenler tam olarak nereye bakacaklarını bilir
Otomatik sınamalar her bölümü bağımsız olarak doğrulayabilir
İstemleri modeller arasında taşımak kolaydır — yapı değil, yalnızca içerik değişir

Üstbilgi/Gövde/Altbilgide Yaygın Hatalar

Kalıbın etkililiğini bozan hatalar:

Biçim talimatlarını üstbilgiye koymak — yanıt üretiminden çok uzakta kalır; model bunları kısmen göz ardı eder
Görev açıklamasını gövdenin içine gömmek — model bunu bir yönerge olarak değil, işlenecek veri olarak ele alabilir
Kısıtlamaları bölümler arasında dağıtmak — denetlenmesi zordur ve çelişkilere yol açar
Altbilgi kullanmamak — istem karmaşıklığı arttıkça çıktı yapısı öngörülemez hâle gelir

Hızlı Kontrol

Üstbilgi/Gövde/Altbilgi kalıbında çıktı biçimi talimatları nereye yerleştirilmelidir ve neden?

Üstbilgi/Gövde/Altbilgi — Temel Çıkarımlar

Üstbilgi/Gövde/Altbilgi kalıbı, belge yapısı disiplinini istem mühendisliğine taşır:

Üstbilgi: Kim olduğunuz + görev — bundan sonra gelen her şey için çerçeveyi belirler
Gövde: İçerik ve bağlam — dinamik olarak eklenir ve anlamsal XML etiketleriyle sarılır
Altbilgi: Biçim talimatları ve çıktı şeması — çıktı yapısı üzerindeki etkisini en üst düzeye çıkarmak için sona yerleştirilir
Kalıp, basit istemlerden son derece karmaşık istemlere doğal olarak ölçeklenir
Altbilgi şablonları, aynı çıktı türünü kullanan istemler arasında yeniden kullanılabilir
Kod tabanındaki tutarlılık, istemlerin incelenebilir, sınanabilir ve sürdürülebilir olmasını sağlar

Sıkça Sorulan Sorular

“Başlık-Gövde-Alt Bilgi İstem Kalıbı” dersi ücretsiz mi?

Evet — “Başlık-Gövde-Alt Bilgi İstem Kalıbı” 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.

“Başlık-Gövde-Alt Bilgi İstem Kalıbı” dersinde ne öğreneceğim?

Karmaşık ve çok görevli istemlere ölçeklenebilen tutarlı bir istem yapısı oluşturun. 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.

“Başlık-Gövde-Alt Bilgi İstem Kalıbı” 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

← AI Prompt Engineering Sayfasına Dön