跳转到主要内容

Google El Carro Oracle的LangChain集成

项目描述

preview pypi versions

已知限制

  • 该库支持Oracle 18c及以上版本的El Carro Operator。

  • 默认情况下,该库使用瘦模式。进行Oracle连接,要使用厚模式,请按照相应的部分。

  • 要使用超过4000个字节的VARCHAR2数据类型,请更改Oracle实例中的参数MAX_STRING_SIZE。

快速入门

创建El Carro Operator Oracle实例和数据库(PDB)

为了使用此库,您首先需要一个运行实例(CDB)和数据库(PDB)的El Carro Operator软件。

请按照El Carro Oracle Operator的步骤配置新数据库并创建PDB

安装

使用pip在virtualenv中安装此库。virtualenv是一个用于创建独立Python环境的工具。它解决的基本问题是依赖和版本,以及间接的权限问题。

使用virtualenv,可以在不需要系统安装权限的情况下安装此库,并且不会与已安装的系统依赖冲突。

支持的Python版本

Python >= 3.8

Mac/Linux

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install langchain-google-el-carro

Windows

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install langchain-google-el-carro

文档加载器使用方法

使用文档加载器将数据作为LangChain 文档加载。

from langchain_google_el_carro import ElCarroEngine
from langchain_google_el_carro.loader import \
    ElCarroLoader, ElCarroDocumentSaver

elcarro_engine = ElCarroEngine.from_instance(
    "Your El Carro endpoint hostname", # e.g. 127.0.0.1
    "Your El Carro endpoint port", # e.g. 3307
    "Your PDB name",  # e.g. PDB1
    "Your DB user",
    "Your DB password",
)
loader = ElCarroLoader(
    elcarro_engine,
    table_name="my-table-name"
)
docs = loader.lazy_load()

请参阅完整的文档加载器教程。

聊天消息历史记录使用方法

使用ChatMessageHistory存储消息,并为LLM提供会话历史记录。

from langchain_google_el_carro import ElCarroEngine
from langchain_google_el_carro.chat_message_history import \
    ElCarroChatMessageHistory

elcarro_engine = ElCarroEngine.from_instance(
    "Your El Carro endpoint hostname", # e.g. 127.0.0.1
    "Your El Carro endpoint port", # e.g. 3307
    "Your PDB name",  # e.g. PDB1
    "Your DB user",
    "Your DB password",
)
history = ElCarroChatMessageHistory(
    elcarro_engine=elcarro_engine,
    table_name="my-message-store",
    session_id="my-session_id"
)

请参阅完整的聊天消息历史记录教程。

Oracle厚模式连接

厚模式连接需要您安装Oracle客户端库,并将thick_mode=True传递给ElCarroEngine。请遵循oracledb安装指南的以下部分

Linux x64,glibc 2.14+的示例

wget https://download.oracle.com/otn_software/linux/instantclient/2113000/instantclient-basic-linux.x64-21.13.0.0.0dbru.zip -O /tmp/drv.zip
rm -fr /tmp/instantclient_21_13/; unzip /tmp/drv.zip -d /tmp
export LD_LIBRARY_PATH=/tmp/instantclient_21_13/:$LD_LIBRARY_PATH

贡献

欢迎并鼓励对此库的贡献。

有关如何开始的更多信息,请参阅CONTRIBUTING

请注意,此项目以贡献者行为准则发布。通过参与此项目,您同意遵守其条款。有关更多信息,请参阅行为准则

许可证

Apache 2.0 - 有关更多信息,请参阅LICENSE

免责声明

这不是一个官方支持的Google产品。

项目详情


下载文件

下载您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

此版本没有可用的源代码分发文件。请参阅生成分发存档的教程。

构建分发

langchain_google_el_carro-0.2.0-py3-none-any.whl (21.3 kB 查看哈希值)

上传时间 Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面