Skip to main content
Weaviate 是一个开源向量数据库,它存储对象和向量,允许将向量搜索与结构化过滤相结合。LangChain 通过 weaviate-client 包(Weaviate 的官方 Typescript 客户端)连接到 Weaviate。 本指南提供了开始使用 Weaviate 向量存储 的快速概览。有关所有 WeaviateStore 功能和配置的详细文档,请访问 API 参考

概述

集成详情

设置

要使用 Weaviate 向量存储,你需要设置一个 Weaviate 实例并安装 @langchain/weaviate 集成包。你还应该安装 weaviate-client 包以初始化一个客户端来连接你的实例,以及 uuid 包(如果你想为索引的文档分配 id)。 本指南还将使用 OpenAI 嵌入,这需要你安装 @langchain/openai 集成包。如果你愿意,也可以使用其他支持的嵌入模型
你需要在本地或服务器上运行 Weaviate。更多信息请参阅 Weaviate 文档

凭证

设置好实例后,设置以下环境变量:
如果你在本指南中使用 OpenAI 嵌入,你还需要设置你的 OpenAI 密钥:
如果你想获得模型调用的自动跟踪,你也可以通过取消注释以下内容来设置你的 LangSmith API 密钥:

实例化

连接 weaviate 客户端

在大多数情况下,你应该使用其中一个连接辅助函数来连接到你的 Weaviate 实例:
  • connectToWeaviateCloud
  • connectToLocal
  • connectToCustom

初始化 vectorStore

要创建一个集合,至少需要指定集合名称。如果你没有指定任何属性,auto-schema 会创建它们。
要使用 Weaviate 的命名向量、向量化器、重排器、生成模型等,请在启用向量存储时使用 schema 属性。创建向量存储时,schema 中的集合名称和其他属性将优先。

管理向量存储

向向量存储添加项目

注意: 如果你想将 id 与索引的文档关联起来,它们必须是 UUID。

从向量存储中删除项目

你可以通过 id 或传递 filter 参数来删除:

查询向量存储

一旦你的向量存储创建完成并且相关文档已添加,你很可能希望在链或代理运行期间查询它。 在 weaviate 的 v3 中,客户端与 collections 交互是处理数据库中对象的主要方式。collection 对象可以在整个代码库中重复使用。

直接查询

执行简单的相似性搜索可以如下进行。Filter 辅助类使得使用带条件的过滤器更容易。v3 客户端简化了你使用 Filter 的方式,使你的代码更清晰、更简洁。 有关 Weaviate 过滤器语法的更多信息,请参阅此页面
如果你想执行相似性搜索并接收相应的分数,你可以运行:

混合搜索

在 Weaviate 中,混合搜索 通过融合两个结果集来结合向量搜索和关键词(BM25F)搜索的结果。要更改关键词和向量组件的相对权重,请在查询中设置 alpha 值。 查看 文档 获取混合搜索选项的完整列表。

检索增强生成 (RAG)

检索增强生成 (RAG) 将信息检索与生成式 AI 模型相结合。 在 Weaviate 中,RAG 查询由两部分组成:搜索查询和给模型的提示。Weaviate 首先执行搜索,然后将搜索结果和你的提示传递给生成式 AI 模型,最后返回生成的响应。
  • @param query 要搜索的查询。
  • @param options 执行混合搜索的可用选项
  • @param generate 生成的可用选项。查看文档获取完整列表

通过转换为检索器进行查询

你也可以将向量存储转换为检索器,以便在你的链中更轻松地使用。

用于检索增强生成的用法

有关如何使用此向量存储进行检索增强生成 (RAG) 的指南,请参阅以下部分:

API 参考

有关所有 WeaviateStore 功能和配置的详细文档,请访问 API 参考