Claude cho trợ lý thương mại điện tử tiếng Thổ Nhĩ Kỳ — tính toán đến từng kuruş với Kunavo

Trợ lý đề xuất sản phẩm dựa trên Claude cho các trang thương mại điện tử Thổ Nhĩ Kỳ: hiểu truy vấn ngôn ngữ tự nhiên của khách hàng như "nếu trời nắng vào mùa hè, tôi sẽ đi biển, có thể mua gì dưới 1000 TL" và đề xuất sản phẩm có thật từ danh mục. Mã đầy đủ + tính chi phí hàng tháng + VAT + chiến lược trước biến động tỷ giá TL.

Tại sao Claude Haiku 4.5?

Trong các tác vụ kiểu "hiểu + định dạng" như đề xuất sản phẩm, Claude Haiku 4.5 cung cấp khoảng 85% chất lượng của Sonnet 4.6 với một phần ba chi phí. Theo giá Kunavo:

• Haiku 4.5: đầu vào $0,40/1M, đầu ra $2,00/1M
• Sonnet 4.6: đầu vào $1,20/1M, đầu ra $6,00/1M

Danh mục 200 sản phẩm + truy vấn khách hàng = ~3K token input, phản hồi JSON = ~200 token output. Chi phí mỗi lần gọi: ~$0,0016 (khoảng ₺0,06).

Mã hoạt động

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)

Chúng tôi đánh dấu lời nhắc hệ thống bằng cache_control. Khi các lần gọi liên tiếp sử dụng cùng lời nhắc, tính năng lưu lời nhắc vào bộ nhớ đệm của Anthropic được kích hoạt và tiết kiệm 90% chi phí đầu vào.

Dự báo chi phí hàng tháng

So sánh: vận hành một trợ lý thương mại điện tử bằng nhân sự liên tục cần đội hỗ trợ tối thiểu 2-3 ca cho hơn 1.000 đề xuất mỗi ngày (~₺120.000/tháng). Dùng AI tiết kiệm 95% chi phí.

Chiến lược đối phó biến động tỷ giá TL

Vì Kunavo định giá bằng USD, chi phí của bạn tăng khi TL mất giá. Để giảm tác động:

• Nạp số lượng lớn: các khoản nạp từ $1.000 trở lên mở khóa thêm 20% tín dụng thưởng (nạp $1.000, nhận $1.200 tín dụng). Tiết kiệm khoảng 17% tính theo USD, tạo vùng đệm tỷ giá gián tiếp tính theo TRY
• Prompt caching luôn được bật — mang lại khoản tiết kiệm 70%
• Phân tầng Haiku → Sonnet: xử lý truy vấn đơn giản bằng Haiku, truy vấn phức tạp bằng Sonnet. Nếu cần bộ quyết định tự động, xem cost optimization guide
• Giới hạn đầu ra: dùng max_tokens=300 để giảm một nửa chi phí output

Cách xử lý vấn đề thẻ

Phần lớn ngân hàng Thổ Nhĩ Kỳ mặc định tắt giao dịch trực tuyến quốc tế. Nếu Stripe checkout bị từ chối:

• Yêu cầu ngân hàng bật quyền "sử dụng thẻ trực tuyến ở nước ngoài"
• Visa, Mastercard, American Express và JCB đều được hỗ trợ
• Apple Pay có thể xử lý thuận lợi hơn; nếu đã thiết lập trên Chrome / Android thì cũng có thể chọn Google Pay, nhưng thẻ đứng sau phương thức đó vẫn phải được mở cho giao dịch quốc tế

Tuân thủ KVKK

Nếu có dữ liệu cá nhân của khách hàng (tên, số điện thoại, địa chỉ), hãy che giấu dữ liệu trước khi gửi cho LLM. Dữ liệu thanh toán Stripe đã thuộc phạm vi PCI-DSS và được xử lý bên ngoài hệ thống của bạn. Kunavo không cung cấp thỏa thuận xử lý dữ liệu (DPA); các yêu cầu được xử lý tại Hoa Kỳ và chuyển đến các nhà cung cấp mô hình thượng nguồn. Nếu cần DPA, hãy ký hợp đồng trực tiếp với nhà cung cấp mô hình (điều khoản doanh nghiệp của Anthropic, OpenAI hoặc Google).

Danh sách kiểm tra cho production

• Đánh giá thủ công 100 đề xuất đầu tiên; chỉ tự động hóa khi chất lượng ≥80%
• Thiết lập giới hạn chi tiêu hàng ngày tại /app/keys (ngăn các khoản tăng vọt ngoài ý muốn)
• Thêm hành vi dự phòng cho payload lỗi, hiển thị với người dùng "xin lỗi, hiện tôi không thể đưa ra đề xuất"
• Theo dõi chi phí hàng tháng tại /app/usage, thiết lập cảnh báo khi có mức tăng bất ngờ

Để bắt đầu, hãy đăng ký miễn phí, nạp từ $10 và trả theo mức sử dụng. Tài liệu đầy đủ tại /docs/quickstart.