JSON Prompting

JSON Prompting, yapay zekâya verilen talimatların veya yapay zekâdan beklenen yanıtın JSON (JavaScript Object Notation) yapısına göre düzenlenmesini sağlayan promptlama yaklaşımıdır. Özellikle çıktının insanlar tarafından okunmasının yanı sıra yazılımlar, API’ler, veri tabanları veya otomasyon sistemleri tarafından işlenmesi gerektiğinde kullanışlıdır.

JSON Prompting ile yapay zekâdan serbest biçimli bir metin yerine, önceden belirlenmiş anahtar-değer (key-value) yapısına uygun ve makine tarafından kolayca işlenebilen bir çıktı üretmesi istenir.

Örneğin:

“Aşağıdaki müşteri yorumunu analiz et. Yanıtını yalnızca geçerli JSON biçiminde ver. duygu, konu, memnuniyet_puani ve özet alanlarını kullan.”

Beklenen çıktı:

{
  "duygu": "olumlu",
  "konu": "müşteri hizmetleri",
  "memnuniyet_puani": 8,
  "özet": "Müşteri hizmet hızından ve personelin yaklaşımından memnun."
}

JSON Prompting ne işe yarar?

JSON Prompting özellikle yapılandırılmış veri elde etmek istediğimiz durumlarda önemlidir. Yapay zekânın ürettiği bilgiler farklı alanlara ayrılabildiği için sonuçların başka sistemlere aktarılması, filtrelenmesi ve otomatik olarak işlenmesi kolaylaşır.

Örneğin şu amaçlarla kullanılabilir:

Veri çıkarma: Metindeki kişi, kurum, tarih veya ürün bilgilerinin ayrıştırılması.

Sınıflandırma: Müşteri yorumlarının olumlu, olumsuz veya nötr olarak sınıflandırılması.

İçerik analizi: Metinlerden tema, duygu, anahtar kelime veya kategori çıkarılması.

API ve yazılım entegrasyonu: Yapay zekâ çıktısının başka bir uygulamaya aktarılması.

Otomasyon: Yapay zekâ tarafından üretilen verilerin sonraki işlemleri otomatik olarak tetiklemesi.

Normal Prompt ve JSON Prompting karşılaştırması

Normal prompt:

“Bu müşteri yorumunu analiz et.”

Bu talimat sonucunda yapay zekâ serbest biçimli bir açıklama üretebilir.

JSON Prompting:

“Bu müşteri yorumunu analiz et. Yanıtı yalnızca geçerli JSON olarak ver. Aşağıdaki alanları kullan: duygu, temel_sorun, önem_düzeyi, önerilen_eylem.”

Beklenen yapı:

{
  "duygu": "olumsuz",
  "temel_sorun": "teslimat gecikmesi",
  "önem_düzeyi": "yüksek",
  "önerilen_eylem": "Müşteriye gecikmenin nedeni ve yeni teslim tarihi bildirilmeli."
}

Daha gelişmiş JSON Prompting örneği

Yapay zekâdan yalnızca alan isimlerini değil, bu alanların veri türlerini ve kullanabileceği değerleri de sınırlandırması istenebilir:

“Aşağıdaki ürün değerlendirmesini analiz et. Yalnızca geçerli JSON üret. sentiment alanı yalnızca positive, negative veya neutral değerlerinden birini alsın. score 1–10 arasında tam sayı olsun. keywords en fazla beş öğeden oluşan bir dizi olsun.”

Örneğin:

{
  "sentiment": "positive",
  "score": 9,
  "keywords": [
    "kalite",
    "tasarım",
    "fiyat",
    "teslimat"
  ]
}

Bu tür kısıtlamalar, çıktının daha tutarlı ve programatik olarak kullanılabilir olmasını sağlar.

JSON Prompting ile JSON Mode aynı şey midir?

Tam olarak değildir.

JSON Prompting, prompt içerisinde modele JSON biçiminde yanıt vermesinin söylenmesidir.

JSON Mode ise bunu destekleyen bir model veya API’de çıktının geçerli JSON olmasını teknik düzeyde sağlamaya yönelik bir özelliktir.

Daha katı uygulamalarda ise Structured Output, yalnızca geçerli JSON üretilmesini değil, çıktının önceden belirlenen bir JSON Schema yapısına uymasını da sağlayabilir.

Bu nedenle kabaca:

JSON Prompting → “JSON biçiminde cevap ver.”
JSON Mode → “Çıktının geçerli JSON olması sağlansın.”
Structured Output → “Çıktı şu kesin şemaya uygun olsun.”

Markdown Prompting ile farkı

Özellik	Markdown Prompting	JSON Prompting
Temel amaç	Okunabilir ve düzenli içerik	Yapılandırılmış veri
Öncelikli kullanıcı	İnsan	İnsan + yazılım
Yapı	Başlık, liste, tablo vb.	Anahtar-değer çiftleri
Otomasyona uygunluk	Orta	Yüksek
API kullanımına uygunluk	Sınırlı	Çok yüksek
Tipik kullanım	Makale, dokümantasyon, web içeriği	Veri çıkarma, API, sınıflandırma, otomasyon

Etkili JSON Prompting için örnek şablon

“Aşağıdaki metni analiz et ve yalnızca geçerli JSON biçiminde yanıt ver. Açıklama veya Markdown kod bloğu ekleme. Çıktıda konu, anahtar_kelimeler, duygu, özet ve güven_puani alanları bulunsun. anahtar_kelimeler bir dizi, güven_puani ise 0 ile 1 arasında sayısal değer olsun. Metinde bulunmayan bilgileri tahmin etme; bulunmayan alanlarda null kullan.”

Kısaca: JSON Prompting, yapay zekâdan standartlaştırılmış, yapılandırılmış ve makineler tarafından kolayca işlenebilen çıktılar almak amacıyla kullanılan promptlama yaklaşımıdır. Özellikle yapay zekânın diğer yazılımlar, API’ler, otomasyonlar ve veri işleme süreçleriyle birlikte kullanılacağı uygulamalarda önem kazanır.