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 的更新可以概括为以下几个核心方向新功能Sub-Agent Event Streaming来自上下文提供器更新工具的子智能体事件会继续流式传递到父运行中AgentOS Registry Auto-PopulationAgentOS 注册表可以从 agents、teams、workflows 自动填充Workflows HITL over Sockets工作流的人机协同能力新增 socket 支持Slack App Manifest为 AgentOS 接口新增 Slack app manifestBug 修复JSON Schemajson_schema 现在可以正确处理没有声明类型的 Optional dataclass 字段MCPTools Sessions刷新后的 MCPTools 会话会在 call task 中关闭Tool Arguments工具参数中的空白字符会被保留Content Hashing元数据纳入内容哈希避免 upsertFalse 插入同一文档时发生折叠MultiMCP清理 MultiMCP 连接失败的问题DaytonaTools对 shell 路径进行引用处理这次版本更新虽然没有大规模重构但每一项改动都非常实用很多都直接对应真实使用场景中的痛点。二、新功能详解1. Sub-Agent Event Streaming子智能体事件流向父运行继续传递这是本次更新中非常值得关注的一项能力增强。在 agno v2.6.13 中来自上下文提供器更新工具的Sub-Agent 事件现在可以继续流式传递到父运行中。这意味着什么在多智能体或嵌套执行场景里子智能体执行时产生的事件过去可能只停留在局部范围内而现在这些事件会继续向上传递到父运行。这种机制对于实时可观测性调试追踪上层任务控制统一事件消费都非常有帮助。价值体现当父运行能够接收到子智能体的事件流时整个智能体系统的执行过程会更加透明。这对于需要观察智能体内部过程的场景尤其重要比如多步骤任务编排子智能体协作上下文更新过程监控运行日志统一收集简单来说这个更新让事件流不再割裂而是可以更完整地贯穿父子运行链路。2. AgentOS Registry Auto-PopulationAgentOS 注册表自动填充这次版本还新增了AgentOS Registry Auto-Population也就是 AgentOS 注册表可以从以下对象自动填充agentsteamsworkflows这项能力的意义过去如果要维护 AgentOS registry可能需要更多手工同步或额外配置。而现在注册表可以直接从现有的 agents、teams 和 workflows 中自动生成和填充这显著降低了维护成本。带来的好处减少重复配置提升注册表一致性更容易让 AgentOS 接口展示完整资源降低漏注册、错注册的概率如果你的系统中已经存在大量 agents、teams、workflows这个更新会让管理和展示变得更顺畅AgentOS 的可用性也会更高。3. Workflows HITL over Sockets工作流人机协同增加 Socket 支持v2.6.13 为工作流中的HITLHuman-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 中。这样一来在upsertFalse的场景下同一文档的插入就不会因为哈希相同而折叠。这个问题的本质如果只根据文档主体内容计算哈希而忽略元数据那么当主体内容相同但元数据不同的时候系统可能误判为同一内容导致插入行为被“折叠”。修复后的变化把元数据纳入内容哈希之后系统能够更准确地区分文档不再把“内容相同但元数据不同”的条目错误合并。实际价值提高文档识别准确性避免插入记录丢失更适合保留不同元数据上下文的文档管理场景这项修复对于向量存储、文档索引和知识库写入流程都很关键。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 upsertFalse inserts of the same document don’t collapse这是前面内容哈希修复的完整说明重点就是把 metadata 也纳入哈希计算避免相同文档在upsertFalse时被错误折叠。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 支持 socketAgentOS 接口新增 Slack app manifestJSON Schema 对 Optional dataclass 无类型字段更友好MCPTools 会话刷新后可正确关闭工具参数空白字符保留元数据纳入内容哈希避免同文档折叠MultiMCP 连接失败清理DaytonaTools shell 路径引用修复
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 的更新可以概括为以下几个核心方向新功能Sub-Agent Event Streaming来自上下文提供器更新工具的子智能体事件会继续流式传递到父运行中AgentOS Registry Auto-PopulationAgentOS 注册表可以从 agents、teams、workflows 自动填充Workflows HITL over Sockets工作流的人机协同能力新增 socket 支持Slack App Manifest为 AgentOS 接口新增 Slack app manifestBug 修复JSON Schemajson_schema 现在可以正确处理没有声明类型的 Optional dataclass 字段MCPTools Sessions刷新后的 MCPTools 会话会在 call task 中关闭Tool Arguments工具参数中的空白字符会被保留Content Hashing元数据纳入内容哈希避免 upsertFalse 插入同一文档时发生折叠MultiMCP清理 MultiMCP 连接失败的问题DaytonaTools对 shell 路径进行引用处理这次版本更新虽然没有大规模重构但每一项改动都非常实用很多都直接对应真实使用场景中的痛点。二、新功能详解1. Sub-Agent Event Streaming子智能体事件流向父运行继续传递这是本次更新中非常值得关注的一项能力增强。在 agno v2.6.13 中来自上下文提供器更新工具的Sub-Agent 事件现在可以继续流式传递到父运行中。这意味着什么在多智能体或嵌套执行场景里子智能体执行时产生的事件过去可能只停留在局部范围内而现在这些事件会继续向上传递到父运行。这种机制对于实时可观测性调试追踪上层任务控制统一事件消费都非常有帮助。价值体现当父运行能够接收到子智能体的事件流时整个智能体系统的执行过程会更加透明。这对于需要观察智能体内部过程的场景尤其重要比如多步骤任务编排子智能体协作上下文更新过程监控运行日志统一收集简单来说这个更新让事件流不再割裂而是可以更完整地贯穿父子运行链路。2. AgentOS Registry Auto-PopulationAgentOS 注册表自动填充这次版本还新增了AgentOS Registry Auto-Population也就是 AgentOS 注册表可以从以下对象自动填充agentsteamsworkflows这项能力的意义过去如果要维护 AgentOS registry可能需要更多手工同步或额外配置。而现在注册表可以直接从现有的 agents、teams 和 workflows 中自动生成和填充这显著降低了维护成本。带来的好处减少重复配置提升注册表一致性更容易让 AgentOS 接口展示完整资源降低漏注册、错注册的概率如果你的系统中已经存在大量 agents、teams、workflows这个更新会让管理和展示变得更顺畅AgentOS 的可用性也会更高。3. Workflows HITL over Sockets工作流人机协同增加 Socket 支持v2.6.13 为工作流中的HITLHuman-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 中。这样一来在upsertFalse的场景下同一文档的插入就不会因为哈希相同而折叠。这个问题的本质如果只根据文档主体内容计算哈希而忽略元数据那么当主体内容相同但元数据不同的时候系统可能误判为同一内容导致插入行为被“折叠”。修复后的变化把元数据纳入内容哈希之后系统能够更准确地区分文档不再把“内容相同但元数据不同”的条目错误合并。实际价值提高文档识别准确性避免插入记录丢失更适合保留不同元数据上下文的文档管理场景这项修复对于向量存储、文档索引和知识库写入流程都很关键。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 upsertFalse inserts of the same document don’t collapse这是前面内容哈希修复的完整说明重点就是把 metadata 也纳入哈希计算避免相同文档在upsertFalse时被错误折叠。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 支持 socketAgentOS 接口新增 Slack app manifestJSON Schema 对 Optional dataclass 无类型字段更友好MCPTools 会话刷新后可正确关闭工具参数空白字符保留元数据纳入内容哈希避免同文档折叠MultiMCP 连接失败清理DaytonaTools shell 路径引用修复
