## 引言
在使用LangChain创建自定义工具时，可能会遇到这样的问题：如何在工具中访问和配置内部运行参数（`RunnableConfig`），并确保子调用（如聊天模型或检索器调用）能够正确追踪和配置？本篇文章将介绍通过`RunnableConfig`实现这一目的的方法，并结合实例代码帮助你掌握该技巧。
## 主要内容
### 什么是`RunnableConfig`？
`RunnableConfig`是LangChain中的一个核心概念，它允许开发者在运行时配置工具以及子调用的行为，例如记录事件、添加额外的配置参数等。当你的工具调用其它运行单元（如聊天模型或检索器）时，正确传递和使用`RunnableConfig`可以帮助你更好地管理这些子调用的行为。
### 工具调用的核心方法
工具本质上是`Runnable`，你可以像调用其他`Runnable`一样调用它们，支持如下方法：
- `invoke()`: 同步调用
- `batch()`: 批量调用
- `stream()`: 流式调用
此外，LangChain还提供了自动通过类型推断为工具注入`RunnableConfig`的功能。我们将在后文中演示如何利用这一特性。
### 类型推断与自动参数传递
在自定义工具中，只需在工具的签名中添加一个参数，其类型为`RunnableConfig`（参数名称无关紧要），即可实现自动的`RunnableConfig`注入。LangChain会根据这一类型推断并传递当前活动的配置对象。
### 示例代码解析
首先，我们需要安装`langchain_core`库，确保版本在`0.2.16`或更高：
```bash
pip install -qU langchain_core
然后，我们定义一个简单的自定义工具，这个工具接受两个参数：一个字符串参数text和一个RunnableConfig类型的参数special_config_param。
from langchain_core.runnables import RunnableConfig
from langchain_core.tools import tool
@tool
async def reverse_tool(text: str, special_config_param: RunnableConfig) -> str:
"""
一个测试工具：将输入文本与配置参数组合后逆序返回。
"""
return (text + special_config_param["configurable"]["additional_field"])[::-1]
工具调用实例
下面演示如何调用上述工具，并传递一个配置字典：
# 异步调用工具
result = await reverse_tool.ainvoke(
{"text": "abc"}, config={"configurable": {"additional_field": "123"}}
)
print(result) # 输出: '321cba'
在这里，我们通过RunnableConfig对象传递了一个名为additional_field的额外字段，并将其与输入文本abc结合起来，最后逆序返回了结果。
常见问题和解决方案
问题1：什么情况下需要显式传递RunnableConfig？
当你的工具调用其它子Runnable（如聊天模型或检索器）时，如果需要追踪调用事件或传递额外配置，就需要显式传递RunnableConfig。否则，子调用可能无法正确继承配置。
问题2：如何调试配置参数的传递？
可以在工具中打印或记录RunnableConfig的内容。例如：
@tool
async def debug_tool(text: str, config: RunnableConfig) -> str:
print(config)
return text
调用时，观察打印的config对象是否包含预期的字段。
总结和进一步学习资源
通过本文，你已经了解了如何利用LangChain的RunnableConfig在工具中实现动态配置和事件追踪。以下是一些值得深挖的资源和阅读建议：
探索这些内容，你将能进一步提升定制工具的能力。
参考资料
- LangChain 官方文档: API Reference: RunnableConfig
- LangChain 核心库：GitHub - langchain-core
如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！
---END---
