探索自定义事件分发：提升你的应用监控能力

用户57716616653
58 阅读2分钟

探索自定义事件分发：提升你的应用监控能力

在现代应用程序开发中，监控和跟踪流程的进展是确保系统稳定性和用户体验的关键因素之一。通过分发自定义回调事件，我们可以更有效地监控应用程序步骤之间的进展，并向最终用户展示任务的当前状态。本指南将带你深入了解如何在长链应用中使用自定义事件。

引言

本文旨在帮助你学习如何在异步和同步环境中分发自定义回调事件。我们将探索LangChain的Runnable机制，学习如何通过Astream Events API来捕获和显示这些事件。了解这些技术后，你将能够创建更具响应性的系统，提供实用的用户反馈。

主要内容

1. 理解自定义事件

自定义事件是一种用户定义的事件类型，可以包含任意数据（建议使用JSON格式）。在LangChain中，这些事件可以从已有的Runnable中分发，适用于复杂的流程管理。

2. 异步自定义事件分发

通过async和adispatch_custom_event，你可以在异步环境中分发事件。使用Astream Events API来监听这些事件，并确保使用API的v2版本来支持自定义事件。

from langchain_core.callbacks.manager import (
    adispatch_custom_event,
)
from langchain_core.runnables import RunnableLambda

@RunnableLambda
async def foo(x: str) -> str:
    await adispatch_custom_event("event1", {"x": x})
    await adispatch_custom_event("event2", 5)
    return x

# 使用API代理服务提高访问稳定性
async for event in foo.astream_events("hello world", version="v2"):
    print(event)

3. 同步自定义事件分发

尽管异步处理普及，我们也需要理解如何在同步环境中分发事件。通过dispatch_custom_event，我们可以在传统的同步任务中实现这一点。

from langchain_core.callbacks import BaseCallbackHandler
from langchain_core.callbacks.manager import (
    dispatch_custom_event,
)
from langchain_core.runnables import RunnableLambda

class CustomHandler(BaseCallbackHandler):
    def on_custom_event(self, name: str, data: Any, **kwargs: Any) -> None:
        print(f"Received event {name} with data: {data}")

@RunnableLambda
def foo(x: int) -> int:
    dispatch_custom_event("event1", {"x": x})
    dispatch_custom_event("event2", {"x": x})
    return x

handler = CustomHandler()
foo.invoke(1, {"callbacks": [handler], "tags": ["foo", "bar"]})

常见问题和解决方案

  • 事件未显示: 如果你使用的是Python 3.10或更早版本，需要手动传播RunnableConfig到子runnable。

  • API访问受限: 由于某些地区的网络限制，开发者可能需要考虑使用API代理服务来提高访问的稳定性和速度。

总结和进一步学习资源

通过学习如何分发和处理自定义事件，你为应用程序添加了一个强大的工具，使其能够实时反馈任务进程。要进一步深入学习，考虑查看LangChain的Astream Events API文档和LangChain核心文档。

参考资料

如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！

---END---

avatar
文章
阅读
粉丝