agno v2.6.13 最新版本发布：AgentOS、Workflows、MCPTools、JSON Schema 等多项更新全面解析

2026年6月11日，agno 正式发布v2.6.13最新版本。这一次的更新内容非常集中，围绕Sub-Agent 事件流、AgentOS 注册表自动填充、Workflows 的 HITL Socket 支持、Slack App Manifest、JSON Schema 兼容性修复、MCPTools 会话关闭、工具参数空格保留、内容哈希逻辑优化、多 MCP 连接清理、DaytonaTools Shell 路径引用处理等多个方面进行了增强和修复。

如果你正在使用 agno 构建智能体系统、工作流系统、上下文提供器更新工具或 AgentOS 相关能力，那么这次 v2.6.13 更新值得重点关注。它不仅新增了若干关键功能，也对一些底层细节做了修复和优化，进一步提升了系统的稳定性、可维护性和扩展能力。

一、版本概览：agno v2.6.13 更新了什么

本次 v2.6.13 的更新可以概括为以下几个核心方向：

新功能

1. Sub-Agent Event Streaming：来自上下文提供器更新工具的子智能体事件会继续流式传递到父运行中
2. AgentOS Registry Auto-Population：AgentOS 注册表可以从 agents、teams、workflows 自动填充
3. Workflows HITL over Sockets：工作流的人机协同能力新增 socket 支持
4. Slack App Manifest：为 AgentOS 接口新增 Slack app manifest

Bug 修复

1. JSON Schema：json_schema 现在可以正确处理没有声明类型的 Optional dataclass 字段
2. MCPTools Sessions：刷新后的 MCPTools 会话会在 call task 中关闭
3. Tool Arguments：工具参数中的空白字符会被保留
4. Content Hashing：元数据纳入内容哈希，避免 upsert=False 插入同一文档时发生折叠
5. MultiMCP：清理 MultiMCP 连接失败的问题
6. DaytonaTools：对 shell 路径进行引用处理

这次版本更新虽然没有大规模重构，但每一项改动都非常实用，很多都直接对应真实使用场景中的痛点。

二、新功能详解

1. Sub-Agent Event Streaming：子智能体事件流向父运行继续传递

这是本次更新中非常值得关注的一项能力增强。
在 agno v2.6.13 中，来自上下文提供器更新工具的Sub-Agent 事件，现在可以继续流式传递到父运行中。

这意味着什么

在多智能体或嵌套执行场景里，子智能体执行时产生的事件，过去可能只停留在局部范围内，而现在这些事件会继续向上传递到父运行。这种机制对于：

• 实时可观测性
• 调试追踪
• 上层任务控制
• 统一事件消费

都非常有帮助。

价值体现

当父运行能够接收到子智能体的事件流时，整个智能体系统的执行过程会更加透明。
这对于需要观察智能体内部过程的场景尤其重要，比如：

• 多步骤任务编排
• 子智能体协作
• 上下文更新过程监控
• 运行日志统一收集

简单来说，这个更新让事件流不再割裂，而是可以更完整地贯穿父子运行链路。

2. AgentOS Registry Auto-Population：AgentOS 注册表自动填充

这次版本还新增了AgentOS Registry Auto-Population，也就是 AgentOS 注册表可以从以下对象自动填充：

• agents
• teams
• workflows

这项能力的意义

过去如果要维护 AgentOS registry，可能需要更多手工同步或额外配置。而现在，注册表可以直接从现有的 agents、teams 和 workflows 中自动生成和填充，这显著降低了维护成本。

带来的好处

• 减少重复配置
• 提升注册表一致性
• 更容易让 AgentOS 接口展示完整资源
• 降低漏注册、错注册的概率

如果你的系统中已经存在大量 agents、teams、workflows，这个更新会让管理和展示变得更顺畅，AgentOS 的可用性也会更高。

3. Workflows HITL over Sockets：工作流人机协同增加 Socket 支持

v2.6.13 为工作流中的HITL（Human-in-the-Loop）场景新增了socket 支持。

HITL 是什么

HITL 指的是在自动化流程中引入人工介入，让某些关键环节由人来确认、修正、审核或继续执行。
在智能体和工作流系统中，HITL 往往用于：

• 需要人工审核后再继续
• 需要用户输入补充信息
• 需要人来做决策确认
• 需要中途暂停和恢复

Socket 支持的意义

