Yapay zeka sözlüğü / API

⚙️ Teknik

API, yani uygulama programlama arayüzü, bir programın başka bir programın işlevlerinden veya verilerinden arayüzüne elle tıklamadan yararlanmasını sağlayan belirli bir yöntemdir.

Türkiye'deki bir mağaza, API aracılığıyla döviz kurunu alıp kendi panelinde gösterebilir. Çalışan sayfadaki sayıyı elle kopyalamak yerine para birimi kodu, tarih ve kur bilgisini içeren düzenli bir yanıt alır. Bu, başlangıç için iyi bir örnektir; çünkü yapay zekâ modeli gerektirmez ve müşteri verilerinin gönderilmesini gerektirmez. API kullanmak, yapay zekâ kullanıldığı anlamına gelmez.

API'ye ilk istek nasıl görünür?

Tarayıcınızda https://api.nbp.pl/api/exchangerates/rates/a/eur/?format=json adresini açın. Bu, belirli bir işlevin adresi olan herkese açık bir endpoint'tir: A tablosundaki EUR için yayımlanmış en son ortalama kuru okur. Yanıtta, yayımlanma tarihini içeren effectiveDate ve kurun yer aldığı mid alanları bulunur. Hafta sonu bu tarih günün tarihi olmayabilir.

Verileri bu şekilde almak bir GET isteğidir. Program bu isteği otomatik olarak gönderip ihtiyaç duyduğu alanları JSON'dan, yani metin tabanlı bir veri biçiminden okuyabilir. Yapay zekâ modeline içerik gönderirken genellikle POST kullanılır: adrese ek olarak başlıklar ve istek içeriği de gönderilir. Kullanılan biçimi her zaman hizmet sağlayıcı belirler. API belgelerinde parametreler, tarih aralıkları ve hata yanıtları açıklanır.

Alıştırma için tek bir kur ve tek bir tarih seçin. Yanıt gelmediğinde veya belirtilen tablo henüz mevcut olmadığında uygulamanın ne yapacağını kontrol edin. Böyle bir durumda sıfır değerini kullanmayın; çünkü sıfır geçerli bir sayı gibi görünür. Veri olmadığını veya son okuma tarihini gösterin. Bu, çalışan bir adresi kopyalamaktan daha önemli bir beceridir.

API yapay zekâ için ne işe yarar?

Örneğin küçük bir şirket Türkçe mesajlar alıyor ve bunları teslimat, iade ve diğer konularla ilgili sorular olarak sınıflandırmak istiyor. Şirketin programı anonimleştirilmiş metni bir modele gönderip tek bir kategori belirlemesini isteyebilir. Ardından sonucu panele kaydeder. Modelin yanıtı yine de kontrol edilmelidir: izin verilen kategori seçeneklerinden biri olmalı, doğrudan para iadesi başlatmamalıdır.

API, modeli kendi formunuza, e-tablonuza veya uygulamanıza entegre etmenizi sağlar. Ancak yanıtın doğru olacağını garanti etmez. Tarayıcıda kullanabildiğiniz sohbet hizmetiyle sağlayıcının API'sinin ücretlendirmesi, limitleri ve erişim koşulları farklı olabilir. Hizmeti şirket verilerinize bağlamadan önce yalnızca sohbet aboneliği teklifini değil, API koşullarını da kontrol edin.

Entegrasyon adım adım nasıl kurulur?

1. Tek bir işlem ve sonuç biçimi belirleyin. Başlangıç için isimler ve sipariş bilgileri olmadan beş örnek mesajı sınıflandırmanız yeterlidir.

2. Kimlik doğrulama belgelerini kontrol edin. API anahtarı gerekiyorsa sunucu tarafında saklayın. Anahtarı herkese açık sayfa koduna, ekran görüntülerine veya kod deposuna eklemeyin. Her API anahtar gerektirmez; yukarıdaki kur sorgusu için anahtar gerekmez.

3. Zaman aşımı ve hata yönetimini ayarlayın. 401 yanıtı genellikle kimlik doğrulama sorununa, 429 yanıtı ise limitlerin aşılmasına işaret eder. Ayrıntıları belgelerden ve hata mesajından kontrol edin. Ücretli bir isteği durmadan yeniden göndermeyin; bağlantı kesilse bile hizmet isteği zaten yerine getirmiş olabilir.

4. Maliyeti, durumu ve işlem süresini kaydedin; gizli bilgileri veya özel mesajların tam metnini kaydetmeyin. Deneme sayısını, girdi uzunluğunu ve en yüksek sonuç miktarını sınırlayın. Sağlayıcının harcama limitinin işlemleri durdurup durdurmadığını, yoksa yalnızca bildirim mi gönderdiğini kontrol edin.

5. Boş metni, ağ bağlantısının kesilmesini ve hatalı yanıtı test edin. Çok sayıda kayıt üzerinde çalışmaya ancak küçük bir örneği kontrol ettikten sonra başlayın.

En sık yapılan hata: API'yi kullanıma hazır bir uygulama sanmak

API işlevlere erişim sağlar, ancak tüm iş akışını kurmaz. Birinin girdi verilerini kontrol etmesi, hizmetin yanıt vermemesi durumunu yönetmesi, anahtarı koruması ve sonuçla ne yapılacağına karar vermesi gerekir. Bir kitaplık veya SDK bu kodu yazmayı kolaylaştırır; API'nin başka bir adı değildir. Arayüz ile kitaplık arasındaki farkı MDN'nin giriş yazısında bulabilirsiniz.