agno v2.2.10 最新更新发布：Workflow运行上下文与事件流优化详解

在 2025 年 11 月 8 日，agno 发布了最新版本 v2.2.10。本次更新主要围绕 Workflows 的运行上下文管理、事件流处理以及 AgentOS 的稳定性优化进行了改进，同时对一些旧的参数进行了调整与弃用规划，并修复了多个已知问题。以下是版本更新的详细说明。

改进内容

1. 1. Workflow运行上下文（run_context）改进
   • • 新增并推荐使用 run_context 参数来读取和修改 Workflows 中的状态数据。
   • • 适用范围包括：Agents、Teams、tools、steps 以及在 steps 使用的自定义 Python 函数。
   • • 官方文档已提供 Workflow 状态的详细说明，建议开发者全面迁移至新的 run_context 方式，以替代旧的处理模式。
2. 2. 自定义执行器（custom executors）事件流增强
   • • 对 Workflows 中自定义 executor 步骤的 Agent/Team 事件处理方式进行了多项优化。
   • • 事件流在执行器中传递的稳定性和后续处理能力得到提升，从而减少事件丢失或延迟的情况。
3. 3. 新增 yield_run_output 参数
   • • 在 Agent/Team 的 run/arun 方法中新增了 yield_run_output 参数，建议开发者使用该参数替代 yield_run_response。
   • • 旧参数 yield_run_response 已进入弃用计划，后续版本中可能会移除。

修复内容

1. 1. AgentOS Resync /docs问题修复
   • • 修复了在 AgentOS resync 过程中 /docs 接口被意外移除的问题，确保文档接口在同步流程中保持可用。
2. 2. 路由重复问题修复
   • • 移除了 home 路由在初始化过程中的重复添加问题，避免了路由冲突和冗余。
3. 3. Workflow事件流相关问题修复
   • • 修复了 Workflow 步骤事件流处理不稳定的问题。
   • • 针对自定义执行器事件的 upsert 操作进行了问题修复，提高事件监听与处理的准确性。
   • • 解决了 run_context 参数在特定场景下的使用故障。

总结

agno v2.2.10 在 Workflows 系统中引入了更标准化和推荐的状态数据处理方式，同时显著强化了事件流在复杂执行环境下的稳定性。本次更新还带来了更明确的参数规划，开发者在迁移和升级项目时需要留意 yield_run_output 与被弃用的 yield_run_response 的变化。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。