Build RAG Chatbot with LangChain, pgvector, Google Vertex AI Claude 3 Opus, and voyage-code-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:

LangChain: An open-source framework that helps you orchestrate the interaction between LLMs, vector stores, embedding models, etc, making it easier to integrate a RAG pipeline.
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.)
Google Vertex AI Claude 3 Opus: This advanced AI model integrates Google's cloud capabilities with Claude's robust language understanding. It excels in generating coherent and contextually relevant content across diverse applications, including chatbots, content creation, and data analysis. Ideal for organizations seeking scalable, high-performance solutions for natural language processing tasks.
Voyage Code 3: This model is designed for advanced code generation and understanding, offering robust capabilities in programming assistance and automated coding tasks. Its strength lies in contextual comprehension and precise syntax generation, making it ideal for developers seeking to enhance productivity through efficient coding solutions and debugging support.

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 LangChain

%pip install --quiet --upgrade langchain-text-splitters langchain-community langgraph

Step 2: Install and Set Up Google Vertex AI Claude 3 Opus

pip install -qU "langchain[google-vertexai]"

# Ensure your VertexAI credentials are configured

from langchain.chat_models import init_chat_model

llm = init_chat_model("claude-3-opus@20240229", model_provider="google_vertexai")

Step 3: Install and Set Up voyage-code-3

pip install -qU langchain-voyageai

import getpass
import os

if not os.environ.get("VOYAGE_API_KEY"):
  os.environ["VOYAGE_API_KEY"] = getpass.getpass("Enter API key for Voyage AI: ")

from langchain-voyageai import VoyageAIEmbeddings

embeddings = VoyageAIEmbeddings(model="voyage-code-3")

Step 4: Install and Set Up pgvector

pip install -qU langchain-postgres

from langchain_postgres import PGVector

vector_store = PGVector(
    embeddings=embeddings,
    collection_name="my_docs",
    connection="postgresql+psycopg://...",
)

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 bs4
from langchain import hub
from langchain_community.document_loaders import WebBaseLoader
from langchain_core.documents import Document
from langchain_text_splitters import RecursiveCharacterTextSplitter
from langgraph.graph import START, StateGraph
from typing_extensions import List, TypedDict

# Load and chunk contents of the blog
loader = WebBaseLoader(
    web_paths=("https://milvus.io/docs/overview.md",),
    bs_kwargs=dict(
        parse_only=bs4.SoupStrainer(
            class_=("doc-style doc-post-content")
        )
    ),
)

docs = loader.load()

text_splitter = RecursiveCharacterTextSplitter(chunk_size=1000, chunk_overlap=200)
all_splits = text_splitter.split_documents(docs)

# Index chunks
_ = vector_store.add_documents(documents=all_splits)

# Define prompt for question-answering
prompt = hub.pull("rlm/rag-prompt")


# Define state for application
class State(TypedDict):
    question: str
    context: List[Document]
    answer: str


# Define application steps
def retrieve(state: State):
    retrieved_docs = vector_store.similarity_search(state["question"])
    return {"context": retrieved_docs}


def generate(state: State):
    docs_content = "\n\n".join(doc.page_content for doc in state["context"])
    messages = prompt.invoke({"question": state["question"], "context": docs_content})
    response = llm.invoke(messages)
    return {"answer": response.content}


# Compile application and test
graph_builder = StateGraph(State).add_sequence([retrieve, generate])
graph_builder.add_edge(START, "retrieve")
graph = graph_builder.compile()

Test the Chatbot

Yeah! You've built your own chatbot. Let's ask the chatbot a question.

response = graph.invoke({"question": "What data types does Milvus support?"})
print(response["answer"])

Example Output

Milvus supports various data types including sparse vectors, binary vectors, JSON, and arrays. Additionally, it handles common numerical and character types, making it versatile for different data modeling needs. This allows users to manage unstructured or multi-modal data efficiently.

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.

LangChain optimization tips

To optimize LangChain, focus on minimizing redundant operations in your workflow by structuring your chains and agents efficiently. Use caching to avoid repeated computations, speeding up your system, and experiment with modular design to ensure that components like models or databases can be easily swapped out. This will provide both flexibility and efficiency, allowing you to quickly scale your system without unnecessary delays or complications.

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.

Google Vertex AI Claude 3 Opus optimization tips

Claude 3 Opus on Google Vertex AI is a high-performance model suited for complex reasoning tasks in RAG applications. Improve retrieval by employing multi-step document ranking to ensure only the most relevant data is passed to the model. Structure prompts effectively, placing key facts upfront to enhance response quality. Keep temperature low (0.1–0.2) for factual accuracy and fine-tune top-k/top-p for nuanced control. Utilize Google Vertex AI’s resource scaling to manage workload surges efficiently. Implement response caching for frequently accessed queries to optimize cost and speed. If using Opus alongside smaller models, deploy it selectively for queries requiring deep analytical capabilities while using lighter models for routine tasks.

voyage-code-3 optimization tips

voyage-code-3 is designed for code generation and understanding, making structured input crucial for optimal RAG performance. Improve retrieval by using high-quality code embeddings and semantic search techniques to surface the most relevant code snippets. Keep prompts well-organized, clearly specifying requirements, constraints, and relevant context. Adjust temperature settings (0.1–0.3) to control creativity versus precision in generated code. Implement response caching for frequently accessed functions and common coding patterns to reduce processing time. Utilize batch processing and token-efficient formatting to optimize resource usage. If integrating multiple models, use voyage-code-3 for generating complex code solutions while reserving smaller models for lightweight code completions and explanations.

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?

By diving into this tutorial, you’ve unlocked the magic of building a RAG system from the ground up! You’ve seen how LangChain acts as the glue, seamlessly connecting your vector database (pgvector) with Google Vertex AI’s Claude 3 Opus—an LLM powerhouse—and voyage-code-3’s embedding model. Together, they form a dynamic pipeline: voyage-code-3 transforms text into rich embeddings, pgvector stores and retrieves them efficiently, and Claude 3 Opus crafts human-like responses using that context. You’ve learned to orchestrate these tools to turn raw data into intelligent, context-aware answers—like teaching a machine to think with memory! Plus, you picked up optimization tricks, like tuning pgvector’s indexing for lightning-fast searches and balancing chunk sizes to improve accuracy without sacrificing speed. And let’s not forget the free RAG cost calculator—a game-changer for estimating expenses and scaling your projects smartly.

Now you’re armed with the skills to build systems that don’t just answer questions but adapt, learn, and evolve. Whether you’re creating chatbots that feel eerily human or research tools that uncover hidden insights, you’ve got the blueprint. The best part? You’ve seen how small tweaks—like adjusting embedding dimensions or experimenting with Claude’s temperature settings—can transform performance. So what’s next? Take this knowledge, mix in your creativity, and start building! Tinker with prompts, optimize costs, and push the boundaries of what’s possible. The future of AI is collaborative, dynamic, and yours to shape. Let’s go blow some minds with RAG magic—your next breakthrough is just a line of code away! 🚀

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! 💖