자연어를 이해하고 자연어로 응답하는 Dialogflow CX Google Chat 앱 빌드

이 페이지에서는 Dialogflow를 사용하여 자연어를 이해하고 자연어로 응답할 수 있는 Google Chat 앱을 빌드하는 방법을 설명합니다. 이 가이드에서는 Google Chat과 직접 통합된 Dialogflow CX를 사용합니다. 또한 Dialogflow ES Google Chat 가이드에 따라 Dialogflow ES를 사용하여 Dialogflow ES Google Chat 앱을 빌드할 수 있습니다.

예를 들어 사용자가 자동차를 렌트하는 데 도움이 되는 Chat 앱을 생각해 보겠습니다. 사용자가 '자동차를 렌트하고 싶습니다'라고 작성할 수 있습니다. 채팅 앱은 '어디에서 차량을 수령하시겠어요?'와 같은 질문으로 응답할 수 있습니다. 그러면 사용자와 인간과 같은 대화가 시작되며, 이 대화에서 채팅 앱은 자동차 대여를 예약하는 동안 인간의 음성을 이해하고 음성으로 응답합니다.

이는 하나의 예에 불과합니다. Dialogflow Chat 앱은 모든 종류의 상호작용에 유용합니다. 자연스러운 인간 음성이 필요한 경우 Dialogflow Chat 앱을 호출합니다. 사전 빌드된 에이전트를 사용하면 빠르게 시작하고 다음과 같은 Dialogflow의 기능을 보여줄 수 있습니다.

• 항공편 예약
• 병원 예약
• 음식 배달 주문
• 상품의 다른 색상 사용 가능 여부와 같은 소매 제품 카탈로그에 관한 질문에 답변합니다.

목표

• 환경을 설정합니다.
• Dialogflow CX 에이전트를 만들고 배포합니다.
• Dialogflow CX 에이전트로 구동되는 채팅 앱을 만들고 배포하세요.
• Chat 앱을 테스트합니다.

기본 요건

• Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정
• 결제가 사용 설정된 Google Cloud 프로젝트. 기존 프로젝트에 결제가 사용 설정되어 있는지 확인하려면 프로젝트의 결제 상태 확인을 참고하세요. 프로젝트를 만들고 결제를 설정하려면 Google Cloud 프로젝트 만들기를 참조하세요.

아키텍처

다음 다이어그램은 Dialogflow로 빌드된 채팅 앱의 아키텍처를 보여줍니다.

위의 다이어그램에서 Dialogflow Chat 앱과 상호작용하는 사용자는 다음과 같은 정보 흐름을 갖습니다.

1. 사용자가 Chat에서 채팅 메시지나 Chat 스페이스를 통해 Chat 앱에 메시지를 보냅니다.
2. Google Cloud에 있는 Dialogflow 가상 에이전트는 메시지를 수신하고 처리하여 응답을 생성합니다.
3. 원하는 경우 Dialogflow webhook을 사용하여 Dialogflow 에이전트가 프로젝트 관리 시스템 또는 티켓 판매 도구와 같은 외부 서드 파티 서비스와 상호작용할 수 있습니다.
4. Dialogflow 에이전트가 Chat의 채팅 앱 서비스로 응답을 다시 보냅니다.
5. 응답이 Chat 스페이스로 전송됩니다.

환경 설정

1. Google Cloud 콘솔에서 Google Chat API 및 Dialogflow API를 사용 설정합니다.

   API 사용 설정

2. 올바른 Cloud 프로젝트에서 API를 사용 설정하고 있는지 확인한 후 다음을 클릭합니다.

3. 올바른 API를 사용 설정했는지 확인한 다음 사용 설정을 클릭합니다.

Dialogflow CX 에이전트 만들기

Dialogflow CX 에이전트는 최종 사용자와의 동시 실행 대화를 처리하는 가상 에이전트입니다. 인간 언어의 미묘한 차이를 이해하는 자연어 이해 모듈입니다 Dialogflow는 대화 중에 최종 사용자의 텍스트를 앱과 서비스가 이해할 수 있는 구조화된 데이터로 변환합니다. 시스템에 필요한 대화 유형을 처리하도록 Dialogflow 에이전트를 직접 설계하고 빌드할 수 있습니다.

Dialogflow 에이전트는 콜센터 상담사와 비슷합니다. 둘 다 예상되는 대화 시나리오를 처리하도록 학습해야 하며, 학습이 지나치게 명시적일 필요는 없습니다.

