版本信息最新版本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 零值采样参数被丢弃的问题显式设置的temperature0将被保留显式设置的top_k0将被保留显式设置的seed0将被保留显式设置的frequency_penalty0将被保留显式设置的presence_penalty0将被保留区分“显式传入 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.1v2.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 是一次新增能力与稳定性修复并重的版本更新。