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

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

예를 들어 사람들이 렌터카를 렌트할 수 있도록 도와주는 채팅 앱을 생각해 보세요. 사용자가 '자동차를 렌트하고 싶습니다'라고 쓸 수 있습니다. Chat 앱은 '차량을 어디에서 픽업하시겠어요?'와 같은 질문에 응답할 수 있습니다. 그러면 렌터카를 예약하는 동안 채팅 앱이 사람의 음성을 이해하고 사람의 음성을 사용해 응답하는 사람과 같은 대화가 시작됩니다.

이는 하나의 예에 불과합니다. Dialogflow 채팅 앱은 모든 종류의 상호작용에 유용합니다 자연스러운 사람의 음성이 필요하다면 Dialogflow 채팅 앱이 필요합니다. 사전 빌드된 에이전트를 통해 빠르게 시작할 수 있으며 다음과 같이 Dialogflow의 기능을 보여줄 수 있습니다.

• 항공편 예약
• 진료 예약
• 음식 배달 주문
• 상품이 다른 색상으로 제공되는지 여부 등 소매 제품 카탈로그에 관한 질문에 답변합니다.

목표

• 환경을 설정합니다.
• Dialogflow CX 에이전트를 만들고 배포합니다.
• Dialogflow CX 에이전트로 지원되는 채팅 앱을 만들고 배포합니다.
• 채팅 앱을 테스트합니다.

기본 요건

• Google Chat에 액세스할 수 있는 Google Workspace 계정
• Google Cloud 프로젝트.
• Cloud 프로젝트에 결제를 사용 설정했는지 확인합니다. 프로젝트의 결제 상태를 확인하는 방법을 알아보세요.

아키텍처

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

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

1. 사용자가 Chat의 메시지를 채팅 앱 또는 Chat 스페이스로 보냅니다.
2. Google Cloud에 있는 Dialogflow 가상 에이전트가 메시지를 수신하고 처리하여 응답을 생성합니다.
3. Dialogflow 에이전트는 Dialogflow 웹훅을 사용하여 프로젝트 관리 시스템이나 티켓팅 도구와 같은 외부 서드 파티 서비스와 상호작용할 수 있습니다.
4. Dialogflow 에이전트는 Chat의 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 프로젝트를 선택합니다. 프로젝트를 찾으려면 All을 클릭한 후 검색해야 할 수 있습니다.

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. Flow에서 Default Start Flow(기본 시작 흐름)를 선택합니다.
   5. 페이지에서 시작 페이지를 선택합니다.
   6. 에이전트에 연결 작성 창에 Hello를 입력하고 Enter를 누릅니다. 상담사는 자신을 소개하며 응답합니다.
   7. 샘플 테스트 대화를 진행하여 테스트를 완료합니다.

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

   Dialogflow CX 콘솔로 이동

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

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

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

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

   Chat API로 이동

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

   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. 도메인의 특정 사용자 및 그룹이 이 채팅 앱을 사용할 수 있도록 설정하고 이메일 주소를 입력합니다.
   9. 로그에서 Logging에 오류 로깅을 선택합니다.

3. 저장을 클릭합니다.

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

채팅 앱 테스트

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

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

   Google Chat으로 이동

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

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

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

   Dialogflow 채팅 앱은 자신을 소개하는 방식으로 응답합니다.

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

샘플 테스트 대화

Dialogflow CX 콘솔 또는 Google Chat에서 Dialogflow CX 채팅 앱을 테스트하려면 다음 대화를 나누세요. 이 설명은 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
  • Dialogflow 에이전트에 전송된 쿼리 입력은 Chat 메시지의 argumentText 필드 값에 해당합니다. 메시지에 슬래시 명령어가 포함되어 있으면 text 필드의 값이 대신 사용됩니다.
  • 각 Chat 상호작용 이벤트의 전체 JSON 페이로드는 쿼리 매개변수의 커스텀 페이로드로 Dialogflow에 전송되며 WebhookRequest.payload 필드의 값을 쿼리하여 Dialogflow 웹훅으로 액세스할 수 있습니다.
• 슬래시 명령어는 제한적으로 지원됩니다.
  • 대화상자를 여는 슬래시 명령어는 Dialogflow 채팅 앱에서 지원되지 않습니다.
  • Dialogflow 채팅 앱이 슬래시 명령어로 메시지를 수신하면 쿼리 입력에 text 필드의 값만 포함됩니다. text 필드는 슬래시 명령어의 이름으로 시작하며 (예: /command) Dialogflow 에이전트의 인텐트를 구성하여 슬래시 명령어를 감지하는 데 사용할 수 있습니다.
  • Dialogflow 에이전트가 슬래시 명령어의 채팅 상호작용 이벤트 JSON 페이로드를 처리해야 하는 경우 Dialogflow 웹훅을 사용하여 쿼리 매개변수의 커스텀 페이로드를 검사하면 됩니다.
• 링크 미리보기는 지원되지 않습니다.
• Dialogflow 에이전트가 메시지 하나만 응답하면 메시지가 Google Chat에 동기식으로 전송됩니다. Dialogflow 에이전트가 여러 메시지로 응답하면 각 메시지에 대해 Chat API의 spaces.messages 리소스에서 create 메서드를 한 번씩 호출하여 모든 메시지가 비동기식으로 Chat에 전송됩니다.

문제 해결

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

Chat UI에 오류 메시지가 표시되지 않더라도 채팅 앱에 대한 오류 기록이 사용 설정되어 있을 때 오류를 수정하는 데 도움이 되는 자세한 오류 메시지와 로그 데이터가 제공됩니다. 오류를 확인, 디버깅, 수정하는 데 도움이 필요하면 Google Chat 오류 문제 해결 및 수정하기를 참고하세요.

삭제

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

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

   Resource Manager로 이동

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

관련 주제

• Dialogflow CX는 Dialogflow 에이전트 설계에 대한 상태 머신 접근 방식을 취하여 대화를 명확하고 명시적으로 제어하고 최종 사용자 환경을 개선하며 개발 워크플로를 개선합니다. Dialogflow Chat 앱을 빌드할 때는 Dialogflow CX를 사용하는 것이 좋습니다.
  • 에이전트 빌드 및 구성에 대한 자세한 내용은 Dialogflow CX 에이전트를 참조하세요.
  • 에이전트를 빌드하고 구성하는 방법에 대한 자세한 안내는 Dialogflow CX 에이전트 만들기를 참조하세요.
• Dialogflow ES는 Dialogflow를 채팅 앱에서 사용하는 또 다른 방법입니다.