Build RAG Chatbot with Llamaindex, Pgvector, Anthropic Claude 3 Haiku, and voyage-3

Introduction to RAG

Retrieval-Augmented Generation (RAG) is a game-changer for GenAI applications, especially in conversational AI. It combines the power of pre-trained large language models (LLMs) like OpenAI’s GPT with external knowledge sources stored in vector databases such as Milvus and Zilliz Cloud, allowing for more accurate, contextually relevant, and up-to-date response generation. A RAG pipeline usually consists of four basic components: a vector database, an embedding model, an LLM, and a framework.

Key Components We'll Use for This RAG Chatbot

This tutorial shows you how to build a simple RAG chatbot in Python using the following components:

Llamaindex: a data framework that connects large language models (LLMs) with various data sources, enabling efficient retrieval-augmented generation (RAG). It helps structure, index, and query private or external data, optimizing LLM applications for search, chatbots, and analytics.
Pgvector: an open-source extension for PostgreSQL that enables efficient storage and querying of high-dimensional vector data, essential for machine learning and AI applications. Designed to handle embeddings, it supports fast approximate nearest neighbor (ANN) searches using algorithms like HNSW and IVFFlat. Since it is just a vector search add-on to traditional search rather than a purpose-built vector database, it lacks scalability and availability and many other advanced features required by enterprise-level applications. Therefore, if you prefer a much more scalable solution or hate to manage your own infrastructure, we recommend using Zilliz Cloud, which is a fully managed vector database service built on the open-source Milvus and offers a free tier supporting up to 1 million vectors.)
Anthropic Claude 3 Haiku: A lightweight, high-speed AI model optimized for rapid processing of simple queries and high-volume tasks. Strengths include low latency, cost-efficiency, and multilingual support, ideal for real-time interactions, data extraction, content moderation, and scalable enterprise workflows requiring fast, accurate responses with minimal resource usage.
Voyage-3: Designed for AI-powered navigation and journey planning, Voyage-3 optimizes route efficiency while providing real-time traffic updates and data insights. Its strengths lie in predictive analysis and adaptive learning, making it ideal for logistics, delivery services, and travel apps that demand reliable and intelligent navigation solutions.

By the end of this tutorial, you’ll have a functional chatbot capable of answering questions based on a custom knowledge base.

Note: Since we may use proprietary models in our tutorials, make sure you have the required API key beforehand.

Step 1: Install and Set Up Llamaindex

pip install llama-index

Step 2: Install and Set Up Anthropic Claude 3 Haiku

%pip install llama-index-llms-anthropic

from llama_index.llms.anthropic import Anthropic

# To customize your API key, do this
# otherwise it will lookup ANTHROPIC_API_KEY from your env variable
# llm = Anthropic(api_key="")
llm = Anthropic(model="claude-3-haiku-20240307")

Step 3: Install and Set Up voyage-3

%pip install llama-index-embeddings-voyageai

from llama_index.embeddings.voyageai import VoyageEmbedding

embed_model = VoyageEmbedding(
    voyage_api_key="",
    model_name="voyage-3",
)

Step 4: Install and Set Up Pgvector

%pip install llama-index-vector-stores-postgres

from llama_index.core import VectorStoreIndex
from llama_index.vector_stores.postgres import PGVectorStore

vector_store = PGVectorStore.from_params(
    database=db_name,
    host=url.host,
    password=url.password,
    port=url.port,
    user=url.username,
    table_name="your_table_name",
    embed_dim=1536,  # openai embedding dimension
    hnsw_kwargs={
        "hnsw_m": 16,
        "hnsw_ef_construction": 64,
        "hnsw_ef_search": 40,
        "hnsw_dist_method": "vector_cosine_ops",
    },
)

Step 5: Build a RAG Chatbot

Now that you’ve set up all components, let’s start to build a simple chatbot. We’ll use the Milvus introduction doc as a private knowledge base. You can replace it with your own dataset to customize your RAG chatbot.

import requests

from llama_index.core import SimpleDirectoryReader

# load documents
url = 'https://raw.githubusercontent.com/milvus-io/milvus-docs/refs/heads/v2.5.x/site/en/about/overview.md'
example_file = 'example_file.md'  # You can replace it with your own file paths.
response = requests.get(url)
with open(example_file, 'wb') as f:
    f.write(response.content)
documents = SimpleDirectoryReader(
    input_files=[example_file]
).load_data()

print("Document ID:", documents[0].doc_id)

storage_context = StorageContext.from_defaults(vector_store=vector_store)
index = VectorStoreIndex.from_documents(
    documents, storage_context=storage_context, embed_model=embed_model
)

query_engine = index.as_query_engine(llm=llm)
res = query_engine.query("What is Milvus?")  # You can replace it with your own question.
print(res)

Example output

Milvus is a high-performance, highly scalable vector database designed to operate efficiently across various environments, from personal laptops to large-scale distributed systems. It is available as both open-source software and a cloud service. Milvus excels in managing unstructured data by converting it into numerical vectors through embeddings, which facilitates fast and scalable searches and analytics. The database supports a wide range of data types and offers robust data modeling capabilities, allowing users to organize their data effectively. Additionally, Milvus provides multiple deployment options, including a lightweight version for quick prototyping and a distributed version for handling massive data scales.

Optimization Tips

As you build your RAG system, optimization is key to ensuring peak performance and efficiency. While setting up the components is an essential first step, fine-tuning each one will help you create a solution that works even better and scales seamlessly. In this section, we’ll share some practical tips for optimizing all these components, giving you the edge to build smarter, faster, and more responsive RAG applications.

