查看智能体实例状态并处理配置不同步
智能体实例状态表示实例当前是否已经启动;配置更新提示表示实例是否需要应用智能体模板的最新配置。这两个状态需要分别处理。
根据实例状态开始调用
实例长时间未使用或被重启后,可能重新显示为 待启动。再次使用时,平台会按需启动它;首次连接可能需要稍等。
打开 智能体实例,找到要检查的实例。
检查实例当前状态:
- 待启动:实例已经创建,当前尚未启动。打开 网页版对话,或通过已配置的 API、渠道使用实例时,平台会按需启动它。
- 运行中:实例已经启动,可以处理通过已配置访问方式进入的调用。
通过计划使用的 网页版对话、API 或渠道发起一次无副作用的测试调用,并检查结果:
- 通过回复、Trace 或调用任务状态,判断本次对话、工具调用或后台任务是否正在执行或已经完成。
- 调用失败,并且刷新实例列表后仍显示 待启动 时,检查模型凭证、能力参数、沙箱资源和渠道绑定。参见排查智能体实例运行问题。
- 仍无法定位时,向平台管理员提供实例 ID、发生时间和页面错误信息以继续排查。
处理模板更新提示
如果列表显示 智能体模板更新,实例需手动更新,说明来源智能体模板已经更新,但实例仍使用原配置。
- 先在测试实例验证新的智能体模板配置。
- 打开目标实例,选择 编辑。
- 检查实例参数,以及需要保留的能力实例配置。更新可能覆盖模板生成资源上的单独修改,参见更新智能体模板和实例。
- 选择 保存修改,使实例使用最新智能体模板配置。
- 使用 网页版对话、API 和 Trace 完成验证。
区分共享资源变化
即使实例未显示配置不同步,修改共享 MCP、知识库组、记忆库或技能组实例仍可能影响引用它们的智能体实例。
生产清单应同时记录智能体模板配置同步状态以及共享能力的版本或更新时间。
暂停和恢复智能体实例访问
暂停访问、执行维护或回退时,先在调用方停止发送新请求,再按影响范围处理:
- 停用或轮换受影响的 WebSocket Token。
- 停用或改绑渠道账号;同账号的其他客户端也会受影响。
- 核对正在执行的请求和待处理中断,必要时取消运行。
- 需要立即结束现有 WebSocket 连接时,单独确认连接已关闭,不能只看 Token 状态。
恢复服务前,用替代凭证完成一次无副作用的真实调用,再恢复业务流量。参见轮换凭证并撤销访问。
删除实例前完成清理
删除智能体实例前:
- 停止 API 和渠道流量。
- 停用并删除 Token。
- 检查渠道用户绑定。
- 记录或处理活动调用任务。
- 盘点专属与共享能力资源。
- 确认外部系统不再保存该实例的访问配置。
删除操作只移除所选智能体实例,不会同时删除共享能力、知识库集合或外部服务数据;请分别盘点并处理这些资源。