E-ticaret İçerik Yazarı

Bu rehberde: Mağazanızın ürün verisinden satışa hazır ürün metinleri yazan ajanı tanırsınız: ürünleri nereden alır, ne üretir, hangi kurallara uyar ve onaydan sonra metinleri nasıl dışa aktarırsınız.

⏱ 9 dakika

Kimlik kartı#

Ne yapar?#

Ajan her ürün için seçtiğiniz metinleri yazar: ürün açıklaması, SEO başlığı ve meta açıklama, kategori sayfası metni, kampanya / banner metni ve Trendyol, Hepsiburada, Amazon'a uygun pazaryeri maddeleri.

Ürünler nereden gelir? Ajan mağazanızı kendisi okuyamaz. İş akışında önceki adım ürünleri ona verir; örneğin app.ikas kutusunun Ürünleri listele işlemi. Ajan ikas, Shopify, WooCommerce ve Shopier alan adlarını tanır ve her ürünü tek bir satıra çevirir: ad, productId, SKU, kategori, marka, fiyat, indirimli / karşılaştırma fiyatı, stok, varyant seçenekleri, özellikler, etiketler ve mevcut açıklama. Hızlı çalıştırmada ürünleri Ürünler alanına yapıştırırsınız.

• Bir çalıştırmada en fazla 20 ürün yazılır; fazlası skipped listesine düşer. Büyük kataloglarda Limit veya Döngü kutusuyla 20'şerli gruplar kurun.
• Aynı productId / SKU iki kez gelirse bir kez yazılır.
• ikas ürün listesi malzeme, beden tablosu veya açıklama vermez. Bu bilgileri bilgi bankasına yüklerseniz ajan knowledge_search ile bir kez arar; yoksa metin kısa kalır ve uyarı eklenir.

Girdiler#

Ortak alanlar (görev, entegrasyonlar, model, düşünme derinliği, maks. adım, bütçe, rapor kaydet) için Ajanlara genel bakış.

Çıktılar#

Sonuçta iki alan vardır: items (metinler) ve skipped (yazılamayan ürünler ve nedeni). İş akışında main çıkışından her metin ayrı bir öğe olarak çıkar ve geldiği ürünün productId / sku değerini taşır.

{
  "kind": "product",
  "productId": "6b3c1f2e-…",
  "sku": "KG-M-01",
  "title": "Keten Gömlek – Beyaz, Rahat Kesim",
  "seoTitle": "Beyaz Keten Gömlek | Rahat Kesim Yazlık Gömlek",
  "metaDescription": "Nefes alan beyaz keten gömlek: rahat kesim, yaz günleri için hafif. Beden seçeneklerini inceleyin.",
  "description": "<p>Yaz günleri için hafif bir keten gömlek…</p><ul><li>Rahat kesim</li></ul>",
  "bullets": ["Kumaş: Keten", "Kesim: Rahat", "Renk: Beyaz"],
  "tags": ["keten gömlek", "yazlık gömlek"],
  "warnings": ["Kumaş oranı ve bakım talimatı yok – eklenirse açıklama güçlenir", "Beden tablosu yok"]
}

category_text seçiliyse ürünlerdeki her kategori için kind: "category" olan ek bir öğe gelir (kategori başlığı, 150–300 kelimelik tanıtım, SEO başlığı ve meta açıklama). İstenmeyen alanlar boş döner.

Kurallar#

• Bilgi uydurmaz: Malzeme, bileşim, ölçü, ağırlık, menşe, içerik, sertifika, garanti, teslimat, iade, stok, yorum veya puan yalnızca ürün verisinde, bilgi bankasında veya marka kurallarında yazıyorsa kullanılır. Eksik bilgi warnings alanına yazılır. Raporda ürün verisinde olmayan sayılar (ör. "120 gr") ayrıca işaretlenir.
• Sağlık iddiası yok: "Tedavi eder", "akneyi iyileştirir", "zayıflatır", "bağışıklığı güçlendirir", "cures", "boosts immunity" gibi ifadeler kodda yakalanır ve metin reddedilir. Kozmetik ve gıdada kullanım, his, tat ve verilen içerikler anlatılır.
• İndirim ve 10 gün kuralı: İndirim ifadesi ("indirim", "eski fiyat", "… TL yerine", "% off") yalnızca üründe indirimli veya karşılaştırma fiyatı varsa kullanılır. Metinde böyle bir ifade geçerse, eski fiyatın indirimden önceki 10 günün en düşük fiyatı olması gerektiğini söyleyen bir uyarı zorunludur; uyarı yoksa metin reddedilir. "%100 keten" gibi bileşim bilgisi indirim sayılmaz.
• Rakip yok: Başka marka veya mağaza adı, karşılaştırma, "muadil" veya "dupe" yazılmaz. Projedeki rakip adları raporda ayrıca aranır.
• Açıklama, SEO başlığı ve meta açıklamada fiyat yazılmaz (fiyat değişir); kanıtsız "en iyi", "1 numara" iddiaları raporda işaretlenir.
• Pazaryeri maddelerinde iletişim bilgisi, bağlantı, mağaza adı ve emoji yoktur.

