Notebooks
M
Milvus
Basic Usage Langchain

Basic Usage Langchain

image-searchvector-databasesemantic-searchIntegrationmilvusembeddingsunstructured-dataquestion-answeringLLMmilvus-bootcampdeep-learningimage-recognitionimage-classificationaudio-searchPythonraglangchainNLP

Use Milvus as a LangChain Vector Store

This notebook shows how to use functionality related to the Milvus as a LangChain vector store.

Setup

You'll need to install langchain-milvus and other necessary dependencies.

[ ]

The latest version of pymilvus comes with a local vector database Milvus Lite, good for prototyping. If you have large scale of data such as more than a million docs, we recommend setting up a more performant Milvus server on docker or kubernetes.

Initialization

[2]
[ ]

Compartmentalize the data with Milvus Collections

You can store different unrelated documents in different collections within same Milvus instance to maintain the context

Here's how you can create a new vector store collection from documents:

[4]

And here is how you retrieve that stored collection

[5]

Manage vector store

Once you have created your vector store, we can interact with it by adding and deleting different items.

Add items to vector store

We can add items to our vector store by using the add_documents function.

[6]
['31915e2d-55fd-4bfb-ae08-d441252b8e08',
, 'dbf6560a-1487-4a6e-8797-245d57874f5b',
, 'e991a253-5f37-46ae-850a-82a660e33013',
, '2818c051-5a1a-44cb-9deb-aaaac709f616',
, '91c7ef07-26d1-4319-b48c-9261df9ce8d7',
, 'fb258085-6400-4cd7-aa92-fc5e32ca243e',
, 'ffea9a9f-460d-4d8d-ba07-c45e9cfa1e33',
, 'eb149e29-239a-4e2c-9f99-751cb7207abf',
, '119d4a42-fd6b-433d-842b-1e0be5df81e5',
, '5b099eb0-98fe-40a3-b13a-300c10250960']

Delete items from vector store

[7]
True

Query vector store

Once your vector store has been created and the relevant documents have been added you will most likely wish to query it during the running of your chain or agent.

Query directly

Similarity search

Performing a simple similarity search with filtering on metadata can be done as follows:

[8]
WARNING: All log messages before absl::InitializeLog() is called are written to STDERR
I0000 00:00:1761298048.354308 7886403 fork_posix.cc:71] Other threads are currently calling into gRPC, skipping fork() handlers
* Building an exciting new project with LangChain - come check it out! [{'source': 'tweet', 'pk': 'e991a253-5f37-46ae-850a-82a660e33013'}]
* LangGraph is the best framework for building stateful, agentic applications! [{'source': 'tweet', 'pk': 'eb149e29-239a-4e2c-9f99-751cb7207abf'}]

Similarity search with score

You can also search with score:

[9]
* [SIM=0.893776] The weather forecast for tomorrow is cloudy and overcast, with a high of 62 degrees. [{'source': 'news', 'pk': 'dbf6560a-1487-4a6e-8797-245d57874f5b'}]

For a full list of all the search options available when using the Milvus vector store, you can visit the API reference.

Query by turning into retriever

You can also transform the vector store into a retriever for easier usage in your chains.

[10]
I0000 00:00:1761298049.275354 7886403 fork_posix.cc:71] Other threads are currently calling into gRPC, skipping fork() handlers
[Document(metadata={'source': 'news', 'pk': '2818c051-5a1a-44cb-9deb-aaaac709f616'}, page_content='Robbers broke into the city bank and stole $1 million in cash.')]

Usage for Retrieval-Augmented Generation

For guides on how to use this vector store for retrieval-augmented generation (RAG), see this RAG guide.

Per-User Retrieval

When building a retrieval app, you often have to build it with multiple users in mind. This means that you may be storing data not just for one user, but for many different users, and they should not be able to see eachother’s data.

Milvus recommends using partition_key to implement multi-tenancy, here is an example.

The feature of Partition key is now not available in Milvus Lite, if you want to use it, you need to start Milvus server from docker or kubernetes.

[11]

To conduct a search using the partition key, you should include either of the following in the boolean expression of the search request:

search_kwargs={"expr": '<partition_key> == "xxxx"'}

search_kwargs={"expr": '<partition_key> == in ["xxx", "xxx"]'}

Do replace <partition_key> with the name of the field that is designated as the partition key.

Milvus changes to a partition based on the specified partition key, filters entities according to the partition key, and searches among the filtered entities.

[12]
[Document(metadata={'namespace': 'ankush', 'pk': 460829372217788296}, page_content='i worked at facebook')]
[13]
[Document(metadata={'namespace': 'harrison', 'pk': 460829372217788295}, page_content='i worked at kensho')]

API reference

For detailed documentation, head to the API reference: https://reference.langchain.com/python/integrations/langchain_milvus/