WordPress Abilities API Rehberi: Pratik Uygulamalar

WordPress 6.9 ile tanıtılan Abilities API, tüm WordPress bileşenlerinin -hem çekirdek hem de eklentilerin- fonctionalitesini insanların ve makinelerin anlayabileceği bir dilde ortaya koymalarına olanak tanıyan bir shared dil oluşturur. Bu, WordPress sitenizi dış otomasyon araçlarıyla entegre etmek için standart ve güvenli bir yol sağlar. Abilities API‘nin bazı kullanım örnekleri merak ediyorsanız, bir AI modelinin bir kullanıcıyı satın alma sürecinde yönlendirdiğini ve hatta e-ticaret sitenizi ziyaret etmeden satın alma işlemini tamamlamasına izin verdiğini düşünün. Veya GitHub Actions’da bir CI/CD pipeline’ın bir ses veya video dosyasından çıkarılan metni işlediğini ve bunu WordPress’e yayınlamak için gönderdiğini düşünün. Kullanım örnekleri sınırsızdır.

Abilities API Nedir?

Abilities API, WordPress’in ekosistem içindeki rolünü değiştirir. Artık sadece bir blog veya CMS değil; bugün WordPress, dışardan orkestralanabilen bir dağıtılmış yürütme motoru gibi davranır, tam olarak otonom ajanlar için hazırdır. Daha fazla öğrenmek ister misiniz? Giriş yapalım.

Yetenek nedir? Bir yetenek, dış Varlıklar (örneğin AI modelleri) veya dahili bileşenler için belirli işlemleri ermögeyen, keşfedilebilir ve eyleme geçirilebilir bir kapasitedir. API, aşağıdaki gibi şeyler için kullanılabilir: İçerik arama veya belirli veritabanı işlemlerini gerçekleştirme, Site yapılandırma ayarlarını okuma, Bir yazı oluşturma, Bir JSON yapısını Gutenberg bloklarına dönüştürme. Bir yeteneği ortaya koymak, belirli bir fonctionaliteyi işletilebilir kılmak anlamına gelir. Bir yetenek keşfedilip kullanılmadan önce, merkezileşmiş bir kataloğa kaydedilmesi gerekir. Sadece o zaman WordPress ve AI modelleri bunu keşfedebilir, amaçlarını anlar ve necesita olduğunda çağırabilir.

Bir yeteneğin temel bileşenleri, girdi verileri, çıktı verileri ve işlem adımlarıdır. Bir yetenek kaydedildiğinde, bu bileşenler API tarafından kullanılır ve dış Varlıkların bu yeteneği kullanabilmesi için gerekli contrato bilgilerini sağlar. Abilities API, bu şekilde WordPress sitenizin güvenli ve standardize bir şekilde dış otomasyon araçlarıyla entegre olmasını sağlar.

Abilities API’nin bir diğer önemli özelliği, güvenlik ve erişim kontrolüdür. Bir yetenek kaydedildiğinde, API bu yeteneğe erişim izni tanımlamanızı sağlar. Bu, yalnızca yetkili dış Varlıkların bu yeteneği kullanabilmesini sağlar ve WordPress sitenizin güvenliğini sağlar.

Abilities API’nin Avantajları

Bir açıklama gerekli: bir AI modeli nunca doğrudan sitenize erişemez. Yalnızca WordPress’ten bir işlemi gerçekleştirmesini talep edebilir (örneğin, “sitedeki toplam yazı sayısını ver”). Varsayılan olarak, eklentinizin fonctionalitesi tamamen izole edilmiştir. Bir yeteneği kaydettiğinizde, altta yatan mantığın tüm ekosistem için bir hizmet olarak kullanılabilir olduğunu beyan edersiniz. Bir örnek verelim. Eklentiniz bir fonksiyonu varsa ve bu fonksiyon bir JSON nesnesini Gutenberg blokları için hazır yapılandırılmış içerik haline dönüştürebiliyorsa, bunu bir yetenek olarak kaydedebilirsiniz. Bu, diğer araçların necessário izinlerle aynı fonksiyonu tetiklemesine izin verir.

Abilities API, ayrıca eklenti geliştiricileri için de bir aantal avantaj sağlar. Bir yeteneği kaydettiğinizde, eklentinizin fonctionalitesi tüm WordPress ekosistemine açılır ve diğer eklentiler ve dış Varlıklarla entegre olabilir. Bu, eklentinizin kullanımını artırır ve daha fazla người tarafından keşfedilmesini sağlar.

