Veri Aksiyonları: kendi API'niz bir araç olarak
Zaten sahip olduğunuz bir ucu asistanın çağırabileceği bir şeye çevirin.
Veri Aksiyonları, hiçbir dokümanın cevaplayamayacağı sorular içindir: "siparişim nerede?", "depoda kaç tane kaldı?", "üyeliğim hâlâ geçerli mi?". Cevap sizin kendi sisteminizde, bir API'nin arkasında durur. Veri Aksiyonu, bir kez tarif edilmiş o uçtur; asistan konuşmanın ortasında onu çağırıp gerçek rakamla cevap verir.
İpucu: Kendi API'niz yok mu? Bu sayfayı atlayın. Asistan onsuz da eksiksizdir — burası sistemleri zaten HTTP konuşan ekipler için.
API Bağlantıları'ndan farkı#
İkisi de asistana araç verir; fark, sunucuyu kimin çalıştırdığındadır. API Bağlantıları, hâlihazırda var olan ve kendi araçlarını sunan bir MCP sunucusuna bağlanır. Veri Aksiyonları ise böyle bir sunucu yokken kullanılır: uçlarınızı burada tarif edersiniz, Pommy bunları asistana araç olarak sunar. API'nizin bir OpenAPI dokümanı varsa elle hiçbir şey tarif etmezsiniz — içe aktarın, uçlar bir grup hâlinde gelsin.
Gruplar ve aksiyonlar#
Aksiyonlar gruplar içinde yaşar. Bir grup tek bir sistemdir — "Sipariş API'si", "Depo" — kendi kök adresi ve gerekiyorsa kendi kimlik doğrulamasıyla. İçinde her aksiyon tek bir uçtur: asistanın gördüğü bir ad, ne zaman kullanılacağının açıklaması, yöntem ve yol, bir de parametreler. Açıklamayı geliştirici için değil, asistan için yazın: ona bu aksiyonun *ne zaman* doğru olduğunu söyleyen tek şey odur.
Nasıl eklenir#
- Bir grup oluşturun
Sol menüden Veri Aksiyonları'nı açın ve bağladığınız sistem için bir grup oluşturun. Kök adresini verin; API kimlik bilgisi istiyorsa buraya ekleyin — bilgiler grupta durur, her aksiyonda tekrarlanmaz.
- Aksiyonları ekleyin ya da içe aktarın
Uçları tek tek ekleyin ya da OpenAPI'den İçe Aktar ile Pommy'nin dokümanı okumasına izin verin. İçe aktarılan aksiyonlar kapalı gelir; yayına girmeden önce gözden geçirebilirsiniz.
- Asistanın kullanacaklarını açın
Her aksiyonun kendi anahtarı var, grubun da. Yalnız bu asistanın gerçekten ihtiyacı olanı açın — kapalı bir aksiyon onun için görünmezdir.
Kimin sorduğunu bilmesi gereken aksiyonlar#
Bazı cevaplar kişiseldir — sipariş tek bir müşteriye aittir. Bir grup kimlik gerektiriyor diye işaretlenebilir; o zaman aksiyonları yalnız konuşmada doğrulanmış bir ziyaretçi varken çalışır. Bir yabancının başkasının siparişini sormasını engelleyen şey budur.
Uyarı: Bir Veri Aksiyonu, gruba verdiğiniz kimlik bilgileriyle canlı sisteminize gider. Yalnız okuyan uçlarla başlayın; yazan bir şeyi ancak okuyanların davranışını izledikten sonra ekleyin.
Nasıl test edilir#
Bir aksiyonu açtıktan sonra müşterinin soracağı soruyu sorun — widget'ta, onun kelimeleriyle, ucun adıyla değil. Asistan sisteminizden cevap veriyorsa açıklama işini yapıyordur. Aksiyonu görmezden geliyorsa sebep genelde açıklamadır: aksiyonun neyi cevapladığını ve ne zaman kullanılacağını açıkça yazın.