agno v2.8.7 发布：顾问模型、精准路线、调度能力全面升级，10项关键修复一次看懂

版本信息

• • 最新版本：v2.8.7

• • 发布时间：2026年8月7日

• • 项目地址：github.com/agno-agi/agno

这次 agno v2.8.7 更新覆盖了工具能力扩展、Studio 调度能力、文件系统工具配置、持久化组件恢复、模型采样参数、人工确认流程、SQLite 加载稳定性、音频工具处理，以及依赖兼容性等多个方向。

从更新内容来看，v2.8.7 的重点并不只是新增功能，更在于对已有组件、工具调用、调度流程、数据恢复和依赖链路进行细致修复。对于正在使用工具集、团队加载、持久化组件、音频处理、Cohere 模型参数或调度能力的用户来说，这个版本包含多项直接相关的改进。

一、核心新增功能：AdvisorTools 正式加入

v2.8.7 新增了 AdvisorTools。

AdvisorTools 的定位是用于向顾问模型请求反馈。对于需要获取模型建议、分析意见或反馈结果的工作流来说，这项新增能力提供了专门的工具支持。

在此前的工具体系中，不同任务通常需要对应不同的工具能力。此次加入 AdvisorTools 后，用户可以将“请求顾问模型反馈”这一类需求纳入工具调用流程中。

这项更新的重点在于：

• • 新增 AdvisorTools 工具集

• • 支持向顾问模型请求反馈

• • 为需要模型建议与反馈的场景提供工具化能力

• • 扩展现有工具体系的使用范围

AdvisorTools 的加入，使顾问模型反馈成为一个明确的工具能力，而不再只是普通的模型调用结果。对于依赖反馈环节的流程而言，这一能力的出现进一步丰富了工具侧的选择。

二、OpenRouteService Toolkit 上线：路线能力更精准

v2.8.7 新增 OpenRouteService Toolkit，用于提供更准确的路线规划能力。

路线规划是很多应用中的重要能力之一，尤其是在需要获取路径、规划出行路线或进行位置相关处理的场景里，路线结果的准确性具有直接影响。此次引入 OpenRouteService Toolkit，更新说明明确指出其目标是实现更准确的路由能力。

本次更新带来的重点包括：

• • 新增 OpenRouteService Toolkit

• • 支持更准确的路由处理

• • 为路线规划相关需求提供新的工具支持

• • 扩展工具集中与路线服务有关的能力

OpenRouteService Toolkit 的加入，意味着 v2.8.7 在工具能力覆盖上进一步延伸到了准确路由这一方向。对于有路线需求的使用者来说，这是一项非常明确的新功能。

三、StudioTools 增强：组件感知调度工具与历史参数到来

StudioTools 是本次更新中一个重要的增强方向。

v2.8.7 为 StudioTools 增加了组件感知的调度工具和历史参数。更新内容中明确提到，新增内容包括 component-aware schedule tools，也就是能够感知组件的调度工具，以及 history parameters，也就是历史参数能力。

这项升级涉及两个关键部分。

1. 组件感知的调度工具

组件感知意味着调度工具能够围绕组件进行处理。在调度相关能力中，组件是重要的组织单位。此次将组件感知能力加入 StudioTools，使调度工具具备更贴近组件结构的处理方式。

更新内容将这一项列为新功能，说明 StudioTools 在调度支持方面获得了新的扩展。

2. 历史参数支持

除了组件感知调度工具外，StudioTools 还新增了历史参数。

历史参数的加入，使工具层面能够处理与历史相关的参数需求。这一改动与调度工具一同出现，构成了 StudioTools 在本版本中的重要升级内容。

本次 StudioTools 更新可以概括为：

• • 新增组件感知调度工具

• • 新增历史参数

• • 提升 StudioTools 在调度相关场景中的能力覆盖

• • 调度功能与组件维度结合更加紧密

