agno v2.4.7發(fā)布！新增Else條件分支、AWS Bedrock重排器、HITL等重大升級(jí)全解析

2026年1月28日，Agno v2.4.7正式發(fā)布！這一版本是Agno在多智能體系統(tǒng)和AI工作流領(lǐng)域的又一次重要更新，不僅帶來(lái)了多項(xiàng)全新特性，也在穩(wěn)定性與兼容性上進(jìn)行了深度優(yōu)化。本文為你詳解v2.4.7版本的所有更新亮點(diǎn)與核心改進(jìn)。

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

工作流條件步驟（Workflow Condition Step）新增了Else path支持，允許用戶定義備用執(zhí)行路徑（else_steps）。
以前，當(dāng)條件不滿足時(shí)系統(tǒng)會(huì)跳過(guò)執(zhí)行；現(xiàn)在，用戶可以在條件為False時(shí)指定另一條執(zhí)行路徑，實(shí)現(xiàn)更靈活的業(yè)務(wù)流程控制。

典型場(chǎng)景：

• ? 技術(shù)支持系統(tǒng)的多分支路由：

• • ? 技術(shù)類問(wèn)題 → 診斷 + 工程處理

  • ? 非技術(shù)性咨詢 → 一般客服處理

  • ? 統(tǒng)一進(jìn)入后續(xù)總結(jié)步驟

示例代碼中，Condition對(duì)象新增了else_steps參數(shù)，可同步與異步執(zhí)行。
官方示例腳本：

• ?condition_with_else_steps.py（同步與異步版本）
  展示了完整的if-else工作流結(jié)構(gòu)及執(zhí)行邏輯。

新增AwsBedrockReranker 類，支持：

• ? Cohere Rerank 3.5

• ? Amazon Rerank 1.0

該功能基于Bedrock Agent Runtime API的統(tǒng)一接口，讓開(kāi)發(fā)者可直接利用亞馬遜云上的大模型能力實(shí)現(xiàn)高精度文檔重排（Reranking）。

支持的模型：

• ?cohere.rerank-v3-5:0

• ?amazon.rerank-v1:0

主要優(yōu)勢(shì)：

• ? 支持統(tǒng)一Bedrock API調(diào)用

• ? 支持top_n自定義返回?cái)?shù)量

• ? 兼容Knowledge與PgVector向量數(shù)據(jù)庫(kù)

額外支持：

• ?CohereBedrockReranker及AmazonReranker便捷類

• ? 自定義additional_model_request_fields選項(xiàng)

AWS Bedrock 向量嵌入器（AwsBedrockEmbedder）現(xiàn)支持Cohere Embed v4 模型，可自定義輸出維度（256、512、1024、1536）并支持多模態(tài)特性（文本 + 圖片）。
示例腳本：aws_bedrock_embedder_v4.py展示了多維度演示及多模態(tài)用法。

主要能力：

• ? 自定義輸出維度以平衡性能與精度

• ? 支持圖片與文本聯(lián)合嵌入

• ? 多語(yǔ)言、檢索場(chǎng)景全面增強(qiáng)

在多智能體協(xié)作中，現(xiàn)在可以為指定工具啟用人工確認(rèn)步驟。
新增參數(shù)：

• ?requires_confirmation_tools：需用戶確認(rèn)的工具

• ?external_execution_required_tools：外部執(zhí)行要求工具

• ?stop_after_tool_call_tools：執(zhí)行后停止的工具

• ?show_result_tools：自動(dòng)展示結(jié)果的工具

配合新示例腳本confirmation_required_mcp_toolkit.py，可實(shí)現(xiàn)：

• ? 敏感操作執(zhí)行前人工確認(rèn)

• ? API調(diào)用前審核

• ? 數(shù)據(jù)變更確認(rèn)、關(guān)鍵操作審批

HITL機(jī)制讓自動(dòng)化系統(tǒng)更加安全、可靠。

修復(fù) (Bug Fixes) 1.LanceDB

• ? 替換廢棄方法table_names()為list_tables()。
  該更新確保與最新的 LanceDB API 兼容。

• ? 修復(fù)重復(fù)的表注冊(cè)問(wèn)題。
  通過(guò)extend_existing=True，避免多次操作導(dǎo)致的重復(fù)注冊(cè)錯(cuò)誤。

ConditionExecutionCompletedEvent新增字段branch，用于標(biāo)識(shí)運(yùn)行分支（if/else）。

- 機(jī)器學(xué)習(xí)異步召回修復(fù)

修復(fù)arecall異步調(diào)用時(shí)的結(jié)果記錄問(wèn)題，確保多存儲(chǔ)源結(jié)果正確合并。

- 版本依賴更新

• ? LanceDB 依賴更新為lancedb>=0.26.0，提升兼容性與性能。

新增大量集成與單元測(cè)試，包括但不限于：

• ?AWS Bedrock Embedder 測(cè)試：驗(yàn)證 v3 與 v4 模型、異步/同步接口、維度配置、多模態(tài)特性

• ?AWS Bedrock Reranker 測(cè)試：覆蓋 Amazon 與 Cohere 模型、多區(qū)域容錯(cuò)、特征排序準(zhǔn)確性

• ?Workflow Else 分支測(cè)試：驗(yàn)證if/else執(zhí)行邏輯、流式事件、阻斷傳播等

• ?MCP HITL參數(shù)測(cè)試：驗(yàn)證確認(rèn)機(jī)制及參數(shù)正確傳遞
  確保2.4.7整體功能的穩(wěn)定與正確性。

• ?版本號(hào)：2.4.7

• ?發(fā)布日期：2026年1月28日

• ?主要文件數(shù)量變更：22個(gè)文件，共新增約2313行代碼

• ?項(xiàng)目名稱：Agno

• ?語(yǔ)言環(huán)境：Python 3.7+

• ?核心功能模塊：Agent、多步驟工作流、知識(shí)檢索、AWS Bedrock整合、MCP工具增強(qiáng)

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

Agno v2.4.7 是一次功能與穩(wěn)定性并重的版本升級(jí)。
無(wú)論是工作流邏輯的細(xì)化，還是AWS生態(tài)的深度整合，甚至在人機(jī)協(xié)同（HITL）場(chǎng)景中的友好性提升，此版本都讓開(kāi)發(fā)者在多智能體系統(tǒng)構(gòu)建中具備更高自由度與可靠性。

我們相信人工智能為普通人提供了一種“增強(qiáng)工具”，并致力于分享全方位的AI知識(shí)。在這里，您可以找到最新的AI科普文章、工具評(píng)測(cè)、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來(lái)發(fā)展。