Dialogflow CX 에이전트를 만드는 방법은 다음과 같습니다.

1. Dialogflow CX 콘솔에서 Dialogflow CX 콘솔을 엽니다. 메뉴 menu > Dialogflow CX를 클릭합니다.

   Dialogflow CX 콘솔로 이동

2. Google Cloud 프로젝트를 선택합니다. 프로젝트를 찾으려면 모두를 클릭한 다음 검색해야 할 수도 있습니다.

3. 이제 사전 빌드된 상담사를 선택하거나 직접 만들 수 있습니다. 나중에 상담사 맞춤설정을 자세히 살펴보려면 사전 빌드된 상담사 중 하나를 선택하세요. 이 상담사는 상담사가 할 수 있는 작업을 알아보는 데도 도움이 됩니다.

   사전 빌드된 상담사를 선택하려면 다음 단계를 따르세요.

   1. 사전 빌드된 에이전트 사용을 클릭합니다.

   2. 사전 빌드된 에이전트를 선택합니다. 이 가이드에서는 여행: 자동차 렌탈을 선택합니다.

      에이전트는 사용하는 기능의 수와 대화 로직의 정교함에 따라 초급, 중급, 고급으로 평가됩니다. 중급 또는 고급 에이전트를 선택하려면 Google Cloud 콘솔에서 기능 및 API를 사용 설정하는 등 에이전트별 맞춤설정 및 설정이 필요할 수 있습니다.

   3. 에이전트로 가져오기를 클릭합니다.

   자체 에이전트를 만들려면 다음 단계를 따르세요.

   1. 에이전트 만들기를 클릭합니다.
   2. 자동 생성을 선택하여 데이터 스토어 에이전트를 만들거나 자체 빌드를 선택하여 다른 종류의 에이전트를 만듭니다.

   에이전트 빌드 프로세스에 관한 자세한 안내는 Dialogflow CX 에이전트 만들기를 참고하세요.

4. 기본 에이전트 설정을 구성합니다.

   1. 표시 이름에 표시 이름을 입력합니다.
   2. 선호하는 위치를 선택합니다. 고급 위치 설정을 변경하려면 수정을 클릭합니다.
   3. 원하는 시간대를 선택합니다.
   4. 에이전트의 기본 언어를 선택합니다. 에이전트를 만든 후에는 기본 언어를 변경할 수 없습니다.

5. 만들기를 클릭합니다. Dialogflow CX가 에이전트 생성을 시작하고 에이전트의 기본 시작 흐름을 표시합니다.

6. 원하는 경우 에이전트를 맞춤설정합니다. 에이전트 맞춤설정 프로세스에 관한 자세한 안내는 Dialogflow CX 에이전트 만들기를 참고하세요.

7. 권장사항에 따라 상담사를 테스트하세요.

   1. 에이전트 테스트를 클릭합니다.
   2. 환경에서 에이전트 테스트를 선택합니다.
   3. 환경에서 초안을 선택합니다.
   4. 흐름에서 기본 흐름 시작을 선택합니다.
   5. 페이지에서 시작 페이지를 선택합니다.
   6. 상담사와 채팅 작성창에 Hello을 입력하고 Enter 키를 누릅니다. 에이전트는 자신을 소개하면서 응답합니다.
   7. 샘플 테스트 대화를 진행하여 테스트를 완료합니다.

8. Dialogflow CX 에이전트가 생성됩니다. Dialogflow CX 콘솔로 돌아갑니다. 메뉴 menu > Dialogflow CX를 클릭합니다.

   Dialogflow CX 콘솔로 이동

9. Agents(에이전트)에서 more_vert > Copy name(이름 복사)을 클릭합니다. 채팅 앱을 구성할 때 사용했으므로 이 이름을 저장합니다.

Chat 앱을 만들고 Dialogflow 에이전트와 연결

Dialogflow CX 에이전트를 만든 후 다음 단계에 따라 Chat 앱으로 전환합니다.

1. Google Cloud 콘솔에서 Google Chat API로 이동합니다. 'Google Chat API'를 검색하고 Google Chat API를 클릭한 다음 관리를 클릭합니다.

   Chat API로 이동

