RAG bằng tiếng Ý cho doanh nghiệp vừa và nhỏ — xây dựng trợ lý với Claude trong 4 tuần

Xây dựng trợ lý RAG bằng tiếng Ý cho doanh nghiệp vừa và nhỏ của bạn — hướng dẫn thực tế dành cho các doanh nghiệp khởi nghiệp và doanh nghiệp Ý muốn đưa Claude vào vận hành thực tế dựa trên cơ sở tri thức bằng tiếng Ý. Mã nguồn hoạt động được, chi phí hằng tháng thực tế, các lưu ý về GDPR và lập hóa đơn điện tử.

Ngăn xếp cơ bản

1. Nhúng tài liệu bằng text-embedding-3-large, gọi trực tiếp trên OpenAI —— Kunavo không cung cấp embedding, chỉ cung cấp bước sinh nội dung
2. Tìm kiếm vector (pgvector / Pinecone / Qdrant)
3. Sinh câu trả lời bằng Claude Sonnet 4.6 + bộ nhớ đệm prompt
4. Dự phòng bằng Gemini 2.5 Flash cho mức đồng thời cao / chi phí tối thiểu

Mã nguồn cốt lõi

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

Chi phí mỗi truy vấn khi bật bộ nhớ đệm: ~$0,004 (khoảng €0,004). Không có bộ nhớ đệm: ~$0,01. Chênh lệch này khiến việc cấu hình đúng cache_control trên system prompt ổn định trở nên đáng làm.

Token tiếng Ý

Với cùng một nội dung, tiếng Ý dùng số token bằng khoảng 1.3-1.5 lần số token của tiếng Anh (do mạo từ và đuôi từ dài). Hãy tính đến điều này trong ngân sách: ngữ cảnh 5K token bằng tiếng Anh sẽ thành ~6.5K token bằng tiếng Ý. Giới hạn ngữ cảnh ở 4K để kiểm soát chi phí mà không làm giảm chất lượng.

Chống ảo giác — điều thực sự hiệu quả

• Lời nhắc hệ thống rõ ràng: "nếu câu trả lời không có trong ngữ cảnh, hãy nói 'Tôi không có thông tin này'". Claude tuân thủ chỉ dẫn này bằng tiếng Ý một cách đáng tin cậy
• Trích dẫn nguồn: yêu cầu mô hình trả về id của tài liệu làm nguồn cho từng khẳng định. Nếu id được bịa ra, bạn đã phát hiện một ảo giác
• Giới hạn đầu ra: max_tokens=400 làm giảm xu hướng thêm nội dung bịa đặt để lấp đầy
• Kiểm thử đối kháng: chuẩn bị 50 câu hỏi trong tập dữ liệu của bạn, được đánh dấu là "không thể trả lời bằng ngữ cảnh hiện tại". Trợ lý phải từ chối tất cả

Chi phí hàng tháng ước tính

• 100 truy vấn/ngày: ~$11/tháng (~€10) với bộ nhớ đệm
• 1.000 truy vấn/ngày: ~$110/tháng (~€100)
• 10.000 truy vấn/ngày: ~$1.100/tháng (~€1.000)

So sánh: một nhân viên hỗ trợ khách hàng người Ý có chi phí ~€2.500/tháng để xử lý ~100 yêu cầu hỗ trợ/ngày. Ngay cả chỉ ở mức 1.000 truy vấn/ngày, trợ lý AI cũng làm công việc của 10 người với chi phí khoảng 4% chi phí của một nhân viên duy nhất.

Thanh toán và lập hóa đơn

• Thẻ: Visa, Mastercard, American Express, PostePay (qua Visa)
• Apple Pay / Google Pay / Link
• Satispay, khi trang thanh toán hiển thị euro

Tất cả giá đều bằng USD; Stripe có thể quy đổi số tiền sang EUR tại trang thanh toán, với tỷ giá bao gồm phí chuyển đổi 2–4% do người thanh toán chịu (không áp dụng khi thanh toán bằng USD; tài liệu Adaptive Pricing của Stripe, đọc ngày 2026-10-03). PayPal và ghi nợ trực tiếp SEPA không khả dụng. Trang thanh toán không hiển thị VAT và không yêu cầu mã số VAT. Hóa đơn điện tử đến SDI: hiện chúng tôi không phát hành hóa đơn điện tử đến SDI của Ý. Nếu có nhu cầu lập hóa đơn, hãy liên hệ sales@kunavo.com.

GDPR — các điểm quan trọng đối với doanh nghiệp vừa và nhỏ tại Ý

• Giả danh hóa PII: xóa tên riêng, mã số thuế, IBAN, email và địa chỉ khỏi prompt trước khi gửi đến mô hình
• DPA / Điều 28 GDPR: Kunavo không cung cấp DPA hoặc các điều khoản hợp đồng tiêu chuẩn (CCT); các yêu cầu được xử lý tại Hoa Kỳ và chuyển tiếp đến các nhà cung cấp upstream. Nếu bạn cần DPA kèm CCT để chuyển dữ liệu sang Hoa Kỳ, hãy ký trực tiếp với nhà cung cấp mô hình (điều khoản doanh nghiệp của Anthropic, OpenAI hoặc Google)
• Thông báo quyền riêng tư cập nhật: nêu rõ việc sử dụng AI bên thứ ba thông qua Kunavo
• Quyền được lãng quên (Điều 17): bảo đảm các nhật ký ứng dụng của bạn có thể bị xóa. Không đưa prompt vào các kho lưu trữ bất biến như blockchain

Lộ trình thực tế

• Tuần 1: nguyên mẫu với 100 tài liệu, 10 truy vấn kiểm thử
• Tuần 2: tích hợp với KB đầy đủ, kiểm thử với người dùng nội bộ
• Tuần 3: tinh chỉnh system prompt bằng các trường hợp thực tế, đánh giá chất lượng
• Tuần 4: triển khai từng bước, theo dõi chi phí tại /app/usage

Sẵn sàng bắt đầu? Đăng ký miễn phí, nạp từ $10 và chỉ trả tiền cho những gì bạn sử dụng (đủ cho khoảng ~1.100 truy vấn kiểm thử). Tài liệu đầy đủ: /docs/quickstart. Nếu có câu hỏi bằng tiếng Ý, hãy viết trực tiếp cho contact@kunavo.com.