실행 가능한 오류 작성

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

우리가 채팅 앱 오류를 떠올릴 때 우리는 영화 2001: 스페이스 오디세이의 악명 높은 오류 메시지 HAL 9000을 생각하게 될 것입니다. 안타깝지만 그렇게 할 수 없는 일입니다. 즐거운 영화관, 짜증나는 채팅 앱 상호작용 대신 HAL은 실행 가능한 오류 메시지로 응답해야 합니다.

작업 가능한 오류 메시지는 사용자에게 목표를 향해 이동하는 방법을 알려줍니다. 스페이스 헬멧 누락과 같은 다른 오류가 발생하지 않도록 하는 것이 좋습니다.

오류 메시지 구조

실행 가능한 오류 메시지는 다음과 같이 구성됩니다.

  • 문제 채팅 앱이 요청을 완료할 수 없는 이유를 설명하면 사용자가 문제를 해결하는 데 도움이 됩니다. 오류가 발생한 이유를 설명하면 신뢰가 쌓일 수 있습니다.
  • 사용자가 목표를 향해 나아가는 방법 단지 무엇이 잘못되었는지 말로 답하기는 어렵습니다. 사용자에게 어떻게 해야 오류를 넘기고 목표를 달성할 수 있는지 설명합니다.
  • 도움을 받는 방법 사용자가 여전히 문제를 해결할 수 있는 경우 추가 지원을 받을 수 있는 방법을 안내합니다. /help 명령어 또는 Chat 앱 문서 링크일 수 있습니다.

오류 메시지 예

몇 가지 오류 메시지를 살펴보겠습니다. 이러한 각 오류 메시지는 실행 가능한 오류와 조치를 취할 수 없는 오류로 작성됩니다.

오류 메시지 예: 잘못된 날짜 형식

사용자가 날짜 형식을 잘못 입력했습니다. November 19, 2021를 작성했지만 앱은 2021-11-19를 예상합니다.

다음은 앱이 응답하는 오류 메시지의 실행 가능한 버전과 비활성 버전입니다.

조치 가능한 오류

앱은 실행 가능하고 괜찮은 오류 메시지로 응답합니다.

입력한 날짜 형식을 알 수 없습니다. 날짜를 yyyy-mm-dd로 작성합니다(예: 2000-01-31). 도움이 필요하면 /help를 입력합니다.

사용자에게 발생한 문제, 진행 방법, 도움을 받는 방법을 설명하는 오류 메시지의 예

이 오류 메시지는 다음과 같은 이유로 실행 가능합니다.

  • 문제를 설명합니다. 앱에서 날짜 형식을 인식할 수 없습니다.
  • 사용자에게 예상 날짜 형식을 안내하여 오류를 해결하는 방법을 설명합니다. 날짜 형식은 기술적인 정보이므로 사용자가 작성할 내용을 이해하는 데 도움이 되는 날짜 예시를 제공합니다.
  • /help 명령어에 대한 추가 도움말을 제공합니다. 사용자가 여전히 문제를 파악할 수 있다면 자세한 내용을 알아볼 수 있습니다.

실행할 수 없는 오류

앱이 도움이 되지 않으며 실행할 수 없는 오류 메시지로 응답합니다.

올바른 날짜 형식을 입력하세요.

활용 가능한 정보를 제공하지 않는 오류 메시지의 예

이 오류 메시지는 다음 작업을 실행하지 않기 때문에 실행할 수 없습니다.

  • 회의가 예약되지 않았다고 말합니다. 사용자는 회의 일정 변경을 주저하거나 회의가 예약되었다고 가정할 수 있습니다.
  • 사용자에게 날짜 형식을 지정하는 방법을 안내합니다. 사용자가 날짜 형식을 지정하는 방법을 알고 있다고 가정하지 않고 날짜 형식을 yyyy-mm-dd으로 예상해야 합니다.
  • 추가 지원 제공 사용자가 작업을 진행할 수 없는 상태에서 중단하는 경우 앱 메시지 전송을 중지할 수 있습니다.

이제 오류 메시지를 생각해 보세요. 실행 가능한 행동인가요? Chat 앱을 사용해 본 적이 없는 사용자가 오류 메시지를 읽은 경우 계속 진행하여 목표를 달성할 수 있나요?

사용해 보기

이제 실행 가능한 오류를 작성하는 방법을 알게 되었으니 조치 가능한 오류를 파악할 수 있을까요?

시나리오:

사용자가 schedule 키워드를 사용하여 앱에 메시지를 보내면 스케줄러 앱에서 캘린더 일정을 만듭니다. 캘린더 일정을 만들려면 스케줄러에 사용자 인증이 필요합니다. 사용자가 인증되지 않은 경우 스케줄러 앱이 오류 메시지로 응답합니다.

다음 중 실행 가능한 오류 메시지는 무엇인가요?
회의 일정을 예약하려면 /login을(를) 입력하여 로그인해야 합니다. 자세히 알아보려면 /help를 입력하세요.
이 오류 메시지는 다음과 같은 이유로 실행 가능합니다.
  • 문제: 앱에 인증이 필요합니다.
  • 진행 방법: 인증하려면 /login를 입력하세요.
  • 도움을 받는 방법: 사용자가 추가 정보를 원하면 /help를 입력합니다.
인증해야 합니다.
이 오류 메시지는 인증 방법을 알려주지 않으므로 작동하지 않습니다.
로그인합니다.
이 오류 메시지는 로그인 방법을 말하지 않고, 사용자가 명료하게 말하지 않고 로그아웃되었다는 의미이므로 혼동을 일으킬 수 있습니다.
회의 일정을 예약할 수 없습니다.
이 오류 메시지는 사용자에게 회의를 예약할 수 없는 이유 또는 사용자의 진행 방법을 알려주지 않으므로 작동하지 않습니다. 도움이 되지 않습니다.