Claude ile İspanyolca RAG chatbot oluşturma — LATAM ve İspanya için pratik rehber

Bilgi tabanınız hakkında doğru yanıtlar veren İspanyolca bir RAG sohbet robotu oluşturma — İspanya ve Latin Amerika'daki ürün ekipleri için hazırlanmış pratik rehber. Model seçimini, İspanyolcanın bölgesel varyantlarını yönetmeyi, sorgu başına maliyetleri ve halüsinasyonlardan kaçınmayı ele alıyoruz.

Temel yığın

1. text-embedding-3-large ile belge gömme; OpenAI'ye doğrudan çağrı — Kunavo embedding sunmaz, yalnızca üretim adımını sunar
2. Vektör araması (pgvector, Pinecone veya Qdrant)
3. Claude Sonnet 4.6 + prompt caching ile yanıt üretimi
4. Yüksek yük / minimum maliyet için Gemini 2.5 Flash'a geri dönüş

Temel snippet

from openai import OpenAI

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

def responder(pregunta: str, contexto: list[str]) -> str:
    """Responde en español usando contexto recuperado de la base de conocimiento."""
    resp = client.chat.completions.create(
        model="claude-sonnet-4-6",
        messages=[
            {
                "role": "system",
                "content": [
                    {
                        "type": "text",
                        "text": (
                            "Eres un asistente que responde en español neutro, "
                            "claro y conciso, basándote exclusivamente en el "
                            "contexto proporcionado. Si la respuesta no está en "
                            "el contexto, di 'No tengo esa información' en lugar "
                            "de inventar."
                        ),
                        "cache_control": {"type": "ephemeral"},
                    },
                ],
            },
            {
                "role": "user",
                "content": (
                    f"## Contexto\n{chr(10).join(contexto)}\n\n"
                    f"## Pregunta\n{pregunta}"
                ),
            },
        ],
        max_tokens=600,
    )
    return resp.choices[0].message.content

Sorgu başına maliyet: caching etkin halde yaklaşık $0,004 (bir euro sentinin yarısından az). Caching olmadan yaklaşık $0,01. Aradaki fark, cache_control'ü doğru yapılandırmaya değer.

Nötr İspanyolca ve bölgesel varyantlar

Ürününüz aynı anda İspanya ve LATAM kullanıcılarına hizmet veriyorsa üç seçeneğiniz vardır:

• Nötr İspanyolca (varsayılan olarak önerilir): modelden resmî dilde "usted/ustedes" kullanmasını ve yerel kullanımlardan kaçınmasını isteyin. Tüm ülkelerde çalışır, ancak kulağa biraz kişisel olmayan gelebilir
• Ülke algılama + özel prompt: "voseo" (Arjantin, Uruguay), "tuteo" (İspanya, Meksika), "ustedeo" (Kolombiya, bazı bölgeler) arasında seçim yapmak için IP'yi veya kullanıcı ayarlarını kullanın. Lehçeyi system prompt'a iletin
• Her pazar için bir model: yalnızca her bölgede özel ekipleriniz ve yüksek hacminiz varsa. Çoğu kişi için gereğinden fazladır

Claude Sonnet 4.6 ve Gemini 2.5 Pro tüm varyantları anlar; çıktı prompt'un stilini izler. "Rioplatense İspanyolcasıyla yanıt ver (voseo, ör. 'vos podés')" gibi tek bir satır yeterlidir.

İspanyolca token'lar

Aynı içerik için İspanyolca, İngilizceye kıyasla yaklaşık 1.3-1.5 kat daha fazla token tüketir (uzun ekler ve artikeller nedeniyle). Girdi ve çıktı bütçelerinizi buna göre ayarlayın. İngilizcedeki 5K token'lık bir bağlam İspanyolcada ~6.5K'ya dönüşür.

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

• Açık system prompt: "yanıt bağlamda yoksa 'Bu bilgiye sahip değilim' de". Model buna nötr İspanyolcada diğer dillere kıyasla daha çok uyar; nedenini bilmiyoruz
• Kaynağı belirtme: her iddianın alındığı belgenin kimliğini döndürmesini isteyin. Kimlik uydurulmuşsa halüsinasyon gördüğünü bilirsiniz
• Çıktıyı sınırlama: max_tokens=300, uydurma dolgu metni ekleme eğilimini büyük ölçüde azaltır
• Karşıt testler: veri kümenizden, "mevcut bağlamla yanıtlanamaz" olarak işaretlenmiş 50 soru. Sohbet robotunuz bunların tümünü reddetmelidir

Tahmini aylık maliyet (İspanyolca)

• Günde 100 sorgu: caching ile aylık ~$11
• Günde 1.000 sorgu: aylık ~$110
• Günde 10.000 sorgu: aylık ~$1.100

10.000+ seviyesine ulaşırsanız ve daha fazla tasarrufa ihtiyacınız varsa basit sorgular için Gemini 2.5 Flash'a geçin (4 ila 10 kat daha ucuz) ve Sonnet 4.6'yı yalnızca karmaşık sorgulara ayırın. Katmanlama deseni cost optimization guide içinde açıklanmıştır.

İspanya ve LATAM'dan ödemeler

Stripe ödemeyi ülkeye göre işler: Pix (Brezilya), uluslararası kartlar, Apple Pay, Google Pay ve Link. Fiyatlar USD cinsindendir ve Stripe tutarı yerel para biriminizde gösterebilir; kuru, alıcının ödediği %2–4 dönüştürme komisyonunu içerir ve USD ile ödeme yapmak bu ücreti önler (Stripe Adaptive Pricing belgeleri, 2026-10-03 tarihinde okundu). Bizum, PayPal, OXXO ve Mercado Pago kullanılamaz; Pay by Bank de kullanılamaz: Kunavo ödeme sayfasında yalnızca Birleşik Krallık, İrlanda ve Finlandiya'daki alıcılara sunulur; Fransa ve Almanya'da Stripe bunu hâlâ özel önizleme olarak sunmaktadır (Stripe Pay by Bank belgeleri, 2026-10-03 tarihinde okundu). Minimum yükleme $10 USD'dir. Bakiye sona ermez.

Destek ve belgeler

contact@kunavo.com üzerinden 24 iş saatinden kısa sürede İspanyolca destek. Eksiksiz teknik belgeler /docs/quickstart adresinde; prompt caching rehberinin tamamı prompt caching deep dive içinde.

Hazır mısınız? Ücretsiz kaydolun, $10'dan başlayan yükleme yapın ve çalışan ilk prototipi oluşturmak için yalnızca kullandığınız kadar ödeyin.