版本信息
- 最新版本：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将被正确保留和尊重。
更新说明明确列出的参数包括：
temperaturetop_kseedfrequency_penaltypresence_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 是一次新增能力与稳定性修复并重的版本更新。