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

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）场景中的友好性提升，此版本都让开发者在多智能体系统构建中具备更高自由度与可靠性。