查看智能体实例状态并处理配置不同步
智能体实例状态表示是否可以接受调用;配置更新提示表示实例是否需要应用智能体模板的最新配置。这两个状态需要分别处理。
判断实例是否可以调用
在 智能体实例 中检查:
- 待启动:实例创建和启动流程尚未完成。
- 运行中:实例可以接受调用。
只有运行中的实例才适合进入 Playground 或接收生产调用。长时间停留在待启动时,检查模型凭证、能力参数、沙箱资源和渠道绑定;仍无法定位时,向平台管理员提供实例 ID、发生时间和页面错误信息以继续排查。
处理模板更新提示
如果列表显示 智能体模板更新,实例需手动更新,说明来源智能体模板已经更新,但实例仍使用原配置。
- 先在测试实例验证新的智能体模板配置。
- 打开目标实例,选择 编辑。
- 检查实例可配置参数。
- 选择 保存修改,使实例使用最新智能体模板配置。
- 使用 Playground、API 和 Trace 完成验证。
区分共享资源变化
即使实例未显示配置不同步,修改共享 MCP、知识库组、记忆库或技能组实例仍可能影响引用它们的智能体实例。
生产清单应同时记录智能体模板配置同步状态以及共享能力的版本或更新时间。
暂停和恢复智能体实例访问
暂停访问、执行维护或进行回退时,需要组合使用 API 调用状态、Token、渠道账号和调用方流量控制。
需要停止业务访问时:
- 关闭智能体实例的 API 调用状态。这会同时停用该实例已有的所有 Agent API Token。
- 按调用方需要停用、轮换或删除 Token。
- 停止或改绑渠道账号。
- 在调用方停止发送流量。
恢复 API 访问时,先重新开启 API 调用状态,再启用原 Agent API Token 或创建替代 Token。重新开启开关本身不会恢复这些 Token;完成一次真实调用测试后再恢复业务流量。
删除实例前完成清理
删除智能体实例前:
- 停止 API 和渠道流量。
- 停用并删除 Token。
- 检查渠道用户绑定。
- 记录或处理活动调用任务。
- 盘点专属与共享能力资源。
- 确认外部系统不再保存该实例的访问配置。
删除操作只移除所选智能体实例,不会同时删除共享能力、知识库集合或外部服务数据;请分别盘点并处理这些资源。