与此同时，更新记录中还提到，开发环境新增了 scheduler extras，以便持续集成能够运行调度测试。

这并不是面向最终使用者的独立功能，而是为了让持续集成环境覆盖调度测试。它反映出本次调度能力更新不仅包含功能补充，也同步增加了相应测试环境支持。

相关变化包括：

• • 在开发依赖中加入 scheduler extras

• • 使持续集成流程能够执行调度测试

• • 为调度能力相关测试提供依赖保障

四、FileSystemTools 支持自定义工具集名称

v2.8.7 对 FileSystemTools 进行了配置能力增强。

此前，FileSystemTools 的工具集名称可能遵循固定命名方式。此次更新后，用户可以覆盖 FileSystemTools 的 toolkit 名称，也就是可以自定义或重写该工具集名称。

这项能力看似细节，但对于工具集标识、工具组织和调用场景来说具有明确意义。

本次改动包括：

• • FileSystemTools 支持覆盖 toolkit 名称

• • 允许用户对文件系统工具集名称进行自定义

• • 提升 FileSystemTools 的配置灵活性

当多个工具集同时存在、工具名称需要进行区分，或者已有命名规范需要统一时，可覆盖名称的能力能够提供更加灵活的配置方式。

需要注意的是，本次更新明确的是“允许覆盖 FileSystemTools 的 toolkit 名称”，更新内容并未说明其他行为变化。因此，使用时应聚焦于工具集名称可覆盖这一能力本身。

五、持久化组件修复：工具限定名称恢复问题解决

v2.8.7 修复了持久化组件中的 toolkit-qualified tool rehydration 问题。

这一问题涉及持久化组件的恢复过程。工具限定名称，也就是带有工具集限定信息的工具，在持久化组件重新恢复时存在问题。本版本对此进行了修复。

更新说明中将其描述为：

• • 修复持久化组件的工具限定名称恢复

• • 修复 persisted components 中 toolkit-qualified tool rehydration 问题

“rehydration” 可以理解为持久化对象恢复、重新构建或重新加载到可用状态的过程。此次修复的核心，是让带有工具集限定信息的工具在持久化组件恢复时能够正确处理。

这一修复对于使用持久化组件的场景尤其重要，重点体现在：

• • 改善持久化组件恢复过程中的工具处理

• • 修复工具集限定工具的恢复问题

• • 提升组件恢复流程的正确性

在工具体系中，工具名称与所属工具集之间的限定关系具有重要意义。此次修复聚焦于这一关系在持久化恢复阶段的处理问题，有助于避免恢复过程中出现不正确的工具重建情况。

六、Cohere 参数修复：显式设置为 0 不再被忽略

v2.8.7 修复了 Cohere 采样参数中零值被丢弃的问题。

这是本次更新中非常具体且重要的一项修复。此前，当某些采样参数被明确设置为0时，系统会错误地将这些值视为未设置或空值，从而导致这些参数被丢弃。

本次修复后，显式传入的0将被正确保留和尊重。

更新说明明确列出的参数包括：

• •temperature

• •top_k

• •seed

• •frequency_penalty

• •presence_penalty

此次修复意味着，当这些参数被显式设置为0时，不会再被自动忽略。

这一改动的关键不在于增加新的参数，而在于修正已有参数的值处理逻辑。0是一个明确的参数值，不应与“没有传入参数”混为一谈。v2.8.7 对此进行了纠正。

可以概括为：

• • 修复 Cohere 零值采样参数被丢弃的问题

• • 显式设置的temperature=0将被保留

• • 显式设置的top_k=0将被保留

• • 显式设置的seed=0将被保留

• • 显式设置的frequency_penalty=0将被保留

• • 显式设置的presence_penalty=0将被保留

• • 区分“显式传入 0”和“未传入值”这两种情况

对于需要精确控制采样参数的使用者来说，这是一项直接影响配置结果的修复。特别是在参数配置中，零值本身具备明确意义时，能够正确传递和保留该值非常关键。

