面向土耳其电商网站的 Claude 产品推荐助手：它能理解客户的自然语言查询，例如“如果夏天天气晴朗、我要去海滩、不能超过 1000 土耳其里拉，我可以买什么”，并从目录中推荐真实产品。包含完整代码、月度成本计算、增值税和土耳其里拉汇率波动策略。
为什么选择 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 输入令牌，JSON 响应 = 约 200 个输出令牌。每次调用成本：约 $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 | 约合土耳其里拉 |
|---|---|---|
| 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。