[轻松掌握自定义回调事件：使用LangChain实现高效监控]-CSDN博客

本文链接：https://blog.csdn.net/rtykjhg/article/details/144460376

引言

在开发长时间运行的工具或应用程序时，实时监控其执行进度是非常重要的。通过自定义回调事件，我们可以在多步骤过程中发送事件，提供进度更新，不仅能帮助开发者调试，还可以向最终用户展示任务的执行状态。在这篇文章中，我们将探讨如何在LangChain中调度自定义回调事件。

主要内容

1. 自定义事件的基本概念

在LangChain中，自定义事件需要具备两个关键属性：name 和 data。

name: 事件名称，由用户定义。
data: 事件关联的数据，建议使用JSON可序列化的数据结构。

2. LangChain的兼容性要求

若要在LangChain中使用自定义事件，确保您的版本是langchain-core>=0.2.15。此外，自定义事件只能从现有的Runnable中调度。

对于使用异步代码的开发者，如果您在Python 3.10及以下版本中工作，需要手动传播RunnableConfig对象。Python 3.11及以上版本将自动传播，但建议始终手动处理以确保兼容性。

3. 使用Astream Events API

通过Astream Events API可以高效地消费自定义事件。需要使用新版本v2 API来查看自定义事件。

代码示例

以下是一个如何在异步环境中调度和消费自定义事件的完整示例：

# 使用API代理服务提高访问稳定性
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) -> str:
    await adispatch_custom_event("event1", {"x": x})
    await adispatch_custom_event("event2", 5)
    return x

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