첫 번째 에이전트 만들기

기본 요건

에이전트 만들기

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

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

  • 파트너로 등록
  • 브랜드 및 에이전트 만들기
  • 선택적으로 Business Messages 도우미 봇과의 대화에서 기능 살펴보기
  • 메시지를 주고받도록 에이전트 설정

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

파트너로 등록

  1. Business Communications 개발자 콘솔을 엽니다.
  2. Business Messages에서 파트너 계정 만들기를 클릭합니다.

  3. 파트너 정보를 입력합니다.

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

  4. Business Messages 서비스 약관을 검토하고 동의합니다.

  5. 만들기 를 클릭합니다.

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

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

서비스 계정 만들기

  1. Business Communications 개발자 콘솔 홈페이지에서 파트너 계정 설정을 클릭합니다.
  2. 왼쪽 탐색 메뉴에서 서비스 계정 을 클릭합니다.

  3. **키 만들기** 를 클릭한 다음 **만들기** 를 클릭합니다.

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

브랜드 및 에이전트 만들기

에이전트는 사용자가 상호작용하는 대화형 항목인 브랜드의 대화형 표현입니다. 비즈니스를 나타내는 브랜드를 만들고 소비자가 대화형으로 연결할 수 있도록 에이전트를 만듭니다.

  1. Business Communications Developer Console을(를) 열고 Business Messages Google 계정으로 로그인합니다.
  2. 에이전트 만들기 를 클릭합니다.
  3. **에이전트 유형** 에서 **Business Messages** 를 선택합니다.
  4. 브랜드 이름 및 에이전트 이름 값을 입력합니다.
  5. 다음 중 한 가지 방법을 사용합니다.
    • 사용 가능한 기능을 살펴볼 수 있는 에이전트와의 대화를 경험하려면 Business Messages 도우미 봇 사용 설정 을 선택합니다.
    • 에이전트를 맞춤설정하고 메시지 처리를 준비하려면 Business Messages 도우미 봇 사용 설정 을 선택 해제합니다.
  6. 에이전트 만들기 를 클릭합니다.

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

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

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

도우미 봇을 사용하면 다음 작업을 할 수 있습니다.

  • 리치 기능 살펴보기
  • 기능 구현 방법 알아보기
  • 에이전트 설정 리소스 찾기

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

도우미 봇과 대화 시작

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

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

  1. 에이전트의 테스트 URL에 액세스합니다. 다음과 같은 방법으로 확인할 수 있습니다.

    • Android 버튼 또는 iOS 버튼을 클릭합니다. 그런 다음 해당 휴대기기로 QR 코드를 스캔하고 실행 을 클릭합니다. 또는 Android URL 복사 또는 iOS URL 복사 를 클릭하여 에이전트의 테스트 URL을 복사합니다.
    • 보내기 를 클릭하여 URL을 이메일 주소로 보냅니다.

  2. 휴대기기에서 URL을 엽니다. (iOS 기기에는 Google 지도 앱이 필요합니다.)

도우미 봇 사용 중지

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

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

  1. Business Communications Developer 콘솔을 엽니다.
  2. 에이전트를 선택합니다.
  3. 왼쪽 탐색 메뉴에서 통합 을 클릭합니다.
  4. 도우미 봇에서 사용 중지를 클릭합니다.

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

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

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

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

다음 단계를 완료합니다.

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

이 가이드가 끝나면 에이전트가 메시지를 주고받을 준비가 됩니다.

GCP에 웹 애플리케이션 배포

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

Cloud 환경 만들기

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

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

  1. Google Cloud 콘솔 프로젝트 선택기를 엽니다.

    Google Cloud 프로젝트를 만든 적이 없는 경우 약관 및 서비스에 동의 해야 합니다.

  2. 프로젝트 만들기 를 클릭합니다.

  3. 새 프로젝트의 이름과 위치를 입력합니다.

    • 프로젝트 ID가 자동으로 생성되어 프로젝트 이름 아래에 표시됩니다.
    • 위치 필드에서 찾아보기 를 클릭하여 프로젝트의 잠재적 위치를 표시합니다. Google Workspace 조직을 찾을 수 없는 경우 Google Workspace 계정에 로그인하지 않은 것입니다. 조직 없이 프로젝트를 만들 수 있지만 일부 기능은 제한됩니다. 자세한 내용은 조직 리소스의 이점을 참고하세요.

  4. 만들기 를 클릭합니다.

  5. 메뉴 를 클릭합니다.

  6. 결제 를 클릭합니다.

  7. 결제 계정 연결 을 클릭합니다.

  8. 새 결제 계정을 만들거나 기존 결제 계정을 프로젝트에 추가합니다. 결제 옵션을 알아보려면 Google Cloud 무료 프로그램 기능을 참고하세요.

Echo Bot 샘플 배포

  1. gcloud CLI를 설치합니다. 이를 사용하여 샘플 코드를 Google Cloud에 배포합니다.

  2. Echo Bot 샘플 (Node.js, Java, Python)을 다운로드하고 압축을 풉니다.

  3. 서비스 계정 만들기에 다운로드한 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

  4. 터미널에서 샘플의 full_sample 디렉터리로 이동합니다.

  5. 터미널에서 다음 명령어를 실행하여 샘플을 배포합니다.

    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의 프로젝트 대시보드에 표시됩니다.

  6. 마지막 명령어의 출력에서 배포된 애플리케이션의 URL을 기록해 둡니다. 이는 웹훅 URL의 기본입니다.

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

웹훅 설정

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

  1. Business Communications 개발자 콘솔에서 계정 설정을 엽니다.
  2. 올바른 파트너 계정이 선택되어 있는지 확인합니다.
  3. Business Messages 웹훅 URL에서 구성을 클릭합니다.

  4. 웹훅 엔드포인트 URL에 애플리케이션의 URL + "/callback"을 입력합니다.

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

    이 엔드포인트는 GCP에 배포한 샘플의 애플리케이션 로직에 미리 정의되어 있습니다.

  5. 개발자 콘솔에서 인증 을 클릭합니다.

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

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

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

에이전트 정보 입력

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

  1. Business Communications Developer 콘솔을 엽니다.
  2. 왼쪽 탐색 메뉴에서 에이전트 정보 를 클릭합니다.

  3. 원하는 대로 값을 업데이트하거나 다음 제안을 사용합니다.

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

  4. 저장 을 클릭합니다.

대화 시작

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

  1. Business Communications Developer 콘솔을 엽니다.
  2. 왼쪽 탐색 메뉴에서 에이전트 정보 를 클릭합니다.
  3. 에이전트 테스트 URL에서 Android 버튼 또는 iOS 버튼을 클릭합니다.

  4. 해당 휴대기기로 QR 코드를 스캔하거나 Android URL 복사 또는 iOS URL 복사 를 클릭하여 에이전트의 테스트 URL을 복사합니다.

    보내기 를 클릭하여 URL을 이메일 주소로 보낼 수도 있습니다.

  5. 휴대기기에서 URL을 엽니다. (iOS 기기에는 Google 지도 앱이 필요합니다.)

에이전트의 환영 메시지가 표시됩니다. 이 시점에서 Echo Bot과 상호작용할 수 있습니다. 전송한 메시지를 다시 에코합니다. 또한 특정 문자열('carousel', 'card', 'chips')을 전송하여 리치 기능을 호출할 수 있습니다.

다음 단계

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