加入 socket 支持后，HITL 的交互方式会更灵活，更适合实时通信场景。
相比传统方式，socket 可以更好地支持双向、持续性的交互流程，尤其适用于需要即时响应的工作流。

应用价值

• 实时人机协同
• 更顺畅的等待与恢复流程
• 更适合交互型工作流
• 提升 HITL 在复杂任务中的适配能力

这说明 agno 在工作流方向上的能力继续增强，开始更好地支持“自动化 + 人工介入”的混合执行模式。

4. Slack App Manifest：新增 AgentOS 接口的 Slack 应用清单

本次更新还为 AgentOS 接口增加了Slack app manifest。

这代表什么

Slack app manifest 是一种面向 Slack 应用配置的清单形式，可以让应用配置更标准化、更方便管理。
在本次更新里，agno 为 AgentOS 接口添加了这一能力，意味着相关 Slack 集成流程将更方便落地。

可能带来的体验提升

• 更便于对接 Slack 环境
• 配置更标准化
• 有助于快速部署和管理应用接口
• 提升 AgentOS 在 Slack 场景中的可用性

对于已经在使用 Slack 作为协作入口的团队来说，这项更新的实际价值很高。

三、Bug 修复详解

5. JSON Schema 修复：Optional dataclass 字段没有声明类型时也能正确处理

在这次版本中，json_schema终于可以正确处理Optional dataclass 字段没有声明类型的情况。

问题背景

在数据结构定义中，dataclass 字段如果使用 Optional，但没有显式声明类型，可能会在生成或解析 JSON Schema 时出现兼容性问题。

这次修复的意义

这项修复增强了 json_schema 的健壮性，让它在面对不完整或边界场景的数据定义时，依然能够正常工作。
对于依赖 dataclass 和 JSON Schema 的项目而言，这可以减少因为类型声明不完整而导致的报错或异常行为。

影响

• 提升 schema 兼容性
• 降低 dataclass 定义边界问题带来的风险
• 让 json_schema 更稳定

这是一个典型的“看起来细小，但很实用”的修复。

6. MCPTools Sessions 修复：刷新后的会话会在 call task 中关闭

v2.6.13 修复了MCPTools sessions的一个资源管理问题：
刷新后的 MCPTools 会话现在会在 call task 中关闭。

为什么重要

会话管理如果不及时关闭，容易带来：

• 资源占用
• 连接残留
• 状态不一致
• 后续任务异常

这次修复带来的改善

通过确保刷新后的会话能在 call task 中正确关闭，系统资源管理会更合理，执行过程也更稳定。
对于高频调用或者长时间运行的场景，这类修复尤其关键。

7. Tool Arguments 修复：保留工具参数中的空白字符

另一个很实用的修复是：工具参数中的空白字符会被保留。

为什么空白字符重要

在某些工具调用场景中，参数里的空格、换行、缩进等空白字符本身就具有意义。
如果这些空白被意外去除，可能会导致：

• 参数内容变化
• 调用结果错误
• 文本格式丢失
• 下游工具解析异常

修复效果

现在工具参数的空白字符会被保留，这意味着工具调用更忠实于原始输入内容，也更适合处理对格式敏感的参数。

这是一个非常直接的修复，尤其适合文本处理类工具和格式敏感型调用。

8. Content Hashing 修复：元数据纳入内容哈希，避免同文档插入折叠

本次更新对内容哈希逻辑做了修正：元数据现在也会被包含在 content hash 中。
这样一来，在upsert=False的场景下，同一文档的插入就不会因为哈希相同而折叠。

这个问题的本质

如果只根据文档主体内容计算哈希，而忽略元数据，那么当主体内容相同但元数据不同的时候，系统可能误判为同一内容，导致插入行为被“折叠”。

修复后的变化

把元数据纳入内容哈希之后，系统能够更准确地区分文档，不再把“内容相同但元数据不同”的条目错误合并。

实际价值

• 提高文档识别准确性
• 避免插入记录丢失
• 更适合保留不同元数据上下文的文档管理场景

这项修复对于向量存储、文档索引和知识库写入流程都很关键。

9. MultiMCP 修复：清理连接失败问题

v2.6.13 还修复了MultiMCP connection failures的清理问题。

这类问题意味着什么

当 MultiMCP 出现连接失败时，如果失败现场没有被正确清理，可能会遗留一些无效状态或资源，影响后续连接和任务执行。

修复后的收益

现在连接失败会被更好地清理掉，系统状态更干净，也更不容易受到异常连接残留影响。

