# Veri Aksiyonları: kendi API'niz bir araç olarak

> AI Asistan · 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

1. **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.
2. **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.
3. **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.

> **Dikkat:** 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.

---

Bu sayfayı web'de okuyun: [Veri Aksiyonları: kendi API'niz bir araç olarak](/tr/docs/ai-assistant/data-actions)
