Yapay Zeka Ajanları İçin API Tasarımı: Pratik Rehber
crmkit'in ajan odaklı API tasarımı: JSON yerine metin, kısa kimlikler, toplu işlemler ve kendi kendini belgeleyen uç noktalar.
Sadece yapay zeka ajanları tarafından kullanılmak üzere tasarlanmış headless bir CRM olan crmkit'i geliştiren yazar, API tasarımının artık bambaşka bir çağrı yapan tarafa göre şekillenmesi gerektiğini anlatıyor: tarayıcı yerine, token bütçesiyle çalışan bir dil modeli. Temel fark, ajanların yanıtları ayrıştırmak yerine okuması; bu da geleneksel API tasarım varsayımlarının neredeyse tamamını değiştiriyor.
Önerilen pratikler arasında JSON yerine düz, grep'lenebilir metni varsayılan format yapmak, UUID yerine kısa ve önekli kimlikler kullanmak, ve ajanın bir sonraki adımda muhtemelen ihtiyaç duyacağı bilgiyi önceden yanıta eklemek yer alıyor. Toplu işlemler hem yazma hem okuma tarafında kritik, çünkü her ajan kararı sadece bir ağ gidiş-dönüşü değil, ek bir düşünme adımı maliyeti de taşıyor.
Diğer öneriler: hata mesajlarının somut ipuçları içermesi ve yeniden denemenin anlamlı olup olmadığını açıkça belirtmesi gerekiyor, çünkü ajanların varsayılan tepkisi tekrar denemek. Yazma işlemlerinin idempotent olması şart, çünkü ajanlar işlemleri sık sık tekrarlıyor veya yeniden başlatıyor; dokümantasyon da harici bir site yerine API'nin kendi içinde makine tarafından okunabilir bir uç nokta olarak sunulmalı.