AI içerik asistanı (Claude)
Mesaj ve şablon editörlerindeki AI asistanı paneli Claude ile başlık/metin önerir, tonu ve uzunluğu ayarlar, A/B varyantları üretir, e-posta konu satırını puanlar ve onaylı çeviri yapar. Karar kaydı:…
Mesaj ve şablon editörlerindeki AI asistanı paneli Claude ile başlık/metin önerir, tonu ve uzunluğu ayarlar,
A/B varyantları üretir, e-posta konu satırını puanlar ve onaylı çeviri yapar. Karar kaydı:
docs/adr/0028-data-feeds-dynamic-content-ai.md.
Kurulum
- Anthropic Console'da bir API anahtarı oluşturun (isteğe bağlı: org için veri saklamama/ZDR ayarı).
- Ortam değişkenleri (
.env):
| Değişken | Varsayılan | Açıklama |
|---|---|---|
ANTHROPIC_API_KEY | — | Gizli; loglanmaz. Boşsa mock sağlayıcı kullanılır. |
AI_PROVIDER | anthropic | mock deterministik test sağlayıcısını zorlar. |
AI_MODEL_DEFAULT | claude-sonnet-5-5 | Öneri, ton, varyant, konu skoru, tek dilli çeviri. |
AI_MODEL_LONG | claude-opus-5-5 | E-posta gövdesi ve çok dilli/uzun çeviri. |
AI_TIMEOUT_MS | 90000 | İstek zaman aşımı. |
AI_MAX_RETRIES | 3 | 429/529/5xx için geri çekilmeli yeniden deneme. |
PROVIDER_MODE=mock iken de mock sağlayıcı kullanılır. Üretimde mock çıktı ALLOW_MOCK_PROVIDERS=true olmadan sunulmaz.
3. Organizasyon ayarları → AI içerik asistanı: özelliği açın (varsayılan kapalı), aylık token kotasını ve yasaklı
ifadeleri belirleyin. Bu ayki kullanım özellik/model bazında aynı kartta görünür.
4. KVKK: Anthropic'i alt işlemci listesine ekleyin; asistan açıldığında yalnızca şablon metinleri gönderilir.
Gizlilik
- Modele yalnızca editördeki şablon metni gider; kullanıcı verisi gönderilmez. Liquid ifadeleri (
{{ user.tags.ad }},{% if … %})[[HS1]]gibi yer tutuculara çevrilir ve yanıtta geri konur. - İstem ve yanıt içerikleri saklanmaz ve loglanmaz; yalnızca
ai_usage(özellik, model, token, zaman) tutulur. Çeviri sonuçları onay için ürün içeriği olarak saklanır.
Özellikler
- Öner / yeniden yaz: Alan (push başlık ≤ 65, metin ≤ 240, SMS ≤ 160, e-posta konu ≤ 78, ön başlık ≤ 110), ton (resmî, samimi, eğlenceli, acil) ve uzunluk (daha kısa/aynı/daha uzun). Sınırı aşan öneri kelime sınırında kısaltılır.
- A/B varyantı: Kampanya editöründe "A/B'ye ekle" tek tıkla varyant ekler: test kapalıysa açılır, ilk varyant kampanya içeriğini devralır, ağırlıklar eşit dağıtılır (en fazla 10 varyant). Kazanan seçimi mevcut A/B akışıyla (elle veya otomatik metrik) yapılır.
- Konu satırı skoru: 0–100 puan, gerekçeler ve iyileştirilmiş öneriler; phishing/yasaklı ifade içeren konu en fazla 20 puan alır.
- Çeviri: Hedef diller app dillerinden seçilir. Tutarlılık sözlüğü (
…/ai/glossary): karşılığı boş terim hiç çevrilmez (ör. marka adı), dil bazlı karşılık verilen terim zorunlu karşılıkla çevrilir.
Çeviri onayı (zorunlu)
Çeviri "onay bekliyor" olarak kaydedilir. Onaylanmamış (veya reddedilmiş) bir çevirinin metnini içeren içerik
gönderilemez: bildirim API'si, kampanya gönderme/zamanlama, zamanlanmış kampanya düzenlemesi ve journey yayınlama
422 HS_CONTENT_INVALID (details.reason = ai_translation_unapproved) döner. Paneldeki onay ekranında gözden geçiren
metni düzenleyip Onayla ve ekle der; onaylanan metin içeriğe dil olarak eklenir.
Kota ve hatalar
- Aylık kota dolunca istekler 429
HS_QUOTA_EXCEEDEDve açık mesajla reddedilir; kota ayın başında (UTC) sıfırlanır. - Kullanıcı başına dakikada 20 AI isteği.
- Sağlayıcı hız sınırı/aşırı yük: yeniden denemeler tükenirse 429
HS_RATE_LIMITEDveya 503HS_PROVIDER_UNAVAILABLE; güvenlik reddinde önce sunucu tarafı yedek model denenir, yine reddedilirse 422. - Yasaklı ifade (platform phishing listesi + org listesi) içeren öneriler süzülür; içeren çeviri onaylanamaz.
API (dashboard oturumu)
GET /internal/v1/apps/{appId}/ai/status, POST …/ai/suggest|variants|subject-score|translate,
GET …/ai/translations, POST …/ai/translations/{id}/approve|reject, …/ai/glossary,
GET|PUT /internal/v1/orgs/{orgId}/ai/settings, GET …/ai/usage.