이 문서에서는 Actions on Google과 맞춤 대화형 사용자 인터페이스를 정의하는 처리 서비스 간에 통신하기 위한 웹훅 형식을 설명합니다.
Actions on Google과 이행이 Actions on Google 웹훅 형식을 통해 통신하는 방식을 이해하는 것이 중요합니다.
- Actions on Google과의 대화에 참여하기 위해 처리에서는 Actions on Google의 HTTP 요청에 응답할 수 있는 웹훅을 구현합니다.
- 사용자가 작업을 호출하면 처리에서 사용자의 요청을 설명하는 JSON 페이로드가 포함된
HTTP POST를 수신합니다. - 그런 다음 처리는 요청 페이로드에서 매개변수를 읽고, 적절한 JSON 형식의 응답을 생성하고, 이 응답으로 어시스턴트에 응답을 전송합니다.
요청 유형
다음 표에는 웹훅에서 어시스턴트로부터 수신할 수 있는 요청 유형이 요약되어 있습니다.
| 유형 | 설명 | JSON 예 |
|---|---|---|
| 호출 요청 | 처리와 대화를 시작하거나 딥 링크 작업을 트리거하는 사용자 발화 (예: '저녁 레시피를 찾기 위해 개인 요리사에게 말하기')
|
|
| 대화 요청 | fulfillment와 대화가 시작된 후 같은 세션에 있는 사용자의 인사말입니다. 대화 웹훅 형식에서는 이전 처리에서 fulfillment가 요청한 actions.intent.TEXT 인텐트에 해당하는 사용자의 원시 텍스트 응답입니다. |
|
| 도우미 결과 | 웹훅이 대화의 일부 내용 (예: actions.intent.OPTION 및 actions.intent.PERMISSION)을 처리하기 위해 이전 대화 차례에서 도우미 인텐트를 요청했을 때 어시스턴트에서 처리로 보낸 요청입니다. |
대화 요청 및 응답
일반적인 Actions on Google 상호작용 시나리오에서는 사용자가 문구를 발화하여 작업을 호출합니다. 응답을 제공하기 위해 Actions on Google은 사용자가 호출한 작업과 일치하는 처리를 찾아 그곳에 요청을 전송합니다.
Actions on Google에서 처리가 사용자의 호출에 적합한 것으로 확인되면 사용자의 요청 정보가 포함된 JSON 페이로드가 포함된 HTTP 요청을 처리 엔드포인트로 전송하여 대화 세션을 시작합니다. 처리는 요청을 파싱하고 JSON 페이로드가 포함된 응답을 반환합니다. 그런 다음 Actions on Google은 페이로드를 사용자를 위해 렌더링된 음성 및 멀티미디어 출력으로 변환합니다.
Actions on Google이 Actions SDK를 통해 처리를 호출할 때 JSON 페이로드 형식에 대해 자세히 알아보려면 대화 웹훅 형식을 참고하세요.
Dialogflow 요청 및 응답
작업을 만들 때 선택적으로 Dialogflow를 사용하여 대화형 인터페이스를 빌드하는 작업을 간소화할 수 있습니다. 이 시나리오에서 Dialogflow는 Actions on Google과 처리 간의 프록시 역할을 합니다. HTTP/JSON 요청을 처리 엔드포인트로 직접 보내는 대신 Actions on Google이 요청을 Dialogflow로 전송합니다.
Dialogflow는 원래 요청에 포함된 JSON 페이로드를 Dialogflow 웹훅 형식으로 래핑하고 그 결과로 생성된 요청을 Dialogflow 처리에 전달합니다.
반대로 처리에서 Dialogflow로 응답을 전송할 때 응답의 JSON 페이로드는 Dialogflow 웹훅 형식을 준수해야 합니다. 처리는 Dialogflow JSON 요청에서 매개변수를 파싱하고 Dialogflow 웹훅 형식으로 응답을 생성합니다. 그런 다음 Dialogflow는 처리의 응답을 어시스턴트가 이해하는 응답 메시지로 변환합니다.
Actions on Google이 Dialogflow를 통해 fulfillment를 호출할 때 JSON 페이로드 형식에 대한 자세한 내용은 Dialogflow 웹훅 형식을 참조하세요.