Claude pour un assistant e-commerce en turc — calcul des coûts en kuruş avec Kunavo

Assistant de recommandation de produits basé sur Claude pour vos sites e-commerce turcs : il comprend les requêtes en langage naturel des clients, comme « s’il fait soleil en été et que je vais à la plage, que puis-je acheter sans dépasser 1 000 TL ? », et recommande de vrais produits du catalogue. Code complet + calcul du coût mensuel + TVA + stratégie face aux fluctuations du taux de change de la TL.

Pourquoi Claude Haiku 4.5 ?

Pour les tâches « comprendre + formater » comme la recommandation de produits, Claude Haiku 4.5 offre environ 85 % de la qualité de Sonnet 4.6 pour un tiers du coût. Avec les tarifs Kunavo :

• Haiku 4.5 : entrée 0,40 $/1M, sortie 2,00 $/1M
• Sonnet 4.6 : entrée 1,20 $/1M, sortie 6,00 $/1M

Catalogue de 200 produits + requête client = environ 3K tokens d’entrée, réponse JSON = environ 200 tokens de sortie. Coût par appel : environ 0,0016 $ (environ 0,06 ₺).

Code fonctionnel

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)

Nous avons marqué le prompt système avec cache_control. Lorsque des appels successifs utilisent le même prompt, la mise en cache des prompts Anthropic s’active et économise 90 % du coût d’entrée.

Projection du coût mensuel

Comparaison : gérer en permanence un assistant e-commerce avec du personnel nécessite au minimum une équipe de support travaillant en 2 à 3 rotations pour 1 000 recommandations ou plus par jour (environ 120 000 ₺/mois). Avec l’IA, 95 % d’économies sur les coûts.

Stratégie face aux fluctuations du taux de change de la TL

Comme Kunavo facture en USD, votre coût augmente lorsque la TL se déprécie. Pour l’atténuer :

• Rechargement en volume : les rechargements de 1 000 USD ou plus débloquent 20 % de crédit bonus supplémentaire (déposez 1 000 USD, recevez 1 200 USD de crédit). Environ 17 % d’économies en USD, avec un tampon de change indirect en TRY
• Mise en cache des prompts toujours active — libère 70 % d’économies
• Segmentation Haiku → Sonnet : résolvez les requêtes simples avec Haiku et les requêtes complexes avec Sonnet. Si vous avez besoin d’un décideur automatique, consultez le guide d’optimisation des coûts
• Limiter la sortie : avec max_tokens=300, réduisez de moitié le coût de sortie

Résolution des problèmes de carte

La plupart des banques turques désactivent par défaut les transactions en ligne à l’étranger. Si le paiement Stripe est refusé :

• Demandez à votre banque d’autoriser « l’utilisation de la carte en ligne à l’étranger »
• Visa, Mastercard, American Express et JCB sont tous pris en charge
• Apple Pay peut être accepté plus facilement ; si Google Pay est configuré dans Chrome / Android, il peut également être sélectionné, mais la carte sous-jacente doit tout de même autoriser les transactions internationales

Conformité KVKK

Si les données personnelles du client (nom, téléphone, adresse) sont présentes, masquez-les avant de les envoyer au LLM. Les données de paiement Stripe sont déjà couvertes par PCI-DSS et restent hors de votre environnement. Kunavo ne fournit pas de contrat de traitement des données (DPA) ; les requêtes sont traitées aux États-Unis et transmises aux fournisseurs de modèles en amont. Si vous avez besoin d’un DPA, concluez directement un contrat avec le fournisseur du modèle (conditions d’entreprise d’Anthropic, OpenAI ou Google).

Liste de contrôle pour la production

• Examinez manuellement les 100 premières recommandations et automatisez lorsque la qualité atteint ≥80 %
• Définissez la limite de dépenses quotidiennes via /app/keys (pour éviter les envolées accidentelles)
• Pour les payloads d’erreur, ajoutez un comportement de repli indiquant à l’utilisateur « désolé, je ne peux pas faire de recommandation pour le moment »
• Suivez le coût mensuel sur /app/usage et configurez une alerte en cas d’augmentation inattendue

Pour commencer, inscrivez-vous gratuitement, rechargez à partir de 10 $ et payez à la consommation. La documentation complète se trouve sur /docs/quickstart.