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工作流结构及执行逻辑。

2. AwsBedrockReranker 全新上线

新增 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选项

⚙️ 改进 (Improvements)

1. AwsBedrockEmbedder 已全面支持 Cohere v4 Embed

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

主要能力：

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

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

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

2. MCPTools 支持 Human-in-the-Loop (HITL) 用户确认机制

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

•
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 兼容。

2. SingleStore

• 修复重复的表注册问题。
通过 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助力您的未来发展。