2026 年 7 月 12 日agno 发布了v2.7.2 Latest。从本次更新内容来看v2.7.2 并不是一次单纯的小修小补而是围绕AgentOS MCP 能力、AG-UI 前端工具支持、连接体验优化、A2A 范围映射调整、远程运行媒体序列化、安全修复、工具注入修复以及 Google Calendar 时间处理一致性做了一次非常完整的更新。如果要用一句话概括这个版本那么可以说agno v2.7.2 在“可接入性、可用性、稳定性、安全性、一致性”这五个方向同时推进。一、版本信息概览版本号v2.7.2发布时间2026 年 7 月 12 日版本定位Latest本次更新主要分为三部分New FeaturesImprovementsBug Fixes此外在 “What’s Changed” 中还列出了本次版本的具体变更项包括功能新增、修复、重构以及版本发布相关内容。二、New Features新功能更新详解这次 v2.7.2 的新功能部分共有 3 项分别是AgentOS MCP Endpoint 支持 OAuthAG-UI Client Toolsagno connect 增强这三项更新分别对应后端接入能力、前端工具能力以及连接体验能力覆盖面非常广。1. OAuth on the AgentOS MCP Endpoint更新内容在 AgentOS MCP endpoint 上新增了OAuth 支持使用方式为AgentOS(mcp_auth...)同时说明中提到可参考 cookbook。这项更新的核心意义这一更新的重点很明确AgentOS 的 MCP endpoint 现在可以通过 OAuth 机制进行接入和认证。在以往很多系统集成场景中认证方式是否标准化往往直接决定了系统能否更顺畅地接入已有平台能力。OAuth 的加入使 AgentOS MCP endpoint 在身份认证与授权层面具备了更成熟的接入方式。从版本说明来看这次不是简单加一个参数而是明确给出了AgentOS MCP endpointOAuth supportAgentOS(mcp_auth…)这意味着MCP endpoint 的认证能力得到了扩展认证配置方式被显式纳入 AgentOS 初始化或配置使用方式中文档侧也同步补充了 cookbook用于帮助用户理解和落地对开发者意味着什么对于开发者而言这一变化意味着在基于 AgentOS 的 MCP endpoint 进行集成时可以使用 OAuth 这一标准方式来完成认证授权流程从而让接入模式更清晰、配置更统一。虽然更新日志中没有展开更多实现细节但仅从发布说明来看已经足以确认一点agno v2.7.2 正在进一步增强 AgentOS 在 MCP 接入层面的标准化能力。2. AG-UI Client Tools更新内容新增了client_tools support for AG-UI frontend tools。这项更新的重点这次更新新增的是AG-UI 前端工具的 client_tools 支持。从字面可以直接理解为AG-UI frontend tools 现在具备了 client_tools 的支持能力。这一变更非常值得关注因为它直接作用在 AG-UI 的前端工具层面。为什么这很重要在一个完整的 AI 应用体系中前端工具能力常常决定了交互层的扩展空间。AG-UI 增加 client_tools 支持后意味着前端工具的组织与调用方式得到了增强。从版本说明本身出发可以明确看到这次更新的关键词是AG-UIfrontend toolsclient_tools support这说明 agno 在工具能力建设上不仅关注后端 agent 或 endpoint也在继续补足前端工具协同能力。实际价值总结这类更新的价值主要体现在两点前端工具能力更完整客户端工具支持被正式纳入 AG-UI 工具体系即便日志没有展开使用示例仅从官方的变更描述也可以判断agno v2.7.2 让 AG-UI 在工具支持上更进一步前端侧的工具协同能力得到补足。3. agno connect Enhancements更新内容agno connect增强具体包括Multi-target selectdisconnectrestart hintsidentity-named entries这项更新包含了什么这是本次版本中非常偏使用体验的一组增强项全部集中在agno connect。具体拆开来看1Multi-target select支持多目标选择。这意味着在 connect 场景下目标选择能力增强不再局限于单一目标模式。对于需要处理多个连接对象的场景这是一项非常直接的体验升级。2disconnect新增或增强了断开连接相关能力。连接不仅要建立也要可控地断开。disconnect 能力的加入或强化说明agno connect在连接生命周期管理方面更加完整。3restart hints加入了重启提示。重启提示看似是一个小功能但在实际使用中很关键。很多连接问题并不是逻辑错误而是状态、环境或配置变更后的重新启动需求。加入 restart hints 后用户在出现相关情况时将得到更明确的提示信息。4identity-named entries支持基于 identity 命名的条目。这一项提升的是条目展示或管理层面的识别性。相比纯粹的默认项或匿名项identity-named entries 会让连接对象在显示、选择和辨识时更加直观。这一组增强的总体价值agno connect这次更新没有停留在单点功能添加而是从多个角度改善了连接体验选择能力更强断开能力更完整操作提示更明确条目标识更清晰所以这部分更新可以归纳为一句话agno v2.7.2 把 connect 的连接体验做得更可选、更可控、更可理解。三、Improvements改进项详解本次改进部分主要有一项但它的重要性并不低A2A Scope Mappings更新内容Moved A2A scope mappings to the interfacefixed custom prefix support这意味着什么这项改进实际上包含两个层面A2A scope mappings 被移动到 interfacecustom prefix support 得到修复也就是说这既是一次结构层面的调整也是一次兼容性与可用性层面的修正。1. A2A scope mappings moved to the interface将 A2A scope mappings 移动到 interface说明这部分映射关系的归属位置发生了变化。从更新描述来看可以确认的是A2A scope mappings 不再停留在原有位置它现在被放置到了 interface 层这种调整通常意味着接口层的职责更加明确。即使日志没有展开设计背景仅从结果看也能得出一个很清晰的判断A2A scope mappings 的管理位置更统一了。这类改动的价值在于scope mapping 作为接口相关能力的一部分被移到 interface 后其组织方式和使用边界会更清晰。2. fixed custom prefix support除了位置迁移这次还修复了custom prefix support。也就是说A2A 相关范围映射在处理自定义前缀时之前存在问题而 v2.7.2 对其进行了修复。这项修复非常关键因为一旦涉及 custom prefix通常说明用户存在自定义命名、自定义协议前缀或扩展方式的需求。现在官方明确写出“fixed custom prefix support”代表这类场景已被纳入修复范围。改进总结这一条改进虽然只有一句但信息密度很高实际完成了两件事映射关系归位到 interface自定义前缀支持问题修复因此可以把这项改进总结为agno v2.7.2 进一步理顺了 A2A scope mappings 的接口归属同时补上了 custom prefix support 的问题。四、Bug Fixes缺陷修复详解本次缺陷修复共有 4 项分别覆盖远程运行、文件系统知识库、安全性、工具方法注入以及 Google Calendar 工具的时间处理。1. Remote RunsMedia更新内容Serialize media for remote agent and team runs问题点在哪里这个修复聚焦的是远程运行时的媒体序列化问题具体对象包括remote agent runsteam runs也就是说在远程 agent 运行以及 team 运行场景下媒体数据的序列化处理被修复了。为什么这个修复重要只要涉及远程运行数据在传输链路中的表达形式就非常关键。日志中直接指出了“Serialize media”说明此前媒体在远程运行场景中的序列化处理存在问题而 v2.7.2 已完成修复。这个修复意味着远程 agent 运行中的媒体处理更完整team runs 场景中的媒体传递更可靠媒体数据在远程执行链路中的表现更加一致总结agno v2.7.2 修复了远程运行中的媒体序列化问题提升了 remote agent 和 team runs 的稳定性。2. FileSystemKnowledgeSecurity更新内容Prevent path traversal in FileSystemKnowledge.get_file这是一次明确的安全修复这一项是本次版本中非常关键的安全修复。问题点集中在FileSystemKnowledge.get_filepath traversal也就是说官方修复的是FileSystemKnowledge.get_file中可能存在的路径遍历问题。为什么必须重视路径遍历属于典型的安全风险类型。此次更新明确指出“Prevent path traversal”说明 v2.7.2 已经加入防护避免在get_file中发生路径遍历问题。从发布内容可以非常直接地得出以下结论FileSystemKnowledge 的文件获取逻辑得到了安全强化get_file 的边界控制更严格文件访问行为的安全性提升了这项修复的价值对于任何涉及文件路径读取的能力来说路径遍历防护都是底线能力之一。这次修复虽然在日志中只占一行但重要性非常高因为它关系到文件访问安全。所以这项修复可以概括为agno v2.7.2 对 FileSystemKnowledge.get_file 增加了路径遍历防护安全性得到实质性提升。3. tool Methods更新内容Toolkit methods decorated with tool now receive injected run_context, agent, and team parameters修复前后的变化本次修复针对的是使用 tool 装饰的 Toolkit methods。修复后的结果是这些方法现在可以收到注入的参数包括run_contextagentteam这一修复的关键点日志中用了 “now receive injected” 这样的表述说明此前这部分注入存在缺失或行为不符合预期而 v2.7.2 已经修复。这意味着tool装饰的 Toolkit 方法现在能获得运行上下文也能获得 agent 参数同时还能获得 team 参数为什么这个修复重要对工具方法来说能否获得上下文和运行主体信息往往会直接影响工具行为是否完整。现在run_context、agent、team都可以被注入说明工具执行时的上下文能力更完整了。从开发视角看这项修复是非常实用的因为它让tool修饰的方法能正确获得预期注入参数。总结agno v2.7.2 修复了 tool 装饰 Toolkit 方法的参数注入问题run_context、agent、team 现在都能正确注入。4. Google Calendar Tools更新内容Timezone-aware start_date/end_date are now honored across list_events, create_event, and update_event同时在 What’s Changed 中还提到fix: normalize calendar list event start dates这项修复具体修了什么这次修复聚焦于Google Calendar Tools的时间处理一致性问题。官方描述非常明确带时区信息的start_date带时区信息的end_date现在会在以下方法中被正确 honoredlist_eventscreate_eventupdate_event此外还修复了calendar list event start dates 的 normalize 问题为什么它很重要时间处理问题往往是工具集成中最容易出现偏差的部分之一尤其当时间带有时区信息时。如果list_events、create_event、update_event三者对时间参数的处理不一致就可能出现查询和创建结果不一致更新时间和预期不一致列表展示与输入时间存在偏差这次更新明确说明timezone-aware start_date/end_date现在会在三类核心操作中被统一尊重和处理。这说明 v2.7.2 在 Calendar 工具上完成了时间处理的一致性修复。修复价值总结这项修复的价值主要体现在两个方面时区感知时间参数得到正确处理列表、创建、更新三种操作保持一致可以概括为agno v2.7.2 统一修复了 Google Calendar Tools 的时区时间处理问题并规范了 list event 的 start date。五、What’s Changed逐条变更清单梳理除了按模块分类的说明外版本日志还列出了更细的变更项。下面逐条进行整理说明不遗漏任何一项内容。1. 重构A2A scope mappings 移动到 interface并修复 custom prefix support这项内容与前文 Improvements 中的描述一致核心是将A2A scope mappings移动到interface修复custom prefix support它既是一次结构层重构也是一次实际问题修复。2. cookbook更新 MiniMax M3 cookbook metadata日志中明确提到update MiniMax M3 cookbook metadata这一项属于 cookbook 元数据更新。从提供的信息来看能够确认的是MiniMax M3 的 cookbook metadata 已被更新。由于用户要求不要新增内容因此这里只依据日志本身进行说明不扩展额外背景。3. 新功能AG-UI frontend tools 增加 client_tools support这项内容与 New Features 中一致说明AG-UI frontend tools 新增了client_tools support这是本次版本中前端工具能力的重要新增。4. 修复为 remote agent 和 team runs 序列化 media这项内容与 Bug Fixes 中一致说明修复了remote agent and team runs中的media serialization强调的是远程运行场景中的媒体处理问题已被解决。5. 修复防止 FileSystemKnowledge.get_file 中的路径遍历这项内容与 FileSystemKnowledge 安全修复一致prevent path traversal位置在FileSystemKnowledge.get_file这是本次版本最关键的安全修复之一。6. 新功能agno connect 支持多目标选择、断开连接、重启提示、identity 命名条目这项内容与 connect 增强一致完整包括multi-target selectdisconnectrestart hintsidentity-named entries说明 connect 的整体使用体验得到了多维增强。7. 新功能AgentOS MCP endpoint 支持 OAuth使用 AgentOS(mcp_auth…)这项内容与新功能部分一致AgentOS MCP endpoint 新增OAuth support使用方式为AgentOS(mcp_auth…)同时日志中提到可查看 cookbook。8. 新功能AgentOS 将 enable_mcp_server 重命名为 mcp_server并合并 mcp_config这一项在前面的概览里没有单独展开但它在 What’s Changed 中明确存在因此不能遗漏。更新内容rename AgentOS enable_mcp_server to mcp_serverfold in mcp_config这项变更说明了什么说明 AgentOS 在 MCP 相关配置上进行了命名与结构调整enable_mcp_server被重命名为mcp_servermcp_config被合并进去从日志表述来看这不仅是字段命名变化也体现出 MCP 配置方式被进一步收拢和整合。总结agno v2.7.2 对 AgentOS 的 MCP 配置项进行了重命名与合并使配置表达更加集中。9. 修复向 tool 装饰的 Toolkit methods 注入 run_context这项内容在 Bug Fixes 中已经展开但在 What’s Changed 里写得更直接inject run_context into tool-decorated Toolkit methods结合前文可知最终实际可注入的参数包括run_contextagentteam10. 修复规范 calendar list event start dates这项内容与 Google Calendar Tools 修复相互呼应normalize calendar list event start dates它表明 Calendar 相关时间处理修复不仅体现在 create 和 update也落实到了 list event 的起始时间规范化上。11. choreRelease v2.7.2最后一项是版本发布相关记录Release v2.7.2这表明本次变更最终汇总并形成了 v2.7.2 正式发布版本。六、agno v2.7.2 的更新价值总结综合本次所有内容agno v2.7.2 的价值可以归纳为以下几个方面。1. 接入能力增强最典型的代表就是AgentOS MCP endpoint 支持 OAuthAgentOS 的 MCP 配置项进行了重命名与整合这表明 agno 正在持续增强 MCP 相关接入能力并且让配置方式更明确。2. 前端工具能力增强这次新增的AG-UI client_tools support说明 AG-UI frontend tools 的能力进一步补齐。这对于前端工具层的扩展来说是一个明确的增强信号。3. 连接体验增强agno connect的多项增强非常集中也非常实用多目标选择断开连接重启提示identity 命名条目这些更新没有改变 connect 的定位但显著提升了可用性与可操作性。4. 接口与映射关系更清晰A2A scope mappings 的调整说明接口层职责更明确映射移动到 interface修复 custom prefix support这是结构整理与使用修正同步推进的典型例子。5. 远程运行更稳定远程运行中的 media serialization 修复说明 agno 对 remote agent 和 team runs 的运行链路进行了稳定性补强。6. 安全性进一步加强本次最关键的安全修复就是Prevent path traversal in FileSystemKnowledge.get_file这意味着文件访问边界控制得到了增强FileSystemKnowledge 的安全性进一步提升。7. 工具注入能力更完整tool装饰的 Toolkit methods 现在能收到run_contextagentteam这让工具方法在运行时拥有更完整的上下文与主体信息。8. 时间处理一致性更好Google Calendar Tools 对时区感知时间参数的统一支持以及 list event start dates 的规范化解决的是典型但高频的时间一致性问题。七、完整更新清单汇总为了便于收藏和快速查阅下面给出一份不遗漏的完整清单。新功能AgentOS MCP endpoint 新增 OAuth 支持可通过AgentOS(mcp_auth...)使用详见 cookbookAG-UI frontend tools 新增client_tools支持agno connect增强支持multi-target selectdisconnectrestart hintsidentity-named entries改进A2A scope mappings 移动到 interface修复 custom prefix support修复为 remote agent 和 team runs 序列化 media防止FileSystemKnowledge.get_file中的 path traversaltool装饰的 Toolkit methods 现在可接收注入的run_context、agent和teamGoogle Calendar Tools 中带时区信息的start_date和end_date现在会在以下操作中被正确处理list_eventscreate_eventupdate_event规范 calendar list event start dates其他变更更新 MiniMax M3 cookbook metadata将 AgentOS 的enable_mcp_server重命名为mcp_server合并mcp_configRelease v2.7.2八、结语代码地址github.com/agno-agi/agno总的来看agno v2.7.2是一个覆盖面非常完整的版本更新。它一方面带来了值得关注的新功能AgentOS MCP endpoint 的 OAuth 支持AG-UI 的 client_tools 支持agno connect 的多维增强另一方面也在基础能力上做了扎实完善A2A scope mappings 调整到 interfacecustom prefix support 修复remote runs 媒体序列化修复FileSystemKnowledge 路径遍历安全修复tool方法注入修复Google Calendar Tools 时区时间处理一致性修复再加上MiniMax M3 cookbook metadata 更新MCP 配置项命名与结构整合Release v2.7.2可以说这次更新虽然版本号是 v2.7.2但其涉及的模块并不单一几乎横跨了接入、前端、连接、接口、远程运行、安全、工具注入、时间处理和版本整理等多个方向。