轻松访问RunnableConfig：掌握LangChain工具配置技巧

最新推荐文章于 2025-03-06 10:39:19 发布

sjufgwgfhoia

最新推荐文章于 2025-03-06 10:39:19 发布

阅读量277

点赞数 2

文章标签： langchain git python

本文链接：https://blog.csdn.net/sjufgwgfhoia/article/details/142698711

版权

# 轻松访问RunnableConfig：掌握LangChain工具配置技巧

## 引言

在使用LangChain工具开发中，访问和配置内部事件对于调用聊天模型、检索器等是至关重要的。本文将为您详细介绍如何通过正确传递参数来实现这一点，并展示一些实际的代码示例。

## 主要内容

### 理解RunnableConfig

在LangChain中，工具被视为可运行的实体（runnable），可以通过`invoke()`、`batch()`和`stream()`等方法调用。然而，创建自定义工具时，常常需要调用其他可运行的实体，如聊天模型或检索器。这时，您需要手动访问并传递工具的当前`RunnableConfig`对象，以便正确跟踪和配置这些子调用。

### 兼容性和前提

- 本指南适用于`langchain-core >= 0.2.16`。
- 您需要对LangChain工具、自定义工具、LangChain表达式语言（LCEL）和可运行行为配置有一定的了解。

### 通过参数类型推断

要访问自定义工具的活动配置对象，需要在工具的签名中添加一个类型为`RunnableConfig`的参数。LangChain将在调用工具时检查工具签名，查找类型为`RunnableConfig`的参数，并自动填充。

### 示例代码

以下是一个简单的示例，定义了一个自定义工具`reverse_tool`，它接受两个参数：一个字符串和一个`RunnableConfig`类型的参数。

```python
%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"}}
)
# Output: '321cba'