Claude für einen türkischen E-Commerce-Assistenten — Berechnung bis auf den Kuruş mit Kunavo

Claude-basierter Produktempfehlungsassistent für Ihre türkischen E-Commerce-Websites: Er versteht natürlichsprachliche Anfragen von Kunden wie „Wenn es im Sommer sonnig ist und ich an den Strand gehe, was kann ich kaufen, ohne 1.000 TL zu überschreiten?“ und empfiehlt echte Produkte aus dem Katalog. Vollständiger Code + monatliche Kostenberechnung + MwSt. + Strategie für TL-Wechselkursschwankungen.

Warum Claude Haiku 4.5?

Bei Aufgaben wie Produktempfehlungen, die „verstehen + formatieren“ erfordern, liefert Claude Haiku 4.5 etwa 85 % der Qualität von Sonnet 4.6 zu einem Drittel der Kosten. Mit Kunavo-Preisen:

• Haiku 4.5: Input $0.40/1M, Output $2.00/1M
• Sonnet 4.6: Input $1.20/1M, Output $6.00/1M

Katalog mit 200 Produkten + Kundenanfrage = ~3K Input-Tokens, JSON-Antwort = ~200 Output-Tokens. Kosten pro Aufruf: ~$0.0016 (etwa ₺0.06).

Funktionierender Code

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)

Wir haben den System-Prompt mit cache_control markiert. Wenn aufeinanderfolgende Aufrufe mit demselben Prompt eingehen, greift Anthropic Prompt Caching und spart 90 % der Input-Kosten.

Monatliche Kostenprojektion

Vergleich: Einen E-Commerce-Assistenten dauerhaft mit Personal zu betreiben, erfordert bei 1.000 oder mehr Empfehlungen täglich mindestens ein Supportteam mit 2–3 Schichten (~₺120.000/Monat). Mit AI sparen Sie 95 % der Kosten.

Strategie gegen TL-Wechselkursschwankungen

Da Kunavo in USD abrechnet, steigen Ihre Kosten, wenn die TL an Wert verliert. So mildern Sie das ab:

• Großvolumenaufladung: Aufladungen ab $1.000 schalten zusätzlich 20 % Bonusguthaben frei (zahlen Sie $1.000 ein, erhalten Sie $1.200 Guthaben). Etwa 17 % Ersparnis auf USD-Basis, indirekter Wechselkurspuffer auf TL-Basis
• Prompt Caching immer aktiviert — setzt die 70-%-Ersparnis frei
• Haiku → Sonnet-Tiering: Einfache Anfragen mit Haiku, komplexe Anfragen mit Sonnet lösen. Wenn Sie einen automatischen Entscheider benötigen, sehen Sie sich den Leitfaden zur Kostenoptimierung an
• Ausgabe begrenzen: Mit max_tokens=300 die Output-Kosten halbieren

Lösung für Kartenprobleme

Die meisten türkischen Banken deaktivieren internationale Online-Transaktionen standardmäßig. Wenn der Stripe-Checkout abgelehnt wird:

• Bitten Sie Ihre Bank, „internationale Online-Kartennutzung“ freizuschalten
• Visa, Mastercard, American Express und JCB werden alle unterstützt
• Apple Pay kann reibungsloser funktionieren; wenn Google Pay in Chrome / Android eingerichtet ist, kann es ebenfalls ausgewählt werden, aber die dahinterliegende Karte muss weiterhin für internationale Transaktionen freigeschaltet sein

KVKK-Konformität

Wenn personenbezogene Daten des Kunden (Name, Telefonnummer, Adresse) vorhanden sind, maskieren Sie sie, bevor Sie sie an ein LLM senden. Stripe-Zahlungsdaten fallen ohnehin unter PCI-DSS und bleiben von Ihnen getrennt. Kunavo bietet keinen Auftragsverarbeitungsvertrag (DPA) an; Anfragen werden in den USA verarbeitet und an vorgelagerte Modellanbieter weitergeleitet. Wenn Sie einen DPA benötigen, schließen Sie den Vertrag direkt mit dem Modellanbieter (den Unternehmenskonditionen von Anthropic, OpenAI oder Google).

Checkliste für die Produktion

• Die ersten 100 Empfehlungen manuell prüfen und erst ab einer Qualität von ≥80 % automatisieren
• Tägliches Ausgabenlimit über /app/keys festlegen (verhindert versehentliche Kostenexplosionen)
• Für Fehler-Payloads ein Fallback-Verhalten mit „Entschuldigung, ich kann derzeit keine Empfehlung abgeben“ für den Nutzer einbauen
• Kosten monatlich unter /app/usage verfolgen und bei unerwarteten Anstiegen eine Warnung einrichten

Registrieren Sie sich zum Start kostenlos, laden Sie ab $10 auf und zahlen Sie nur für Ihre Nutzung. Die vollständige Dokumentation finden Sie unter /docs/quickstart.