Build RAG Chatbot with Haystack, Zilliz Cloud, Google Vertex AI Gemini 2.0 Flash, and OpenAI text-embedding-3-small

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:

Haystack: An open-source Python framework designed for building production-ready NLP applications, particularly question answering and semantic search systems. Haystack excels at retrieving information from large document collections through its modular architecture that combines retrieval and reader components. Ideal for developers creating search applications, chatbots, and knowledge management systems that require efficient document processing and accurate information extraction from unstructured text.
Zilliz Cloud: a fully managed vector database-as-a-service platform built on top of the open-source Milvus, designed to handle high-performance vector data processing at scale. It enables organizations to efficiently store, search, and analyze large volumes of unstructured data, such as text, images, or audio, by leveraging advanced vector search technology. It offers a free tier supporting up to 1 million vectors.
Google Vertex AI Gemini 2.0 Flash: A lightweight, high-speed AI model optimized for rapid inference and cost-effective scalability. It excels in real-time applications requiring low latency, such as chatbots, summarization, and data processing, balancing performance with efficiency for high-volume enterprise workloads on Google Cloud.
OpenAI text-embedding-3-small: Designed to generate dense vector representations of text, this model excels in efficiency and cost-effectiveness, optimized for speed and low resource usage. It delivers competitive performance in semantic similarity, retrieval, and clustering tasks, making it ideal for large-scale applications like search engines, recommendation systems, and text classification where balancing accuracy with computational cost is crucial.

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 Haystack

import os
import requests

from haystack import Pipeline
from haystack.components.converters import MarkdownToDocument

from haystack.components.preprocessors import DocumentSplitter
from haystack.components.writers import DocumentWriter

Step 2: Install and Set Up Google Vertex AI Gemini 2.0 Flash

Using theVertexAIGeminiGenerator with Haystack requires authentication using Google Cloud Application Default Credentials (ADCs). This means your application must be set up with credentials that allow it to access Google Cloud services. If you're not sure how to configure ADCs, check the official Google documentation for setup instructions.

It's important to use a Google Cloud account that has the right permissions to access a project with Google Vertex AI endpoints. Without proper access, the generator won’t work as expected.

To find your project ID, you can either look it up in the Google Cloud Console under the resource manager or run the following command in your terminal.

Now let's install and set up this model.

pip install google-vertex-haystack

from haystack_integrations.components.generators.google_vertex import VertexAIGeminiGenerator

generator = VertexAIGeminiGenerator(model="gemini-2.0-flash-001")

Step 3: Install and Set Up OpenAI text-embedding-3-small

Text documents often come with a set of metadata. If they are distinctive and semantically meaningful, you can embed them along with the text of the document to improve retrieval.

from haystack import Document
from haystack.components.embedders import OpenAIDocumentEmbedder

doc = Document(content="some text",meta={"title": "relevant title", "page number": 18})

document_embedder = OpenAIDocumentEmbedder(meta_fields_to_embed=["title"])

docs_w_embeddings = embedder.run(documents=[doc])["documents"]

Now let's install and set up the model.

from haystack import Document
from haystack.components.embedders import OpenAIDocumentEmbedder
from haystack.components.embedders import OpenAITextEmbedder

text_embedder = OpenAITextEmbedder(api_key=Secret.from_token("<your-api-key>"), model="text-embedding-3-small")
document_embedder = OpenAIDocumentEmbedder(api_key=Secret.from_token("<your-api-key>"), model="text-embedding-3-small")

Step 4: Install and Set Up Zilliz Cloud

pip install --upgrade pymilvus milvus-haystack

from milvus_haystack import MilvusDocumentStore
from milvus_haystack.milvus_embedding_retriever import MilvusEmbeddingRetriever

document_store = MilvusDocumentStore(connection_args={"uri": ZILLIZ_CLOUD_URI, "token": ZILLIZ_CLOUD_TOKEN}, drop_old=True,)
retriever = MilvusEmbeddingRetriever(document_store=document_store, top_k=3)

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 your own dataset to customize your RAG chatbot.

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

indexing_pipeline = Pipeline()
indexing_pipeline.add_component("converter", MarkdownToDocument())
indexing_pipeline.add_component("splitter", DocumentSplitter(split_by="sentence", split_length=2))
indexing_pipeline.add_component("embedder", document_embedder)
indexing_pipeline.add_component("writer", DocumentWriter(document_store))
indexing_pipeline.connect("converter", "splitter")
indexing_pipeline.connect("splitter", "embedder")
indexing_pipeline.connect("embedder", "writer")
indexing_pipeline.run({"converter": {"sources": file_paths}})

# print("Number of documents:", document_store.count_documents())
  
question = "What is Milvus?"  # You can replace it with your own question.

retrieval_pipeline = Pipeline()
retrieval_pipeline.add_component("embedder", text_embedder)
retrieval_pipeline.add_component("retriever", retriever)
retrieval_pipeline.connect("embedder", "retriever")

retrieval_results = retrieval_pipeline.run({"embedder": {"text": question}})

# for doc in retrieval_results["retriever"]["documents"]:
#     print(doc.content)
#     print("-" * 10)

from haystack.utils import Secret
from haystack.components.builders import PromptBuilder

retriever = MilvusEmbeddingRetriever(document_store=document_store, top_k=3) 
 text_embedder = OpenAITextEmbedder(api_key=Secret.from_token("<your-api-key>"), model="text-embedding-3-small")

