nvidia-rag-canonical
此模板使用 Milvus 向量存储和 NVIDIA 模型(嵌入和聊天)执行 RAG。
环境设置
您应该将您的 NVIDIA API 密钥导出为环境变量。
如果您没有 NVIDIA API 密钥,可以通过以下步骤创建一个:
- 在 NVIDIA GPU Cloud 服务上创建一个免费帐户,该服务托管 AI 解决方案目录、容器、模型等。
- 导航到
Catalog > AI Foundation Models > (带有 API 端点的模型)
。 - 选择
API
选项并点击Generate Key
。 - 将生成的密钥保存为
NVIDIA_API_KEY
。从此,您应该能够访问这些端点。
export NVIDIA_API_KEY=...
有关托管 Milvus 向量存储的说明,请参阅底部的部分。
使用方法
要使用此包,您首先需要安装 LangChain CLI:
pip install -U langchain-cli
要使用 NVIDIA 模型,请安装 Langchain NVIDIA AI Endpoints 包:
pip install -U langchain_nvidia_aiplay
要创建一个新的 LangChain 项目并将其作为唯一包安装,您可以执行:
langchain app new my-app --package nvidia-rag-canonical
如果您想将其添加到现有项目中,只需运行:
langchain app add nvidia-rag-canonical
并将以下代码添加到您的 server.py
文件中:
from nvidia_rag_canonical import chain as nvidia_rag_canonical_chain
add_routes(app, nvidia_rag_canonical_chain, path="/nvidia-rag-canonical")
如果您想设置一个摄取管道,可以将以下代码添加到您的 server.py
文件中:
from nvidia_rag_canonical import ingest as nvidia_rag_ingest
add_routes(app, nvidia_rag_ingest, path="/nvidia-rag-ingest")
请注意,对于通过摄取 API 摄取的文件,服务器需要重新启动,以便重新摄取的文件可以被检索器访问。
(可选)现在让我们配置 LangSmith。 LangSmith 将帮助我们跟踪、监控和调试 LangChain 应用程序。 您可以在 这里 注册 LangSmith。 如果您没有访问权限,可以跳过此部分。
export LANGCHAIN_TRACING_V2=true
export LANGCHAIN_API_KEY=<your-api-key>
export LANGCHAIN_PROJECT=<your-project> # 如果未指定,默认为 "default"
如果您尚未拥有要连接的 Milvus 向量存储,请在继续之前查看下面的 Milvus 设置
部分。
如果您有要连接的 Milvus 向量存储,请在 nvidia_rag_canonical/chain.py
中编辑连接详细信息。
如果您在此目录内,则可以直接启动 LangServe 实例:
langchain serve
这将启动 FastAPI 应用程序,服务器在本地运行于 http://localhost:8000
我们可以在 http://127.0.0.1:8000/docs 查看所有模板。 我们可以在 http://127.0.0.1:8000/nvidia-rag-canonical/playground 访问游乐场。
我们可以通过代码访问模板:
from langserve.client import RemoteRunnable
runnable = RemoteRunnable("http://localhost:8000/nvidia-rag-canonical")
Milvus 设置
如果您需要创建一个 Milvus 向量存储并导入数据,请使用此步骤。我们将首先按照标准的 Milvus 设置说明 这里 进行操作。
下载 Docker Compose YAML 文件。
wget https://github.com/milvus-io/milvus/releases/download/v2.3.3/milvus-standalone-docker-compose.yml -O docker-compose.yml
启动 Milvus 向量存储容器
sudo docker compose up -d
安装 PyMilvus 包以与 Milvus 容器进行交互。
pip install pymilvus
现在让我们导入一些数据!我们可以通过进入此目录并运行
ingest.py
中的代码来实现,例如:python ingest.py
请注意,您可以(并且应该!)更改此内容以导入您选择的数据。