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