2. 구성을 클릭하고 Chat 앱을 설정합니다.

   1. 앱 이름에 Dialogflow App를 입력합니다.
   2. 아바타 URL에 https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png를 입력합니다.
   3. 설명에 Responds to real human conversation을 입력합니다.
   4. 기능에서 1:1 메시지 수신 및 스페이스 및 그룹 대화 참여를 선택합니다.
   5. 연결 설정에서 Dialogflow를 선택합니다.
   6. Dialogflow 설정에서 Dialogflow CX를 선택합니다.
   7. 에이전트 또는 환경 리소스 이름에 Dialogflow CX 에이전트 만들기의 끝부분에서 복사한 Dialogflow CX 에이전트 이름을 붙여넣습니다.
   8. 도메인의 특정 사용자 및 그룹에서 이 Chat 앱을 사용할 수 있도록 설정하고 이메일 주소를 입력합니다.
   9. 로그에서 Logging에 오류 로깅을 선택합니다.

3. 저장을 클릭합니다.

Chat 앱이 Chat에서 메시지를 수신하고 응답할 준비가 되었습니다.

채팅 앱 테스트

Google Chat에서 메시지를 보내 Dialogflow CX Chat 앱을 테스트합니다.

1. 신뢰할 수 있는 테스터로 추가할 때 제공한 Google Workspace 계정을 사용하여 Google Chat을 엽니다.

   Google Chat으로 이동

2. add 새 채팅을 클릭합니다.
3. 사용자 1명 이상 추가 입력란에 Chat 앱의 이름을 입력합니다.

4. 검색 결과에서 채팅 앱을 선택합니다. 채팅 메시지가 열립니다.

5. 앱과의 새 채팅 메시지에서 Hello을 입력하고 enter를 누릅니다.

   Dialogflow Chat 앱은 자신을 소개하여 응답합니다.

6. 샘플 테스트 대화를 진행하여 테스트를 완료합니다.

샘플 테스트 대화

Dialogflow CX 콘솔 또는 Google Chat에서 Dialogflow CX Chat 앱을 테스트하려면 다음 대화를 진행하세요. 이 설명을 통해 Dialogflow CX 에이전트가 사용자의 자연어를 해석하고 대화의 각 단계에서 자체 자연어 응답을 생성하는 방법을 이해할 수 있습니다. 이 샘플 대화는 여행: 렌터카라는 사전 빌드된 상담사를 기반으로 합니다.

Dialogflow에서 카드 메시지 전송

Dialogflow는 텍스트 또는 카드 메시지로 응답할 수 있습니다. 카드 메시지로 응답하려면 fulfillment에서 커스텀 페이로드로 지정합니다.

