Türkçe e-ticaret asistanı için Claude — Kunavo ile kuruş hesaplama

Türk e-ticaret siteleriniz için Claude tabanlı ürün öneri asistanı: müşterinin "yazın güneşliyse, plaja gidicem, 1000 TL'yi geçmesin ne alabilirim" gibi doğal dil sorgusunu anlıyor ve katalogdan gerçek ürünler öneriyor. Tam kod + aylık maliyet hesabı + KDV + TL kur dalgalanması stratejisi.

Neden Claude Haiku 4.5?

Ürün önerisi gibi "anla + format" görevlerinde Claude Haiku 4.5, Sonnet 4.6'nın yaklaşık %85 kalitesini, üçte biri maliyetine sunar. Kunavo fiyatlarıyla:

• Haiku 4.5: input $0,40/1M, output $2,00/1M
• Sonnet 4.6: input $1,20/1M, output $6,00/1M

200 ürünlük katalog + müşteri sorgusu = ~3K input token, JSON cevap = ~200 output token. Çağrı başına maliyet: ~$0,0016 (yaklaşık ₺0,06).

Çalışan kod

import json
from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

# Claude, json_schema tipindeki response_format'a uyar; json_object garanti edilmez.
ONERI = {
    "type": "object",
    "properties": {
        "oneriler": {"type": "array", "items": {
            "type": "object",
            "properties": {"urun_id": {"type": "string"}, "neden": {"type": "string"}},
            "required": ["urun_id", "neden"],
            "additionalProperties": False,
        }},
        "toplam_oneri": {"type": "integer"},
    },
    "required": ["oneriler", "toplam_oneri"],
    "additionalProperties": False,
}

def urun_oneri(kullanici_sorgusu: str, urun_katalogu: list[dict]) -> dict:
    """Müşterinin doğal dil sorgusuna göre 3-5 ürün önerir."""
    katalog_metni = "\n".join(
        f"- {u['id']}: {u['baslik']} | {u['kategori']} | {u['fiyat']} TL"
        for u in urun_katalogu[:200]
    )
    resp = client.chat.completions.create(
        model="claude-haiku-4-5",  # Hızlı + ucuz, ürün önerisi için yeterli
        messages=[
            {
                "role": "system",
                "content": [
                    {
                        "type": "text",
                        "text": (
                            "Sen bir Türk e-ticaret asistanısın. "
                            "Türkçe doğal konuş, samimi ama saygılı. "
                            "Cevap formatı JSON: "
                            '{"oneriler": [{"urun_id": "...", "neden": "..."}, ...], '
                            '"toplam_oneri": int}'
                        ),
                        "cache_control": {"type": "ephemeral"},
                    },
                ],
            },
            {
                "role": "user",
                "content": (
                    f"## Müşteri sorgusu\n{kullanici_sorgusu}\n\n"
                    f"## Mevcut katalog\n{katalog_metni}"
                ),
            },
        ],
        response_format={"type": "json_schema",
                         "json_schema": {"name": "oneri", "schema": ONERI}},
        max_tokens=400,
    )
    return json.loads(resp.choices[0].message.content)

System prompt'u cache_control ile işaretledik. Aynı prompt'la art arda çağrılar geldiğinde Anthropic prompt caching devreye girer ve input maliyetinin %90'ını tasarruf eder.

Aylık maliyet projeksiyonu

Karşılaştırma: bir e-ticaret asistanını sürekli personelle yapmak günlük 1.000+ öneri için minimum 2-3 vardiyalı destek ekibi gerektirir (~₺120.000/ay). AI ile %95 maliyet tasarrufu.

TL kur dalgalanmasına karşı strateji

Kunavo USD fiyatlandırma kullandığı için TL değer kaybettikçe maliyetiniz yükselir. Bunu yumuşatmak için:

• Toplu yükleme: $1.000+ yüklemeler ekstra %20 bonus kredi açar ($1.000 yatırın, $1.200 kredi alın). USD bazında yaklaşık %17 tasarruf, TL bazında dolaylı kur tamponu
• Prompt caching her zaman açık — %70 tasarrufu serbest bırakır
• Haiku → Sonnet tiering: basit sorguları Haiku, kompleks sorguları Sonnet ile çöz. Otomatik karar verici lazımsa cost optimization guide'a göz at
• Çıktı sınırla: max_tokens=300 ile output maliyetini yarıya indir

Kart sorunları çözümü

Türk bankalarının çoğu yurt dışı online işlemleri varsayılan kapalı tutar. Stripe checkout reddi alırsanız:

• Bankanıza "yurt dışı online kart kullanımı" izni açtırın
• Visa, Mastercard, American Express ya da JCB hepsi destekli
• Apple Pay daha sorunsuz geçebilir; Chrome / Android'de kuruluysa Google Pay de seçilebilir, ama arkasındaki kartın yine yurt dışı işlemlere açık olması gerekir

KVKK uyumluluk

Müşterinin kişisel verisi (isim, telefon, adres) varsa LLM'e göndermeden önce maskeleyin. Stripe ödeme verisi zaten PCI-DSS kapsamında, sizden uzakta. Kunavo veri işleme sözleşmesi (DPA) sunmaz; istekler ABD'de işlenir ve upstream model sağlayıcılarına iletilir. DPA'ya ihtiyacınız varsa doğrudan model sağlayıcısıyla (Anthropic, OpenAI veya Google kurumsal koşulları) sözleşme yapın.

Üretim için kontrol listesi

• İlk 100 öneri elden incelensin, kalite ≥%80 olunca otomatize edin
• Günlük harcama limiti /app/keys üzerinden ayarlansın (kazara patlamaları engeller)
• Hata payload'ları için kullanıcıya "üzgünüm, şu an öneri yapamıyorum" ile düşüş davranışı ekleyin
• Aylık /app/usage'dan maliyeti takip edin, beklenmeyen artışta uyarı kurun

Başlamak için ücretsiz kayıt olun, $10'dan itibaren yükleyip kullandığınız kadar ödeyin. Tam dokümantasyon /docs/quickstart'ta.