이 페이지는 Cloud Translation API를 통해 번역되었습니다.

첫 번째 에이전트 만들기

기본 요건

2022년 3월 7일 전에 파트너 계정을 등록한 경우 Business Messages API를 사용 설정해야 합니다. Business Communications API 및 Business Messages API 사용 설정을 참조하세요.

에이전트 만들기

이 가이드에서는 샘플 애플리케이션을 사용하여 에이전트를 만드는 방법을 안내합니다. 이 샘플은 에이전트의 기능을 빠르게 살펴볼 수 있는 방법을 제공하고 에이전트 개발을 위한 시작점으로 사용할 수 있습니다. 에이전트를 포함하도록 기존 애플리케이션을 수정하려는 경우 샘플에서는 애플리케이션 로직에 적합한 모델을 제공합니다.

이 빠른 시작에서 다루는 작업은 다음과 같습니다.

파트너 등록
브랜드 및 에이전트 만들기
필요한 경우 Business Messages 도우미 봇과 대화하는 기능을 살펴보세요.
에이전트가 메시지를 주고받도록 설정

샘플을 사용하지 않고 에이전트를 만들려면 에이전트 만들기를 참고하세요.

파트너 등록

비즈니스 커뮤니케이션 개발자 콘솔을 엽니다.
비즈니스 메시지에서 파트너 계정 만들기를 클릭합니다.
파트너 정보 입력:

필드 값

이름 성명

파트너 이름 조직 이름

파트너 웹사이트 조직 웹사이트

리전 Business Messages 서비스를 호스팅할 리전
Business Messages 서비스 약관을 검토하고 이에 동의합니다.
만들기를 클릭합니다.

필드	값
이름	성명
파트너 이름	조직 이름
파트너 웹사이트	조직 웹사이트
리전	Business Messages 서비스를 호스팅할 리전

Business Messages 파트너로 등록되었습니다. Business Messages 및 Business Communications API가 사용 설정된 새 Google Cloud 프로젝트가 생성되었습니다. 이 프로젝트에 액세스할 수 없으며, 기존 Google Cloud 프로젝트에도 영향을 주지 않습니다.

이제 Business Messages 및 Business Communications API에 액세스할 수 있습니다.

서비스 계정 만들기

비즈니스 커뮤니케이션 개발자 콘솔 홈페이지에서 파트너 계정 설정을 클릭합니다.
왼쪽 탐색 메뉴에서 서비스 계정을 클릭합니다.
키 만들기를 클릭한 다음 만들기를 클릭합니다.

브라우저에서 서비스 계정 키를 다운로드합니다. 안전한 위치에 저장합니다. 나중에 웹 애플리케이션을 배포하고 나중에 Business Messages 및 Business Communications API에 액세스하려면 이 키가 필요합니다.

브랜드 및 에이전트 만들기

에이전트는 사용자가 상호작용하는 대화형 항목인 브랜드를 나타내는 대화입니다. 소비자가 브랜드를 통해 소통할 수 있도록 브랜드를 만들고 에이전트를 만듭니다.

비즈니스 커뮤니케이션 개발자 콘솔을 열고 Business Messages Google 계정으로 로그인합니다.
에이전트 만들기를 클릭합니다.
에이전트 유형으로 Business Messages를 선택합니다.
브랜드 이름 및 에이전트 이름 값을 입력합니다.
다음 중 한 가지 방법을 사용합니다.
- 사용 가능한 기능을 살펴볼 수 있는 에이전트와의 대화를 경험하려면 Business Messages 도우미 봇 사용 설정을 선택합니다.
- 에이전트를 맞춤설정하고 메시지 처리를 준비하려면 Business Messages 도우미 봇 사용 설정을 선택 해제합니다.
에이전트 만들기를 클릭합니다.

Business Messages 도우미 봇을 사용 설정한 경우 즉시 대화를 시작할 수 있습니다. 그렇지 않으면 메시지 처리를 위한 에이전트 설정을 진행하세요.

Business Messages 도우미 봇으로 기능 살펴보기

Business Messages 도우미 봇을 사용하면 에이전트와의 대화를 빠르게 시작할 수 있으므로 플랫폼에서 제공하는 기능을 경험할 수 있습니다. 도우미 봇 사용 설정은 선택사항이지만 첫 번째 에이전트를 만들 때 사용하는 것이 좋습니다.

도우미 봇을 사용하면

풍부한 기능 살펴보기
기능 구현 방법 알아보기
에이전트 설정을 위한 리소스 찾기

도우미 봇을 사용 설정하면 에이전트에서 도우미 봇이 메시지를 전송하고 수신하므로 웹훅이 필요하지 않습니다. 사용자 메시지를 처리하기 위해 웹훅을 설정하거나 Dialogflow를 사용 설정하려면 먼저 도우미 봇을 사용 중지해야 합니다.

