Xagent v0.8.2
全新 V2 执行事件体系与任务暂停/自动恢复，知识库引入 Milvus 引擎，新会话等连接器输入填齐再发送，新增 Bedrock Converse 运行时与可配置的执行 token 预算
📅 发布日期：2026 年 10 月 10 日
🔄 更新方式
cd xagent && git pull
docker compose up -d
pip install --upgrade xagent-ai
✅ 本次亮点
V2 执行事件
执行、模型上下文与任务展示统一基于执行事件构建，并可从事件事实恢复。
暂停与自动恢复
遇到持久化或模型故障时暂停而非失败，并可按策略自动续跑。
Milvus 知识库
Milvus 引擎支持检索、删除、重命名与回滚，可作为 docker-compose 附加组件部署。
🚀 核心更新
🧱 V2 执行事件体系
接入执行事件写入器并确立读取契约；V2 执行可从事件事实恢复，模型上下文与任务展示均改为基于执行事件构建，上下文读取限定在最新摘要之后。
⏸️ 任务中断与自动恢复
运行失败按中断原因归类；遇到持久化失败或模型 provider 持续不可用时暂停而非直接失败；任务 API 与事件暴露中断状态；新增任务自动恢复的配置项、自动续跑策略与资格规则。
🗄️ Milvus 知识库引擎
每个部署锁定一种 KB 引擎；新增 Milvus 集合句柄，支持按文档提交向量（带可见性标记）、检索、删除、重命名与回滚；Milvus 可作为 docker-compose 附加组件一键部署。
🔌 连接器运行时输入检查
打开会话时检查连接器所需的运行时输入；新会话的首条消息会等连接器输入填齐后再发送；可在 Tools 页的编辑对话框中删除自定义连接器。
📁 连接器能力增强
Google Drive 新增文件移动工具、Picker 授权流程与原地替换文件内容；OneDrive 新增移动工具；Jira 新增附件上传工具；HubSpot 迁移到托管 MCP；连接器下载的文件改为持久化引用。
🤖 模型与运行时
新增原生 Bedrock Converse 运行时；provider 注册表声明 Azure OpenAI 与路由模型 id；新增安全的 provider 调用边界与任务级模型覆盖；OpenAI 兼容 provider 故障抛出类型化的 ModelProviderError；支持 Claude 兼容的模型配置。
💰 可配置的执行 token 预算
可为执行设置 token 预算，控制单次任务的消耗上限。
🧠 持久记忆与上下文
启用重新设计的持久记忆生命周期；上下文压缩时列出已存储的工具结果；按调用持久化工具身份；模型生成的表单被回答后可继续执行。
🧹 数据保留
v1 API 上报已过期的任务，内部界面显示过期任务，并新增按团队覆盖保留期的扩展点。
🔐 OAuth 与权限
Google 审核相关权限范围加门控；支持按账号配置授权与令牌端点；所有内置 Microsoft 连接器统一请求 offline_access，OneDrive、Outlook、Teams 要求应用级授权。
🛠️ 构建与交互体验
Agent Builder 保留预览历史并可重跑样例；澄清表单提供建议与分页；失败的任务消息与渠道失败回复附带任务 id；新增可直接运行的 Parallel Search MCP 示例。
🛠 稳定性与体验优化
- Trace：llm_call_end 记录 finish_reason 与 usage_missing
- 模型：OpenAI 兼容流长时间无进展时主动中止
- 为上传清理的处置过程设置上限
- Agent：V2 上下文读取跳过结算类 agent 结果，并按事件 id 查找锚点
- 知识库：通过句柄删除文档，补全 KBCollectionHandle 并增加契约测试，通过引擎读取集合与文档统计
- 保留 Gemini 图像输入的 token 模态
- 厘清连接器访问说明，并在鉴权失败时暂停
- 知识库：集合删除按精确目录前缀匹配行；删除集合时保留其目录下仍被引用的文件
- A2A：取消接口返回已取消状态
- Web：修复暂停先于记录发生时的暂停结算
- 记忆：不再把用户请求原文复制进记忆笔记元数据
- 工具：read_tool_result 分页不超过工具输出上限
- 知识库：主指针时间戳截断到毫秒
- 模型：OpenAICompatibleLLM 请求构建器应用 default_max_tokens
- 工具：知识库编辑工具不再挂载到聊天 agent
- 暴露实际生效的 MCP 运行时参数绑定
- 模型：显式凭据、严格的目录读取与智谱 SDK 线程上下文
- 进入准入队列的 SDK 回复正确确认为已排队
- 任务附件解绑以原子方式记录
- Web：准入容量按活跃执行计算；跨执行通道保留可运行的准入队首；任务继续运行时释放已排空实例的准入票据
- 按任务状态跟踪 builder 预览完成
- MCP：OAuth 运行时诊断中脱敏 resource/issuer
- MCP：用回收被放弃的握手替代每服务器初始化上限
- 防止 SQLite 任务身份被复用
- 保留语义任务与渠道任务的完成结果
- OAuth：为 Microsoft 连接器提供可转发的管理员同意链接
- Deputy：确认更新后的记录可读再报告成功
- 移除 Google Slides 空白页，并支持导入带设计的 PPTX
- 知识库：稀疏子串回退检索应用调用方范围
- 表格预览显示未缓存的公式，并清理预览 HTML
- MCP：为上传类连接器暂存持久文件
- Excel：新增可靠的有界行查询，以及用于结构化删行的 excel_delete_rows
- 厘清 Agent Builder 完成与聊天交接
- 缓存淘汰后保留已登记的上传路径；上传失败后恢复 builder 预览
- Agent：先单独获取最新恢复状态，再分页读取较早的状态
- 防止知识库引用被上传清理认领；完成可恢复的文件清理（2B）
- 聊天中保留失败的 DAG 步骤结果
- Jira：jira_search_issues 截断分页时附加续读提示
- 避免任务历史中出现重复的澄清文本
- Agent：归类 V2 运行中的持久化失败，并对账丢失的 finalize 确认
- Web：任务命令派发多次失败后退避；任务所有者取消命令时保持命令派发器运行
- PowerPoint：写入结果不再返回原始 driveItem
- 日历：日历事件附带 Zoom 入会链接，并新增 zoom_create_meeting
- 将执行预算设置移到账户设置下方
- Google：说明无法访问的文件与失败的 Drive 移动，以及存储在 Drive 中的 Office 文件如何打开
- MCP：仅有授权被应用级策略拒绝的 OAuth 服务器显示为需重新连接
- OneDrive：去掉 drive item 中所有预鉴权下载 URL；路径未命中时给出说明且不再转发 Graph 错误正文；空搜索引导到文件夹列表，Office 文件优先原地编辑
- OAuth：内置 OAuth 服务器接受目录来源标记；actor OAuth 回调错误可直接处理
- Agent：基于已提交的步骤状态构建 DAG 检查点载荷
- 连接器：拒绝折叠后与已有连接器或目录应用重名的名称
- MCP：上传路径被拒时引导 agent 改用 file:
- Web：外部取消的终止帧标记为中断；向任务流消费者暴露模型 provider 故障
- 知识库：已摄取文档在集合统计中只计一次
- Jobs：在子进程中运行 Celery 引擎检查
- Agent：不再重发在输出上限处被截断的工具调用
- Web：将续跑后的运行结果投射到触发运行上
- 知识库：一系列内部重构，失败摄取的清理决策与状态快照统一交给门面与句柄处理
- CI：为每个测试设置超时，避免挂起的测试拖住流水线
- compose 镜像升级至 0.8.1