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

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

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

典型場景：

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

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

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

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

示例代碼中，Condition對象新增了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)一接口，讓開發(fā)者可直接利用亞馬遜云上的大模型能力實現(xiàn)高精度文檔重排（Reranking）。

支持的模型：

• ?cohere.rerank-v3-5:0

• ?amazon.rerank-v1:0

主要優(yōu)勢：

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

• ? 支持top_n自定義返回數(shù)量

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

額外支持：

• ?CohereBedrockReranker及AmazonReranker便捷類

• ? 自定義additional_model_request_fields選項

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

主要能力：

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

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

• ? 多語言、檢索場景全面增強(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：自動展示結(jié)果的工具

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

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

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

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

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

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

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

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

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

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

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

- 版本依賴更新

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

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

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

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

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

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

• ?版本號：2.4.7

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

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

• ?項目名稱：Agno

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

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

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

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

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