轻松掌握：如何在LangChain中分派自定义回调事件

最新推荐文章于 2024-11-05 15:28:12 发布

bhawfgrcbtwny

最新推荐文章于 2024-11-05 15:28:12 发布

阅读量279

点赞数 5

文章标签： langchain python 服务器

本文链接：https://blog.csdn.net/bhawfgrcbtwny/article/details/142536665

版权

## 引言

在现代应用开发中，回调事件是实现异步操作和事件驱动编程的关键工具。在使用LangChain时，你可能需要在运行过程中发出自定义回调事件，以便更好地监控任务进度或与用户交互。这篇文章将深入探讨如何在LangChain中分派自定义回调事件，并提供详细的代码示例和解决常见问题的方法。

## 主要内容

### 1. 什么是自定义回调事件？

自定义回调事件是开发者定义的特定事件，通常用于在应用中传递信息或触发特定操作。在LangChain中，自定义回调事件可以通过`Runnable`在异步和同步环境中发出。

### 2. 分派自定义事件的基本步骤

- **定义事件名称和数据**：你需要为每个事件指定一个名称（`name`）和相关数据（`data`），数据建议使用JSON序列化。
- **运行环境要求**：需要LangChain `langchain-core>=0.2.15`，并且只能从现有的`Runnable`中分派。
- **API版本要求**：使用`astream_events`时，需要选择`version='v2'`来查看自定义事件。

### 3. 兼容性注意事项

- **Python版本**：在Python <= 3.10中，必须手动传递`RunnableConfig`对象；在Python >= 3.11中则自动传递，但建议手动以防兼容性问题。

## 代码示例

以下是如何在异步环境中分派自定义事件的代码示例：

```python
from langchain_core.callbacks.manager import adispatch_custom_event
from langchain_core.runnables import RunnableLambda
from langchain_core.runnables.config import RunnableConfig

@RunnableLambda
async def foo(x: str, config: RunnableConfig) -> str:
    await adispatch_custom_event("event1", {"x": x}, config=config)  # 使用API代理服务提高访问稳定性
    await adispatch_custom_event("event2", 5, config=config)
    return x

async for event in foo.astream_events("hello world", version="v2"):
    print(event)