도우미 봇과 대화 시작하기

Business Messages 도우미 봇을 사용 설정하면 대화를 시작할 수 있습니다. 에이전트 생성 직후 시작할 수 있도록 대화상자가 열립니다.

도우미 봇과 상호작용하려면 이 대화상자에서 다음 단계를 따르세요.

에이전트의 테스트 URL에 액세스합니다. 여기에는 몇 가지 방법이 있습니다.
- Android 버튼 또는 iOS 버튼을 클릭합니다. 그런 다음 해당하는 휴대기기로 QR 코드를 스캔하고 실행을 클릭합니다. 또는 Android URL 복사 또는 iOS URL 복사를 클릭하여 에이전트의 테스트 URL을 복사합니다.
- 보내기를 클릭하여 URL을 내 이메일 주소로 보냅니다.
휴대기기에서 URL을 엽니다. iOS 기기에는 Google 지도 앱이 필요합니다.

도우미 봇 사용 중지

에이전트를 맞춤설정하고 출시를 준비하기 전에 Business Messages 도우미 봇을 사용 중지해야 합니다.

도우미 봇을 사용 중지하려면

비즈니스 커뮤니케이션 개발자 콘솔을 엽니다.
에이전트를 선택합니다.
왼쪽 탐색 메뉴에서 통합을 클릭합니다.
도우미 봇에 대해 사용 중지를 클릭합니다.

도우미 봇을 사용 중지하면 더 이상 에이전트의 메시지를 전송하고 수신하지 않습니다. 이제 메시지 흐름을 처리하도록 에이전트를 설정할 수 있습니다.

메시지 처리를 위한 에이전트 설정

이 가이드에서는 사용자 메시지를 처리하도록 설계된 웹훅을 사용하여 Google Cloud Platform (GCP)에 에코 봇을 배포합니다.

Echo Bot은 사용자에게 메시지를 다시 표시하는 샘플 애플리케이션입니다. 이를 통해 에이전트와의 대화에서 추천 작업 및 리치 카드와 같은 리치 기능을 실험할 수 있습니다. Echo Bot을 에이전트 개발의 시작점으로 사용할 수도 있습니다.

다음 단계를 완료합니다.

GCP에 에코 봇 샘플 배포
Business Messages 파트너 계정의 웹훅 URL 구성
에이전트에 관한 기본 정보 제공

이 가이드를 마치고 나면 에이전트가 메시지를 주고받을 수 있습니다.

GCP에 웹 애플리케이션 배포

Business Messages는 사용자의 메시지를 인프라의 웹훅으로 전달합니다. 이 가이드에서는 사전 구성된 웹훅에 Echo Bot 샘플 소스 코드를 배포합니다. 메시지 수신에 활용할 수 있는 웹 인프라가 이미 있다면 웹 서비스에서 새 웹훅을 만들 수 있지만 로직을 직접 구성해야 합니다. 자세한 내용은 파트너 수준 웹훅 설정을 참조하세요.

Cloud 환경 만들기

Echo Bot 샘플을 배포하려면 클라우드 환경이 필요합니다.

GCP 프로젝트를 클라우드 환경으로 만들려면 다음 단계를 따르세요.

Google Cloud Console 프로젝트 선택기를 엽니다.

Google Cloud 프로젝트를 만든 적이 없다면 서비스 약관에 동의해야 합니다.
프로젝트 만들기를 클릭합니다.
새 프로젝트의 이름과 위치를 입력하세요.
- 프로젝트 ID가 자동으로 생성되어 프로젝트 이름 아래에 표시됩니다.
- 위치 필드에서 찾아보기를 클릭하여 프로젝트의 잠재적 위치를 표시합니다. Google Workspace 조직을 찾을 수 없다면 Google Workspace 계정에 로그인하지 않은 것입니다. 조직 없이 프로젝트를 만들 수 있지만 일부 기능은 제한됩니다. 자세한 내용은 조직 리소스의 이점을 참조하세요.
만들기를 클릭합니다.
메뉴를 클릭합니다.
결제를 클릭합니다.
결제 계정 연결을 클릭합니다.
새 결제 계정을 만들거나 기존 결제 계정을 프로젝트에 추가합니다. 결제 옵션을 알아보려면 Google Cloud 무료 프로그램 기능을 참고하세요.

Echo 봇 샘플 배포

