agno v2.7.2发布：OAuth 接入、AG-UI Client Tools 上线、远程运行与文件安全双修复全解析

福大大架构师每日一题

发布于 2026-07-13 16:35:05

190

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

本次更新主要分为三部分：

1. New Features
2. Improvements
3. Bug Fixes

此外，在 “What’s Changed” 中，还列出了本次版本的具体变更项，包括功能新增、修复、重构以及版本发布相关内容。

二、New Features：新功能更新详解

这次 v2.7.2 的新功能部分，共有 3 项，分别是：

1. AgentOS MCP Endpoint 支持 OAuth
2. AG-UI Client Tools
3. agno 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 endpoint
• OAuth support
• AgentOS(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-UI
• frontend tools
• client_tools support

这说明 agno 在工具能力建设上，不仅关注后端 agent 或 endpoint，也在继续补足前端工具协同能力。

实际价值总结

这类更新的价值主要体现在两点：

1. 前端工具能力更完整
2. 客户端工具支持被正式纳入 AG-UI 工具体系

即便日志没有展开使用示例，仅从官方的变更描述也可以判断：

agno v2.7.2 让 AG-UI 在工具支持上更进一步，前端侧的工具协同能力得到补足。

3. agno connect Enhancements

更新内容

agno connect 增强，具体包括：

• Multi-target select
• disconnect
• restart hints
• identity-named entries

这项更新包含了什么

这是本次版本中非常偏使用体验的一组增强项，全部集中在 agno connect。

具体拆开来看：

1）Multi-target select

支持 多目标选择。

这意味着在 connect 场景下，目标选择能力增强，不再局限于单一目标模式。对于需要处理多个连接对象的场景，这是一项非常直接的体验升级。

2）disconnect

新增或增强了 断开连接 相关能力。

连接不仅要建立，也要可控地断开。disconnect 能力的加入或强化，说明 agno connect 在连接生命周期管理方面更加完整。

3）restart hints

加入了 重启提示。

重启提示看似是一个小功能，但在实际使用中很关键。很多连接问题并不是逻辑错误，而是状态、环境或配置变更后的重新启动需求。加入 restart hints 后，用户在出现相关情况时将得到更明确的提示信息。

4）identity-named entries

支持 基于 identity 命名的条目。

这一项提升的是条目展示或管理层面的识别性。相比纯粹的默认项或匿名项，identity-named entries 会让连接对象在显示、选择和辨识时更加直观。

这一组增强的总体价值

agno connect 这次更新没有停留在单点功能添加，而是从多个角度改善了连接体验：

• 选择能力更强
• 断开能力更完整
• 操作提示更明确
• 条目标识更清晰

所以这部分更新可以归纳为一句话：

agno v2.7.2 把 connect 的连接体验做得更可选、更可控、更可理解。

三、Improvements：改进项详解

本次改进部分主要有一项，但它的重要性并不低：

A2A Scope Mappings

更新内容

• Moved A2A scope mappings to the interface
• fixed custom prefix support

这意味着什么

这项改进实际上包含两个层面：

1. A2A scope mappings 被移动到 interface
2. custom 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 Runs（Media）

更新内容

Serialize media for remote agent and team runs

问题点在哪里

这个修复聚焦的是 远程运行时的媒体序列化问题，具体对象包括：

• remote agent runs
• team runs

也就是说，在远程 agent 运行以及 team 运行场景下，媒体数据的序列化处理被修复了。

为什么这个修复重要

只要涉及远程运行，数据在传输链路中的表达形式就非常关键。日志中直接指出了“Serialize media”，说明此前媒体在远程运行场景中的序列化处理存在问题，而 v2.7.2 已完成修复。

这个修复意味着：

• 远程 agent 运行中的媒体处理更完整
• team runs 场景中的媒体传递更可靠
• 媒体数据在远程执行链路中的表现更加一致

总结

agno v2.7.2 修复了远程运行中的媒体序列化问题，提升了 remote agent 和 team runs 的稳定性。

2. FileSystemKnowledge（Security）

更新内容

Prevent path traversal in FileSystemKnowledge.get_file

这是一次明确的安全修复

这一项是本次版本中非常关键的安全修复。问题点集中在：

• FileSystemKnowledge.get_file
• path 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_context
• agent
• team

这一修复的关键点

日志中用了 “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
• 现在会在以下方法中被正确 honored：
- • list_events
- • create_event
- • update_event

此外，还修复了：

• calendar list event start dates 的 normalize 问题

为什么它很重要

时间处理问题往往是工具集成中最容易出现偏差的部分之一，尤其当时间带有时区信息时。如果 list_events、create_event、update_event 三者对时间参数的处理不一致，就可能出现：

• 查询和创建结果不一致
• 更新时间和预期不一致
• 列表展示与输入时间存在偏差

这次更新明确说明，timezone-aware start_date/end_date 现在会在三类核心操作中被统一尊重和处理。

这说明 v2.7.2 在 Calendar 工具上完成了时间处理的一致性修复。

修复价值总结

这项修复的价值主要体现在两个方面：

1. 时区感知时间参数得到正确处理
2. 列表、创建、更新三种操作保持一致

可以概括为：

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 select
• disconnect
• restart hints
• identity-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_server
• fold in mcp_config

这项变更说明了什么

说明 AgentOS 在 MCP 相关配置上进行了命名与结构调整：

1. enable_mcp_server 被重命名为 mcp_server
2. mcp_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_context
• agent
• team

10. 修复：规范 calendar list event start dates

这项内容与 Google Calendar Tools 修复相互呼应：

• normalize calendar list event start dates

它表明 Calendar 相关时间处理修复不仅体现在 create 和 update，也落实到了 list event 的起始时间规范化上。

11. chore：Release v2.7.2

最后一项是版本发布相关记录：

• Release v2.7.2

这表明本次变更最终汇总并形成了 v2.7.2 正式发布版本。

六、agno v2.7.2 的更新价值总结

综合本次所有内容，agno v2.7.2 的价值可以归纳为以下几个方面。

1. 接入能力增强

最典型的代表就是：

• AgentOS MCP endpoint 支持 OAuth
• AgentOS 的 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_context
• agent
• team

这让工具方法在运行时拥有更完整的上下文与主体信息。

8. 时间处理一致性更好

Google Calendar Tools 对时区感知时间参数的统一支持，以及 list event start dates 的规范化，解决的是典型但高频的时间一致性问题。

七、完整更新清单汇总

为了便于收藏和快速查阅，下面给出一份不遗漏的完整清单。

新功能

• AgentOS MCP endpoint 新增 OAuth 支持，可通过 AgentOS(mcp_auth=...) 使用，详见 cookbook
• AG-UI frontend tools 新增 client_tools 支持
• agno connect 增强，支持：
- • multi-target select
- • disconnect
- • restart hints
- • identity-named entries

改进

• A2A scope mappings 移动到 interface
• 修复 custom prefix support

修复

• 为 remote agent 和 team runs 序列化 media
• 防止 FileSystemKnowledge.get_file 中的 path traversal
• @tool 装饰的 Toolkit methods 现在可接收注入的 run_context、agent 和 team
• Google Calendar Tools 中，带时区信息的 start_date 和 end_date 现在会在以下操作中被正确处理：
- • list_events
- • create_event
- • update_event
• 规范 calendar list event start dates