返回部落格
應用·2026年5月25日·閱讀約 7 分鐘

適用於土耳其電子商務助理的 Claude——使用 Kunavo 精確計算成本

以 Claude Haiku 4.5 為基礎的土耳其電子商務網站產品推薦助理：完整可執行程式碼、每次呼叫 ₺0.08、每月 1,000–100,000 次推薦的成本預估，以及因應 TRY 匯率波動的 4 種策略（大量儲值 + 快取 + 分級 + max_tokens）、土耳其卡片問題解法與 KVKK 合規。

為土耳其電商網站打造的 Claude 產品推薦助理：理解客戶如「如果夏天陽光充足、我要去海灘、不要超過 1000 TL，我可以買什麼」等自然語言查詢，並從目錄推薦真實產品。完整程式碼 + 每月成本計算 + VAT + 土耳其里拉匯率波動策略。

為什麼選擇 Claude Haiku 4.5？

在產品推薦這類「理解 + 格式化」任務中，Claude Haiku 4.5 能提供 Sonnet 4.6 約 85% 的品質，成本僅為其三分之一。按照 Kunavo 價格：

  • Haiku 4.5：輸入 $0.40/1M，輸出 $2.00/1M
  • Sonnet 4.6：輸入 $1.20/1M，輸出 $6.00/1M

200 項產品的目錄 + 客戶查詢 = 約 3K 輸入 token，JSON 回應 = 約 200 個輸出 token。每次呼叫成本：約 $0.0016（約 ₺0.06）。

可運作的程式碼

asistan.py
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)

我們使用 cache_control 標記系統提示。當連續收到使用相同提示的呼叫時，Anthropic 提示快取會啟用，節省 90% 的輸入成本。

每月成本預估

每日推薦數每月 USD約合 TL
1.000~$48~₺1.700
10.000~$480~₺17.000
100.000~$4.800~₺170.000

比較：若持續以人工人員經營電商助理，每日 1,000 次以上的推薦至少需要 2–3 班支援團隊（約 ₺120,000/月）。使用 AI 可節省 95% 成本。

因應土耳其里拉匯率波動的策略

Kunavo 使用 USD 定價，因此土耳其里拉貶值時，你的成本會上升。可透過以下方式降低影響：

  • 大額儲值：儲值 $1,000 以上可獲得額外 20% 獎勵餘額（存入 $1,000，獲得 $1,200 餘額）。以美元計算約節省 17%，以土耳其里拉計算則可間接形成匯率緩衝
  • 始終啟用提示快取——釋放 70% 的節省空間
  • Haiku → Sonnet 分級：簡單查詢使用 Haiku，複雜查詢使用 Sonnet。若需要自動決策器，請參閱 成本最佳化指南
  • 限制輸出：使用 max_tokens=300 將輸出成本減半

卡片問題的解決方式

多數土耳其銀行預設會關閉海外線上交易。如果 Stripe 結帳遭拒：

  • 請向銀行申請開啟「海外線上卡片使用」權限
  • 支援 Visa、Mastercard、American Express 與 JCB
  • Apple Pay 可能更順利；若已在 Chrome / Android 中設定，也可選擇 Google Pay，但其背後的卡片仍必須開啟海外交易

KVKK 合規

如果客戶的個人資料（姓名、電話、地址）存在，請在傳送給 LLM 前先進行遮罩。Stripe 付款資料已受 PCI-DSS 規範保護，不會接觸到你的系統。Kunavo 不提供資料處理協議（DPA）；請求會在美國處理，並傳送給上游模型供應商。如果需要 DPA，請直接與模型供應商（Anthropic、OpenAI 或 Google 的企業條款）簽約。

生產環境檢查清單

  • 先人工檢查前 100 次推薦，品質達到 ≥80% 後再自動化
  • 透過 /app/keys 設定每日支出上限（防止意外爆量）
  • 為錯誤 payload 加入備援行為，向使用者顯示「抱歉，我目前無法提供推薦」
  • 每月從 /app/usage 追蹤成本，若出現異常增加便設定警示

免費註冊即可開始使用，儲值金額 $10 起，依實際用量付費。完整文件請見 /docs/quickstart。

相關深度文章