七、HITL 确认流程修复：顶层确认正确传递到工具执行

v2.8.7 修复了 HITL 相关的确认信息传递问题。

HITL 指的是人工参与流程。在某些流程中，工具执行可能要求确认信息。此次修复聚焦于 requirement deserialization，也就是需求反序列化阶段。

更新内容指出，系统现在会将顶层 confirmation 正确传播到tool_execution。

本次修复的核心包括：

• • 修复需求反序列化过程中的确认信息传递

• • 将顶层 confirmation 传递到tool_execution

• • 改善 HITL 场景下工具执行所需确认信息的处理

在涉及人工确认的流程中，顶层确认信息与具体工具执行之间的传递是否正确，会直接影响工具执行阶段能否获得应有的确认要求。v2.8.7 对这一链路进行了修复。

可以理解为，原本位于顶层的确认信息，在需求反序列化后需要继续进入工具执行配置。此次更新解决了这一传播问题，让tool_execution能够获得相应的确认信息。

这一改动强化了以下环节：

• • 顶层确认配置

• • 需求反序列化

• • 工具执行配置

• • HITL 流程中的确认传递关系

八、Team.load 修复：解决 SQLite 场景下的加载崩溃

v2.8.7 修复了Team.load在 SQLite 中可能发生崩溃的问题。

更新说明指出，崩溃原因是出现了意外的关键字参数label。在 SQLite 场景下，Team.load因为 unexpected keyword argumentlabel而发生崩溃，本版本已经修复。

本次修复包含：

• • 修复Team.load在 SQLite 环境中的崩溃问题

• • 解决意外关键字参数label引发的异常

• • 提升团队加载流程在 SQLite 场景下的稳定性

这一问题的表现非常明确：当Team.load与 SQLite 结合使用时，出现了不被接受的label关键字参数，进而导致加载过程崩溃。

v2.8.7 对该问题进行修复后，团队加载流程在对应 SQLite 场景中获得改善。

对于使用 SQLite 存储或加载团队配置的用户，这一修复具有直接价值。它针对的是实际加载过程中的崩溃问题，而不是功能扩展，因此升级后可以减少由label参数异常导致的加载失败。

九、音频工具结果处理更稳健，同时示例切换到 Gemini

本次版本还改进了音频工具的工具结果处理能力。

更新说明中明确提到，Audio Tools 的 tool-result handling 更加稳健。也就是说，音频工具在处理工具执行结果时获得了更健壮的处理方式。

本次与音频相关的更新包括两个部分。

1. 音频工具结果处理更稳健

音频工具的结果处理流程得到增强。更新内容没有进一步描述具体实现细节，因此可以确认的是：v2.8.7 改善了音频工具结果的处理稳健性。

这项改进聚焦于：

• • 音频工具结果处理

• • 工具结果处理的健壮性

• • 音频相关流程的稳定性改善

2. Smallest AI cookbook 切换至 Gemini

除了音频工具结果处理增强外，Smallest AI cookbook 也切换到了 Gemini。

该变化属于示例或 cookbook 相关调整，更新说明明确指出已完成切换。需要注意的是，更新内容没有描述该切换的更多原因或具体实现，因此不应延伸为未公开的结论。

与音频部分相关的完整变化可以概括为：

• • 提高音频工具结果处理的稳健性

• • Smallest AI cookbook 切换到 Gemini

• • 音频工具处理与 cookbook 配置均有对应调整

十、依赖修复：排除会破坏导入链的 nltk 3.10.1

v2.8.7 对依赖兼容性进行了重要处理：排除nltk 3.10.1。

更新说明明确指出，nltk 3.10.1会破坏 unstructured 的导入链。因此，本版本通过排除该版本，避免这一依赖问题影响导入流程。

这项修复非常清晰，核心内容包括：

