Google Business Messages는 2024년 7월 31일에 지원 중단됩니다. 자세히 알아보기

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

첫 번째 에이전트 만들기

기본 요건

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

에이전트 만들기

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

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

파트너로 등록
브랜드 및 에이전트 만들기
원하는 경우 Business Messages와의 대화에서 기능을 살펴보세요. 도우미 봇
에이전트를 설정하여 메시지를 주고 받으세요.

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

파트너로 등록

Google 검색 앱 홈 화면의 오른쪽 상단에 있는 비즈니스 커뮤니케이션 개발자 콘솔.
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 Communications Developer(비즈니스 커뮤니케이션 개발자)를 엽니다. 콘솔 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 지도 app.)

도우미 봇 사용 중지

에이전트를 맞춤설정하고 출시를 준비하려면 먼저 Business Messages 도우미 봇을 사용 중지하세요.

도우미 봇을 사용 중지하려면 다음 단계를 따르세요.

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

도우미 봇을 사용 중지하면 더 이상 확인할 수 있습니다 이제 에이전트에서 메시지 흐름에 집중할 수 있습니다

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

이 가이드에서는 다음 명령어를 사용하여 Echo Bot을 Google Cloud Platform (GCP)에 배포합니다. 웹훅을 설정할 수도 있습니다

Echo Bot은 사용자에게 메시지를 다시 에코하는 샘플 애플리케이션입니다. 그것은 다양한 기능을 실험해 보세요. 추천 작업 및 리치 카드와 에이전트와의 대화에서 확인할 수 있습니다 에코 봇을 시작점으로 사용할 수도 있습니다. 살펴봤습니다

다음 단계를 완료합니다.

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

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

GCP에 웹 애플리케이션 배포

Business Messages는 사용자의 메시지를 웹훅으로 전달합니다. 구성할 수 있습니다 이 가이드에서는 에코 봇 샘플을 배포합니다. 소스 코드를 사전 구성된 웹훅으로 변환합니다 웹 인프라가 이미 구축되어 있고 메시지를 수신하기 위해 활용하는 경우 해당 웹에 새 웹훅을 만들 수 있습니다. 로직을 직접 구성해야 합니다. 자세한 내용은 파트너 수준 웹훅 설정 참조하세요.

클라우드 환경 만들기

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

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

Google 검색 앱 홈 화면의 오른쪽 상단에 있는 Google Cloud 콘솔 프로젝트 선택기.

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

Echo Bot 샘플 배포

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는 생성한 프로젝트의 프로젝트 ID입니다. 클라우드 환경을 만듭니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 나열됩니다.
자바
```
gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy
```
PROJECT_ID는 생성한 프로젝트의 프로젝트 ID입니다. 클라우드 환경을 만듭니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 나열됩니다.
Python
```
gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy
```
PROJECT_ID는 생성한 프로젝트의 프로젝트 ID입니다. 클라우드 환경을 만듭니다. 프로젝트 ID는 Google Cloud의 프로젝트 대시보드에 나열됩니다.
마지막 명령어의 출력에서 배포된 애플리케이션의 URL을 기록해 둡니다. 웹훅 URL의 기본은 다음과 같습니다.

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

웹훅 설정

이제 Echo Bot이 배포되었으므로 웹훅 URL( 작동)을 사용하여 메시지 수신 중 하나가 될 수 있습니다.

Google 검색 앱 홈 화면의 오른쪽 상단에 있는 계정 설정 에 대해 자세히 알아보세요.
올바른 파트너 계정을 선택했는지 확인합니다.
Business Messages 웹훅 URL에서 구성을 클릭합니다.
Webhook 엔드포인트 URL(웹훅 엔드포인트 URL)에 애플리케이션의 URL과 '/callback'을 입력합니다.

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

이 엔드포인트는 배포한 샘플의 애플리케이션 로직에 배포할 수 있습니다
Play Console에서 인증을 클릭합니다.

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

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

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

에이전트 정보 입력

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

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

필드 값

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

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

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

대화 시작

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

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

보내기를 클릭하여 URL을 내 이메일 주소로 보낼 수도 있습니다.
휴대기기에서 URL을 엽니다. (iOS 기기의 경우 Google 지도 앱에만 제공됩니다.)

에이전트의 환영 메시지가 표시됩니다. 이 시점에서 Kubernetes와 에코 봇입니다. 사용자에게 다시 보낸 메시지를 되풀이합니다. 또한 다음 작업을 수행할 수 있습니다. '캐러셀', '카드', '칩'과 같은 특정 문자열을 전송하여 풍부한 기능을 호출합니다.

다음 단계

첫 번째 에이전트를 만들었으므로 이제 Business Messages에 대해 자세히 알아보세요. 플랫폼에서 할 수 있는 다른 활동에 대해서도 알아보겠습니다

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