agno 在 2025 年 12 月 20 日正式發(fā)布 v2.3.18 版本。本次更新提交數(shù)量雖不多，但涵蓋了對 Google Vertex AI 使用方式的重要改進(jìn)，以及對 AgentOS 中數(shù)據(jù)庫遷移路由的一項(xiàng)關(guān)鍵缺陷修復(fù)，整體提升了在生產(chǎn)環(huán)境和系統(tǒng)重同步場景下的穩(wěn)定性與可配置性。

一、版本基本信息

版本號(hào)：v2.3.18
發(fā)布日期：2025 年 12 月 20 日
本次發(fā)布共包含 3 個(gè)提交，涉及 6 個(gè)文件變更，新增代碼約 730 行，主要集中在模型能力擴(kuò)展、系統(tǒng)路由修復(fù)和測試補(bǔ)充三個(gè)方面。

二、主要改進(jìn)內(nèi)容

1. 1. Google Vertex AI 新增顯式憑證文件支持

在 v2.3.18 中，agno 的 Gemini 模型對 Vertex AI 的認(rèn)證方式進(jìn)行了增強(qiáng)，新增了對 google oauth2 憑證對象的直接支持。這意味著在使用 Vertex AI 模式時(shí)，不再只依賴環(huán)境變量或默認(rèn)憑證，而可以顯式傳入一個(gè)憑證對象，用于精細(xì)化控制生產(chǎn)環(huán)境下的認(rèn)證方式。

核心變化點(diǎn)包括：

• ? Gemini 模型新增 credentials 參數(shù)，用于接收 Google Cloud 的憑證對象

• ? 當(dāng) vertexai 參數(shù)為 True 時(shí)，如果提供了 credentials，將其直接傳入 genai Client

• ? 在非 Vertex AI 模式（即 Google AI Studio 模式）下，即使提供了 credentials，也不會(huì)被傳遞，避免混用認(rèn)證方式

這種設(shè)計(jì)使得模型在不同運(yùn)行環(huán)境下的行為更加明確，特別適合以下場景：

• ? 多項(xiàng)目、多服務(wù)賬號(hào)并存的生產(chǎn)環(huán)境

• ? 容器化或 CI/CD 場景中需要顯式加載服務(wù)賬號(hào) JSON 文件

• ? 不方便或不允許使用全局默認(rèn)憑證的部署環(huán)境

官方示例中通過加載服務(wù)賬號(hào) JSON 文件創(chuàng)建憑證對象，并在初始化 Gemini 模型時(shí)傳入，從而直接完成 Vertex AI 的身份認(rèn)證配置。

1. 2. Gemini 客戶端初始化邏輯完善

在 Gemini 模型的 get_client 方法中，對 Client 初始化參數(shù)進(jìn)行了細(xì)化處理：

• ? Vertex AI 模式下，project 和 location 參數(shù)會(huì)被明確設(shè)置

• ? 如果 credentials 不為空，則加入 Client 初始化參數(shù)

• ? 最終統(tǒng)一過濾掉值為 None 的參數(shù)，保證 Client 初始化參數(shù)干凈且可控

同時(shí)補(bǔ)充了對應(yīng)的單元測試，分別驗(yàn)證了以下情況：

• ? Vertex AI 模式下傳入 credentials 時(shí)，Client 能正確接收

• ? Vertex AI 模式下未傳入 credentials 時(shí)，不會(huì)錯(cuò)誤傳遞該參數(shù)

• ? 非 Vertex AI 模式下，即使傳入 credentials，也不會(huì)傳遞給 Client

這些測試確保了不同模式下 Gemini 客戶端行為的一致性和可預(yù)期性。

三、問題修復(fù)：數(shù)據(jù)庫遷移路由無法重建

本次版本還修復(fù)了一個(gè)在 AgentOS 重同步過程中存在的問題。此前在執(zhí)行 resync 操作時(shí)，數(shù)據(jù)庫遷移路由在某些情況下不會(huì)被正確重新注冊，導(dǎo)致相關(guān)接口缺失。

在 v2.3.18 中：

• ? 重構(gòu)了路由重新注冊列表

• ? 確保數(shù)據(jù)庫路由在重同步時(shí)能夠被正確重新 provision

• ? 避免系統(tǒng)在重載配置或恢復(fù)狀態(tài)后出現(xiàn)數(shù)據(jù)庫相關(guān)功能不可用的問題

這一修復(fù)對依賴 AgentOS 進(jìn)行長期運(yùn)行和熱更新的場景尤為重要。

四、測試與版本號(hào)更新

為了保證上述改動(dòng)的穩(wěn)定性，本次更新新增了：

• ? 針對 Gemini 模型憑證邏輯的單元測試

• ? 針對 AgentOS resync 行為的集成測試

同時(shí)，agno 的項(xiàng)目版本號(hào)在 pyproject.toml 中從 2.3.17 正式更新為 2.3.18，與發(fā)布版本保持一致。

五、小結(jié)

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

agno v2.3.18 是一次以穩(wěn)定性和生產(chǎn)可用性為核心的版本更新：

• ? 在模型層面，為 Vertex AI 提供了更靈活、安全的認(rèn)證方式

• ? 在系統(tǒng)層面，修復(fù)了數(shù)據(jù)庫路由在重同步時(shí)的關(guān)鍵缺陷

• ? 在工程層面，通過新增測試確保行為的一致性

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