探索如何在运行时传递秘密：Langchain 运行配置详解-优快云博客

引言

在现代应用程序开发中，保护敏感信息是一项重要任务。在使用Langchain-core进行开发时，可能需要在运行时传递敏感信息（如API密钥）。本篇文章将介绍如何通过RunnableConfig在运行时安全地传递这些秘密，同时确保它们不会被记录。

主要内容

Langchain-core提供了一种通过RunnableConfig在运行时传递秘密的机制。利用这一特性，我们可以确保这些秘密不会在调用过程中被跟踪记录。

使用`RunnableConfig`传递秘密

在Langchain-core v0.2.22及以上版本中，可以通过在配置字段名前添加__前缀，来防止秘密被记录。我们来看一下具体的实现方式。

from langchain_core.runnables import RunnableConfig
from langchain_core.tools import tool

@tool
def foo(x: int, config: RunnableConfig) -> int:
    """Sum x and a secret int"""
    return x + config["configurable"]["__top_secret_int"]

# 传递秘密int并执行
result = foo.invoke(
    {"x": 5},
    {"configurable": {"__top_secret_int": 2, "traced_key": "bar"}}
)
print(result)  # 输出: 7

在上述代码中，__top_secret_int是敏感信息，其值在函数调用中使用，但不会被记录。

LangSmith Tracing

在LangSmith的跟踪中，可以看到traced_key被记录（作为元数据的一部分），而__top_secret_int则没有被记录。这确保了敏感数据的安全性。

代码示例

完整代码如下：

from langchain_core.runnables import RunnableConfig
from langchain_core.tools import tool

@tool
def foo(x: int, config: RunnableConfig) -> int:
    """Sum x and a secret int"""
    return x + config["configurable"]["__top_secret_int"]

# 使用API代理服务提高访问稳定性
result = foo.invoke(
    {"x": 5},
    {"configurable": {"__top_secret_int": 2, "traced_key": "bar"}}
)
print(result)  # 输出: 7