프로젝트 빌드

작업 프로젝트는 모든 작업을 단일 컨테이너로 패키징합니다. 이 프로젝트를 Actions on Google에 게시하면 Google 어시스턴트가 대화형 환경을 검색하고 호출하는 방법을 알 수 있습니다.

작업 프로젝트 구성요소
그림 1. 작업 프로젝트 구조

작업 프로젝트를 빌드할 때는 다음과 같은 하위 수준의 구성요소를 사용합니다.

  • 설정 및 리소스는 프로젝트 메타데이터와 프로젝트 아이콘 같은 리소스를 정의합니다. Google은 이 정보를 사용하여 어시스턴트 디렉터리에 작업을 게시하므로 사용자가 작업을 검색하고 호출할 수 있습니다.

  • 인텐트는 일부 사용자 입력이나 처리가 필요한 시스템 이벤트와 같이 실행할 작업을 나타냅니다. 사용할 가장 일반적인 인텐트 유형은 사용자 인텐트입니다. 이러한 인텐트를 사용하면 NLU (자연어 이해) 엔진에 의해 자연스럽게 확장되는 학습 문구를 선언하여 더 많은 유사한 문구를 포함할 수 있습니다. NLU는 이러한 구문의 집계를 사용하여 어시스턴트가 사용자 입력을 매칭하는 데 사용하는 언어 모델을 학습시킵니다. 대화 중에 일부 사용자 입력이 인텐트의 언어 모델과 일치하면 어시스턴트 런타임은 인텐트를 처리하고 사용자에게 응답할 수 있도록 인텐트를 작업에 전송합니다.

  • 유형을 사용하면 사용자 입력에서 구조화된 데이터를 추출할 수 있습니다. 학습 문구에 유형을 주석으로 처리하면 NLU가 관련성이 높고 구조화된 데이터를 추출할 수 있으므로 서술형 입력을 파싱할 필요가 없습니다.

  • 장면은 인텐트를 처리하며 작업의 기본 로직 실행자입니다. 슬롯 채우기를 하고, 조건부 로직을 평가하고, 사용자에게 메시지를 반환하고, 외부 웹 서비스를 호출하여 비즈니스 로직을 실행할 수도 있습니다. 장면을 인텐트와 함께 사용하면 특정 사용자 입력 또는 시스템 이벤트를 감지하고 상응하는 로직을 실행할 수 있습니다.

  • 프롬프트는 사용자에게 응답하는 데 사용하는 정적 또는 동적 응답을 정의합니다.

  • 웹훅을 사용하면 데이터 유효성 검사 또는 메시지 생성과 같은 추가 작업을 웹 서비스(처리)에 위임할 수 있습니다. 작업은 JSON 기반의 웹훅 프로토콜을 통해 처리와 통신합니다.

  • Interactive Canvas를 사용하면 HTML, CSS, JavaScript를 활용하는 웹 앱으로 풍부하고 몰입도 높은 환경을 만들 수 있습니다.

프로젝트 만들기

Google 어시스턴트용으로 개발하려면 먼저 Actions 콘솔에서 프로젝트를 만들어야 합니다. 프로젝트를 만들려면 다음 안내를 따르세요.

  1. Actions 콘솔로 이동합니다.
  2. 새 프로젝트를 클릭합니다.
  3. 프로젝트 이름을 입력하고 프로젝트 만들기를 클릭합니다.
  4. What kind of Action do you want to build? 화면에서 프로젝트를 가장 잘 나타내는 카테고리를 선택하고 Next를 클릭합니다.
  5. How do you want to build it(빌드 방법) 화면에서 빌드 방법을 선택하고 Start build(빌드 시작)를 클릭합니다. 예를 들어 빈 프로젝트나 샘플로 시작할 수 있습니다.

프로젝트 정보 정의

프로젝트의 설정 및 리소스는 기능 및 노출 영역 지원, 지원되는 언어, 표시 이름, 설명, 로고 등과 같은 프로젝트 관련 정보를 정의합니다. 다음 표에서는 개발자가 제공하는 기본 설정과 리소스를 설명합니다. Actions on Google은 이 정보를 사용하여 프로젝트를 배포하고 어시스턴트 디렉터리에 게시합니다.

이름 설명
디렉터리 정보 Actions on Google이 어시스턴트 디렉터리에 프로젝트를 게시할 수 있도록 정보를 제공합니다. 로고 및 배너 이미지의 프로젝트 및 이미지 리소스에 관한 메타데이터와 설명이 포함됩니다.
위치 타겟팅 작업을 사용할 수 있는 언어를 구성합니다.
기능 표시 작업을 사용할 수 있는 표시 경로를 구성합니다.
회사 세부정보 회사의 연락처 정보를 지정합니다.
브랜드 인증 소유한 웹사이트 또는 Android 앱을 연결하여 작업 내에서 예약된 호출 이름 및 웹사이트 연결과 같은 추가 이점을 얻으세요.
출시 테스트와 프로덕션을 위해 작업의 다양한 테스트 및 프로덕션 버전을 구성합니다.
어시스턴트 링크 사용자가 웹 속성에서 작업을 호출할 수 있도록 허용합니다.

프로젝트 정보를 정의하려면 다음 안내를 따르세요.

시뮬레이터에서 프로젝트 테스트

Actions 콘솔은 작업을 미리 볼 수 있는 시뮬레이터를 제공합니다. 시뮬레이터를 사용하면 디버그 정보를 확인하고, 기기 기능을 설정하고, 언어를 시뮬레이션하는 등의 작업을 할 수 있습니다.

그림 3. 시뮬레이터의 기본 영역은 (1) 사용자 입력, (2) 기기 보기, (3) 옵션 및 설정, (4) 대화 로그입니다.

프로젝트를 테스트하려면 다음 안내를 따르세요.