• • 排除nltk 3.10.1

• • 该版本会破坏 unstructured 的导入链

• • 通过排除该版本改善依赖兼容性

依赖问题往往具有隐蔽性。即使业务代码没有变化，特定依赖版本也可能导致导入链出现问题。此次更新直接针对nltk 3.10.1进行排除，修复目标十分明确。

对于依赖 unstructured 导入链的环境而言，这一变更尤其值得关注。升级到 v2.8.7 后，应注意依赖解析结果中不再使用nltk 3.10.1。

十一、调度数据库调用优化：同步调用移出事件循环

除了新增调度能力和测试支持外，v2.8.7 还对调度器数据库调用进行了修复。

更新内容指出：将同步调度器数据库调用移出事件循环。

这项改动涉及同步数据库调用与事件循环之间的关系。版本中对这一部分进行了调整，使同步调度器数据库调用不再直接运行在事件循环中。

本次优化的明确内容包括：

• • 修复同步调度器数据库调用的执行位置

• • 将同步数据库调用移出事件循环

• • 改善调度器相关数据库调用的处理方式

该更新与前文提到的调度工具、历史参数、调度测试支持共同构成了本版本在调度方向上的一组变化。

调度方向的完整变化包括：

• • StudioTools 新增组件感知调度工具

• • StudioTools 新增历史参数

• • 开发依赖加入 scheduler extras

• • 持续集成能够运行调度测试

• • 同步调度器数据库调用移出事件循环

这些改动覆盖了调度能力、参数支持、测试环境和数据库调用处理等多个层面。

十二、v2.8.7 更新内容完整清单

为了方便快速核对，下面汇总本次版本全部更新内容。

新增功能

• • 新增 AdvisorTools，用于向顾问模型请求反馈

• • 新增 OpenRouteService Toolkit，用于更准确的路由处理

• • StudioTools 新增组件感知调度工具

• • StudioTools 新增历史参数

• • FileSystemTools 支持覆盖工具集名称

问题修复

• • 修复持久化组件中工具集限定工具的恢复问题

• • 修复 Cohere 将零值采样参数丢弃的问题

• • 修复 HITL 需求反序列化时顶层确认未正确传递至tool_execution的问题

• • 修复Team.load在 SQLite 场景下因意外label参数崩溃的问题

• • 改进音频工具结果处理的稳健性

• • 排除会破坏 unstructured 导入链的nltk 3.10.1

• • 将同步调度器数据库调用移出事件循环

相关调整

• • Smallest AI cookbook 切换到 Gemini

• • 开发环境加入 scheduler extras

• • 持续集成环境能够覆盖调度测试

• • 完成 v2.8.7 版本发布

十三、结语：一次围绕工具、调度、恢复与稳定性的版本更新

agno v2.8.7 的更新范围十分集中，主要围绕工具能力扩展、调度支持、组件恢复、参数传递、数据库加载、音频结果处理与依赖稳定性展开。

新增方面，AdvisorTools、OpenRouteService Toolkit、组件感知调度工具、历史参数以及 FileSystemTools 名称覆盖能力，进一步扩展了现有工具与调度体系。

修复方面，持久化组件工具恢复、Cohere 零值参数、HITL 确认传递、SQLite 下的Team.load崩溃、音频工具结果处理、nltk 3.10.1依赖问题，以及同步调度器数据库调用位置等问题均得到处理。

如果当前使用了以下能力，v2.8.7 值得重点关注：

• • 顾问模型反馈

• • 路线规划

• • StudioTools 调度

• • 历史参数

• • FileSystemTools 命名

• • 持久化组件恢复

• • Cohere 采样参数

• • HITL 确认流程

• • SQLite 团队加载

• • 音频工具结果处理

• • unstructured 导入链

• • 调度器数据库调用

总体来看，agno v2.8.7 是一次新增能力与稳定性修复并重的版本更新。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。