轻松掌控：如何在运行时传递机密参数给Runnables-CSDN博客

本文链接：https://blog.csdn.net/ahdfwcevnhrtds/article/details/142698595

在现代应用开发中，管理机密信息的安全性至关重要。本文将深入探讨如何在LangChain中使用RunnableConfig来安全地传递运行时机密参数。这不仅保障了信息安全，也让开发者能更灵活地调用API。

引言

在LangChain中，RunnableConfig允许开发者在运行时动态传递机密参数。通过使用特定前缀，我们可以确保这些机密信息不会被追踪到。这篇文章将详细介绍这个过程的实现方法，并提供代码示例帮助你更好地理解和应用。

主要内容

1. 理解`RunnableConfig`

RunnableConfig是一个配置对象，可以在运行时传递给函数。它允许我们灵活地传递和管理配置参数，尤其是机密信息。

2. 为什么使用`__prefix`？

通过在参数名前添加__前缀，我们确保这些机密信息不会被LangChain的追踪系统记录下来。这是保护敏感数据的一种有效方法。

3. 实际应用场景

很多应用需要调用外部API，这些API通常需要密钥或其他机密信息。通过RunnableConfig，我们可以在保持代码简洁的同时保证数据的安全性。

代码示例

下面是一个使用RunnableConfig传递机密参数的完整示例：

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"]

# 调用工具函数，传递机密参数
result = foo.invoke(
    {"x": 5}, 
    {"configurable": {"__top_secret_int": 2, "traced_key": "bar"}}
)

print(result)  # 输出 7