Agno v3.1.0 发布：新增 RBAC 授权、AgentOS 文件系统与 MCP 工具开关

本次变化

来源显示 Agno 发布 v3.1.0，主要新增与调整包括：

• 用户管理与授权（RBAC）：新增 agno.os.authz 包，为 AgentOS 提供基于角色的访问控制，包含角色存储、范围策略、审计日志、用户目录和管理路由；授权引擎可插拔，提供原生引擎与细粒度 fga 引擎，并扩展了 scope 与鉴权中间件来落实这些策略。
• AgentOS 文件系统：新增 agno.fs，提供基于数据库的 DbFileSystem，配套 /filesystem 路由用于列出、读取和管理文件，底层使用 agno_fs 表。
• MCP 配置与鉴权更新：刷新了 MCP 服务端配置，并内置 MCP 鉴权处理。
• AIMLAPITools：新增工具包，通过 AI/ML API 支持图像、视频、语音与转写能力。

破坏性变更

• agno_fs 表改为按 (namespace, user_id, path) 作为键，其中 user_id 是用户分区（共享/无用户分区为空字符串）。旧版本创建的表会被拒绝并抛出 SchemaOutdatedError，重键不会自动执行。若在使用 DbFileSystem，需在应用停止状态下，用来源给出的对应数据库迁移脚本升级一次（PostgreSQL 或 SQLite）。该表由 DbFileSystem 自行管理，因此不在 MigrationManager 范围内。
• MCPConfig(tools=[...]) 现在只发布显式列出的工具，default_tools 与 lifecycle_tools 默认均为 False；此前 tools=[...] 配置还会附带内置默认工具及生命周期工具。

缺陷修复

版本同时修复多项问题，包括人工介入（HITL）在后台加流式续跑时重复记录暂停运行、OpenAIResponses 链式响应丢失后的恢复、异步删除失败与记录不存在的区分、结构化输出在 JSON 片段先出现标量时的崩溃、Python 工具结果为 None 与变量缺失的区分、分块重叠不小于块大小时的拒绝、CSV 对 CR 行尾与显式零行数限制的处理、shell/工作区工具的显式零 tail、GeminiTools 视频字节留存、GithubTools 分支链接与 UTF-8 文本、LocalFileSystemTools 的 UTF-8 读写、PubMed 短摘要元数据及 Claude 引用中可空文档标题等。

限制与待核实

以上内容均来自发布说明，未在本地运行验证，具体升级步骤与脚本路径需以官方迁移脚本为准。