总体作用

• 提升连接失败后的恢复能力
• 减少异常状态残留
• 增强 MultiMCP 稳定性

这类修复虽然不直接增加新功能，但对长期运行系统非常重要。

10. DaytonaTools 修复：shell 路径加引号

本次版本还修复了DaytonaTools中 shell 路径未加引号的问题。

问题点

如果 shell 路径中包含空格或特殊字符，而没有加引号，可能会导致命令解析错误。

修复后的效果

现在路径会被正确引用，shell 执行过程更安全，也更可靠。

实际意义

• 避免路径解析失败
• 提升命令执行稳定性
• 减少因路径格式引发的错误

这是一个很典型但非常必要的 shell 相关修复。

四、What’s Changed 变更项完整解读

除了上面按功能分类的说明外，本次更新日志中还列出了具体的变更摘要。下面我们按照原始内容逐项整理，确保不遗漏。

cookbook：将 HTML 生成折叠进 01_demo wiki agents

这项变更说明在 cookbook 中，将 HTML 生成整合进了 01_demo wiki agents。
这属于文档或示例层面的调整，有助于内容组织和演示结构统一。

refactor：移除 decision logs 中过时的 Phase 2 标签

这是一项重构性质的调整：
decision logs 中原先存在一些过时的 Phase 2 标签，现在已经被移除。

这类变化通常意味着日志或流程标记更加简洁，减少历史残留信息带来的干扰。

[fix] Quote DaytonaTools shell paths

这与前面提到的 DaytonaTools 修复一致，就是为 shell 路径增加引用处理。

[fix] Clean up MultiMCP connection failures

这同样对应前面提到的 MultiMCP 连接失败清理修复。

fix: include metadata in content hash so upsert=False inserts of the same document don’t collapse

这是前面内容哈希修复的完整说明，重点就是把 metadata 也纳入哈希计算，避免相同文档在upsert=False时被错误折叠。

fix: preserve tool argument whitespace

这项修复就是保留工具参数中的空白字符，避免参数格式被破坏。

feat: add Slack app manifest for AgentOS interface

这是前面提到的新增 Slack app manifest，对 AgentOS 接口的 Slack 集成更友好。

fix: close refreshed MCPTools sessions in call task

这是 MCPTools session 关闭逻辑修复，确保刷新后的会话能在 call task 中关闭。

fix: json_schema handle Optional dataclass fields without a type

这是 JSON Schema 对 Optional dataclass 无类型字段的兼容性修复。

feat: socket support for workflows HITL

这是工作流 HITL 新增 socket 支持。

feat: auto-populate AgentOS registry from agents, teams, and workflows

这是 AgentOS registry 自动填充能力。

feat: stream sub-agent events from context provider update tool

这是子智能体事件流向父运行传递的增强。

chore: bump version

这是版本号升级的常规维护项，表示本次正式发布为 v2.6.13。

五、为什么这次更新值得关注

从整体上看，agno v2.6.13 的特点非常明确：

1. 更强的事件流能力

Sub-Agent 事件可以继续流向父运行，说明系统对可观测性和多层执行链路的支持更完整。

2. 更强的 AgentOS 集成能力

注册表自动填充 + Slack app manifest，说明 AgentOS 接口生态在增强。

3. 更好的工作流人机协同

HITL 增加 socket 支持，意味着工作流交互能力更进一步。

4. 更稳定的底层行为

JSON Schema、MCPTools、工具参数、内容哈希、MultiMCP、DaytonaTools 这些修复，都是围绕稳定性和兼容性展开的。

5. 更适合真实生产场景

这些更新并不是“看起来很炫”的表面功能，而是直接针对真实运行过程中的问题做优化，属于非常实用的一版更新。

六、总结：agno v2.6.13 是一次偏实用型的增强版本

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

如果要用一句话概括 agno v2.6.13，那就是：
这是一版围绕事件流、注册表自动化、工作流协同、兼容性修复和稳定性提升展开的实用型更新。

它带来的改进包括：

• Sub-Agent 事件流向父运行传递
• AgentOS registry 自动填充
• Workflows HITL 支持 socket
• AgentOS 接口新增 Slack app manifest
• JSON Schema 对 Optional dataclass 无类型字段更友好
• MCPTools 会话刷新后可正确关闭
• 工具参数空白字符保留
• 元数据纳入内容哈希，避免同文档折叠
• MultiMCP 连接失败清理
• DaytonaTools shell 路径引用修复