상태 점검

Google은 배포된 작업을 모니터링하여 작업이 사용 가능한지 확인하고 사용자 요청에 응답합니다.

각 작업의 엔드포인트는 매개변수 호출 없는 기본값에 응답해야 합니다. 이는 사용자가 추가 정보를 제공하지 않고 작업과의 대화를 요청하는 시나리오를 지원합니다 (예: "호출 이름과 통신하고 싶어요").

자주 하는 질문

상태 점검을 지원하려면 특별히 구현해야 하는 것이 있나요?

아니요. 작업 상태 확인은 작업과 통신하기 위한 표준 요청처럼 작동합니다.

작업의 상태는 얼마나 자주 확인되나요?

작업이 하루 종일 모니터링될 수 있습니다.

요청이 상태 점검인지 어떻게 알 수 있나요?

Actions Builder를 개발 플랫폼으로 사용하면 아래 스니펫과 비슷한 상태 확인 요청을 받게 됩니다.

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}
  

이 요청을 받으면 응답 코드 200으로 응답해야 합니다. 그러지 않으면 작업이 비정상으로 간주됩니다. 다음 스니펫은 올바른 형식의 응답의 예입니다.

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

Dialogflow를 개발 플랫폼으로 사용하는 경우 Google은 "is_health_check" 인수를 추가하고 이를 인텐트에 전달합니다. 이 인수는 웹훅 요청의 Input 객체에서 찾을 수 있습니다.

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}
  

Google에서 비정상 작업을 감지하면 어떻게 되나요? Google에서 작업에 중단이 발생한 것을 감지하면 작업이 정지됩니다. 비정상 작업을 요청하는 사용자에게는 'ACTION_NAME을(를) 사용할 수 없음'이라는 음성이 나옵니다.

작업이 비정상으로 표시되면 어떻게 알림을 받나요? Google에서 비정상 작업을 감지하면 작업 프로젝트와 연결된 기본 개발자에게 알림 이메일을 전송합니다.

계정 연결을 사용하는 작업이 비정상으로 표시되면 어떻게 되나요? 다른 작업과 달리 계정 연결을 사용하는 작업은 Google에서 비정상으로 선언한 후에도 정지되지 않습니다. 알림 이메일을 받은 후 7일 동안 사용자는 작업에 계속 액세스할 수 있습니다. 하지만 7일 후에도 계정 연결 문제를 해결하지 않으면 작업이 게시 중단됩니다.

작업 상태를 확인하려면 어떻게 해야 하나요? 개발자 콘솔에서 작업의 상태를 확인할 수 있습니다. 비정상 작업은 비정상 상태가 됩니다. 정상 작업이 배포됨으로 표시됩니다.

작업을 배포된 상태로 되돌리는 프로세스는 무엇인가요? 배포를 검토하고 작업이 출시 인텐트에 응답하지 못하게 할 수 있는 문제를 해결해야 합니다.

Google은 비정상 상태인 작업의 상태를 주기적으로 계속 모니터링합니다. Google에서 작업이 예상대로 응답하는 것을 감지하면 작업이 배포된 상태로 돌아갑니다.