Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

2.6 KB
Raw Blame

langchain-openviking

langchain-openviking 是 OpenViking 官方维护的 LangChain 和 LangGraph 集成包。框架适配逻辑不再依赖 OpenViking 服务端实现,远程访问统一通过轻量的 openviking-sdk 完成。

OpenViking Server 要求:文档中的示例使用 viking://~ Home 别名(例如 viking://~/memories),Server 会将其展开为当前调用方自己的用户空间,因此需要一个支持 viking://~ 的 Server。不带 uid 的 viking://user/memories 旧写法会被新版 Server 拒绝;要访问其他用户请显式传入 viking://user/<uid>/...。

安装

LangChain Retriever、Tools、Message History 和 Context Wrapper:

pip install langchain-openviking

LangGraph Store 和 Middleware:

pip install "langchain-openviking[langgraph]"

快速开始

from langchain_openviking import OpenVikingRetriever
from openviking_sdk import SyncHTTPClient

client = SyncHTTPClient(
    url="http://127.0.0.1:1933",
    api_key="your-user-api-key",
)
client.initialize()
retriever = OpenVikingRetriever(
    client=client,
    target_uri="viking://~/memories",
)

try:
    documents = retriever.invoke("需要记住哪些部署偏好?")
finally:
    client.close()

外部传入的 client 仍由调用方管理。通过 url= 创建的 client 由适配器管理。

导入迁移

从 v0.5.0 之后的下一个服务端版本开始,旧的 openviking.integrations.langchain 命名空间将移除,不提供兼容转发模块;v0.5.0 仍保留该路径。 请安装独立包,并改用 langchain_openviking 导入, 详见未发布版本的迁移说明。

from langchain_openviking import OpenVikingRetriever

参见示例和框架适配指南。

验证

在仓库根目录运行:

pip install -e 'integrations/frameworks/langchain[langgraph,test,dev]'
python -m pytest -q --noconftest -o addopts='' \
  integrations/frameworks/langchain/tests tests/unit/test_langchain_package_boundary.py

包元数据和源码声明 AGPL-3.0,详见 LICENSE。 可运行示例保留 Apache-2.0 许可。