다음 JSON은 처리에서 카드 메시지를 맞춤 페이로드로 전송하는 방법을 보여줍니다.

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from Dialogflow',
        'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
        'imageType': 'CIRCLE'
      },
      'sections': [
        {
          'widgets': [
            {
              'buttonList': {
                'buttons': [
                  {
                    'text': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

제한사항 및 고려사항

• 채팅 상호작용 이벤트는 지원이 제한되며 몇 가지 고려사항이 있습니다.
  • 다음과 같은 상호작용 이벤트 유형이 지원됩니다.
    • MESSAGE
    • ADDED_TO_SPACE
    • CARD_CLICKED
  • MESSAGE 또는 ADDED_TO_SPACE 이벤트의 경우 Dialogflow 에이전트로 전송된 쿼리 입력은 채팅 메시지의 argumentText 필드 값에 해당합니다. 메시지에 슬래시 명령어가 포함된 경우 text 필드의 값이 대신 사용됩니다.
  • CARD_CLICKED 이벤트의 경우 Dialogflow 상담사에게 전송되는 쿼리 입력은 CARD_CLICKED.functionName 형식이며 여기서 functionName는 양방향 카드 요소 (예: 버튼)에 연결된 Action 객체의 function 필드 값에 해당합니다.
  • 각 채팅 상호작용 이벤트의 전체 JSON 페이로드는 쿼리 매개변수의 맞춤 페이로드로 Dialogflow에 전송되며 WebhookRequest.payload 필드의 값을 쿼리하여 Dialogflow 웹훅으로 액세스할 수 있습니다.
• 슬래시 명령어에 응답하고 카드 또는 대화상자에서 데이터를 수신하기 위한 고려사항은 다음과 같습니다.
  • Dialogflow Chat 앱이 슬래시 명령어가 포함된 메시지를 수신하면 쿼리 입력에는 text 필드의 값만 포함됩니다. text 필드는 슬래시 명령어의 이름 (예: /command)으로 시작하며, 이를 사용하여 슬래시 명령어를 감지하도록 Dialogflow 에이전트의 인텐트를 구성할 수 있습니다.
  • Dialogflow 에이전트가 채팅 상호작용 이벤트 JSON 페이로드를 처리해야 하는 경우 Dialogflow 웹훅을 사용하여 쿼리 매개변수의 맞춤 페이로드를 검사하면 됩니다.
  • Dialogflow 에이전트의 대화상자를 표시하려면 DIALOG 작업 응답이 포함된 메시지가 포함된 단일 커스텀 JSON 페이로드로 응답합니다.
  • 카드에서 입력된 데이터를 처리하기 위해 Dialogflow 에이전트는 CARD_CLICKED 텍스트로 시작하는 인텐트를 감지하고 적절한 작업이 포함된 단일 맞춤 JSON 페이로드로 응답할 수 있습니다.
• 링크 미리보기는 지원되지 않습니다.
• Dialogflow 에이전트가 하나의 메시지로만 응답하면 메시지가 Google Chat에 동기식으로 전송됩니다. Dialogflow 상담사가 여러 메시지로 응답하는 경우 모든 메시지는 Chat API의 spaces.messages 리소스에서 create 메서드를 메시지별로 한 번씩 호출하여 Chat에 비동기식으로 전송됩니다.
• Chat과 Dialogflow CX 통합을 사용하는 경우 Dialogflow 에이전트와 Chat 앱을 동일한 Google Cloud 프로젝트에 설정해야 합니다. 서로 다른 Cloud 프로젝트에서 Dialogflow와 Chat을 설정해야 하는 경우 중간 서버를 설정하여 연결을 용이하게 할 수 있습니다. 방법을 알아보려면 GitHub에서 Dialogflow CX용 채팅 통합 예시를 참조하세요.

문제 해결

Google Chat 앱 또는 카드가 오류를 반환하면 Chat 인터페이스에 '문제가 발생했습니다'라는 메시지가 표시됩니다. '요청을 처리할 수 없습니다' Chat UI에 오류 메시지가 표시되지 않지만 Chat 앱 또는 카드에서 예기치 않은 결과가 발생하는 경우가 있습니다. 예를 들어 카드 메시지가 표시되지 않을 수 있습니다.

Chat UI에 오류 메시지가 표시되지 않을 수 있지만 채팅 앱의 오류 로깅이 사용 설정되어 있을 때 오류 메시지 및 로그 데이터를 사용하여 오류를 해결할 수 있습니다. 확인, 디버깅, 오류 수정에 관한 도움말은 Google Chat 오류 문제 해결을 참고하세요.

삭제

이 튜토리얼에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 Cloud 프로젝트를 삭제하는 것이 좋습니다.

1. Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다. 메뉴 menu > IAM 및 관리자 > 리소스 관리를 클릭합니다.

   Resource Manager로 이동

2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제 delete를 클릭합니다.
3. 대화상자에서 프로젝트 ID를 입력한 다음 종료를 클릭하여 프로젝트를 삭제합니다.

관련 주제

• Dialogflow CX는 Dialogflow 에이전트 설계에 상태 머신 접근 방식을 취하여 대화를 명확하고 명시적으로 제어하고, 더 나은 최종 사용자 환경, 더 나은 개발 워크플로를 제공합니다. Dialogflow 채팅 앱을 빌드할 때는 Dialogflow CX를 사용하는 것이 좋습니다.
  • 에이전트 빌드 및 구성에 관한 자세한 내용은 Dialogflow CX 에이전트를 참고하세요.
  • 에이전트를 빌드하고 구성하는 방법을 안내하는 자세한 워크플로는 Dialogflow CX 에이전트 만들기를 참고하세요.
  • code Codelab: Dialogflow CX 데이터 스토어 에이전트를 빌드하는 방법의 예는 Gemini로 Google Chat용 앱 빌드 Codelab의 지식 채팅 앱을 참고하세요.
  • code Codelab: Dialogflow CX 대화형 에이전트를 빌드하는 방법의 예는 Gemini로 Google Chat용 앱 빌드 Codelab의 의견 채팅 앱을 참고하세요.
• Dialogflow ES는 Chat 앱에서 Dialogflow를 사용하는 또 다른 방법입니다.