Skip to content

查看智能体实例状态并处理配置不同步

智能体实例状态表示实例当前是否已经启动;配置更新提示表示实例是否需要应用智能体模板的最新配置。这两个状态需要分别处理。

根据实例状态开始调用

智能体实例 中检查:

  • 待启动:实例已经创建,当前尚未启动。打开 Playground,或通过已开启的 API、渠道使用实例时,平台会按需启动它。
  • 运行中:实例已经启动,可以处理通过已配置访问方式进入的调用。

实例长时间未使用或被重启后,可能重新显示为 待启动。再次使用时,平台会按需启动它;首次连接可能需要稍等。要判断一次对话、工具调用或后台任务是否正在执行或已经完成,请检查回复、Trace 或调用任务状态。

先通过计划使用的 Playground、API 或渠道发起一次无副作用的测试调用。调用失败,并且刷新实例列表后仍显示 待启动 时,再检查模型凭证、能力参数、沙箱资源和渠道绑定;仍无法定位时,向平台管理员提供实例 ID、发生时间和页面错误信息以继续排查。参见排查智能体实例运行问题

处理模板更新提示

如果列表显示 智能体模板更新,实例需手动更新,说明来源智能体模板已经更新,但实例仍使用原配置。

  1. 先在测试实例验证新的智能体模板配置。
  2. 打开目标实例,选择 编辑
  3. 检查实例可配置参数。
  4. 选择 保存修改,使实例使用最新智能体模板配置。
  5. 使用 Playground、API 和 Trace 完成验证。

区分共享资源变化

即使实例未显示配置不同步,修改共享 MCP、知识库组、记忆库或技能组实例仍可能影响引用它们的智能体实例。

生产清单应同时记录智能体模板配置同步状态以及共享能力的版本或更新时间。

暂停和恢复智能体实例访问

暂停访问、执行维护或进行回退时,需要组合使用 API 调用状态、Token、渠道账号和调用方流量控制。

需要停止业务访问时:

  • 关闭智能体实例的 API 调用状态。这会同时停用该实例已有的所有 Agent API Token。
  • 按调用方需要停用、轮换或删除 Token。
  • 停止或改绑渠道账号。
  • 在调用方停止发送流量。

恢复 API 访问时,先重新开启 API 调用状态,再启用原 Agent API Token 或创建替代 Token。重新开启开关本身不会恢复这些 Token;完成一次真实调用测试后再恢复业务流量。

删除实例前完成清理

删除智能体实例前:

  • 停止 API 和渠道流量。
  • 停用并删除 Token。
  • 检查渠道用户绑定。
  • 记录或处理活动调用任务。
  • 盘点专属与共享能力资源。
  • 确认外部系统不再保存该实例的访问配置。

删除操作只移除所选智能体实例,不会同时删除共享能力、知识库集合或外部服务数据;请分别盘点并处理这些资源。