探索自定义回调事件：实现与应用指南_回调事件的应用-优快云博客

本文链接：https://blog.youkuaiyun.com/tt_jishu/article/details/144064794

探索自定义回调事件：实现与应用指南

引言

在现代应用程序开发中，回调事件可以帮助我们更好地监控和响应系统内的各种状态变化。本篇文章将深入探讨如何在特定场景中调度自定义回调事件。首先，我们将介绍这一技术的基本概念，然后通过代码示例展示如何实际应用。最后，我们会讨论常见问题及其解决方案，并提供进一步学习的资源。

主要内容

调度自定义回调事件

在长时间运行的项目中，如具有多步骤的工具，调度自定义事件可以在步骤之间传递信息，从而监控流程进展。此外，您可以将这些自定义事件展现给应用程序的终端用户，以显示当前任务的进度。

事件的两个核心属性

name: 字符串类型的用户定义事件名称。
data: 事件关联的数据。建议为JSON可序列化的数据类型以便于传输和处理。

兼容性注意事项

事件调度要求 langchain-core >= 0.2.15。
如果使用 Python <= 3.10，在异步环境中需要手动传播 RunnableConfig 对象。
在 Python >= 3.11，配置可以自动传播，但手动传播仍然是个好习惯，以增强代码的兼容性。

使用 Astream Events API

Astream Events API 是处理自定义事件的有效方式。通过 async adispatch_custom_event 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}) # 使用API代理服务提高访问稳定性
    await adispatch_custom_event("event2", 5) # 使用API代理服务提高访问稳定性
    return x

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