gcloud CLI 설치 이를 사용하여 샘플 코드를 Google Cloud에 배포합니다.
Echo Bot 샘플(Node.js, 자바, Python)을 다운로드하고 추출합니다.
서비스 계정 만들기에서 다운로드한 JSON 사용자 인증 정보 파일을 샘플의 리소스 폴더에 복사하고 사용자 인증 정보의 이름을 'bm-agent-service-account-credentials.json'으로 바꿉니다. 이 사용자 인증 정보 파일의 경로는 다운로드한 샘플에 따라 다릅니다.
Node.js
```
./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
```
자바
```
./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json
```
Python
```
./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
```
터미널에서 샘플의 full_sample 디렉터리로 이동합니다.
터미널에서 다음 명령어를 실행하여 샘플을 배포합니다.
Node.js
```
gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy
```
PROJECT_ID는 Cloud 환경 만들기에서 만든 프로젝트의 프로젝트 ID입니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 표시됩니다.
자바
```
gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy
```
PROJECT_ID는 Cloud 환경 만들기에서 만든 프로젝트의 프로젝트 ID입니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 표시됩니다.
Python
```
gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy
```
PROJECT_ID는 Cloud 환경 만들기에서 만든 프로젝트의 프로젝트 ID입니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 표시됩니다.
마지막 명령어 결과에서 배포된 애플리케이션의 URL을 기록합니다. 웹훅 URL의 기본은 다음과 같습니다.

Deployed service [default] to [https://PROJECT_ID.appspot.com]

웹훅 설정

이제 Echo Bot이 배포되었으므로 메시지 수신을 시작하려면 사용자가 운영하는 웹훅 URL을 지정해야 합니다.

비즈니스 커뮤니케이션 개발자 콘솔에서 계정 설정을 엽니다.
올바른 파트너 계정이 선택되었는지 확인합니다.
Business Messages 웹훅 URL에서 구성을 클릭합니다.
웹훅 엔드포인트 URL에 애플리케이션의 URL과 '/callback'을 입력합니다.

엔드포인트는 'https://PROJECT_ID.appspot.com/callback' 형식을 따릅니다.

이 엔드포인트는 GCP에 배포한 샘플의 애플리케이션 로직에 사전 정의되어 있습니다.
Play Console에서 확인을 클릭합니다.

Business Messages가 웹훅을 확인하면 대화상자가 닫힙니다.

Business Communications API로 웹훅을 구성하려면 예: 웹훅 URL 업데이트를 참조하세요.

Business Messages 테스트 프레임워크를 사용하여 웹훅이 Business Messages 페이로드에 성공적으로 응답하는지 테스트할 수 있습니다.

에이전트 정보 입력

에이전트 설정을 완료하기 위한 몇 가지 기본 정보를 제공하세요.

비즈니스 커뮤니케이션 개발자 콘솔을 엽니다.
왼쪽 탐색 메뉴에서 에이전트 정보를 클릭합니다.
원하는 대로 값을 업데이트하거나 다음 제안을 사용하세요.

필드 값

환영 메시지 Echo Bot 대화에 오신 것을 환영합니다.

개인정보처리방침 https://policies.google.com/privacy
저장을 클릭합니다.

필드	값
환영 메시지	Echo Bot 대화에 오신 것을 환영합니다.
개인정보처리방침	https://policies.google.com/privacy

대화 시작하기

에코 봇과 상호작용하려면 다음 단계를 따르세요.

비즈니스 커뮤니케이션 개발자 콘솔을 엽니다.
왼쪽 탐색 메뉴에서 에이전트 정보를 클릭합니다.
에이전트 테스트 URL에서 Android 버튼 또는 iOS 버튼을 클릭합니다.
해당하는 휴대기기로 QR 코드를 스캔하거나 Android URL 복사 또는 iOS URL 복사를 클릭하여 에이전트의 테스트 URL을 복사합니다.

보내기를 클릭하여 URL을 내 이메일 주소로 보낼 수도 있습니다.
휴대기기에서 URL을 엽니다. iOS 기기에는 Google 지도 앱이 필요합니다.

에이전트의 환영 메시지가 표시됩니다. 이제 에코 봇과 상호작용할 수 있습니다. 다시 보낸 메일을 되풀이합니다. 또한 특정 문자열('캐러셀', '카드', '칩')을 전송하여 리치 기능을 호출할 수 있습니다.

다음 단계

첫 번째 에이전트를 만들었으므로 Business Messages와 플랫폼에서 할 수 있는 작업을 자세히 알아보세요.

Business Messages 작동 방식에 대해 자세히 알아보세요.
Business Messages 요구사항 및 가이드라인을 검토합니다.
메시지 수신 방법을 검토하여 Echo 봇을 수정하고 비즈니스 로직으로 응답합니다.
인프라를 인증합니다.
더 많은 에이전트 및 위치를 실행하세요.