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, %5 maliyetine sunar. Kunavo fiyatlarıyla:

• Haiku 4.5: input $0.56/1M, output $2.80/1M
• Sonnet 4.6: input $2.10/1M, output $10.50/1M

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

Çalışan kod

from openai import OpenAI

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

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_object"},
        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 %25 bonus kredi açar ($1.000 yatırın, $1.250 kredi alın). USD bazında %20 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 playbook'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 ve Google Pay daha sorunsuz geçebilir
• Kurumsal müşteriler Net 30 fatura ödemesi için sales@kunavo.com

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) sales@kunavo.com üzerinden talep edilebilir.

Ü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, $2 kredi alın. Tam dokümantasyon /docs/quickstart'ta.