인텐트는 작업 방법을 설명하는 메시지 객체입니다. 다음 두 가지 방법 중 하나로 인텐트를 사용할 수 있습니다.
- 인텐트에 처리를 제공합니다.
- Google 어시스턴트의 인텐트 처리를 요청합니다.
인텐트의 처리를 제공하는 프로세스는 Dialogflow로 빌드하는 개발자와 Actions SDK로 빌드하는 개발자마다 다릅니다. 그러나 두 경우 모두 인텐트의 이름과 처리 웹훅의 URL을 제공합니다. 이렇게 하면 인텐트와 일치하는 사용자 쿼리를 지원할 수 있음을 Actions on Google에 알릴 수 있습니다.
인텐트 처리를 요청하려면 어시스턴트에 응답할 때 possibleIntents 객체에 인텐트를 지정합니다. 후속 처리 요청에서 어시스턴트는 처리된 인텐트의 결과를 개발자에게 반환합니다. 자세한 내용은 헬퍼 사용 개요를 참고하세요.
공통 인텐트
다음 표에서는 어시스턴트가 처리하도록 요청하는 인텐트를 설명합니다.
| 인텐트 이름 | 사용 | Dialogflow 이벤트 |
|---|---|---|
actions.intent.MAIN |
필수: 모든 작업 패키지는 단 하나의 인텐트만 사용자가 대화를 시작할 수 있는 진입점 역할을 합니다. | WELCOME 또는 GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
사용자 요청의 원시 텍스트 표현을 가져옵니다. 개발자는 사용자와 대화할 때 대부분의 시간을 사용합니다. | |
actions.intent.CANCEL |
작업 패키지에서 취소 인텐트를 수신하도록 선택하면 이 인텐트를 수신합니다. 사용자가 'quit'과 같은 전역 취소 명령어를 말하면 다음 처리 요청에서 이 인텐트를 수신하므로 최종 메시지로 응답하고 처리 로직에서 정리를 실행할 수 있습니다. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
작업 패키지에서 입력이 없는 인텐트를 수신하도록 선택하면 이 인텐트를 수신합니다. 사용자가 프롬프트에 응답하지 않으면 처리에 대한 다음 요청에서 이 인텐트를 수신합니다. | actions_intent_NO_INPUT |
도우미
다음 표에서는 어시스턴트에 처리를 요청할 수 있는 지원되는 도우미를 설명합니다.
| 인텐트 이름 | 사용 | Dialogflow 이벤트 |
|---|---|---|
actions.intent.PERMISSION |
사용자의 전체 이름, 대략적인 위치, 정확한 위치 또는 3가지 모두를 가져옵니다. | actions_intent_PERMISSION |
actions.intent.OPTION |
목록 또는 캐러셀 UI에서 선택한 항목을 수신합니다. 또는 사용자가 목록이나 캐러셀 UI에서 선택하지 않으면 목록 또는 캐러셀 UI의 키와 일치하는 음성 또는 텍스트 입력을 수신합니다. | actions_intent_OPTION |
actions.intent.DATETIME |
사용자로부터 날짜 및 시간 입력을 가져옵니다. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
사용자의 계정을 연결하기 위해 계정 연결 흐름을 요청합니다. | actions_intent_SIGN_IN |
actions.intent.PLACE |
사용자로부터 주소 또는 저장된 위치를 가져옵니다. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
사용자로부터 확인을 받습니다 (예: 예 또는 아니요 질문에 대한 답변). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
사용자에게 다른 어시스턴트 표시 경로로 전달할 권한을 요청합니다. | actions_intent_NEW_SURFACE |
내장 인텐트
내장 인텐트는 사용자가 식사 주문, 탑승 예약, 계정 잔액 확인 등 실행하려는 작업이나 원하는 정보를 표현하는 일반적인 방법을 모델링합니다. 자세한 내용은 내장 인텐트 참조를 확인하세요.
추가 인텐트
대부분의 대화형 작업은 일반적인 인텐트, 도우미, 응답의 조합으로 빌드됩니다. 그러나 트랜잭션이나 일일 업데이트와 같은 추가 기능을 포함하는 작업은 이러한 기능과 관련된 인텐트에 액세스할 수 있습니다.
거래 도우미
다음 표에서는 어시스턴트에게 처리하도록 요청할 수 있는 구매 처리와 관련된 도우미를 설명합니다. 이러한 인텐트와 기타 관련 인텐트를 구현하는 방법에 관한 자세한 내용은 트랜잭션 기능 문서를 참고하세요.
| 인텐트 이름 | 사용 | Dialogflow 이벤트 |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
사용자로부터 배송지 주소 입력을 가져옵니다. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
거래의 모든 요구사항이 충족되었는지 확인합니다. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
사용자에게 거래가 이루어져야 하는지 묻습니다. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
사용자의 트랜잭션 구성을 검증합니다. 거래가 실패할 사용자에게 디지털 상품을 제공하지 않기 위해 사용됩니다. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
구매 요청을 시작합니다. 그 결과 거래의 성공 여부와 실패 방법을 설명하는 구매 결과가 표시됩니다. | actions_intent_COMPLETE_PURCHASE |
사용자 참여 인텐트
다음 표에서는 사용자 참여 기능과 관련된 인텐트를 설명합니다. 이러한 인텐트와 기타 관련 인텐트를 구현하는 방법에 관한 자세한 내용은 사용자 참여 기능 문서를 참고하세요.
| 인텐트 이름 | 처리 제공 | 요청 처리 | 사용 | Dialogflow 이벤트 |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | 사용자에게 업데이트를 등록하도록 요청합니다. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | 사용자가 업데이트를 위해 등록하려고 할 때 이 인텐트를 수신합니다(즉, REGISTER_UPDATE 인텐트를 전송해야 함). | actions_intent_CONFIGURE_UPDATES |
맞춤 인텐트
사용자가 더 효율적으로 작업을 완료할 수 있도록 자체 인텐트를 만들어 대화의 바로가기를 정의할 수 있습니다. 이러한 인텐트는 자체 네임스페이스에 있습니다. 사용자가 인텐트를 트리거하는 방법을 정의하면 작업 패키지만 이를 지원할 수 있습니다.
자세한 내용은 Dialogflow에서 작업 정의 또는 Actions SDK를 사용하여 작업 정의를 참조하세요. 작업 패키지에 관한 자세한 내용은 작업 패키지 참조 문서를 참고하세요.
스마트 홈 인텐트
스마트 홈 작업을 빌드하는 경우 약간 다른 방식으로 인텐트 지원을 정의합니다. 자세한 내용은 스마트 홈 인텐트 문서를 참고하세요.