LlamaIndex optimization tips

To optimize LlamaIndex for a Retrieval-Augmented Generation (RAG) setup, structure your data efficiently using hierarchical indices like tree-based or keyword-table indices for faster retrieval. Use embeddings that align with your use case to improve search relevance. Fine-tune chunk sizes to balance context length and retrieval precision. Enable caching for frequently accessed queries to enhance performance. Optimize metadata filtering to reduce unnecessary search space and improve speed. If using vector databases, ensure indexing strategies align with your query patterns. Implement async processing to handle large-scale document ingestion efficiently. Regularly monitor query performance and adjust indexing parameters as needed for optimal results.

pgvector optimization tips

To optimize pgvector in a Retrieval-Augmented Generation (RAG) setup, consider indexing your vectors using GiST or IVFFlat to significantly speed up search queries and improve retrieval performance. Make sure to leverage parallelization for query execution, allowing multiple queries to be processed simultaneously, especially for large datasets. Optimize memory usage by tuning the vector storage size and using compressed embeddings where possible. To further enhance query speed, implement pre-filtering techniques to narrow down search space before querying. Regularly rebuild indexes to ensure they are up to date with any new data. Fine-tune vectorization models to reduce dimensionality without sacrificing accuracy, thus improving both storage efficiency and retrieval times. Finally, manage resource allocation carefully, utilizing horizontal scaling for larger datasets and offloading intensive operations to dedicated processing units to maintain responsiveness during high-traffic periods.

Anthropic Claude 3 Haiku optimization tips

To optimize Claude 3 Haiku in RAG systems, prioritize semantic search quality by combining keyword and vector-based retrieval with tuned chunk sizes (256-512 tokens) and overlap for context preservation. Structure retrieved content using XML tags or section headers for clearer parsing, and enforce strict context grounding via system prompts like "Base responses solely on provided documents." Limit output length to 300-500 tokens for cost efficiency, implement response validation against source materials to reduce hallucinations, and cache frequent queries. Use rate limiting to manage throughput and parallelize processing for high-volume workflows while monitoring accuracy metrics.

voyage-3 optimization tips

voyage-3 is a versatile model suitable for balanced performance in RAG systems, making efficient retrieval strategies crucial for maintaining low latency and high accuracy. Improve retrieval by leveraging embedding-based similarity search with reranking to ensure relevant context is included. Structure prompts with clear context separation and concise instructions to maximize response accuracy. Set temperature between 0.1 and 0.3 for controlled output while tuning top-k and top-p for flexibility. Implement response caching for frequently queried data to minimize redundant processing and API calls. Utilize parallel processing and request batching to optimize resource efficiency. For multi-model deployments, assign voyage-3 to mid-tier complexity tasks while using larger models for deeper analysis and smaller models for real-time, low-latency queries.

By implementing these tips across your components, you'll be able to enhance the performance and functionality of your RAG system, ensuring it’s optimized for both speed and accuracy. Keep testing, iterating, and refining your setup to stay ahead in the ever-evolving world of AI development.

RAG Cost Calculator: A Free Tool to Calculate Your Cost in Seconds

Estimating the cost of a Retrieval-Augmented Generation (RAG) pipeline involves analyzing expenses across vector storage, compute resources, and API usage. Key cost drivers include vector database queries, embedding generation, and LLM inference.

RAG Cost Calculator is a free tool that quickly estimates the cost of building a RAG pipeline, including chunking, embedding, vector storage/search, and LLM generation. It also helps you identify cost-saving opportunities and achieve up to 10x cost reduction on vector databases with the serverless option.

Calculate your RAG cost now.

Calculate your RAG cost

What Have You Learned?

Congratulations on completing this tutorial! You've learned how to harness the power of LlamaIndex, Pgvector, Anthropic Claude 3, and a robust embedding model to create your very own Retrieval-Augmented Generation (RAG) system. Throughout the steps, you discovered how these components come together in an elegant pipeline to enhance information retrieval and generation capabilities. The LlamaIndex framework provides a stellar foundation for data organization, while Pgvector offers the perfect vector database solution for efficiently managing and querying embeddings. With Anthropic Claude 3, you can generate coherent and contextually relevant responses that bring your applications to life. You've seen firsthand how embedding models improve the way your system understands and interacts with information, making your RAG setup not just functional but outstanding.

But wait, there's more! You also picked up valuable optimization tips that can enhance the performance of your RAG system, as well as a handy free RAG cost calculator to help you keep track of your project's budget. Now is the time to put your newfound knowledge into action! Dive in, start building your RAG applications, experiment with different configurations, and watch as your ideas take flight. The possibilities are endless, and your innovation could pave the way for game-changing solutions. So roll up your sleeves—let's get building and make an impact!

Further Resources

🌟 In addition to this RAG tutorial, unleash your full potential with these incredible resources to level up your RAG skills.

How to Build a Multimodal RAG | Documentation
How to Enhance the Performance of Your RAG Pipeline
Graph RAG with Milvus | Documentation
How to Evaluate RAG Applications - Zilliz Learn
Generative AI Resource Hub | Zilliz

We'd Love to Hear What You Think!

We’d love to hear your thoughts! 🌟 Leave your questions or comments below or join our vibrant Milvus Discord community to share your experiences, ask questions, or connect with thousands of AI enthusiasts. Your journey matters to us!

If you like this tutorial, show your support by giving our Milvus GitHub repo a star ⭐—it means the world to us and inspires us to keep creating! 💖