agno v2.4.7发布！新增Else条件分支、AWS Bedrock重排器、HITL等重大升级全解析

2026年1月28日，Agno v2.4.7正式发布！这一版本是Agno在多智能体系统和AI工作流领域的又一次重要更新，不仅带来了多项全新特性，也在稳定性与兼容性上进行了深度优化。本文为你详解v2.4.7版本的所有更新亮点与核心改进。

新特性 (New Features) 1.Workflow Condition Step 全新支持 Else 分支

工作流条件步骤（Workflow Condition Step）新增了Else path支持，允许用户定义备用执行路径（else_steps）。
以前，当条件不满足时系统会跳过执行；现在，用户可以在条件为False时指定另一条执行路径，实现更灵活的业务流程控制。

典型场景：

• • 技术支持系统的多分支路由：

• • • 技术类问题 → 诊断 + 工程处理

  • • 非技术性咨询 → 一般客服处理

  • • 统一进入后续总结步骤

示例代码中，Condition对象新增了else_steps参数，可同步与异步执行。
官方示例脚本：

• •condition_with_else_steps.py（同步与异步版本）
  展示了完整的if-else工作流结构及执行逻辑。

新增AwsBedrockReranker 类，支持：

• • Cohere Rerank 3.5

• • Amazon Rerank 1.0

该功能基于Bedrock Agent Runtime API的统一接口，让开发者可直接利用亚马逊云上的大模型能力实现高精度文档重排（Reranking）。

支持的模型：

• •cohere.rerank-v3-5:0

• •amazon.rerank-v1:0

主要优势：

• • 支持统一Bedrock API调用

• • 支持top_n自定义返回数量

• • 兼容Knowledge与PgVector向量数据库

额外支持：

• •CohereBedrockReranker及AmazonReranker便捷类

• • 自定义additional_model_request_fields选项

AWS Bedrock 向量嵌入器（AwsBedrockEmbedder）现支持Cohere Embed v4 模型，可自定义输出维度（256、512、1024、1536）并支持多模态特性（文本 + 图片）。
示例脚本：aws_bedrock_embedder_v4.py展示了多维度演示及多模态用法。

主要能力：

• • 自定义输出维度以平衡性能与精度

• • 支持图片与文本联合嵌入

• • 多语言、检索场景全面增强

在多智能体协作中，现在可以为指定工具启用人工确认步骤。
新增参数：

• •requires_confirmation_tools：需用户确认的工具

• •external_execution_required_tools：外部执行要求工具

• •stop_after_tool_call_tools：执行后停止的工具

• •show_result_tools：自动展示结果的工具

配合新示例脚本confirmation_required_mcp_toolkit.py，可实现：

• • 敏感操作执行前人工确认

• • API调用前审核

• • 数据变更确认、关键操作审批

HITL机制让自动化系统更加安全、可靠。

修复 (Bug Fixes) 1.LanceDB

• • 替换废弃方法table_names()为list_tables()。
  该更新确保与最新的 LanceDB API 兼容。

• • 修复重复的表注册问题。
  通过extend_existing=True，避免多次操作导致的重复注册错误。

ConditionExecutionCompletedEvent新增字段branch，用于标识运行分支（if/else）。

- 机器学习异步召回修复

修复arecall异步调用时的结果记录问题，确保多存储源结果正确合并。

- 版本依赖更新

• • LanceDB 依赖更新为lancedb>=0.26.0，提升兼容性与性能。

新增大量集成与单元测试，包括但不限于：

• •AWS Bedrock Embedder 测试：验证 v3 与 v4 模型、异步/同步接口、维度配置、多模态特性

• •AWS Bedrock Reranker 测试：覆盖 Amazon 与 Cohere 模型、多区域容错、特征排序准确性

• •Workflow Else 分支测试：验证if/else执行逻辑、流式事件、阻断传播等

• •MCP HITL参数测试：验证确认机制及参数正确传递
  确保2.4.7整体功能的稳定与正确性。

• •版本号：2.4.7

• •发布日期：2026年1月28日

• •主要文件数量变更：22个文件，共新增约2313行代码

• •项目名称：Agno

• •语言环境：Python 3.7+

• •核心功能模块：Agent、多步骤工作流、知识检索、AWS Bedrock整合、MCP工具增强

代码地址：github.com/agno-agi/agno

Agno v2.4.7 是一次功能与稳定性并重的版本升级。
无论是工作流逻辑的细化，还是AWS生态的深度整合，甚至在人机协同（HITL）场景中的友好性提升，此版本都让开发者在多智能体系统构建中具备更高自由度与可靠性。

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