Claude untuk asisten e-commerce berbahasa Turki — menghitung biaya hingga kuruş dengan Kunavo

Asisten rekomendasi produk berbasis Claude untuk situs e-commerce Turki Anda: memahami kueri bahasa alami pelanggan seperti "jika cuaca cerah pada musim panas, saya akan ke pantai, apa yang bisa saya beli dengan harga tidak lebih dari 1.000 TL" dan merekomendasikan produk nyata dari katalog. Kode lengkap + perhitungan biaya bulanan + PPN + strategi menghadapi fluktuasi nilai tukar TL.

Mengapa Claude Haiku 4.5?

Untuk tugas seperti "pahami + format" dalam rekomendasi produk, Claude Haiku 4.5 memberikan sekitar 85% kualitas Sonnet 4.6, dengan sepertiga biayanya. Dengan harga Kunavo:

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

Katalog 200 produk + kueri pelanggan = ~3K token input, respons JSON = ~200 token output. Biaya per panggilan: ~$0,0016 (sekitar ₺0,06).

Kode yang berfungsi

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)

Kami menandai system prompt dengan cache_control. Saat panggilan berurutan menggunakan prompt yang sama, prompt caching Anthropic aktif dan menghemat 90% biaya input.

Proyeksi biaya bulanan

Perbandingan: menjalankan asisten e-commerce dengan staf secara terus-menerus memerlukan setidaknya tim dukungan yang bekerja dalam 2–3 shift untuk 1.000+ rekomendasi per hari (~₺120.000/bulan). Dengan AI, penghematan biaya 95%.

Strategi menghadapi fluktuasi nilai tukar TL

Karena Kunavo menggunakan penetapan harga dalam USD, biaya Anda meningkat ketika nilai TL turun. Untuk meredamnya:

• Pengisian saldo dalam jumlah besar: pengisian $1.000+ membuka kredit bonus tambahan 20% (setor $1.000, dapatkan kredit $1.200). Penghematan sekitar 17% dalam denominasi USD, dengan perlindungan nilai tukar tidak langsung dalam denominasi TRY
• Prompt caching selalu aktif — memungkinkan penghematan 70%
• Pemberian tingkat Haiku → Sonnet: selesaikan kueri sederhana dengan Haiku dan kueri kompleks dengan Sonnet. Jika memerlukan pengambil keputusan otomatis, lihat cost optimization guide
• Batasi output: gunakan max_tokens=300 untuk mengurangi separuh biaya output

Solusi masalah kartu

Sebagian besar bank Turki menonaktifkan transaksi online internasional secara default. Jika checkout Stripe ditolak:

• Minta bank Anda mengaktifkan izin "penggunaan kartu online internasional"
• Visa, Mastercard, American Express, dan JCB semuanya didukung
• Apple Pay mungkin lebih lancar; jika telah dipasang di Chrome / Android, Google Pay juga dapat dipilih, tetapi kartu di baliknya tetap harus mengaktifkan transaksi internasional

Kepatuhan KVKK

Jika terdapat data pribadi pelanggan (nama, telepon, alamat), samarkan sebelum mengirimkannya ke LLM. Data pembayaran Stripe sudah berada dalam cakupan PCI-DSS dan tidak berada dalam sistem Anda. Kunavo tidak menyediakan perjanjian pemrosesan data (DPA); permintaan diproses di AS dan diteruskan ke penyedia model upstream. Jika Anda memerlukan DPA, buat kontrak langsung dengan penyedia model (ketentuan perusahaan Anthropic, OpenAI, atau Google).

Daftar periksa untuk produksi

• Tinjau 100 rekomendasi pertama secara manual; otomatisasikan setelah kualitas mencapai ≥80%
• Atur batas pengeluaran harian melalui /app/keys (mencegah lonjakan yang tidak disengaja)
• Untuk payload error, tambahkan perilaku fallback kepada pengguna dengan pesan "maaf, saat ini saya tidak dapat memberikan rekomendasi"
• Pantau biaya bulanan di /app/usage dan buat peringatan jika terjadi kenaikan yang tidak terduga

Untuk memulai, lakukan pendaftaran gratis, isi saldo mulai dari $10, lalu bayar sesuai penggunaan. Dokumentasi lengkap tersedia di /docs/quickstart.