API Prompting

API Prompting, yapay zekânın bir API (Application Programming Interface – Uygulama Programlama Arayüzü) ile çalışmasını sağlamak amacıyla promptların yapılandırılması yaklaşımıdır. Bu yöntemde modelden yalnızca metinsel bir yanıt üretmesi değil; bir API’nin gerektirdiği parametreleri belirlemesi, yapılandırılmış veri üretmesi, API çağrısı için gerekli bilgileri hazırlaması veya API’den gelen verileri işlemesi istenir.

Basit ifadeyle API Prompting, yapay zekâ ile başka bir yazılım veya çevrim içi hizmet arasında kontrollü veri alışverişi kurulmasına yönelik promptlama yaklaşımıdır.

Örneğin: “Kullanıcının seyahat talebinden şehir, giriş tarihi, çıkış tarihi ve kişi sayısını çıkar. Bu bilgileri otel arama API’sine gönderilebilecek JSON yapısında hazırla. Kullanıcının belirtmediği bilgileri tahmin etme.”

Kullanıcı: “10 Eylül’de Ankara’ya gideceğim, iki gece kalacağım. İki kişiyiz.” dediğinde sistem şu tür yapılandırılmış veri hazırlayabilir:

{
  "city": "Ankara",
  "check_in": "2026-09-10",
  "check_out": "2026-09-12",
  "guests": 2
}

Burada yapay zekâ, doğal dildeki isteği API’nin anlayabileceği yapılandırılmış verilere dönüştürmektedir.

API Prompting ne işe yarar?

API Prompting, yapay zekânın yalnızca sohbet eden bir sistem olmaktan çıkarak başka yazılım ve hizmetlerle etkileşime girebilmesinde kullanılabilir. Örneğin hava durumu, harita, rezervasyon, e-ticaret, CRM, finans veya veri tabanı sistemleriyle çalışan uygulamalarda yararlanılabilir.

Başlıca kullanım alanları:

Parametre çıkarma: Kullanıcının doğal dildeki isteğinden API’nin ihtiyaç duyduğu değerleri belirleme.

API çağrısı hazırlama: Endpoint, parametre ve veri gövdesini uygun biçimde oluşturma.

API sonucunu yorumlama: API tarafından döndürülen JSON/XML verisini kullanıcıya anlaşılır şekilde açıklama.

Araç seçimi: Birden fazla API veya işlev arasından kullanıcının isteğine uygun olanı belirleme.

İş akışı oluşturma: Bir API’nin çıktısını başka bir API’nin girdisi olarak kullanma.

Basit ve güçlü API Prompting örneği

Basit prompt: “Hava durumu API’sini kullan.”

Bu komut hangi konum, tarih veya hava durumu bilgisinin istendiğini yeterince açıklamaz.

Daha güçlü prompt: “Kullanıcının mesajından şehir ve tarihi belirle. Hava durumu API’sinin location ve date parametrelerine dönüştür. Kullanıcı tarih belirtmediyse bugünü kullan. API sonucundan yalnızca sıcaklık, yağış olasılığı ve rüzgâr hızını kullanıcıya Türkçe olarak bildir.”

Burada hem API girdisinin oluşturulması hem de API çıktısının nasıl kullanılacağı tanımlanmıştır.

API Prompting’in temel bileşenleri

Bileşen	Örnek
API’nin amacı	Hava durumu verisi alma
İşlem/Endpoint	Forecast
Gerekli parametreler	Konum, tarih
Veri formatı	JSON
Zorunlu alanlar	location, date
Çıktıdan alınacak bilgiler	Sıcaklık, yağış, rüzgâr
Eksik veri kuralı	Eksik zorunlu bilgiyi kullanıcıdan iste
Hata yönetimi	API sonuç döndürmezse bunu belirt

API Prompting ve Function Calling

Bu iki kavram ilişkilidir ancak tamamen aynı değildir.

API Prompting, modeli API kullanımıyla ilgili davranışa doğal dil talimatlarıyla yönlendiren genel yaklaşımdır.

Function Calling/Tool Calling ise modele önceden tanımlanmış işlevlerin ve bunların parametrelerinin sunulduğu, modelin gerektiğinde uygun işlevi ve argümanları seçtiği daha yapılandırılmış mekanizmadır.

Örneğin kullanıcı: “Yarın İstanbul- Süreyyaplajı’nda hava nasıl?” dediğinde sistem uygun bir hava durumu fonksiyonunu seçerek:

{
  "location": "İstanbul",
  "date": "2026-08-22"
}

gibi argümanlar oluşturabilir. Ardından gerçek hava durumu verisi ilgili hizmetten alınabilir.

API Prompting ile JSON Prompting arasındaki fark

JSON Prompting, çıktının belirli bir veri formatında olmasını amaçlar:

“Sonucu JSON olarak ver.”

API Prompting ise bu yapılandırılmış bilginin çoğu zaman başka bir sistemle etkileşim amacıyla kullanılmasına odaklanır:

“Kullanıcının talebinden gerekli alanları çıkar ve rezervasyon API’sinin beklediği parametrelere dönüştür.”

Dolayısıyla API Prompting sırasında JSON kullanılabilir; ancak API Prompting ile JSON Prompting aynı kavram değildir.

API Prompting ile SQL Prompting arasındaki fark

SQL Prompting veri tabanını sorgulamaya odaklanırken, API Prompting harici veya dahili bir yazılım hizmetiyle belirlenmiş bir arayüz üzerinden iletişim kurulmasına odaklanır.

Örneğin:

SQL Prompting: “2026 yılındaki en yüksek satışları veri tabanından getiren SQL sorgusunu yaz.”

API Prompting: “E-ticaret API’sinden 2026 yılındaki siparişleri almak için gerekli parametreleri oluştur ve dönen verilerden en yüksek satışları belirle.”

API Prompting için örnek şablon

Etkili bir prompt şu yapıyla hazırlanabilir:

Amaç + kullanılacak API/işlev + gerekli parametreler + parametre çıkarma kuralları + eksik veri davranışı + çıktı biçimi + hata yönetimi

Örneğin: “Kullanıcının mesajından kalkış şehri, varış şehri, seyahat tarihi ve yolcu sayısını çıkar. Bunları uçuş arama API’sinin gerektirdiği parametrelere dönüştür. Kullanıcının belirtmediği değerleri tahmin etme. Zorunlu bir bilgi eksikse API çağrısı oluşturmadan önce eksik bilgiyi iste. API sonucunda bulunan uçuşları fiyat, süre ve aktarma sayısına göre karşılaştır.”

Önemli bir ayrım

API Prompting’in tek başına gerçek bir API’ye erişim sağlamadığını belirtmek gerekir. Bir modele:

“Borsa API’sinden bugünkü fiyatı getir.”

demek, modelin otomatik olarak söz konusu API’ye erişebileceği anlamına gelmez. Gerçek API erişimi için uygulamanın ilgili API veya araçla teknik olarak entegre edilmiş olması gerekir. Prompt, bu entegrasyonun nasıl kullanılacağını yönlendiren katmandır.

Kısaca: API Prompting, yapay zekâyı harici veya dahili yazılım hizmetleriyle etkileşime uygun biçimde yönlendirmek; doğal dili API parametrelerine dönüştürmek ve API sonuçlarını işlemek amacıyla kullanılan promptlama yaklaşımıdır. JSON Prompting verinin hangi formatta olacağını belirlerken, API Prompting daha çok bu verinin hangi sistemle ve hangi amaçla kullanılacağını belirler.