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

이 페이지에서는 두 기능을 모두 사용할 수 있는 Google Chat 앱을 빌드하는 방법을 설명합니다. 자연어를 사용하여 Dialogflow 이 가이드에서는 Dialogflow CX: Google Chat과의 직접 통합 또한 Dialogflow ES를 통해 Dialogflow ES Google Chat 앱 Dialogflow ES Google Chat 참조하세요.

렌트를 도와주는 채팅 앱을 예로 들어보겠습니다. 자동차 사용자는 '차를 렌트하고 싶어'라고 쓸 수 있습니다. 이 채팅 앱에서 다음과 같은 질문을 할 수 있습니다. "어디에서 차량을 수령하시겠어요?" 이는 인간과 유사한 채팅 앱에서 사용자와 나눈 대화 렌터카를 예약하는 동안 사람의 음성을 이해하고 응답합니다.

이는 하나의 예에 불과합니다. Dialogflow 채팅 앱은 상호작용의 종류에 따라 다릅니다. 자연스러운 인간의 음성이 필요한 경우에는 Dialogflow 채팅 앱 이 사전 빌드된 에이전트 다음과 같이 Dialogflow로 무엇을 할 수 있는지 보여줍니다.

• 항공편 예약
• 진료 예약
• 음식 배달 주문
• 소매 제품 카탈로그에 관한 질문에 답하기 다른 색상으로 제공

목표

• 환경을 설정합니다.
• Dialogflow CX 에이전트를 만들고 배포합니다.
• 다음을 기반으로 하는 채팅 앱을 만들고 배포합니다. Dialogflow CX 에이전트
• 채팅 앱을 테스트합니다.

기본 요건

• 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
• 결제가 사용 설정된 Google Cloud 프로젝트. 기존 프로젝트에 결제가 사용 설정되어 있는지 확인하려면 다음 안내를 따르세요. 자세한 내용은 결제 상태를 볼 수 있습니다. 프로젝트를 만들고 결제를 설정하려면 다음을 참조하세요. Google Cloud 프로젝트를 만듭니다.

아키텍처

다음 다이어그램은 Google Cloud의 Dialogflow로 빌드된 채팅 앱:

앞의 다이어그램에서 Dialogflow 에이전트와 상호작용하는 사용자는 채팅 앱에는 다음과 같은 정보 흐름이 있습니다.

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

환경 설정

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

   API 사용 설정

2. 올바른 Cloud 프로젝트에서 선택한 후 다음을 클릭합니다.

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 사용 설정을 비롯한 Google Cloud 콘솔

   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. 에이전트에서 more_vert를 클릭합니다. > 이름 복사를 탭합니다. 이 이름을 다른 이름으로 저장 채팅 앱을 구성할 때 사용합니다

채팅 앱을 만들고 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. 저장을 클릭합니다.

채팅 앱이 메시지를 받고 응답할 준비가 되었습니다. 채팅 메시지

채팅 앱 테스트

Dialogflow CX Chat 앱 Google Chat

1. 사용하는 Google Workspace 계정을 사용하여 Google Chat을 엽니다. 제공됩니다.

   Google Chat으로 이동

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

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

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

   Dialogflow 채팅 앱은 있습니다.

6. 먼저 샘플 테스트 대화를 참조하세요.

샘플 테스트 대화

Dialogflow CX 채팅 앱을 Dialogflow CX 콘솔 또는 Google Chat에서 다음과 같은 대화를 나눌 수 있습니다. 이 설명은 Dialogflow CX 에이전트가 사용자의 자연어 응답을 생성하여 대화를 나눌 수 있습니다. 이 샘플 대화는 사전 빌드된 에이전트 여행: 렌터카라고 불립니다.

Dialogflow에서 카드 메시지 전송

Dialogflow는 text 또는 카드 메시지를 전송합니다. 카드로 응답하기 로 지정합니다. 커스텀 페이로드 인치 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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

제한사항 및 고려사항

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

문제 해결

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

채팅 UI에 오류 메시지가 표시되지 않을 수도 있지만 오류 해결에 도움이 되는 오류 메시지 및 로그 데이터를 사용할 수 있음 채팅 앱의 오류 로깅이 사용 설정된 경우 보는 데 도움이 필요한 경우 오류를 수정하는 방법에 대한 자세한 내용은 Google Chat 오류 문제 해결하기

삭제

서비스 요금이 Google Cloud 계정에 청구되지 않도록 리소스 사용을 중단하려면 Cloud 프로젝트입니다.

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

   <ph type="x-smartling-placeholder"></ph> Resource Manager로 이동 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

관련 주제

• Dialogflow CX는 상태 머신 Dialogflow 에이전트 설계에 대한 접근 방식으로 더 나은 최종 사용자 경험을 제공하며 살펴보겠습니다 Dialogflow를 빌드할 때 채팅 앱을 사용하는 경우 Dialogflow CX를 사용하는 것이 좋습니다.
  • 에이전트 빌드 및 구성에 대한 자세한 내용은 다음을 참조하세요. Dialogflow CX 에이전트
  • 빌드 및 구성 방법을 안내하는 자세한 둘러보기 자세한 내용은 Dialogflow CX 에이전트를 만듭니다.
  • code Codelab: Dialogflow CX 데이터를 빌드하는 방법의 예시를 확인합니다. Google Cloud의 Knowledge Chat 앱을 Codelab Gemini로 Google Chat용 앱 빌드하기
  • code Codelab: Dialogflow CX 빌드 방법의 예시 대화형 에이전트, 피드백 채팅 앱 보기 Codelab에서 Gemini로 Google Chat용 앱 빌드하기
• Dialogflow ES Dialogflow를 채팅 앱과 함께 사용하는 또 다른 방법입니다.