Örnek görev metinleri#

1. "Keten koleksiyonumuzun açıklamalarını ve SEO başlıklarını yenile; nefes alması ve kalıbı öne çıksın, asla 'ucuz' yazma."
2. "Bu 10 ürün için Trendyol maddeleri yaz: malzeme, beden, bakım ve kutu içeriği." (contentTypes: marketplace_bullets)
3. "'Seramik kupalar' kategori sayfası için SEO başlığı ve meta açıklamasıyla bir tanıtım metni yaz." (contentTypes: category_text)
4. "Yeni sezon ürünlerine kısa banner metinleri yaz; fiyatı yalnızca ürün verisinde yazıyorsa kullan." (contentTypes: campaign_text)

İpuçları#

İpucu: Malzeme, beden tablosu ve bakım talimatlarını bilgi bankasına bir belge olarak yükleyin. Ajan uyarıda ne eksik olduğunu söyler; bilgiyi ekleyip yeniden çalıştırdığınızda metin güçlenir.

• Ajanın arkasına bir Onay adımı koyun ve uyarıları okuyun.
• Hedef anahtar kelimeleri ürün grubuna göre verin; alakasız kelimeyi ajan kullanmaz.
• Marka kurallarına yasak kelimeleri, beden yazımını ve hitap biçimini ekleyin.

Beklenen rapor#

Ürün içerikleri raporu: metin tablosu (tür, başlık, SKU, SEO başlığı ve karakter sayısı, meta açıklama karakter sayısı, madde ve uyarı sayısı), kontrol edilecekler (kanıt gerektiren iddialar, rakip adları, ürün verisinde olmayan sayılar, eksik bilgi uyarıları), atlanan ürünler ve tam metinler. Metrik kartları: metin, uyarılı metin, kontrol işareti ve atlanan ürün sayısı.

Maliyet beklentisi#

10 ürün, 1 bilgi bankası araması (~25K giriş / ~9K çıkış token):

20 ürünlük bir çalıştırma yaklaşık iki katıdır. Kalıplı pazaryeri maddeleri için ekonomik model yeterlidir.

İş akışında kullanım#

Hazır Ürün açıklamalarını yenile şablonu:

Elle başlat → ikas: Ürünleri listele (limit 20) → E-ticaret İçerik Yazarı → Onay
  approved → Kod: dışa aktarma tablosu → Rapor oluştur (PRODUCT_CONTENT, tablo + CSV) → Bildirim
  rejected → Bildirim

• ikas, Shopify ve WooCommerce bağlantılarında henüz ürün güncelleme işlemi yoktur; onaylanan metinler bu yüzden rapora tablo ve CSV olarak kaydedilir. Metinleri mağaza panelinde ürünlere yapıştırın.
• Uygulama kutusunda resultMode: "merge" kullanılırsa ürün listesi gelen öğenin içinde bir dizi olarak kalır; ajan bu diziyi de bulur.
• Tek bir ürün akışı için (ör. her yeni ürün) ajan kutusunda itemMode: "each" kullanın; varsayılan, gelen tüm ürünleri tek çalıştırmada yazmaktır.

Sık karşılaşılan sorunlar#

Sık sorulan sorular#

Metinleri mağazaya kendisi yazar mı? Hayır. Ajan yalnızca metin üretir; mağazaya yazacak bir ürün güncelleme işlemi henüz yok.

Hangi dillerde yazar? Varsayılan Türkçe; language alanıyla İngilizce, Almanca ve diğer dillerde de yazar.

Shopify veya WooCommerce verisiyle çalışır mı? Evet. Ürünleri HTTP isteği kutusuyla mağaza API'sinden çekip ajana bağlayın veya Ürünler alanına JSON olarak verin; alan adlarını tanır.

Sonraki adım#

• E-ticaret şablonları
• Mevzuat Uyum Denetçisi
• Ajanlara genel bakış