Araç kataloğu
Yapay zekânın kullanabileceği araçların tam listesi; bu sayfa Treyza'nın kendi araç kaydından üretilir, elle yazılmaz.
Nerede bulunur: Anahtar oluştururken Yetkileri seçin adımındaki Araç paketleri listesi Kimler için: Bir anahtarın tam olarak neyi yapabildiğini görmek isteyen herkes Kısaca: Yapay zekânın kullanabileceği araçların tam listesi; bu sayfa Treyza'nın kendi araç kaydından üretilir, elle yazılmaz.
Araç nedir?
Yapay zekâ mağazanıza doğrudan bakmaz; Treyza'nın ona verdiği araçları çağırır. Her araç tek bir işi yapar ve tek bir izin ister. Siz anahtar oluştururken paket seçersiniz; paket, birbiriyle ilgili araçların kutusudur.
Yapay zekâ yalnız anahtarınızın kapsamındaki araçları görür. Kapalı bir paketin araçları listede hiç görünmez — yapay zekâ onların var olduğunu bile bilmez.
Bugün yayında 59 araç var; bunların 27 tanesi veri değiştirebilir (yazma aracı).
Paketler
| Paket | Gereken yetki | Yazma içerir mi | Durum |
|---|---|---|---|
Temel meta | — (yetki istemez) | Hayır | Yayında — 4 araç |
Katalog (okuma) catalog.read | PRODUCTS_READ | Hayır | Yayında — 11 araç |
Siparişler (okuma) orders.read | ORDERS_READ | Hayır | Yayında — 4 araç |
Raporlar analytics | FINANCE_READ, ORDERS_READ, PRODUCTS_READ | Hayır | Yayında — 4 araç |
Katalog (yazma) catalog.write | PRODUCTS_READ, PRODUCTS_WRITE | Evet | Yayında — 13 araç |
Siparişler (yazma) orders.write | ORDERS_READ, ORDERS_WRITE | Evet | Yayında — 5 araç |
Müşteriler (okuma) customers | CUSTOMERS_READ | Hayır | Yayında — 5 araç |
Müşteriler (yazma) customers.write | CUSTOMERS_READ, CUSTOMERS_WRITE | Evet | Yayında — 2 araç |
Mağaza ayarları store.settings | SETTINGS_READ, SETTINGS_WRITE | Evet | Yayında — 2 araç |
Galeri (okuma) media | PRODUCTS_READ | Hayır | Yayında — 3 araç |
Galeri (yazma) media.write | PRODUCTS_READ, PRODUCTS_WRITE | Evet | Yayında — 6 araç |
Pazarlama marketing | MARKETING_WRITE | Evet | Henüz yayında değil |
İçerik content | CONTENT_WRITE | Evet | Henüz yayında değil |
Tema editörü theme | THEME_WRITE | Evet | Henüz yayında değil |
Yetki kodlarının ne anlama geldiği: Güvenlik ve izinler
Bir paketi seçebilmeniz için sizde o yetkinin olması gerekir. Yazma içeren paketler yalnız Okuma-yazma modundaki anahtarlarda seçilebilir.
Araçlar
Temel meta
Mağaza kimliği, yetenek listesi ve yardım merkezi araması. Her anahtarda açıktır ve kapatılamaz.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
whoami | Bu anahtarın bağlı olduğu mağazayı, planı, anahtar modunu, kapsamlarını ve açık araç paketlerini döndürür. | — (yetki istemez) | Evet |
capabilities | Araç paketlerinin listesi: hangisi bu anahtara açık, kapalıysa nedeni ve paket başına araç sayısı. | — (yetki istemez) | Evet |
store_get | Mağazanın adı, slug'ı, alan adları, para birimi, dili, saat dilimi ve durumu. | — (yetki istemez) | Evet |
help_search | Treyza yardım merkezinde arama yapar; başlık, bağlantı ve kısa alıntı döndürür. | — (yetki istemez) | Evet |
Katalog (okuma) catalog.read
Ürün, varyant, stok, kategori, marka, etiket ve fiyat listesi okuma.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
products_list | Mağazanın ürünlerini süzerek sayfalı biçimde listeler: stok, fiyat, durum, kategori, marka, etiket ve metin araması. | PRODUCTS_READ | Evet |
products_get | Tek bir ürünün künyesini döndürür: ad, durum, tip, fiyat, toplam stok, kategori ve varyant sayısı. | PRODUCTS_READ | Evet |
products_search | Ada, SKU'ya ya da barkoda göre ürün arar ve en çok 5 en iyi eşleşmeyi döndürür; kimlik bulmanın en ucuz yoludur. | PRODUCTS_READ | Evet |
variants_list | Bir ürünün varyantlarını (beden, renk gibi seçenek birleşimlerini) fiyat ve stoklarıyla listeler. | PRODUCTS_READ | Evet |
stock_get | Bir ürünün stoğunu depo ve varyant kırılımıyla döndürür; düşük stok eşiği de yanıttadır. | PRODUCTS_READ | Evet |
stock_movements_list | Bir tarih aralığındaki stok hareketlerini verir: varsayılan olarak ürün başına toplayıp net değişimi, toplam giriş ve çıkışı döndürür; istenirse hareketleri tek tek listeler. | PRODUCTS_READ | Evet |
products_seo_get | Bir ürünün arama motoru alanlarını döndürür: arama başlığı ve açıklaması, paylaşım başlığı/açıklaması, kanonik adres, anahtar kelimeler ve sayfanın dizine açık olup olmadığı. | PRODUCTS_READ | Evet |
categories_list | Mağazanın kategori ağacını sayfalı biçimde listeler; her satır kendi üst kategorisini parentId ile gösterir. | PRODUCTS_READ | Evet |
brands_list | Mağazadaki markaları sayfalı biçimde listeler. | PRODUCTS_READ | Evet |
tags_list | Ürün etiketlerini sayfalı biçimde listeler. | PRODUCTS_READ | Evet |
price_lists_get | Mağazanın fiyat listelerini döndürür: para birimi, durum, öncelik, geçerlilik aralığı ve içerdiği ürün sayısı. | PRODUCTS_READ | Evet |
Siparişler (okuma) orders.read
Sipariş, kargo gönderisi ve iade talebi okuma.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
orders_list | Mağazanın siparişlerini süzerek sayfalı biçimde listeler: durum, ödeme durumu, tarih aralığı, tutar aralığı, satış kanalı, kaynak ve müşteri araması. | ORDERS_READ | Evet |
orders_get | Tek bir siparişin künyesini döndürür: durum, tutar, kalem sayısı, teslimat şehri ve istenirse kalemler, adres, ödeme ve durum geçmişi. | ORDERS_READ | Evet |
shipments_list | Mağazanın kargo gönderilerini süzerek sayfalı biçimde listeler: taşıyıcı, takip numarası, gönderi durumu, koli sayısı, desi ve hareket geçmişi. | ORDERS_READ | Evet |
returns_list | Mağazaya açılan iade ve değişim taleplerini süzerek sayfalı biçimde listeler: durum, tip, müşteri, tarih aralığı. | ORDERS_READ | Evet |
Raporlar analytics
Satış özeti, çok satanlar, trafik kırılımı ve zamanlanmış rapor listesi.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
sales_summary | Seçilen dönemin satış ve trafik özetini döndürür: ciro, sipariş sayısı, ortalama sepet, dönüşüm oranı, ziyaretçi ve oturum sayısı. | FINANCE_READ | Evet |
top_products | Seçilen dönemde en çok satan, en çok kazandıran ya da en çok görüntülenen ürünleri sıralar. | FINANCE_READ, PRODUCTS_READ | Evet |
traffic_summary | Seçilen dönemde trafiğin hangi kaynaktan geldiğini, her kaynağın kaç oturum, kaç sipariş ve ne kadar ciro getirdiğini döndürür. | FINANCE_READ | Evet |
reports_list | Mağazada tanımlı zamanlanmış raporları listeler: adı, hangi veri kümesini çıkardığı, sıklığı, açık mı ve en son ne zaman koştuğu. | FINANCE_READ | Evet |
Katalog (yazma) catalog.write
Ürün oluşturma (yayında değil), ürün bilgisi, stok ve fiyat güncelleme; kategori, marka ve etiket oluşturma ve güncelleme; ürünlere toplu kategori/etiket atama. Oluşturma ve toplu işlemler önizlemeli. Silme ve yayına alma bu pakete hiç girmez.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
products_create | Mağazaya yeni bir basit (varyantsız) ürün kurar: ad, kategoriler, açıklamalar, stok kodu, fiyat, marka ve etiketler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
products_update | Tek bir ürünün adını, kısa ve uzun açıklamasını, stok kodunu, markasını ve etiketlerini değiştirir; verilmeyen alanlara dokunmaz. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
products_seo_update | Tek bir ürünün arama motoru alanlarını değiştirir: arama başlığı, arama açıklaması, paylaşım başlığı ve açıklaması, kanonik adres, anahtar kelimeler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
stock_update | Bir ürünün ya da varyantın bir depodaki stoğunu verilen değere ÇEKER; üstüne ekleme yapmaz, mevcut değerin yerine yazar. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
price_update | Tek bir ürünün ya da varyantın satış, liste ve maliyet fiyatını değiştirir. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
products_bulk_update | Bir süzgeçle seçilen ürünlerin satış fiyatını topluca değiştirir: yüzde zam/indirim ya da sabit fiyat. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
products_bulk_assign | Seçtiğin ürünlere topluca kategori ya da ürün etiketi bağlar; tek ürün için de kullanılabilir (productIds tek kimlik). | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
categories_create | Mağazaya yeni bir kategori ekler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
categories_update | Bir kategorinin adını, üst kategorisini, açıklamalarını ve vitrinde görünürlüğünü değiştirir; verilmeyen alanlara dokunmaz. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
brands_create | Mağazaya yeni bir marka ekler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
brands_update | Bir markanın adını, açıklamasını ve vitrinde görünürlüğünü değiştirir; verilmeyen alanlara dokunmaz. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
tags_create | Mağazaya yeni bir ürün etiketi ekler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
tags_update | Bir ürün etiketinin adını ve vitrinde görünürlüğünü değiştirir; verilmeyen alanlara dokunmaz. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
products_create, products_bulk_update, products_bulk_assign, categories_create, brands_create, tags_create önce önizleme yapar: kaç kaydın etkileneceğini ve örnek satırların önce/sonra değerini döndürür, hiçbir şeyi değiştirmez. Uygulamak için yapay zekânın önizlemeden aldığı tek kullanımlık jetonu geri vermesi gerekir; jeton 5 dakika yaşar ve argümanlardan biri değişirse geçersiz olur.
Siparişler (yazma) orders.write
Sipariş durumunu ilerletme, sipariş notu ve kargo gönderisi girişi. Sipariş iptali, iade ve ödeme işlemleri bu pakete hiç girmez.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
orders_status_update | Tek bir siparişin durumunu ilerletir: CONFIRMED (onaylandı) → PREPARING (hazırlanıyor) → SHIPPED (kargoya verildi) → DELIVERED (teslim edildi). | ORDERS_READ, ORDERS_WRITE | Hayır |
orders_note_update | Bir siparişin notunu değiştirir. | ORDERS_READ, ORDERS_WRITE | Hayır |
orders_note_add | Bir siparişe mağaza ekibinin göreceği bir İÇ NOT ekler. | ORDERS_READ, ORDERS_WRITE | Hayır |
orders_shipment_create | Bir siparişe kargo gönderisi ekler: taşıyıcı firma, takip numarası ve isteğe bağlı koli/ağırlık bilgisi. | ORDERS_READ, ORDERS_WRITE | Hayır |
orders_shipment_status_update | Var olan bir kargo gönderisinin takip durumunu ilerletir: LABEL_CREATED, IN_TRANSIT, UNDELIVERED, DELIVERED. | ORDERS_READ, ORDERS_WRITE | Hayır |
orders_note_update önce önizleme yapar: kaç kaydın etkileneceğini ve örnek satırların önce/sonra değerini döndürür, hiçbir şeyi değiştirmez. Uygulamak için yapay zekânın önizlemeden aldığı tek kullanımlık jetonu geri vermesi gerekir; jeton 5 dakika yaşar ve argümanlardan biri değişirse geçersiz olur.
Müşteriler (okuma) customers
Müşteri, etiket ve grup kayıtlarını okuma. Liste yanıtlarında e-posta, telefon ve adres hiç geçmez; iletişim bilgisi yalnız tek müşteri sorulduğunda ve açıkça istendiğinde, varsayılan olarak maskeli döner.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
customers_list | Mağazanın kayıtlı müşterilerini sayfalı biçimde listeler: ad, kayıt tarihi ve etiketler. | CUSTOMERS_READ | Evet |
customers_get | Tek bir müşterinin künyesini döndürür: ad, kayıt tarihi, etiketler, pazarlama izni durumu ve giriş yöntemi. | CUSTOMERS_READ | Evet |
customers_tags_list | Mağazada tanımlı müşteri etiketlerini listeler: etiketin kimliği, adı ve kaç müşteriye takılı olduğu. | CUSTOMERS_READ | Evet |
customers_groups_list | Mağazanın müşteri gruplarını (segmentlerini) listeler: ad, tür, üye sayısı ve etkin olup olmadığı. | CUSTOMERS_READ | Evet |
customers_group_members | Bir müşteri grubunun üyelerini sayfalı biçimde listeler ve her üye için sipariş sayısını ve toplam harcamasını döndürür. | CUSTOMERS_READ | Evet |
Müşteriler (yazma) customers.write
Müşteriye etiket takma ve sökme, elle yönetilen müşteri grubuna üye ekleme ve çıkarma. Müşteri oluşturma, silme, iletişim bilgisi ve pazarlama izni değiştirme, müşteri notu yazma, grup oluşturma ve toplu dışa aktarma bu pakete hiç girmez.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
customers_tag_update | Tek bir müşteriye etiket takar ya da müşteriden etiket söker. | CUSTOMERS_READ, CUSTOMERS_WRITE | Hayır |
customers_group_members_update | Bir MANUAL müşteri grubuna müşteri ekler ve gruptan müşteri çıkarır. | CUSTOMERS_READ, CUSTOMERS_WRITE | Hayır |
customers_group_members_update önce önizleme yapar: kaç kaydın etkileneceğini ve örnek satırların önce/sonra değerini döndürür, hiçbir şeyi değiştirmez. Uygulamak için yapay zekânın önizlemeden aldığı tek kullanımlık jetonu geri vermesi gerekir; jeton 5 dakika yaşar ve argümanlardan biri değişirse geçersiz olur.
Mağaza ayarları store.settings
Genel, vergi, sepet, bildirim, SEO, bölgesel, ürün görünümü ve site yapısı ayarları. Kargo taşıyıcı bilgileri ve sağlayıcı sırları bu pakete hiç girmez.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
settings_read | Mağaza ayarlarını bölüm bölüm okur; section verilmezse yalnız bölüm adlarını ve ne işe yaradıklarını listeler, bütün ayarları tek seferde dökmez. | SETTINGS_READ | Evet |
settings_update | Tek bir ayar bölümünün verdiğin alanlarını değiştirir; vermediğin alanlara dokunmaz. | SETTINGS_READ, SETTINGS_WRITE | Hayır |
settings_update önce önizleme yapar: kaç kaydın etkileneceğini ve örnek satırların önce/sonra değerini döndürür, hiçbir şeyi değiştirmez. Uygulamak için yapay zekânın önizlemeden aldığı tek kullanımlık jetonu geri vermesi gerekir; jeton 5 dakika yaşar ve argümanlardan biri değişirse geçersiz olur.
Galeri (okuma) media
Medya kütüphanesini okuma: dosyalar, klasör ağacı, depolama kullanımı ve bir görselin hangi ürün, kategori, marka ya da tema bileşeninde kullanıldığı.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
media_list | Mağazanın medya kütüphanesindeki dosyaları listeler: görsel, video ve diğer dosyalar. | PRODUCTS_READ | Evet |
media_get | Tek bir galeri dosyasının bütün bilgisini ve NEREDE KULLANILDIĞINI döndürür. | PRODUCTS_READ | Evet |
media_folders_list | Medya kütüphanesinin klasör ağacını ve mağazanın depolama kullanımını döndürür. | PRODUCTS_READ | Evet |
Galeri (yazma) media.write
Adresten görsel ekleme, dosya adlandırma ve taşıma, klasör açma, adlandırma ve taşıma, dosya ve klasör silme. Silme ve klasör silme önizlemesiz uygulanamaz ve GERİ ALINAMAZ. Dosya yükleme, görsel işleme ve mağaza yedeği alma bu pakete hiç girmez.
| Araç | Ne yapar | Gereken yetki | Salt okuma |
|---|---|---|---|
media_import_url | Verilen adresteki görseli sunucu indirir, küçültüp mağazanın deposuna koyar ve galeriye yeni bir dosya olarak ekler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_update | Bir galeri dosyasını yeniden adlandırır ve/veya başka bir klasöre taşır. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_delete | Bir ya da birkaç dosyayı medya kütüphanesinden siler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_folder_create | Medya kütüphanesinde yeni bir klasör açar. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_folder_update | Bir klasörü yeniden adlandırır ve/veya başka bir klasörün altına taşır. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_folder_delete | Bir klasör kaydını siler. | PRODUCTS_READ, PRODUCTS_WRITE | Hayır |
media_delete, media_folder_delete GERİ ALINAMAZ. Platformda galeriyi geri yükleyen bir uç yok: Galeri yedeği yalnız indirilebilir bir ZIP arşivi üretir, dosyaları geri koymaz ve indirme bağlantısı süreli. Silinen bir dosyayı kullanan ürün, kategori, marka ve tema bileşeni görselsiz kalır; silinen bir klasörün içindeki dosyalar kök klasöre, alt klasörleri de kök seviyesine düşer.
media_delete, media_folder_delete önce önizleme yapar: kaç kaydın etkileneceğini ve örnek satırların önce/sonra değerini döndürür, hiçbir şeyi değiştirmez. Uygulamak için yapay zekânın önizlemeden aldığı tek kullanımlık jetonu geri vermesi gerekir; jeton 5 dakika yaşar ve argümanlardan biri değişirse geçersiz olur.
Pazarlama marketing
İndirim kodları, kampanyalar ve e-posta akışları.
Bu paket henüz yayında değil; anahtar oluştururken seçilemez. Hazır olduğunda araçları burada listelenecek.
İçerik content
Blog, yasal sayfalar, sıkça sorulanlar, yönlendirmeler ve SEO.
Bu paket henüz yayında değil; anahtar oluştururken seçilemez. Hazır olduğunda araçları burada listelenecek.
Tema editörü theme
Tema ve şablon yüzeyi.
Bu paket henüz yayında değil; anahtar oluştururken seçilemez. Hazır olduğunda araçları burada listelenecek.
Sayılar nereden geliyor?
Rapor araçlarının hepsi aynı yerden beslenmez ve bu, iki aracın aynı soruya farklı sayı vermesinin en sık sebebidir. Aşağıdaki liste araç kaydından üretilir, yani her zaman günceldir.
| Araç | Sayı nereden okunuyor | Ne anlama gelir |
|---|---|---|
sales_summary | Sipariş kayıtları | Sipariş sayısı, ciro ve ortalama sepet sipariş tablosundan okunur — sipariş listesiyle aynı yetkili kaynak. Muhasebe ve mutabakat sorularında güvenilir. Aynı aracın ziyaretçi ve oturum sayıları olaylardan gelir. |
top_products | Ziyaret olayları | Kırılım mağaza ziyaretlerinden toplanan olaylardan üretilir; olayı toplanmamış bir sipariş burada görünmez ve kırılımların toplamı satış özetinin toplamını tutmayabilir. |
traffic_summary | Ziyaret olayları | Kırılım mağaza ziyaretlerinden toplanan olaylardan üretilir; olayı toplanmamış bir sipariş burada görünmez ve kırılımların toplamı satış özetinin toplamını tutmayabilir. |
Ciro, tahsil edilen para değildir. Satış özetindeki ciro sipariş tutarıdır: sipariş verildiği anda toplama girer, ödemesi henüz alınmamış olsa bile. Panelin kontrol panelindeki Net Gelir kartı ise tahsilat esaslıdır ve bu yüzden daha düşük çıkabilir. İkisi de doğrudur; farkı bozukluk değil tanım yaratır.
Bir ürünün kesin satış adedi ya da kesin ciro gerekiyorsa sipariş listesini kullanın: "Son 30 günün siparişlerini listele ve toplam tutarı hesapla."
Bilmekte fayda var
- Araçlar kısa cevap verir. Her araç yanıtını küçük tutar ve gerekirse sonucu böler; yapay zekâ "devamını getir" diyerek kalanını alır. Uzun listelerde ilk yanıtın kısa olması normaldir.
- Kişisel veri maskelidir. Sipariş araçlarında ad, telefon, e-posta ve açık adres yıldızlı döner. Maskeyi açmak
CUSTOMERS_READyetkisi ister ve denetim kaydına düşer. - Hangi sayının nereden geldiği yukarıda yazıyor. Rapor araçlarının bir kısmı sipariş kayıtlarından, bir kısmı ziyaret olaylarından besleniyor; iki araç aynı soruya farklı sayı verdiğinde sebebi budur. Örneklerle: Örnek senaryolar
- Bu sayfa kendiliğinden güncellenir. Yeni bir araç eklendiğinde ya da bir aracın adı değiştiğinde sayfa yeniden üretilir; bu yüzden burada gördüğünüz liste her zaman yayındaki listedir.
Bu sayfa faydalı oldu mu?