Bir diğer avantaj, Abilities API’nin standardize bir şekilde çalışmasıdır. Bir yetenek kaydedildiğinde, API bu yeteneği tüm WordPress sitelerinde aynı şekilde çalışır. Bu, eklenti geliştiricileri için kolaylık sağlar ve onların farklı sitelerde aynı fonksiyonu tekrar tekrar yazmalarına gerek kalmaz.

Abilities API Uygulama Alanları

Önceki tutorial’imizde WordPress AI Client, core mantığını AI modeline ses dosyasını göndermek ve JSON biçiminde bir réponse almak için kullanmıştı, ancak bu fonctionalite bizim eklentimize mahsus kaldı. Bu süreci bir yetenek olarak kaydettiğinizde, yürütme işlemini ayrıştırırsınız ve dış Varlıkların tüm eklenti mantığını sadece bir JSON nesnesini içeren bir ses dosyası kimliğini geçirerek tetiklemesine izin verirsiniz. Bir yetenek, altta yatan PHP mantığı ve bu mantığı çağıran herhangi bir Varlık arasındaki resmi bir sözleşme olarak hizmet eder. Sözleşme, yeteneğin beklediği girdi verilerini, niyetini ve çıktı olarak döndüğü veri şemasını belirtir. Bir yeteneği kaydettiğinizde, sitenizin yetenek kayıtlarına eklenir. O andan itibaren WordPress, güvenli bir ağ geçidi gibi davranır: kimlik doğrulamasını doğrular ve gelen verilerin sözleşmede belirtilen şemayla uyumlu olup olmadığını doğrular. WordPress, yalnızca yükün sözleşmeye严格 uyduğu takdirde isteği altta yatan PHP fonksiyonuna yönlendirir.

Abilities API, ayrıca e-ticaret siteleri için de bir aantal uygulama alanı sunar. Örneğin, bir e-ticaret sitesi, Abilities API kullanarak AI modelini müşterilerin satın alma işlemlerini tamamlayabilmesi için kullanabilir. Veya, bir CI/CD pipeline kullanarak, yeni ürünler eklediğinde, AI modeli bu ürünleri otomatik olarak siteye ekleyebilir.

Bir diğer uygulama alanı, haber siteleridir. Bir haber sitesi, Abilities API kullanarak AI modelini haber makalelerini otomatik olarak oluşturabilmesi için kullanabilir. Veya, bir CI/CD pipeline kullanarak, yeni haber makaleleri eklediğinde, AI modeli bu makaleleri otomatik olarak siteye ekleyebilir.

Abilities API Kullanım Örnekleri

Bir yetenek tarafsızdır. WordPress, erişimi talep eden özel Varlığı bilmesine gerek yoktur; yalnızca isteğin yetkili olduğunu ve sözleşmenin kısıtlamalarına uyduğunu doğrular. Bir yeteneği kaydettiğinizde, eklentiniz artık sadece dahili mantığı olan bir uzantı değildir; tüm ekosistem için bir hizmet sağlayan bir bileşen haline gelir.

Abilities API’nin bir diğer önemli örneği, AI modellerinin kullanarak WordPress sitenize erişiminin sağlanmasıdır. Bir AI modeli, Abilities API kullanarak WordPress sitenize erişebilir ve belirli işlemleri gerçekleştirebilir. Örneğin, bir AI modeli, Abilities API kullanarak WordPress sitenize bir yazı ekleyebilir veya var olan bir yazıyı güncelleyebilir.

Bir diğer örnek, CI/CD pipeline’lardır. Bir CI/CD pipeline, Abilities API kullanarak WordPress sitenize erişebilir ve belirli işlemleri gerçekleştirebilir. Örneğin, bir CI/CD pipeline, Abilities API kullanarak WordPress sitenize bir yeni ürün ekleyebilir veya var olan bir ürünü güncelleyebilir.

Abilities API, ayrıca eklenti geliştiricileri için de bir aantal örnek sunar. Bir eklenti geliştiricisi, Abilities API kullanarak eklentisinin fonctionalitesini tüm WordPress ekosistemine açabilir ve diğer eklentiler ve dış Varlıklarla entegre edebilir. Örneğin, bir eklenti geliştiricisi, Abilities API kullanarak eklentisinin bir JSON nesnesini Gutenberg blokları için hazır yapılandırılmış içerik haline dönüştürebilmesini sağlayabilir.