引言
在开发长时间运行的工具或应用程序时,实时监控其执行进度是非常重要的。通过自定义回调事件,我们可以在多步骤过程中发送事件,提供进度更新,不仅能帮助开发者调试,还可以向最终用户展示任务的执行状态。在这篇文章中,我们将探讨如何在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来查看自定义事件。
代码示例
以下是一个如何在异步环境中调度和消费自定义事件的完整示例: