故障排查

智能体没有响应

当智能体或聊天机器人保持沉默、显示错误信息或给出笼统回复时该检查什么。

智能体可能无法在构建器的测试聊天中、你网站上的聊天机器人中或通过 API 作答。原因几乎总是以下检查项之一。请按顺序往下排查,因为排在最前面的原因最常见,也最容易排除。

症状#

  • 你发送了一条消息,却没有任何回复。
  • 聊天界面显示的是错误,而不是回答。
  • 聊天机器人的访客看到 “Oops! Something went wrong. Please contact website owner!”

可能的原因(按顺序)#

1. 工作区积分耗尽#

没有积分,智能体就无法运行。请留意 只读模式 提示,并查看侧边栏底部的积分数量。调用 API 的用户会收到 “Insufficient credits to perform this action. Please recharge your credits."。聊天机器人的访客则会看到 “Sorry, you’ve reached your payment limit."。参见积分耗尽。

2. 订阅已结束或工作区处于只读状态#

如果套餐已被取消,工作区将处于非活跃状态,运行会被拒绝,并提示 “This workspace is inactive because its subscription ended."。只有所有者才能重新选择套餐。

3. 智能体需要的某个应用未连接#

如果某个工具需要你尚未连接的账户,你会看到诸如 “Slack integration is required, but was not found” 或 “Component is not integrated” 的警告,并且运行到该工具时会失败,提示 “is not configured. Please set up the integration first."。打开 集成 并连接它。参见集成已断开。

4. 开启了记忆但未选择类别#

在智能体构建器中,记忆 需要选择一个类别。构建器会警告 “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked."。请在 高级 下选择一个类别,或关闭记忆。参见记忆与聊天历史。

5. 更改已保存但未发布#

编辑内容会保存为草稿。在你点击 发布更改 之前,使用线上智能体的人(包括你网站上的聊天机器人)看到的仍是上一个已发布的版本。在此之前,触发器会显示 “Publish to activate”。参见分享与发布。

6. 聊天机器人已关闭或受到速率限制#

在 聊天机器人 中,打开该聊天机器人并检查 启用聊天机器人 是否已开启。发送过多消息的访客会看到 “Too many requests. Please try again later or sign in to continue."。相关限制位于聊天机器人设置中的 速率限制 下。

7. 某个步骤或工具失败了#

即使模型本身工作正常,智能体中的某个工具或步骤也可能失败。打开 历史记录,找到该会话,开启 错误消息 筛选器,然后阅读失败的事件。参见运行失败。

修复方法#

  1. 在构建器的聊天中发送一条简短的测试消息,并记下任何错误的确切文本。
  2. 将该文本与上面的列表对应起来,并应用相应的修复方法。
  3. 如果你做了任何更改,请发布,然后从出现故障的地方(例如你的网站)重新测试。

在出故障的地方测试

请在用户遇到问题的同一个地方复现该问题,无论是测试聊天、你网站上的聊天机器人还是 API 调用。每种方式都有自己的设置,聊天机器人还有自己的速率限制。