故障排查
运行失败
如何在历史记录中找到失败的运行、读取其错误信息并解决常见原因。
当某个步骤无法完成时,运行就会失败:工具报错、应用未连接、工作区没有额度,或者套餐不允许某个步骤。每次运行都会被保存,因此你可以在事后查看发生了什么。
症状#
- 智能体中途停止,或给出空泛、笼统的回答。
- 工作流提前结束,或者批次中的某一行显示 失败。
- 定时运行没有执行任何操作。
- 点击发布后看到错误横幅,例如 “Validation failed. Please fix the errors highlighted on the components.”
在历史记录中找到该运行#
- 点击侧边栏中的 历史记录。
- 打开 错误消息 筛选器,只列出包含错误的会话。你还可以按 智能体或工作流 以及按聊天机器人进行筛选。
- 打开一个会话。使用 简洁 或 详细 来改变你看到的细节程度。
- 向下阅读各事件。它们分别标记为 用户消息、聊天机器人输出、系统消息、聊天钩子、工具调用 和 智能体查询。查看 工具调用 事件,找到报告错误的那个。
表格上方的指标面板(显示指标)会绘制 错误总数 随时间的变化。你的套餐会限制历史记录可以回溯的时间范围。请参阅套餐与限制。对于批次运行,表格包含 状态 和 错误 列,并且 重新运行失败项 或 重试行 会重新运行失败的行。
常见错误及解决方法#
| 你看到的内容 | 原因 | 解决方法 |
|---|---|---|
| “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.” | 某个步骤缺少必需的设置 | 修复被标出的步骤,然后再次发布 |
定时运行#
如果工作区额度用尽,系统会关闭定时任务,而不是永远重试。打开它,并在你有额度后重新启用。请参阅定时任务。
修复它#
- 找到失败的会话并复制确切的错误信息。
- 将其与表格中的条目对应,应用解决方法,然后用相同的输入再次运行。
- 如果错误来自外部服务且你无法判断原因,请在画布上单独测试该步骤。请参阅测试与运行日志。
See what a run cost
如果你不确定某次运行花费了多少,请查看 交易记录。每笔扣费都会列出其类型和上下文。请参阅额度。