撰写切实可行的错误消息

本页介绍了编写切实可行的错误消息的最佳实践,以告知用户如何解决问题以达成目标。

当用户与 Google Chat 应用互动时,如果遇到无法解决的错误消息,可能会让人感到沮丧。例如,错误消息 An error occurred 没有用,因为该消息未说明出了什么问题、用户如何解决问题或用户如何获取帮助。本页通过展示切实可行且不可操作的示例来介绍如何设计错误消息的结构,使其对用户有用。

错误消息结构

可操作错误消息的结构如下:

  • 哪里出错了。说明 Chat 应用无法完成请求的原因有助于用户解决问题。说明发生错误的原因,从而建立信任。
  • 用户可以如何实现目标。仅仅说错误是不够的告诉用户如何才能越过错误并实现目标。
  • 如何获取帮助。如果用户仍然遇到困难,请告诉他们如何获取更多帮助。这可以是 /help 命令,也可以是指向 Chat 应用相关文档的链接。

错误消息示例:日期格式不正确

在此示例中,用户以 Chat 应用没有预料的格式输入了日期。他们编写了 November 19, 2021,但 Chat 应用要求使用 2021-11-19

以下是 Chat 应用响应的错误消息的可操作版本和不可操作版本:

可操作的错误

用户要求 Chat 应用安排与其他人的会议。Chat 应用会返回一条实用的错误消息:

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

告诉用户出了什么问题、如何继续操作以及如何获取帮助的示例错误消息。

此错误消息具有可操作性,原因如下:

  • 说明问题所在。Chat 应用无法识别日期格式。
  • 通过告知用户预期的日期格式来说明如何修复错误,并提供一个示例日期,帮助用户了解要写什么。
  • 使用 /help 斜杠命令提供更多帮助。如果用户仍然遇到困难,就会知道如何了解更多信息。

不可处理的错误

用户要求 Chat 应用安排与其他人的会议。Chat 应用会返回一条没有帮助且无法采取任何措施的错误消息:

Enter the correct date format.

未提供可操作信息的错误消息示例。

此错误消息无法处理,原因如下:

  • 没有说明是否已安排了会议。用户可能会犹豫是否要重新安排会议,或者认为会议已经安排好了。
  • 不告知用户如何设置日期格式。您应说明希望使用日期格式 yyyy-mm-dd,而不是假定用户知道如何设置日期格式。
  • 不会提供更多帮助。当用户遇到困难且不知道如何继续操作时,可能会停止向 Chat 应用发送消息。

试试看

现在,您已经知道如何编写可操作的错误,接下来您能确定在以下场景中哪些错误是可操作的:

当用户向 Chat 应用发送包含关键字 schedule 的消息时,Chat 应用会创建日历活动。如需创建日历活动,Chat 应用需要用户身份验证。如果用户未经过身份验证,Chat 应用会返回错误消息。

哪条错误消息是可处理的?
你必须先输入“/signin”登录,然后我才能安排会议。如需了解详情,请输入“/help”。
此错误消息的内容如下,因此可以采取措施:
  • 哪里出错了。Chat 应用要求进行身份验证。
  • 如何继续操作。输入 /signin 以进行身份验证。
  • 如何获取帮助。如果用户想要了解更多信息,可以输入 /help
您必须进行身份验证。
此错误消息没有说明如何进行身份验证,因此无法处理。
登录。
此错误消息无法执行操作,因为它没有说明如何登录,并且暗示用户已退出登录,而没有明确说明已退出,这就令人感到困惑。
无法安排会议。
此错误消息无法操作,因为它未告知用户无法安排会议的原因或用户如何继续。未提供任何帮助。