Membangun chatbot RAG berbahasa Spanyol dengan Claude — panduan praktis untuk LATAM dan Spanyol

Membangun chatbot RAG dalam bahasa Spanyol yang menjawab dengan akurat tentang basis pengetahuan Anda — panduan praktis untuk tim produk di Spanyol dan Amerika Latin. Kami membahas pemilihan model, cara menangani variasi regional bahasa Spanyol, biaya per kueri, dan cara menghindari halusinasi.

Stack dasar

1. Penyematan dokumen dengan text-embedding-3-large, dipanggil langsung ke OpenAI —— Kunavo tidak menyediakan embedding, hanya tahap generasi
2. Pencarian vektor (pgvector, Pinecone, atau Qdrant)
3. Generasi respons dengan Claude Sonnet 4.6 + caching prompt
4. Fallback ke Gemini 2.5 Flash untuk beban tinggi / biaya minimum

Cuplikan dasar

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

Biaya per kueri: sekitar $0,004 (kurang dari setengah sen euro) dengan caching aktif. Tanpa caching, sekitar $0,01. Perbedaannya sepadan dengan mengonfigurasi cache_control dengan benar.

Bahasa Spanyol netral vs variasi regional

Jika produk Anda melayani pengguna dari Spanyol dan LATAM secara bersamaan, Anda memiliki tiga opsi:

• Bahasa Spanyol netral (direkomendasikan secara default): minta model menggunakan "usted/ustedes" dalam konteks formal dan menghindari ungkapan lokal. Ini berfungsi di semua negara, tetapi terdengar sedikit impersonal
• Deteksi negara + prompt khusus: gunakan IP atau pengaturan pengguna untuk memilih antara "voseo" (Argentina, Uruguay), "tuteo" (Spanyol, Meksiko), dan "ustedeo" (Kolombia, wilayah tertentu). Teruskan dialek tersebut dalam system prompt
• Satu model per pasar: hanya jika Anda memiliki tim khusus dan volume tinggi di setiap wilayah. Bagi sebagian besar kasus, ini berlebihan

Claude Sonnet 4.6 dan Gemini 2.5 Pro memahami semua variasi; output mengikuti gaya prompt. Satu baris seperti "Jawab dalam bahasa Spanyol rioplatense (voseo, mis. 'vos podés')" sudah cukup.

Token dalam bahasa Spanyol

Bahasa Spanyol menggunakan sekitar 1,3–1,5x lebih banyak token daripada bahasa Inggris untuk konten yang sama (karena akhiran yang lebih panjang dan artikel). Sesuaikan anggaran input dan output Anda. Konteks 5K token dalam bahasa Inggris menjadi sekitar ~6,5K dalam bahasa Spanyol.

Anti-halusinasi — apa yang benar-benar berhasil

• System prompt eksplisit: "jika jawaban tidak ada dalam konteks, katakan 'Saya tidak memiliki informasi tersebut'". Model lebih mematuhinya dalam bahasa Spanyol netral daripada bahasa lain; kami tidak tahu alasannya
• Mengutip sumber: minta model mengembalikan id dokumen tempat setiap klaim diambil. Jika id tersebut dibuat-buat, Anda tahu bahwa model berhalusinasi
• Membatasi output: max_tokens=300 sangat mengurangi dorongan untuk mengarang isi tambahan
• Pengujian adversarial: 50 pertanyaan dari dataset Anda yang ditandai sebagai "tidak dapat dijawab dengan konteks saat ini". Chatbot Anda harus menolak semuanya

Perkiraan biaya bulanan (bahasa Spanyol)

• 100 kueri/hari: ~$11/bulan dengan caching
• 1.000 kueri/hari: ~$110/bulan
• 10.000 kueri/hari: ~$1.100/bulan

Jika mencapai 10.000+ dan membutuhkan penghematan lebih besar, gunakan Gemini 2.5 Flash untuk kueri sederhana (4 hingga 10 kali lebih murah) dan simpan Sonnet 4.6 hanya untuk kueri kompleks. Pola tiering dijelaskan dalam panduan optimasi biaya.

Pembayaran dari Spanyol dan LATAM

Stripe memproses pembayaran berdasarkan negara: Pix (Brasil), kartu internasional, Apple Pay, Google Pay, dan Link. Harga ditetapkan dalam USD, dan Stripe dapat menampilkan jumlah dalam mata uang Anda; nilai tukarnya mencakup biaya konversi 2–4% yang dibayar pembeli, dan pembayaran dalam USD menghindarinya (dokumentasi Adaptive Pricing Stripe, dibaca pada 2026-10-03). Bizum, PayPal, OXXO, dan Mercado Pago tidak tersedia, begitu pula Pay by Bank: di checkout Kunavo, metode ini hanya ditawarkan kepada pembeli di Britania Raya, Irlandia, dan Finlandia, sedangkan di Prancis dan Jerman Stripe masih menyediakannya dalam pratinjau pribadi (dokumentasi Pay by Bank Stripe, dibaca pada 2026-10-03). Pengisian saldo minimum $10 USD. Saldo tidak kedaluwarsa.

Dukungan dan dokumentasi

Dukungan dalam bahasa Spanyol melalui contact@kunavo.com dalam waktu kurang dari 24 jam kerja. Dokumentasi teknis lengkap tersedia di /docs/quickstart; panduan lengkap caching prompt tersedia di pendalaman caching prompt.

Siap? Daftar gratis, isi ulang mulai dari $10, dan bayar hanya sesuai penggunaan Anda untuk membangun prototipe fungsional pertama.