prompt_template = """Answer the following query based on the provided context. If the context does
                     not include an answer, reply with 'I don't know'.\n
                     Query: {{query}}
                     Documents:
                     {% for doc in documents %}
                        {{ doc.content }}
                     {% endfor %}
                     Answer: 
                  """

rag_pipeline = Pipeline()
rag_pipeline.add_component("text_embedder", text_embedder)
rag_pipeline.add_component("retriever", retriever)
rag_pipeline.add_component("prompt_builder", PromptBuilder(template=prompt_template))
rag_pipeline.add_component("generator", generator)
rag_pipeline.connect("text_embedder.embedding", "retriever.query_embedding")
rag_pipeline.connect("retriever.documents", "prompt_builder.documents")
rag_pipeline.connect("prompt_builder", "generator")

results = rag_pipeline.run({"text_embedder": {"text": question}, "prompt_builder": {"query": question},})
print('RAG answer:\n', results["generator"]["replies"][0])

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.

Haystack optimization tips

To optimize Haystack in a RAG setup, ensure you use an efficient retriever like FAISS or Milvus for scalable and fast similarity searches. Fine-tune your document store settings, such as indexing strategies and storage backends, to balance speed and accuracy. Use batch processing for embedding generation to reduce latency and optimize API calls. Leverage Haystack's pipeline caching to avoid redundant computations, especially for frequently queried documents. Tune your reader model by selecting a lightweight yet accurate transformer-based model like DistilBERT to speed up response times. Implement query rewriting or filtering techniques to enhance retrieval quality, ensuring the most relevant documents are retrieved for generation. Finally, monitor system performance with Haystack’s built-in evaluation tools to iteratively refine your setup based on real-world query performance.

Zilliz Cloud optimization tips

Optimizing Zilliz Cloud for a RAG system involves efficient index selection, query tuning, and resource management. Use Hierarchical Navigable Small World (HNSW) indexing for high-speed, approximate nearest neighbor search while balancing recall and efficiency. Fine-tune ef_construction and M parameters based on your dataset size and query workload to optimize search accuracy and latency. Enable dynamic scaling to handle fluctuating workloads efficiently, ensuring smooth performance under varying query loads. Implement data partitioning to improve retrieval speed by grouping related data, reducing unnecessary comparisons. Regularly update and optimize embeddings to keep results relevant, particularly when dealing with evolving datasets. Use hybrid search techniques, such as combining vector and keyword search, to improve response quality. Monitor system metrics in Zilliz Cloud’s dashboard and adjust configurations accordingly to maintain low-latency, high-throughput performance.

Google Vertex AI Gemini 2.0 Flash optimization tips

To optimize Gemini 2.0 Flash in RAG, balance chunk size for retrieved documents—smaller chunks (200-400 tokens) improve precision, while larger ones preserve context. Use preprocessing to clean text, remove noise, and add metadata (e.g., timestamps) for relevance scoring. Adjust model parameters: lower temperature (0.2-0.5) for factual outputs, and limit max_output_tokens to reduce latency. Batch process embeddings to cut API calls. Cache frequent queries and responses. Fine-tune with domain-specific data if available. Monitor latency and cost via Vertex AI’s tools, and use asynchronous calls for non-blocking operations.

OpenAI text-embedding-3-small optimization tips

Optimize input text by truncating or chunking to stay within the 8191-token limit while preserving semantic context. Normalize embeddings to unit vectors to improve cosine similarity accuracy. Batch embedding requests to reduce API calls and latency. Experiment with dimensionality reduction (e.g., 256-dim) to balance performance and storage costs. Preprocess text by removing redundant or noisy content and standardizing formats (lowercase, trimming whitespace). Cache frequent or static embeddings to avoid redundant computations. Monitor retrieval quality via metrics like recall@k and adjust chunking strategies or hybrid retrieval methods if needed. Fine-tune temperature and top-k parameters during generation to align with embedding outputs.

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 power of combining cutting-edge tools to build a robust RAG system from the ground up! You learned how Haystack acts as the flexible framework orchestrating your entire pipeline, seamlessly connecting components like a conductor leading an orchestra. Zilliz Cloud stepped in as your high-performance vector database, storing and retrieving embeddings at lightning speed—perfect for handling large-scale data without breaking a sweat. Then came Google Vertex AI Gemini 2.0 Flash, the LLM powerhouse that generates crisp, context-aware answers, balancing speed and accuracy like a pro. And let’s not forget OpenAI’s text-embedding-3-small, which transformed your raw text into rich, meaningful vectors, ensuring your system understands nuances and relationships in the data. Together, these tools formed a symphony of efficiency, turning complex queries into actionable insights!

But wait—there’s more! You also picked up optimization tricks, like tuning retrieval parameters and balancing cost vs. performance, and even discovered a free RAG cost calculator to keep your projects budget-friendly. Imagine the possibilities now: chatbots that truly understand context, search engines that feel psychic, or tools that automate knowledge-heavy tasks. The best part? You’ve got everything you need to start experimenting, iterating, and scaling. So why wait? Take these tools, mix in your creativity, and build something that blows minds—whether it’s for work, a passion project, or just to see what’s possible. The future of intelligent apps is in your hands—go make it happen! 🚀

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