İtalyanca KOBİ'ler için RAG — Claude ile 4 haftada asistan oluşturma

KOBİ'niz için İtalyanca bir RAG asistanı oluşturma — Claude'u İtalyanca bir bilgi tabanı üzerinde üretime almak isteyen İtalyan startup'ları ve şirketleri için pratik kılavuz. Çalışan kod, gerçekçi aylık maliyetler, GDPR ve elektronik faturalandırma değerlendirmeleri.

Temel teknoloji yığını

1. Belgeleri text-embedding-3-large ile doğrudan OpenAI üzerinden gömme — Kunavo embedding hizmeti sunmaz, yalnızca üretim adımını sunar
2. Vektör arama (pgvector / Pinecone / Qdrant)
3. Claude Sonnet 4.6 + istem önbelleğe alma ile yanıt üretimi
4. Yüksek eşzamanlılık / minimum maliyet için Gemini 2.5 Flash'a geri dönüş

Temel kod

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

def rispondere(domanda: str, contesto: list[str]) -> str:
    """Risponde in italiano basandosi solo sul contesto recuperato dalla KB."""
    resp = client.chat.completions.create(
        model="claude-sonnet-4-6",
        messages=[
            {
                "role": "system",
                "content": [
                    {
                        "type": "text",
                        "text": (
                            "Sei un assistente che risponde in italiano formale "
                            "ma cordiale, basandoti esclusivamente sul contesto "
                            "fornito. Se la risposta non si trova nel contesto, "
                            "rispondi 'Non ho questa informazione' invece di "
                            "inventare. Cita sempre il documento di origine "
                            "quando possibile."
                        ),
                        "cache_control": {"type": "ephemeral"},
                    },
                ],
            },
            {
                "role": "user",
                "content": (
                    f"## Contesto\n{chr(10).join(contesto)}\n\n"
                    f"## Domanda\n{domanda}"
                ),
            },
        ],
        max_tokens=600,
    )
    return resp.choices[0].message.content

Önbellekleme etkinken sorgu başına maliyet: ~$0,004 (yaklaşık €0,004). Önbellekleme olmadan: ~$0,01. Fark, cache_control ayarını kararlı sistem isteminde doğru yapılandırmayı haklı çıkarır.

İtalyanca token'lar

İtalyanca, aynı içerik için İngilizceye kıyasla yaklaşık 1.3-1.5 kat daha fazla token tüketir (artikeller ve uzun sözcük sonları nedeniyle). Bütçelerde bunu hesaba katın: İngilizcede 5K token olan bir bağlam, İtalyancada ~6.5K olur. Kaliteyi kaybetmeden maliyetleri kontrol altında tutmak için bağlamı 4K ile sınırlayın.

Halüsinasyon önleme — gerçekten işe yarayanlar

• Açık sistem istemi: "Yanıt bağlamda yoksa 'Bu bilgiye sahip değilim' deyin". Claude bu talimata İtalyancada güvenilir biçimde uyar
• Kaynağı belirtme: modelden her iddianın alındığı belgenin kimliğini döndürmesini isteyin. Kimlik uydurulmuşsa bir halüsinasyon yakalamışsınız demektir
• Çıktıyı sınırlama: max_tokens=400, doldurma amacıyla uydurma içerik ekleme eğilimini azaltır
• Karşıt testler: veri kümenizde mevcut bağlamla "yanıtlanamaz" olarak işaretlenmiş 50 soru hazırlayın. Asistan bunların tümünü reddetmelidir

Tahmini aylık maliyet

• Günde 100 sorgu: önbellekleme ile ayda ~$11 (~€10)
• Günde 1.000 sorgu: ayda ~$110 (~€100)
• Günde 10.000 sorgu: ayda ~$1.100 (~€1.000)

Karşılaştırma: İtalyan bir müşteri destek çalışanının günde yaklaşık 100 destek talebini karşılamasının maliyeti ayda ~€2.500'dur. Günde yalnızca 1.000 sorguda bile AI asistanı, tek bir çalışanın maliyetinin yaklaşık %4'üne 10 kişinin işini yapar.

Ödeme ve faturalandırma

• Kartlar: Visa, Mastercard, American Express, PostePay (Visa üzerinden)
• Apple Pay / Google Pay / Link
• Ödeme sayfası euro cinsindeyse Satispay

Tüm fiyatlar USD cinsindedir; Stripe, ödeme sayfasında tutarı EUR’a çevirebilir ve kullanılan kur, ödemeyi yapan kişiden alınan %2–4 dönüşüm ücretini içerir (USD ile ödemede bu ücret yoktur; Stripe Adaptive Pricing belgeleri, 2026-10-03 tarihinde incelenmiştir). PayPal ve SEPA Direct Debit kullanılamaz. Ödeme sayfasında KDV gösterilmez ve KDV numarası istenmez. SDI’ye elektronik faturalama: şu anda İtalya’daki SDI’ye elektronik fatura düzenlemiyoruz. Faturalama ihtiyaçlarınız için sales@kunavo.com adresiyle iletişime geçin.

GDPR — İtalyan KOBİ'leri için kritik noktalar

• Kişisel verileri takma adlandırma: modele göndermeden önce adları, vergi kimliklerini, IBAN'ları, e-posta adreslerini ve adresleri istemden kaldırın
• DPA / GDPR Madde 28: Kunavo bir DPA veya standart sözleşme maddeleri (CCT) sunmaz; istekler Amerika Birleşik Devletleri’nde işlenir ve upstream sağlayıcılara iletilir. ABD’ye veri aktarımı için CCT içeren bir DPA’ya ihtiyacınız varsa bunu doğrudan model sağlayıcısıyla (Anthropic, OpenAI veya Google’ın kurumsal koşulları) imzalayın.
• Güncel gizlilik bildirimi: Kunavo aracılığıyla üçüncü taraf AI kullanımından açıkça bahsedin
• Unutulma hakkı (Madde 17): uygulama günlüklerinizin silinebilir olduğundan emin olun. İstemleri blockchain gibi değiştirilemez arşivlere koymayın

Pratik yol haritası

• 1. hafta: 100 belge ve 10 test sorgusuyla prototip
• 2. hafta: eksiksiz bilgi tabanıyla entegrasyon, şirket içi kullanıcılarla test
• 3. hafta: gerçek durumlarla sistem istemini ayarlama, kalite değerlendirmesi
• Hafta 4: kademeli dağıtım, /app/usage üzerinde maliyet izleme

Başlamaya hazır mısınız? Ücretsiz kaydolun, 10 $ yükleyin ve yalnızca kullandığınız kadar ödeyin (yaklaşık 1.100 test sorgusu için yeterlidir). Eksiksiz belgeler: /docs/quickstart. İtalyanca sorularınız için doğrudan contact@kunavo.com adresine yazın.