停用智能体访问并清理资源
维护期间需要暂时停止服务时,先停新请求,处理在途运行,再撤销相应的访问。保留实例、渠道和需要恢复的配置,按恢复服务重新接入。永久下线时,继续清理专属资源并核对数据去向。
只需下线单个客户端或渠道用户时,直接按撤销访问处理对应的凭证或消息来源。停用整个渠道账号会影响该账号下的所有客户端或渠道用户。
停止新请求并处理在途运行
- 按 ID 找到要停用的实例。核对实际使用的渠道账号、用户绑定、API 客户端和定时任务。渠道账号或插件被其他实例共用时,先确认会受影响的使用者。
- 让 API 调用方暂停提交,并通知渠道用户结束手上的会话,暂停发送新消息。暂停该实例关联的定时任务,以停止后续触发。
- 等待正在处理的请求完成,或在撤销凭证前按取消和恢复运行取消仍在执行的 API 运行。用 Trace 和外部业务记录核对审批、定时任务和工具写入的结果,再决定是否需要在业务系统中撤回或补救。必须立即阻止新请求时,先撤销访问,再通过可用记录核对已提交的运行。
撤销访问并核对连接
永久下线前,先确认哪些会话或附件还需要通过现有入口留存或清理。要通过渠道的当前会话命令处理历史时,在停用渠道前完成这项操作。
- WebSocket 客户端。让客户端关闭旧连接,再停用对应 Token。分别核对旧连接已关闭、旧 Token 的 HTTP 请求和新建握手已被拒绝。需要立即停止整个账号的访问时,按停用或删除渠道账号处理。
- 飞书或 QQ 用户。按需要调整消息接收范围或停用渠道。仅删除用户绑定会让该用户重新进入初始化流程,原智能体实例依然保留。要断开接入,先限制消息来源,再处理用户绑定。
- 团队成员。需要回收资源管理权限时,按撤销一条授权处理。将成员授权和调用方的凭证分别核对。
使用调用方记录、渠道状态与一次无副作用的访问检查,确认已停用的入口不再接收请求。
恢复服务
- 确认原实例、绑定目标和依赖资源仍能使用。在恢复账号前,先核对准备恢复的渠道用户和客户端凭证。
- 启用需要恢复的渠道与凭证,重新连接并完成一次无副作用的调用。确认回复来自预期实例后,再恢复业务请求和需要继续运行的定时任务。
清理专属资源
- 核对待下线的实例和能力资源 ID,记录仍需保留的配置、会话与业务数据。需要恢复的文件保存到已批准的外部存储,并从存储端读回确认。共享资源先检查其余引用,再决定是否移除实例上的关联。
- 在删除实例前,通过仍可访问的入口处理需要清理的会话和附件。渠道当前会话按管理渠道会话处理。按相应业务系统的留存要求决定是否清理飞书或 QQ 中的原始消息。
- 删除专属定时任务、Token、用户绑定和已停用的渠道账号。分别回查任务、凭证和渠道列表,确认操作作用于预期的记录。保留其余调用方仍在使用的渠道和凭证。
- 在 智能体实例 列表按完整 ID 查找并删除目标实例,再按 ID 搜索确认结果。删除沙箱实例或共享规格前,按安全修改或删除沙箱检查引用。需要删除记忆时,按删除记忆或记忆库核对条目和库的范围。
核对记录和数据去向
在控制台按 ID 回查,记录已经删除的实例、渠道、凭证和任务。会话历史、附件、外部数据与运行记录按各自入口另行确认。
- 会话和历史。分别核对渠道绑定、当前会话和历史。需要删除的历史在控制台没有相应入口时,请向平台支持提供实例、渠道和会话标识,由支持方确认可用的处理方式及保留范围。
- 文件和挂载。上传链接失效后,向负责存储的团队确认对象是否已删除。沙箱工作目录的回收取决于运行环境,共享挂载中的数据按存储所有者的生命周期规则处理。
- 运行记录和外部动作。向记录所有者确认定时任务运行记录、Trace 和服务日志的留存要求。外部系统中的工单、消息和写入结果,需要在对应系统核对。
清理记录应包含资源 ID、核对结果和仍需处理的数据。需要平台支持时,按提交故障信息准备相关标识和发生时间。