故障排查

运行失败

如何在历史记录中找到失败的运行、读取其错误信息并解决常见原因。

当某个步骤无法完成时,运行就会失败:工具报错、应用未连接、工作区没有额度,或者套餐不允许某个步骤。每次运行都会被保存,因此你可以在事后查看发生了什么。

症状#

  • 智能体中途停止,或给出空泛、笼统的回答。
  • 工作流提前结束,或者批次中的某一行显示 失败。
  • 定时运行没有执行任何操作。
  • 点击发布后看到错误横幅,例如 “Validation failed. Please fix the errors highlighted on the components.”

在历史记录中找到该运行#

  1. 点击侧边栏中的 历史记录。
  2. 打开 错误消息 筛选器,只列出包含错误的会话。你还可以按 智能体或工作流 以及按聊天机器人进行筛选。
  3. 打开一个会话。使用 简洁 或 详细 来改变你看到的细节程度。
  4. 向下阅读各事件。它们分别标记为 用户消息、聊天机器人输出、系统消息、聊天钩子、工具调用 和 智能体查询。查看 工具调用 事件,找到报告错误的那个。

表格上方的指标面板(显示指标)会绘制 错误总数 随时间的变化。你的套餐会限制历史记录可以回溯的时间范围。请参阅套餐与限制。对于批次运行,表格包含 状态 和 错误 列,并且 重新运行失败项 或 重试行 会重新运行失败的行。

常见错误及解决方法#

你看到的内容原因解决方法
“Insufficient credits to perform this action. Please recharge your credits.”余额为空额度不足
“Workspace credit limit reached”工作区的支出上限在 设置 → 额度 中提高上限
“NAME is not configured. Please set up the integration first.”该步骤需要一个未连接的应用在 集成 中连接它
“…is connected but is missing the permissions it requires. Please reconnect the integration and grant the additional permissions.”该连接缺少某项权限重新连接并接受所有权限
“…requires re-authorization. The refresh token is expired or revoked. Please reconnect the integration.”登录已过期或被撤销重新连接该账户
“Component NAME can only be used with … plan”该步骤不在你的套餐中替换该步骤或升级
“Allowed limit of … reached. Please upgrade your plan.”你在创建内容时达到了套餐上限删除一项或升级
“Validation failed. Please fix the errors highlighted on the components.”某个步骤缺少必需的设置修复被标出的步骤,然后再次发布

定时运行#

如果工作区额度用尽,系统会关闭定时任务,而不是永远重试。打开它,并在你有额度后重新启用。请参阅定时任务。

修复它#

  1. 找到失败的会话并复制确切的错误信息。
  2. 将其与表格中的条目对应,应用解决方法,然后用相同的输入再次运行。
  3. 如果错误来自外部服务且你无法判断原因,请在画布上单独测试该步骤。请参阅测试与运行日志。

See what a run cost

如果你不确定某次运行花费了多少,请查看 交易记录。每笔扣费都会列出其类型和上下文。请参阅额度。